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 berlaku untuk satu perangkat. Lihat panduan untuk 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 bentuk enterprises/{enterprise}/migrationTokens/{migrationToken}.

value

string

Hanya output. Nilai token migrasi.

createTime

string (Timestamp format)

Hanya output. Waktu pembuatan token migrasi ini.

Stempel waktu dalam format 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. Tidak dapat diubah. ID pengguna akun Google Play Terkelola di perangkat, seperti di Play EMM API. Ini sesuai dengan parameter userId dalam panggilan Devices.get Play EMM API.

deviceId

string

Wajib. Tidak dapat diubah. ID perangkat, seperti di Play EMM API. Ini sesuai dengan parameter deviceId dalam 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 bentuk enterprises/{enterprise}/policies/{policy}.

additionalData

string

Tidak dapat diubah. Data tambahan yang ditentukan EMM secara opsional. Setelah perangkat dimigrasikan, kolom ini akan diisi di kolom migrationAdditionalData resource Perangkat. Panjangnya tidak boleh lebih dari 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 hal berikut:

expireTime

string (Timestamp format)

Tidak dapat diubah. Waktu habis masa berlaku token migrasi ini. Periode ini dapat berlangsung maksimal tujuh hari sejak pembuatan. Token migrasi akan dihapus tujuh hari setelah masa berlakunya berakhir.

Stempel waktu dalam format 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)

Hanya input. Durasi validitas token migrasi ini. Ini hanya input, dan untuk menampilkan token migrasi, server akan mengisi kolom expireTime. Proses ini dapat memerlukan waktu maksimal 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 di 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 yang sepenuhnya terkelola. Hanya didukung di perangkat yang menjalankan Android 9 dan yang lebih baru.

Metode

create

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

get

Mendapatkan token migrasi.

list

Mencantumkan token migrasi.