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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expireTime": string,
  "ttl": string
  // End of mutually exclusive fields.
}
Поля
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} .

Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из этих полей:
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

 Отображает список токенов миграции.