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

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

create Time

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

user Id

string

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

device Id

string

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

management Mode

enum ( ManagementMode )

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

policy

string

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

additional Data

string

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

device

string

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

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

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

expire Time

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

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

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

Токен, позволяющий инициировать миграцию устройства из-под управления стороннего ЦОД в управление через 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

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

create Time

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

user Id

string

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

device Id

string

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

management Mode

enum ( ManagementMode )

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

policy

string

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

additional Data

string

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

device

string

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

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

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

expire Time

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

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