REST Resource: enterprises.migrationTokens

Zasób: MigrationToken

Token do inicjowania migracji urządzenia z zarządzanego przez zewnętrzny kontroler DPC na interfejs Android Management API. Token migracji jest ważny tylko dla jednego urządzenia. Więcej informacji znajdziesz w przewodniku.

Zapis 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.
}
Pola
name

string

Tylko dane wyjściowe. Nazwa tokena migracji, która jest generowana przez serwer podczas tworzenia i ma postać enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

Tylko dane wyjściowe. Wartość tokena migracji.
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tego tokena migracji.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
userId

string

Wymagane. Stałe. Identyfikator użytkownika konta w zarządzanym Sklepie Google Play na urządzeniu, tak jak w przypadku interfejsu Play EMM API. Odpowiada to parametrowi userId w wywołaniu Devices.get interfejsu Play EMM API.
deviceId

string

Wymagane. Stałe. Identyfikator urządzenia, taki jak w interfejsie Play EMM API. Odpowiada to parametrowi deviceId w wywołaniu Devices.get interfejsu Play EMM API.
managementMode

enum (ManagementMode)

Wymagane. Stałe. Tryb zarządzania przenoszonego urządzenia lub profilu.
policy

string

Wymagane. Stałe. Nazwa zasady zastosowanej początkowo do zarejestrowanego urządzenia w formacie enterprises/{enterprise}/policies/{policy}.
additionalData

string

Stałe. Opcjonalne dane dodatkowe określone przez dostawcę usług EMM. Po przeniesieniu urządzenia ta wartość pojawi się w polu migrationAdditionalData zasobu Urządzenie. Może zawierać maksymalnie 1024 znaki.
device

string

Tylko dane wyjściowe. Gdy użyjesz tego tokena migracji do przeniesienia urządzenia, w tym miejscu pojawi się nazwa wynikowego zasobu Device w formacie enterprises/{enterprise}/devices/{device}.

Pole sumy expiration.

expiration może być tylko jedną z tych wartości:
expireTime

string (Timestamp format)

Stałe. Czas wygaśnięcia tego tokena migracji. Może to potrwać do 7 dni od momentu utworzenia. Token migracji jest usuwany 7 dni po wygaśnięciu.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Tylko wejście. Czas ważności tego tokena migracji. Dane są tylko wejściowe. Aby zwrócić token migracji, serwer wypełnia pole expireTime. Może to być maksymalnie 7 dni. Wartość domyślna to 7 dni.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

ManagementMode

Tryb zarządzania przenoszonego urządzenia lub profilu.

Wartości w polu enum
MANAGEMENT_MODE_UNSPECIFIED Tej wartości nie można używać.
WORK_PROFILE_PERSONALLY_OWNED Profil służbowy na urządzeniu należącym do Ciebie. Obsługiwane tylko na urządzeniach z Androidem 9 lub nowszym.
WORK_PROFILE_COMPANY_OWNED profilu służbowego na urządzeniu należącym do firmy, Obsługiwane tylko na urządzeniach z Androidem 11 lub nowszym.
FULLY_MANAGED Urządzenie w pełni zarządzane. Obsługiwane tylko na urządzeniach z Androidem 9 lub nowszym.

Metody

create

 Tworzy token migracji, aby przeprowadzić migrację istniejącego urządzenia z zarządzanego przez kontroler zasad dotyczących urządzeń (DPC) EMM do zarządzania przez interfejs Android Management API.

get

 Pobiera token migracji.

list

 Wyświetla listę tokenów migracji.