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

必須。変更不可。デバイス上の managed 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 フィールドに入力されます。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 以降を搭載したデバイスでのみサポートされています。

Methods

create

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

get

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

list

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