REST Resource: enterprises.migrationTokens

Ressource: MigrationToken

Ein Token, mit dem die Migration eines Geräts gestartet wird, das nicht mehr durch einen DPC eines Drittanbieters verwaltet wird, sondern durch die Android Management API verwaltet wird. Ein Migrationstoken ist nur für ein einzelnes Gerät gültig. Weitere Informationen finden Sie im Leitfaden.

JSON-Darstellung 
{
  "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.
}
Felder
name

string

Nur Ausgabe Der Name des Migrationstokens, das vom Server während der Erstellung generiert wird, im Format enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Nur Ausgabe Der Wert des Migrationstokens.
createTime

string (Timestamp format)

Nur Ausgabe Zeitpunkt, zu dem dieses Migrationstoken erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
userId

string

Erforderlich. Nicht veränderbar. Die Nutzer-ID des Managed Google Play-Kontos auf dem Gerät, wie in der Play EMM API. Es entspricht dem Parameter userId im Aufruf Devices.get der Play EMM API.
deviceId

string

Erforderlich. Nicht veränderbar. Die ID des Geräts, wie in der Play EMM API. Es entspricht dem Parameter deviceId im Aufruf Devices.get der Play EMM API.
managementMode

enum (ManagementMode)

Erforderlich. Nicht veränderbar. Der Verwaltungsmodus des zu migrierenden Geräts oder Profils.
policy

string

Erforderlich. Nicht veränderbar. Der Name der Richtlinie, die anfänglich auf das registrierte Gerät angewendet wurde, im Format enterprises/{enterprise}/policies/{policy}.
additionalData

string

Nicht veränderbar. Optionale, vom EMM angegebene zusätzliche Daten. Nach der Migration des Geräts wird der Wert in das Feld migrationAdditionalData der Geräteressource eingefügt. Er darf höchstens 1.024 Zeichen lang sein.
device

string

Nur Ausgabe Sobald dieses Migrationstoken für die Gerätemigration verwendet wurde, wird der Name der resultierenden Device-Ressource hier im Format enterprises/{enterprise}/devices/{device} eingefügt.

Union-Feld expiration.

Für expiration ist nur einer der folgenden Werte zulässig:
expireTime

string (Timestamp format)

Nicht veränderbar. Der Zeitpunkt, zu dem dieses Migrationstoken abläuft. Der Zeitraum ab der Erstellung kann höchstens sieben Tage betragen. Das Migrationstoken wird sieben Tage nach Ablauf gelöscht.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Nur Eingabe. Die Gültigkeitsdauer dieses Migrationstokens. Dies ist nur Eingabe. Damit ein Migrationstoken zurückgegeben wird, füllt der Server das Feld expireTime aus. Das kann höchstens sieben Tage betragen. Die Standardeinstellung beträgt sieben Tage.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

ManagementMode

Der Verwaltungsmodus des zu migrierenden Geräts oder Profils.

Enums
MANAGEMENT_MODE_UNSPECIFIED Dieser Wert darf nicht verwendet werden.
WORK_PROFILE_PERSONALLY_OWNED Arbeitsprofil auf einem privaten Gerät Diese Option wird nur auf Geräten mit Android 9 und höher unterstützt.
WORK_PROFILE_COMPANY_OWNED Ein Arbeitsprofil auf einem unternehmenseigenen Gerät Diese Option wird nur auf Geräten mit Android 11 und höher unterstützt.
FULLY_MANAGED Ein vollständig verwaltetes Gerät Diese Option wird nur auf Geräten mit Android 9 und höher unterstützt.

Methoden

create

 Erstellt ein Migrationstoken, um ein vorhandenes Gerät, das nicht über den Device Policy Controller (DPC) des EMM verwaltet wird, durch die Android Management API zu verwalten.

get

 Ruft ein Migrationstoken ab.

list

 Listet Migrationstokens auf.