REST Resource: enterprises.migrationTokens

Risorsa: MigrationToken

Un token per avviare la migrazione di un dispositivo dalla gestione da un DPC di terze parti alla gestione dall'API Android Management. Il token di migrazione è valido solo per un singolo dispositivo. Per ulteriori dettagli, consulta la guida.

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. 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 nel formato RFC3339 UTC "Zulu" 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

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

string

Obbligatorio. Immutabile. 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)

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

string

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

string

Immutabile. Dati aggiuntivi facoltativi specificati per 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. Una volta utilizzato il token di migrazione per eseguire la migrazione di un dispositivo, il nome della risorsa Device risultante verrà compilato qui, nel formato enterprises/{enterprise}/devices/{device}.

Campo unione expiration.

expiration può essere solo uno dei seguenti:
expireTime

string (Timestamp format)

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

Un timestamp nel formato RFC3339 UTC "Zulu" 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 tempo di validità del token di migrazione. Si tratta di un valore di solo input e per restituire un token di migrazione il server compilerà il campo expireTime. L'operazione può durare al massimo sette giorni. Il valore predefinito è sette giorni.

Durata in secondi con un massimo di nove cifre frazionarie e 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 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 dal controller dei criteri dei dispositivi (DPC) dell'EMM alla gestione dall'API Android Management.

get

 Recupera un token di migrazione.

list

 Elenca i token di migrazione.