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

必須。変更不可。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

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