REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

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 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 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. Es 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 Play EMM. 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 migra.

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 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 de vencimiento de 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 su vencimiento.

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. Esto es de solo 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 de propiedad 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 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 para que deje de ser administrado por el controlador de política de dispositivo (DPC) de EMM y pase a ser administrado por la API de administración de Android.

get

Obtiene un token de migración.

list

Enumera los tokens de migración.