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 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
userId

string

必要欄位。不可變動。裝置上 Google Play 管理版帳戶的使用者 ID，與 Play EMM API 中的 ID 相同。此值對應 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)

不可變動。這個遷移權杖的到期時間。建立時間最多為七天。遷移權杖會在過期的七天後刪除。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
ttl

string (Duration format)

僅限輸入。這個遷移權杖的有效時間。這是僅供輸入之用。如要傳回遷移權杖，伺服器會填入 expireTime 欄位。最多需要七天。預設值為七天。

時間長度以秒為單位，最多可有 9 個小數位數，並結尾為「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

 列出遷移權杖。