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 中的使用者 ID。這會對應至 Play EMM API 的 Devices.get 呼叫中的 userId 參數。
deviceId

string

必要欄位。不可變動。裝置 ID，如同 Play EMM API 中的 ID。這會對應至 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)

不可變動。此遷移權杖的到期時間。這項作業最多需要七天才能完成。遷移權杖會在過期後七天刪除。

使用 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 欄位。最多為七天。預設為七天。

時間長度以秒為單位，最多可有 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

 列出遷移符記。