REST Resource: enterprises.migrationTokens

Ресурс: MigrationToken

Токен для инициирования миграции устройства из-под управления сторонним DPC под управление 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 на устройстве, как в API Play EMM. Соответствует параметру userId в вызове Devices.get API Play EMM.

deviceId

string

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

managementMode

enum ( ManagementMode )

Обязательно. Неизменяемо. Режим управления устройством или профилем, который переносится.

policy

string

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

additionalData

string

Неизменяемые. Необязательные дополнительные данные, указанные в EMM. После миграции устройства они будут добавлены в поле migrationAdditionalData ресурса Device. Длина поля не должна превышать 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 под управление API управления Android.

get

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

list

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