REST Resource: enterprises.migrationTokens

Risorsa: MigrationToken

Un token per avviare la migrazione di un dispositivo dalla gestione da parte di un DPC di terze parti alla gestione da parte dell'API Android Management. Un 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. 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. Ora in cui è stato creato questo token di migrazione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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, come nell'API Play EMM. Corrisponde al parametro userId nella chiamata Devices.get dell'API Play EMM.
deviceId

string

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

enum (ManagementMode)

Obbligatorio. Immutabile. La modalità di gestione del dispositivo o del profilo di cui è in corso 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 dall'EMM. Una volta eseguita la migrazione del dispositivo, questo valore verrà inserito nel campo migrationAdditionalData della risorsa Dispositivo. Deve contenere al massimo 1024 caratteri.
device

string

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

Campo unione expiration.

expiration può essere solo uno dei seguenti:
expireTime

string (Timestamp format)

Immutabile. L'ora in cui scade questo token di migrazione. Possono trascorrere al massimo sette giorni dal momento della creazione. Il token di migrazione viene eliminato sette giorni dopo la scadenza.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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à di questo token di migrazione. Si tratta di un valore di sola input e, per restituire un token di migrazione, il server completerà il campo expireTime. L'operazione può richiedere 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 è in corso 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. Supportato solo sui dispositivi con Android 9 e versioni successive.
WORK_PROFILE_COMPANY_OWNED Un profilo di lavoro su un dispositivo di proprietà dell'azienda. Supportato solo sui dispositivi con Android 11 e versioni successive.
FULLY_MANAGED Un dispositivo completamente gestito. Supportato solo su dispositivi con Android 9 e versioni successive.

Metodi

create

 Crea un token di migrazione per eseguire la migrazione di un dispositivo esistente dalla gestione tramite il controller dei criteri dei dispositivi (DPC) dell'EMM alla gestione tramite l'API Android Management.

get

 Recupera un token di migrazione.

list

 Elenca i token di migrazione.