資源:MigrationToken
這個權杖可以啟動遷移程序,讓裝置從目前由第三方 DPC 管理,改為由 Android Management API 管理。遷移權杖僅適用於單一裝置。詳情請參閱指南。
JSON 表示法 |
---|
{ "name": string, "value": string, "createTime": string, "userId": string, "deviceId": string, "managementMode": enum ( |
欄位 | |
---|---|
name |
僅供輸出。伺服器在建立時產生的遷移權杖名稱,格式為 |
value |
僅供輸出。遷移權杖的值。 |
createTime |
僅供輸出。這個遷移權杖的建立時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
userId |
必要欄位。不可變動。裝置上的 Google Play 管理版帳戶使用者 ID,例如 Play EMM API。這與 Play EMM API |
deviceId |
必要欄位。不可變動。裝置 ID,與 Play EMM API 中顯示的內容。這與 Play EMM API |
managementMode |
必要欄位。不可變動。要遷移的裝置或設定檔的管理模式。 |
policy |
必要欄位。不可變動。註冊裝置最初套用的政策名稱,格式為 |
additionalData |
不可變動。選用的 EMM 指定其他資料。裝置遷移後,這項資訊會填入裝置資源的 |
device |
僅供輸出。使用這個遷移權杖遷移裝置後,系統會在這裡填入產生的 |
聯集欄位
|
|
expireTime |
不可變動。這個遷移權杖的到期時間。此期限最長為建立後的七天。遷移權杖會在到期七天後刪除。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
ttl |
僅限輸入。這個遷移憑證生效的時間。此為必填資訊,且如要傳回遷移權杖,伺服器會將該權杖填入 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
ManagementMode
要遷移的裝置或設定檔的管理模式。
列舉 | |
---|---|
MANAGEMENT_MODE_UNSPECIFIED |
不能使用這個值。 |
WORK_PROFILE_PERSONALLY_OWNED |
個人擁有裝置上的工作資料夾。這項功能僅適用於搭載 Android 9 以上版本的裝置。 |
WORK_PROFILE_COMPANY_OWNED |
公司擁有裝置上的工作資料夾。這項功能僅適用於搭載 Android 11 以上版本的裝置。 |
FULLY_MANAGED |
全代管裝置。這項功能僅適用於搭載 Android 9 以上版本的裝置。 |
方法 |
|
---|---|
|
建立遷移權杖,將現有裝置從 EMM 的裝置政策控制器 (DPC) 管理,不再由 Android Management API 管理。 |
|
取得遷移權杖。 |
|
列出遷移權杖。 |