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)

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

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 天后被删除。

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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

 列出迁移令牌。