REST Resource: enterprises.migrationTokens

Risorsa: MigrationToken

Un token per avviare la migrazione di un dispositivo dalla gestione di un DPC di terze parti alla gestione dell'API Android Management. Un token di migrazione è valido per un solo dispositivo. Consulta la guida per ulteriori dettagli.

Rappresentazione 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.
}
Campi
name

string

Solo output. Il nome del token di migrazione, generato dal server durante la creazione, nel formato enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Solo output. Il valore del token di migrazione.
createTime

string (Timestamp format)

Solo output. Data e ora di creazione del token di migrazione.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
userId

string

Obbligatoria. Immutabile. L'ID utente dell'account della versione gestita di Google Play sul dispositivo, ad esempio nell'API EMM di Google Play. Corrisponde al parametro userId nella chiamata Devices.get dell'API EMM di Play.
deviceId

string

Obbligatoria. Immutabile. L'ID del dispositivo, come nell'API EMM di Play. Corrisponde al parametro deviceId nella chiamata Devices.get dell'API EMM di Play.
managementMode

enum (ManagementMode)

Obbligatoria. Immutabile. La modalità di gestione del dispositivo o del profilo di cui viene eseguita la migrazione.
policy

string

Obbligatoria. Immutabile. Il nome del criterio inizialmente applicato al dispositivo registrato, nel formato enterprises/{enterprise}/policies/{policy}.
additionalData

string

Immutabile. Dati aggiuntivi facoltativi specificati per l'EMM. Una volta eseguita la migrazione del dispositivo, questo verrà inserito nel campo migrationAdditionalData della risorsa Dispositivo. Deve contenere al massimo 1024 caratteri.
device

string

Solo output. Dopo aver utilizzato questo token di migrazione per eseguire la migrazione di un dispositivo, il nome della risorsa Device risultante verrà inserito qui nel formato enterprises/{enterprise}/devices/{device}.

Campo di unione expiration.

expiration può essere solo uno dei seguenti:
expireTime

string (Timestamp format)

Immutabile. L'ora di scadenza del token di migrazione. Può essere di massimo sette giorni dal momento della creazione. Il token di migrazione viene eliminato sette giorni dopo la scadenza.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Solo input. Il periodo di validità del token di migrazione. Si tratta di un campo di solo input e per restituire un token di migrazione il server completerà il campo expireTime. Il valore può durare al massimo sette giorni. Il valore predefinito è sette giorni.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

ManagementMode

La modalità di gestione del dispositivo o del profilo di cui viene eseguita la migrazione.

Enum
MANAGEMENT_MODE_UNSPECIFIED Questo valore non deve essere utilizzato.
WORK_PROFILE_PERSONALLY_OWNED Un profilo di lavoro su un dispositivo di proprietà personale. Funzionalità supportata solo sui dispositivi con Android 9 e versioni successive.
WORK_PROFILE_COMPANY_OWNED Un profilo di lavoro su un dispositivo di proprietà dell'azienda. Funzionalità supportata solo sui dispositivi con Android 11 e versioni successive.
FULLY_MANAGED Un dispositivo completamente gestito. Funzionalità supportata solo sui dispositivi con Android 9 e versioni successive.

Metodi

create

 Crea un token di migrazione per eseguire la migrazione di un dispositivo esistente dalla gestione del controller dei criteri dei dispositivi (DPC) dell'EMM a quella dell'API Android Management.

get

 Recupera un token di migrazione.

list

 Elenca i token di migrazione.