REST Resource: enterprises.migrationTokens

Zasób: MigrationToken

Token, który umożliwia rozpoczęcie migracji urządzenia z zewnętrznej firmy DPC do zarządzania nim przez 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, ma format 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 RFC3339 UTC „Zulu” 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ły. Identyfikator użytkownika zarządzanego konta Google Play na urządzeniu, np. interfejsu Play EMM API. Odpowiada to parametrowi userId w wywołaniu Devices.get interfejsu Play EMM API.
deviceId

string

Wymagane. Stały. Identyfikator urządzenia (na przykład w interfejsie Play EMM API). Odpowiada to parametrowi deviceId w wywołaniu Devices.get interfejsu Play EMM API.
managementMode

enum (ManagementMode)

Wymagane. Stały. Tryb zarządzania przenoszonym urządzeniem lub profilem.
policy

string

Wymagane. Stały. Nazwa zasady, która została początkowo zastosowana do zarejestrowanego urządzenia, ma postać enterprises/{enterprise}/policies/{policy}.
additionalData

string

Stały. Opcjonalne dane dodatkowe określone przez EMM. Po przeniesieniu urządzenia ta informacja zostanie uzupełniona w polu migrationAdditionalData zasobu urządzenia. Może zawierać maksymalnie 1024 znaki.
device

string

Tylko dane wyjściowe. Gdy ten token migracji zostanie użyty do przeniesienia urządzenia, nazwa powstałego zasobu Device zostanie uzupełniona tutaj w formacie enterprises/{enterprise}/devices/{device}.

Pole sumy expiration.

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

string (Timestamp format)

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

Sygnatura czasowa w RFC3339 UTC „Zulu” 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 dane wejściowe. Czas, przez jaki ten token migracji jest ważny. Można ich używać tylko do wprowadzania danych. W przypadku zwrócenia tokena migracji serwer wypełnia pole expireTime. Może to wynosić maksymalnie 7 dni. Wartość domyślna to 7 dni.

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

ManagementMode

Tryb zarządzania przenoszonym urządzeniem lub profilem.

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 osobistym urządzeniu. 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 przenieść istniejące urządzenie z kontrolera zasad dotyczących urządzeń (DPC) dostawcy usług EMM na zarządzane przez interfejs Android Management API.

get

 Pobiera token migracji.

list

 Wyświetla listę tokenów migracji.