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

列出遷移符記。