REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

Es un token para iniciar la migración de un dispositivo de ser administrado por un DPC de terceros a ser administrado por la API de Android Management. Un token de migración solo es válido para un dispositivo único.

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 a 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 EMM de Play.

deviceId

string

Obligatorio. Inmutable. Es 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 EMM de Play.

managementMode

enum (ManagementMode)

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

policy

string

Obligatorio. Inmutable. Es 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 con EMM. Una vez que se migre el dispositivo, este campo se propagará 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. Puede ser como máximo siete días desde la fecha de 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. La hora durante la cual es válido este token de migración. Esto es de solo entrada, y para mostrar un token de migración, el servidor propagará el campo expireTime. Puede ser de siete días como máximo. El valor predeterminado es siete días.

Es una duración en segundos con hasta nueve dígitos decimales que termina 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. Solo es 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 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 que el controlador de política de dispositivo (DPC) de EMM lo administre la API de Android Management.

get

Obtiene un token de migración.

list

Enumera los tokens de migración.