REST Resource: enterprises.migrationTokens

Ressource: MigrationToken

Ein Token, mit dem die Migration eines Geräts von der Verwaltung durch einen DPC eines Drittanbieters zur Verwaltung durch die Android Management API eingeleitet 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, 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. Die Zeit, zu der 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 Feld 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 Feld entspricht dem Parameter deviceId im Devices.get-Aufruf der Play EMM API.
managementMode

enum (ManagementMode)

Erforderlich. Nicht veränderbar. Der Verwaltungsmodus des migrierten 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 vom EMM angegebene zusätzliche Daten. Nach der Migration wird dieser Wert in das Feld migrationAdditionalData der Geräteressource eingefügt. Dieser darf höchstens 1.024 Zeichen lang sein.
device

string

Nur Ausgabe. Sobald dieses Migrationstoken zum Migrieren eines Geräts verwendet wurde, wird hier der Name der resultierenden Device-Ressource 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. Das kann maximal sieben Tage nach der Erstellung sein. Das Migrationstoken wird sieben Tage nach 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 Zeitspanne, während der dieses Migrationstoken gültig ist. Dieses Feld ist nur zur Eingabe vorgesehen. Wenn ein Migrationstoken zurückgegeben werden soll, füllt der Server das Feld expireTime aus. Das kann maximal sieben Tage dauern. Standardmäßig sind es sieben Tage.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

ManagementMode

Der Verwaltungsmodus des migrierten 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. Nur auf Geräten mit Android 9 und höher unterstützt.
WORK_PROFILE_COMPANY_OWNED Ein Arbeitsprofil auf einem unternehmenseigenen Gerät. Nur auf Geräten mit Android 11 und höher unterstützt.
FULLY_MANAGED Ein vollständig verwaltetes Gerät. 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 durch den Device Policy Controller (DPC) des EMM zur Verwaltung durch die Android Management API zu migrieren.

get

 Ruft ein Migrationstoken ab.

list

 Listet Migrationstokens auf.