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 指定的可选附加数据。设备迁移后,系统会在 Device 资源的 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

列出迁移令牌。