REST Resource: enterprises.migrationTokens

Zasób: MigrationToken

Token do inicjowania migracji urządzenia z poziomu zarządzania przez zewnętrzny kontroler zasad dotyczących urządzeń (DPC) do zarządzania przez interfejs Android Management API. Token migracji jest ważny tylko na 1 urządzenie. 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óry jest generowany przez serwer podczas tworzenia, w formie 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.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
userId

string

Wymagany. Niezmienna. Identyfikator użytkownika konta zarządzanego Sklepu Google Play na urządzeniu, jak w interfejsie API EMM w Google Play. Odpowiada on parametrowi userId w wywołaniu interfejsu Play EMM API Devices.get.
deviceId

string

Wymagany. Niezmienna. Identyfikator urządzenia, taki jak w interfejsie Play EMM API. Odpowiada on parametrowi deviceId w wywołaniu interfejsu Play EMM API Devices.get.
managementMode

enum (ManagementMode)

Wymagany. Niezmienna. Tryb zarządzania urządzeniem lub profilem, który jest przenoszony.
policy

string

Wymagany. Niezmienna. Nazwa zasady początkowo zastosowana do zarejestrowanego urządzenia w formie enterprises/{enterprise}/policies/{policy}.
additionalData

string

Niezmienna. Opcjonalne dane dodatkowe określone przez EMM. Po przeniesieniu urządzenia te informacje zostaną wypełnione w polu migrationAdditionalData zasobu urządzenia. Możesz użyć maksymalnie 1024 znaków.
device

string

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

Pole unii expiration.

expiration może być tylko jednym z tych elementów:
expireTime

string (Timestamp format)

Niezmienna. Czas, w którym wygasa ten token migracji. Może to być maksymalnie 7 dni od momentu utworzenia. Token migracji zostanie usunięty 7 dni po wygaśnięciu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
ttl

string (Duration format)

Tylko dane wejściowe. Czas, przez jaki token migracji jest ważny. Jest to pole tylko do wprowadzania danych, a w przypadku zwracania tokena migracji serwer wypełni pole expireTime. Może to potrwać do 7 dni. Domyślnie jest to 7 dni.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

ManagementMode

Tryb zarządzania urządzeniem lub profilem, który jest przenoszony.

Wartości w polu enum
MANAGEMENT_MODE_UNSPECIFIED Nie należy używać tej wartości.
WORK_PROFILE_PERSONALLY_OWNED Profil służbowy na urządzeniu należącym do użytkownika. Obsługiwane tylko na urządzeniach z Androidem 9 lub nowszym.
WORK_PROFILE_COMPANY_OWNED Profil służbowy 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) usługi EMM do zarządzania przez interfejs Android Management API.

get

 Pobiera token migracji.

list

 Wyświetla tokeny migracji.