REST Resource: enterprises.migrationTokens

Resource: MigrationToken

Token untuk memulai migrasi perangkat dari dikelola oleh DPC pihak ketiga ke 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 dihasilkan oleh server selama pembuatan, dalam format 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 format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

userId

string

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

deviceId

string

Wajib. Tidak dapat diubah. ID perangkat, seperti pada Play EMM API. Ini sesuai dengan parameter deviceId di panggilan Devices.get Play EMM API.

managementMode

enum (ManagementMode)

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

policy

string

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

additionalData

string

Tidak dapat diubah. Data tambahan opsional yang ditentukan EMM. Setelah perangkat dimigrasikan, ini akan diisi di kolom migrationAdditionalData pada Resource perangkat. Jumlah karakter tidak boleh lebih dari 1024.

device

string

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

Kolom union expiration.

expiration hanya dapat berupa salah satu dari yang berikut:

expireTime

string (Timestamp format)

Tidak dapat diubah. Waktu saat token migrasi ini berakhir masa berlakunya. Proses ini dapat berlangsung paling lama tujuh hari dari waktu pembuatan. Token migrasi dihapus tujuh hari setelah masa berlakunya habis.

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

ttl

string (Duration format)

Hanya input. Masa berlaku token migrasi ini. Ini hanya bersifat input, dan untuk menampilkan token migrasi, server akan mengisi kolom expireTime. Proses ini dapat berlangsung paling lama tujuh hari. Defaultnya adalah tujuh hari.

Durasi dalam detik dengan maksimal sembilan digit pecahan, 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 sudah ada dari dikelola oleh Pengontrol Kebijakan Perangkat (DPC) EMM ke dikelola oleh Android Management API.

get

Mendapatkan token migrasi.

list

Mencantumkan token migrasi.