REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

Um token para iniciar a migração de um dispositivo de um DPC de terceiros para a API Android Management. Um token de migração é válido apenas para um dispositivo. Consulte o guia para mais detalhes.

Representação 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

Apenas saída. O nome do token de migração, que é gerado pelo servidor durante a criação, no formato enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Apenas saída. O valor do token de migração.
createTime

string (Timestamp format)

Apenas saída. Hora em que o token de migração foi criado.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
userId

string

Obrigatório. Imutável. O ID do usuário da conta do Google Play gerenciado no dispositivo, como na API Play EMM. Isso corresponde ao parâmetro userId na chamada Devices.get da API Play EMM.
deviceId

string

Obrigatório. Imutável. O ID do dispositivo, como na API Play EMM. Isso corresponde ao parâmetro deviceId na chamada Devices.get da API Play EMM.
managementMode

enum (ManagementMode)

Obrigatório. Imutável. O modo de gerenciamento do dispositivo ou perfil que está sendo migrado.
policy

string

Obrigatório. Imutável. O nome da política aplicada inicialmente ao dispositivo registrado, no formato enterprises/{enterprise}/policies/{policy}.
additionalData

string

Imutável. Dados adicionais opcionais especificados pelo EMM. Depois que o dispositivo for migrado, ele será preenchido no campo migrationAdditionalData do recurso do dispositivo. Precisa ter no máximo 1.024 caracteres.
device

string

Apenas saída. Quando esse token de migração é usado para migrar um dispositivo, o nome do recurso Device resultante é preenchido aqui, no formulário enterprises/{enterprise}/devices/{device}.

Campo de união expiration.

expiration pode ser apenas de um dos tipos a seguir:
expireTime

string (Timestamp format)

Imutável. A hora em que esse token de migração expira. Isso pode ser feito no máximo sete dias após a criação. O token de migração é excluído sete dias após o vencimento.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
ttl

string (Duration format)

Somente entrada. O tempo de validade do token de migração. Essa é uma entrada somente, e para retornar um token de migração, o servidor vai preencher o campo expireTime. Isso pode levar até sete dias. O padrão é de sete dias.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

ManagementMode

O modo de gerenciamento do dispositivo ou perfil que está sendo migrado.

Enums
MANAGEMENT_MODE_UNSPECIFIED Esse valor não deve ser usado.
WORK_PROFILE_PERSONALLY_OWNED Um perfil de trabalho em um dispositivo pessoal. Suporte apenas para dispositivos com o Android 9 e versões mais recentes.
WORK_PROFILE_COMPANY_OWNED Um perfil de trabalho em um dispositivo da empresa. Somente em dispositivos com o Android 11 e versões mais recentes.
FULLY_MANAGED Um dispositivo totalmente gerenciado. Suporte apenas para dispositivos com o Android 9 e versões mais recentes.

Métodos

create

 Cria um token de migração para migrar um dispositivo do controle de política de dispositivo (DPC) do EMM para a API Android Management.

get

 Recebe um token de migração.

list

 Lista tokens de migração.