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)

仅限输出。此迁移令牌的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
userId

string

必需。不可变。设备上 Google Play 企业版账号的用户 ID，如 Play EMM API 中一样。这对应于 Play EMM API 的 Devices.get 调用中的 userId 参数。
deviceId

string

必需。不可变。设备的 ID，如 Play EMM API 所示。这对应于 Play EMM API 的 Devices.get 调用中的 deviceId 参数。
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)

不可变。此迁移令牌的到期时间。自创建之时起，最多可为 7 天。迁移令牌会在过期 7 天后被删除。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
ttl

string (Duration format)

仅限输入。此迁移令牌的有效期。此字段仅供输入，为了返回迁移令牌，服务器将填充 expireTime 字段。这一过程最多可能需要 7 天。默认值为 7 天。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

ManagementMode

要迁移的设备或配置文件的管理模式。

枚举
MANAGEMENT_MODE_UNSPECIFIED 不得使用此值。
WORK_PROFILE_PERSONALLY_OWNED 个人拥有设备上的工作资料。仅适用于搭载 Android 9 及更高版本的设备。
WORK_PROFILE_COMPANY_OWNED 公司自有设备上的工作资料。仅适用于搭载 Android 11 及更高版本的设备。
FULLY_MANAGED 完全受管设备。仅适用于搭载 Android 9 及更高版本的设备。

方法

create

 创建迁移令牌，将现有设备从受 EMM 的设备政策控制器 (DPC) 管理改为受 Android Management API 管理。

get

 获取迁移令牌。

list

 列出迁移令牌。