REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

Es un token para iniciar la migración de un dispositivo de la administración de un DPC de terceros a la administración de la API de Android Management. Un token de migración solo es válido para un solo dispositivo. Consulta la guía para obtener más detalles.

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. Es el nombre del token de migración, que genera el servidor durante la creación, en el formato enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Solo salida. Es el valor del token de migración.
createTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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. Es el ID del dispositivo, como en la API de Play EMM. 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 migra.
policy

string

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

string

Inmutable. Datos adicionales opcionales especificados por EMM. Una vez que se haya migrado el dispositivo, se completará en el campo migrationAdditionalData del recurso 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í, en 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. Esto puede ser, como máximo, siete días desde el momento de la creación. El token de migración se borra siete días después de que venza.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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 momento en que es válido este token de migración. Esta es solo una 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 terminan en “s”. Ejemplo: "3.5s".

ManagementMode

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

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

Métodos

create

 Crea un token de migración para migrar un dispositivo existente de la administración del controlador de política de dispositivos (DPC) de la EMM a la administración de la API de Android Management.

get

 Obtiene un token de migración.

list

 Enumera los tokens de migración.