REST Resource: enterprises.migrationTokens

Ресурс: Миграционный токен

Токен, позволяющий инициировать миграцию устройства из-под управления стороннего ЦОД в управление через Android Management API. Токен миграции действителен только для одного устройства. Более подробную информацию смотрите в руководстве .

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.
}
Поля
name

string

Только вывод. Имя токена миграции, который генерируется сервером во время создания, в форме enterprises/{enterprise}/migrationTokens/{migrationToken} .

value

string

Только вывод. Значение токена миграции.

createTime

string ( Timestamp format)

Только вывод. Время создания токена миграции.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

userId

string

Необходимый. Неизменяемый. Идентификатор пользователя управляемого аккаунта Google Play на устройстве, как в Play EMM API. Это соответствует параметру userId в вызове Devices.get API EMM API.

deviceId

string

Необходимый. Неизменяемый. Идентификатор устройства, как в Play EMM API. Это соответствует параметру deviceId в вызове Devices.get API EMM API.

managementMode

enum ( ManagementMode )

Необходимый. Неизменяемый. Режим управления переносимого устройства или профиля.

policy

string

Необходимый. Неизменяемый. Имя политики, первоначально примененной к зарегистрированному устройству, в форме enterprises/{enterprise}/policies/{policy} .

additionalData

string

Неизменяемый. Необязательные дополнительные данные, указанные EMM. После миграции устройства это значение будет заполнено в поле migrationAdditionalData ресурса «Устройство». Оно должно содержать не более 1024 символов.

device

string

Только вывод. Как только этот токен миграции будет использоваться для миграции устройства, здесь будет указано имя результирующего ресурса Device в форме enterprises/{enterprise}/devices/{device} .

expiration поля объединения .

expiration может быть только одним из следующих:

expireTime

string ( Timestamp format)

Неизменяемый. Время истечения срока действия токена миграции. Это может быть максимум семь дней с момента создания. Токен миграции удаляется через семь дней после истечения срока его действия.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

ttl

string ( Duration format)

Только ввод. Время, в течение которого действителен этот токен миграции. Это поле предназначено только для ввода, и для возврата токена миграции сервер заполнит поле expireTime . Это может быть максимум семь дней. По умолчанию — семь дней.

Продолжительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

Режим управления

Режим управления переносимого устройства или профиля.

Перечисления
MANAGEMENT_MODE_UNSPECIFIED Это значение нельзя использовать.
WORK_PROFILE_PERSONALLY_OWNED Рабочий профиль на личном устройстве. Поддерживается только на устройствах под управлением Android 9 и выше.
WORK_PROFILE_COMPANY_OWNED Рабочий профиль на корпоративном устройстве. Поддерживается только на устройствах под управлением Android 11 и выше.
FULLY_MANAGED Полностью управляемое устройство. Поддерживается только на устройствах под управлением Android 9 и выше.

Методы

create

 Создает токен миграции для перевода существующего устройства из-под управления контроллером политики устройств (DPC) EMM в управление через Android Management API.

get

 Получает токен миграции.

list

 Перечисляет токены миграции.