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 el EMM Una vez que se migre el dispositivo, se propagará en el campo migrationAdditionalData del recurso Device. 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 de hasta siete días a partir 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 período durante el cual 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 de 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 es compatible con dispositivos que ejecutan Android 9 y versiones posteriores.
WORK_PROFILE_COMPANY_OWNED Un perfil de trabajo en un dispositivo de la empresa Solo es compatible con dispositivos que ejecutan Android 11 y versiones posteriores.
FULLY_MANAGED Un dispositivo completamente administrado Solo es 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.