REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

Es un token para iniciar la migración de un dispositivo administrado por un DPC de terceros a que lo administre la API de Android Management. Un token de migración es válido solo para un dispositivo. Para obtener más detalles, consulta la guía.

Representación 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.
}
Campos
name

string

Solo salida. El nombre del token de migración, que genera el servidor durante la creación, con el formato enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Solo salida. El valor del token de migración.
createTime

string (Timestamp format)

Solo salida. Hora en la que se creó este token de migración.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
userId

string

Obligatorio. Inmutable. El ID de usuario de la cuenta de Google Play administrado en el dispositivo, como en la API de EMM de Play. Esto corresponde al parámetro userId en la llamada Devices.get de la API de Play EMM.
deviceId

string

Obligatorio. Inmutable. El ID del dispositivo, como en la API de EMM de Play. Esto corresponde al parámetro deviceId en la llamada Devices.get de la API de Play EMM.
managementMode

enum (ManagementMode)

Obligatorio. Inmutable. El modo de administración del dispositivo o perfil que se migrará.
policy

string

Obligatorio. Inmutable. El nombre de la política que se aplicó inicialmente al dispositivo inscrito, con el formato enterprises/{enterprise}/policies/{policy}.
additionalData

string

Inmutable. Datos adicionales opcionales especificados por EMM. Una vez que se migren los dispositivos, estos datos se propagarán en el campo migrationAdditionalData del recurso Device (dispositivo). Debe tener un máximo de 1,024 caracteres.
device

string

Solo salida. Una vez que se use este token de migración para migrar un dispositivo, el nombre del recurso Device resultante se propagará aquí con el formato enterprises/{enterprise}/devices/{device}.

Campo de unión expiration.

expiration puede ser una de las siguientes opciones:
expireTime

string (Timestamp format)

Inmutable. La hora a la que vence este token de migración. Puede ser, como máximo, siete días a partir del momento de la creación. El token de migración se borra siete días después de su vencimiento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Solo entrada. El tiempo durante el que es válido este token de migración. Esto es solo de entrada, y para mostrar un token de migración, el servidor propagará el campo expireTime. Esto puede ser de siete días como máximo. El valor predeterminado es siete días.

Una duración en segundos con hasta nueve dígitos decimales que terminen en "s". Ejemplo: "3.5s".

ManagementMode

El modo de administración del dispositivo o perfil que se migrará.

Enumeradores
MANAGEMENT_MODE_UNSPECIFIED No se debe usar este valor.
WORK_PROFILE_PERSONALLY_OWNED Un perfil de trabajo en un dispositivo de propiedad personal Compatible solo con dispositivos que ejecutan Android 9 y versiones posteriores.
WORK_PROFILE_COMPANY_OWNED Un perfil de trabajo en un dispositivo empresarial. Solo se admite en dispositivos que ejecutan Android 11 y versiones posteriores.
FULLY_MANAGED Un dispositivo completamente administrado. Compatible solo con dispositivos que ejecutan Android 9 y versiones posteriores.

Métodos

create

 Crea un token de migración para migrar un dispositivo existente de que es administrado por el controlador de política de dispositivo (DPC) de EMM a ser administrado por la API de Android Management.

get

 Obtiene un token de migración.

list

 Enumera los tokens de migración.