REST Resource: enterprises.migrationTokens

Recurso: MigrationToken

Um token para iniciar a migração de um dispositivo, que deixa de ser gerenciado por um DPC de terceiros e passa a ser gerenciado pela API Android Management. Um token de migração é válido apenas para um único 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.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
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 código 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 inicialmente aplicada ao dispositivo registrado, no formato enterprises/{enterprise}/policies/{policy}.
additionalData

string

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

string

Apenas saída. Depois que esse token de migração for usado para migrar um dispositivo, o nome do recurso Device resultante será preenchido aqui, no formato 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 levar no máximo sete dias a partir do momento da criação. O token de migração é excluído sete dias após a expiração.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Somente entrada. O tempo de validade do token de migração. Ele é somente de entrada. Para retornar um token de migração, o servidor preencherá o campo expireTime. Isso pode levar, no máximo, sete dias. O padrão é 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 Não use esse valor.
WORK_PROFILE_PERSONALLY_OWNED Um perfil de trabalho em um dispositivo pessoal. Compatível apenas com dispositivos que executam o Android 9 ou versão mais recente.
WORK_PROFILE_COMPANY_OWNED Um perfil de trabalho em um dispositivo corporativo. Disponível apenas em dispositivos com o Android 11 ou versões mais recentes.
FULLY_MANAGED Um dispositivo totalmente gerenciado. Compatível apenas com dispositivos que executam o Android 9 ou versão mais recente.

Métodos

create

 Cria um token de migração para migrar um dispositivo atual do gerenciamento pelo controlador de política de dispositivo (DPC) do EMM para o gerenciamento pela API Android Management.

get

 Recebe um token de migração.

list

 Lista os tokens de migração.