REST Resource: enterprises.migrationTokens

Resource: MigrationToken

Token untuk memulai migrasi perangkat dari dikelola oleh DPC pihak ketiga menjadi dikelola oleh Android Management API. Token migrasi hanya valid untuk satu perangkat. Lihat panduan untuk mengetahui detail selengkapnya.

Representasi JSON
{
  "name": string,
  "value": string,
  "createTime": string,
  "userId": string,
  "deviceId": string,
  "managementMode": enum (ManagementMode),
  "policy": string,
  "additionalData": string,
  "device": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
Kolom
name

string

Hanya output. Nama token migrasi, yang dibuat oleh server selama pembuatan, dalam bentuk enterprises/{enterprise}/migrationTokens/{migrationToken}.

value

string

Hanya output. Nilai token migrasi.

createTime

string (Timestamp format)

Hanya output. Waktu saat token migrasi ini dibuat.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

userId

string

Wajib diisi. Tidak dapat diubah. ID pengguna akun Google Play Terkelola di perangkat, seperti di Play EMM API. Hal ini sesuai dengan parameter userId dalam panggilan Devices.get Play EMM API.

deviceId

string

Wajib diisi. Tidak dapat diubah. ID perangkat, seperti di Play EMM API. Hal ini sesuai dengan parameter deviceId dalam panggilan Devices.get Play EMM API.

managementMode

enum (ManagementMode)

Wajib diisi. Tidak dapat diubah. Mode pengelolaan perangkat atau profil yang dimigrasikan.

policy

string

Wajib diisi. Tidak dapat diubah. Nama kebijakan yang awalnya diterapkan ke perangkat terdaftar, dalam bentuk enterprises/{enterprise}/policies/{policy}.

additionalData

string

Tidak dapat diubah. Data tambahan opsional yang ditentukan EMM. Setelah perangkat dimigrasikan, data ini akan diisi di kolom migrationAdditionalData pada resource Perangkat. Nama harus berisi maksimal 1.024 karakter.

device

string

Hanya output. Setelah token migrasi ini digunakan untuk memigrasikan perangkat, nama resource Device yang dihasilkan akan diisi di sini, dalam bentuk enterprises/{enterprise}/devices/{device}.

Kolom union expiration.

expiration hanya dapat berupa salah satu dari yang berikut:

expireTime

string (Timestamp format)

Tidak dapat diubah. Waktu habis masa berlaku token migrasi ini. Batas waktu maksimal adalah tujuh hari sejak waktu pembuatan. Token migrasi akan dihapus tujuh hari setelah masa berlakunya habis.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

ttl

string (Duration format)

Input saja. Waktu validitas token migrasi ini. Tindakan ini hanya untuk input, dan untuk menampilkan token migrasi, server akan mengisi kolom expireTime. Paling lama bisa tujuh hari. Defaultnya adalah tujuh hari.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

ManagementMode

Mode pengelolaan perangkat atau profil yang dimigrasikan.

Enum
MANAGEMENT_MODE_UNSPECIFIED Nilai ini tidak boleh digunakan.
WORK_PROFILE_PERSONALLY_OWNED Profil kerja di perangkat milik pribadi. Hanya didukung pada perangkat yang menjalankan Android 9 dan yang lebih baru.
WORK_PROFILE_COMPANY_OWNED Profil kerja di perangkat milik perusahaan. Hanya didukung di perangkat yang menjalankan Android 11 dan yang lebih baru.
FULLY_MANAGED Perangkat terkelola sepenuhnya. Hanya didukung pada perangkat yang menjalankan Android 9 dan yang lebih baru.

Metode

create

Membuat token migrasi untuk memigrasikan perangkat yang ada agar tidak dikelola oleh Pengontrol Kebijakan Perangkat (DPC) EMM agar dikelola oleh Android Management API.

get

Mendapatkan token migrasi.

list

Mencantumkan token migrasi.