REST Resource: enterprises.migrationTokens

リソース: MigrationToken

デバイスをサードパーティの DPC による管理から Android Management API による管理に移行するためのトークン。移行トークンは 1 台のデバイスにのみ有効です。詳しくは、こちらのガイドをご覧ください。

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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
userId

string

必須。変更不可。Play EMM API と同様に、デバイス上の managed Google Play アカウントのユーザー ID。これは、Play EMM API の Devices.get 呼び出しの userId パラメータに対応しています。
deviceId

string

必須。変更不可。Play EMM API と同様に、デバイスの ID。これは、Play EMM API の Devices.get 呼び出しの deviceId パラメータに対応しています。
managementMode

enum (ManagementMode)

必須。変更不可。移行されるデバイスまたはプロファイルの管理モード。
policy

string

必須。変更不可。登録済みデバイスに最初に適用されたポリシーの名前（enterprises/{enterprise}/policies/{policy} 形式）。
additionalData

string

変更不可。EMM 指定の追加データ（省略可）。デバイスの移行が完了すると、この値は Device リソースの migrationAdditionalData フィールドに入力されます。1,024 文字以内で入力してください。
device

string

出力専用。この移行トークンを使用してデバイスを移行すると、生成された Device リソースの名前が enterprises/{enterprise}/devices/{device} の形式でここに入力されます。

共用体フィールド expiration。

expiration は次のいずれかになります。
expireTime

string (Timestamp format)

変更不可。この移行トークンの有効期限が切れる時刻。作成日から最大 7 日間です。移行トークンは、有効期限が切れてから 7 日後に削除されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
ttl

string (Duration format)

入力のみのこの移行トークンが有効な期間。これは入力専用です。移行トークンを返すために、サーバーは expireTime フィールドに値を設定します。最長で 7 日間まで設定できます。デフォルトは 7 日間です。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

ManagementMode

移行するデバイスまたはプロファイルの管理モード。

列挙型
MANAGEMENT_MODE_UNSPECIFIED この値は使用しないでください。
WORK_PROFILE_PERSONALLY_OWNED 個人所有デバイスの仕事用プロファイル。Android 9 以降を搭載したデバイスでのみサポートされます。
WORK_PROFILE_COMPANY_OWNED 会社所有デバイス上の仕事用プロファイル。Android 11 以降を搭載したデバイスでのみサポートされます。
FULLY_MANAGED 完全管理対象デバイス。Android 9 以降を搭載したデバイスでのみサポートされます。

メソッド

create

 移行トークンを作成して、既存のデバイスを EMM の Device Policy Controller（DPC）から Android Management API に移行します。

get

 移行トークンを取得します。

list

 移行トークンを一覧表示します。