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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"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 指定其他資料。裝置遷移後,這項資訊會填入裝置資源的 migrationAdditionalData 欄位中。長度上限為 1024 個半形字元。

device

string

僅供輸出。使用這個遷移權杖遷移裝置後,系統會在這裡填入產生的 Device 資源名稱,格式為 enterprises/{enterprise}/devices/{device}

聯集欄位 expiration

expiration 只能採用下列其中一種設定:

expireTime

string (Timestamp format)

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

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

ttl

string (Duration format)

僅限輸入。這個遷移憑證生效的時間。此為必填資訊,且如要傳回遷移權杖,伺服器會將該權杖填入 expireTime 欄位中。最長 7 天。預設值為 7 天。

持續時間以秒為單位,最多 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

列出遷移權杖。