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

列出迁移令牌。