REST Resource: enterprises.migrationTokens

Ressource: MigrationToken

Ein Token, mit dem die Migration eines Geräts von der Verwaltung durch einen Drittanbieter-DPC zu der Android Management API initiiert wird. Ein Migrationstoken ist nur für ein einzelnes Gerät gültig. Weitere Informationen finden Sie in diesem 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, der beim Erstellen vom Server im Format enterprises/{enterprise}/migrationTokens/{migrationToken} generiert wird.
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 einer Auflösung im Nanosekundenbereich 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. Das entspricht dem Parameter userId im Devices.get-Aufruf der Play EMM API.
deviceId

string

Erforderlich. Nicht veränderbar. Die ID des Geräts, wie in der Play EMM API. Das entspricht dem Parameter deviceId im Devices.get-Aufruf 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 ursprünglich auf das registrierte Gerät angewendet wurde, im Format enterprises/{enterprise}/policies/{policy}.
additionalData

string

Nicht veränderbar. Optionale zusätzliche, durch EMM angegebene Daten. Nach der Migration des Geräts wird dieser Wert im Feld migrationAdditionalData der Geräteressource eingetragen. Er darf höchstens 1.024 Zeichen lang sein.
device

string

Nur Ausgabe. Nachdem dieses Migrationstoken zum Migrieren eines Geräts verwendet wurde, wird der Name der resultierenden Device-Ressource hier im Format enterprises/{enterprise}/devices/{device} eingetragen.

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. Dieser Wert kann maximal sieben Tage nach der Erstellung sein. Das Migrationstoken wird sieben Tage nach dem Ablauf gelöscht.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 Zeit, für die dieses Migrationstoken gültig ist. Dies ist eine reine Eingabe. Für die Rückgabe eines Migrationstokens füllt der Server das Feld expireTime aus. Dieser Wert kann höchstens sieben Tage betragen. Der Standardwert beträgt sieben Tage.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". 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 Ein Arbeitsprofil auf einem privaten Gerät. Diese Einstellung 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 Einstellung wird nur auf Geräten mit Android 11 und höher unterstützt.
FULLY_MANAGED Ein vollständig verwaltetes Gerät. Diese Einstellung wird nur auf Geräten mit Android 9 und höher unterstützt.

Methoden

create

 Erstellt ein Migrationstoken, um ein vorhandenes Gerät von der Verwaltung über den Device Policy Controller (DPC) des EMM auf die Verwaltung über die Android Management API zu migrieren.

get

 Ruft ein Migrationstoken ab.

list

 Listet Migrationstokens auf.