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

 列出迁移令牌。