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)

出力専用。この移行トークンが作成された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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 日後に削除されます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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

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