DpcMigrationClient

Kotlin |Java

interface DpcMigrationClient

---

Klient wysyłający żądania związane z migracją DPC.

Podsumowanie

Funkcje publiczne
ListenableFuture<DpcMigrationAttempt?>	getMigrationAttempt(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Pobiera próbę migracji.
suspend DpcMigrationAttempt?	getMigrationAttemptAwait(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Pobiera próbę migracji.
ListenableFuture<List<DpcMigrationAttempt>>	listMigrationAttempts() Zwraca listę wszystkich prób migracji.
suspend List<DpcMigrationAttempt>	listMigrationAttemptsAwait() Zwraca listę wszystkich prób migracji.
ListenableFuture<DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Przenieś to urządzenie, aby było zarządzane w interfejsie Android Management API.
suspend DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Przenieś to urządzenie, aby było zarządzane w interfejsie Android Management API.

Funkcje publiczne

getMigrationAttempt

fun getMigrationAttempt(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): ListenableFuture<DpcMigrationAttempt?>

Pobiera próbę migracji.

Jeśli w polu GetDpcMigrationAttemptRequest nie podasz nazwy, zwracana jest ostatnia wartość w kolumnie DpcMigrationAttempt.

Tę metodę może wywoływać tylko właściciel urządzenia lub właściciela profilu albo poprzedni właściciel urządzenia lub właściciel profilu, którzy przeszli na interfejs Android Management API.

Akcje powrotne

ListenableFuture<DpcMigrationAttempt?>

Kod ListenableFuture obejmujący wynik. Może to być Powodzenia w przyszłości – DpcMigrationAttempt na wypadek sukcesu. Udane funkcje przyszłego pakowania o wartości null na wypadek, gdyby nie znaleziono elementu DpcMigrationAttempt. Niepowodzenie dodawania kodu SecurityException, jeśli element wywołujący nie jest właścicielem urządzenia ani profilu albo poprzednim właścicielem urządzenia lub profilem, który został przeniesiony do interfejsu Android Management API. Niepowodzenie przyszłego pakowania DpcMigrationException Jeśli wywołanie związane z migracją DPC nie powiodło się. Więcej informacji o błędzie zawiera komunikat i podtyp wyjątku.

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

Pobiera próbę migracji.

Jeśli w polu GetDpcMigrationAttemptRequest nie podasz nazwy, zwracana jest ostatnia wartość w kolumnie DpcMigrationAttempt.

Tę metodę może wywoływać tylko właściciel urządzenia lub właściciela profilu albo poprzedni właściciel urządzenia lub właściciel profilu, którzy przeszli na interfejs Android Management API.

Akcje powrotne
DpcMigrationAttempt?	Żądana wartość DpcMigrationAttempt lub wartość null, jeśli nie można jej znaleźć

Rzuty
java.lang.SecurityException	Jeśli rozmówca nie jest właścicielem urządzenia ani profilu ani poprzednim właścicielem urządzenia lub właścicielem profilu, który przeprowadził migrację do interfejsu Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Nie udało się wywołać wywołania dotyczącego migracji DPC. Więcej informacji o błędzie zawiera komunikat i podtyp wyjątku.

listMigrationAttempts

fun listMigrationAttempts(): ListenableFuture<List<DpcMigrationAttempt>>

Zwraca listę wszystkich prób migracji.

Tę metodę może wywoływać tylko właściciel urządzenia lub właściciela profilu albo poprzedni właściciel urządzenia lub właściciel profilu, którzy przeszli na interfejs Android Management API. Uwaga: starsze próby migracji są automatycznie usuwane i nie są zwracane.

Akcje powrotne

ListenableFuture<List<DpcMigrationAttempt>>

Kod ListenableFuture obejmujący wynik. Może to być Powodzenie w przyszłości z użyciem listy DpcMigrationAttempt na wypadek sukcesu. Niepowodzenie dodawania kodu SecurityException, jeśli element wywołujący nie jest właścicielem urządzenia ani profilu albo poprzednim właścicielem urządzenia lub profilem, który został przeniesiony do interfejsu Android Management API. Niepowodzenie przyszłego pakowania DpcMigrationException Jeśli wywołanie związane z migracją DPC nie powiodło się. Więcej informacji o błędzie zawiera komunikat i podtyp wyjątku.

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

Zwraca listę wszystkich prób migracji.

Tę metodę może wywoływać tylko właściciel urządzenia lub właściciela profilu albo poprzedni właściciel urządzenia lub właściciel profilu, którzy przeszli na interfejs Android Management API. Uwaga: starsze próby migracji są automatycznie usuwane i nie są zwracane.

Akcje powrotne
List<DpcMigrationAttempt>	Lista DpcMigrationAttempt

Rzuty
java.lang.SecurityException	Jeśli rozmówca nie jest właścicielem urządzenia ani profilu ani poprzednim właścicielem urządzenia lub właścicielem profilu, który przeprowadził migrację do interfejsu Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Nie udało się wywołać wywołania dotyczącego migracji DPC. Więcej informacji o błędzie zawiera komunikat i podtyp wyjątku.

migrateDeviceManagementToAndroidManagementApi

fun migrateDeviceManagementToAndroidManagementApi(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): ListenableFuture<DpcMigrationAttempt>

Przenieś to urządzenie, aby było zarządzane w interfejsie Android Management API.

Po zakończeniu migracji aplikacja do połączeń utraci uprawnienia właściciela urządzenia lub właściciela profilu, ponieważ zostaną one przeniesione do Android Device Policy.

Uwaga: tej czynności nie można cofnąć. Zwracana wartość ListenableFuture kończy się, gdy Android Device Policy otrzyma żądanie i przeprowadzi wstępne testy tokena migracji. W przypadku niepowodzenia ListenableFuture opakuje obiekt Exception.

Tę metodę może wywoływać tylko właściciel urządzenia lub profilu. W Androidzie 10 i starszych ta funkcja nie może być wywoływana z urządzenia, które ma jednocześnie właściciela urządzenia i właściciela profilu.

Skonfigurowane sieci Wi-Fi muszą przekazać w DpcMigrationRequest właściciel profilu (z wyjątkiem Androida 12) na urządzeniu należącym do Ciebie, jeśli na nim zostały skonfigurowane jakieś sieci Wi-Fi. Nie mogą być one przekazywane na urządzenie należące do firmy. Te sieci Wi-Fi zostaną usunięte tuż przed migracją zarządzania urządzeniami do Android Device Policy. Jeśli nie uda się usunąć sieci, migracja także się nie uda, a usunięcie sieci nie jest operacją niepodzielną, więc niektóre sieci mogły już zostać usunięte.

Na należących do firmy urządzeniach z profilem służbowym z Androidem 12 wszystkie sieci Wi-Fi skonfigurowane przez wywołującego DPC zostaną usunięte tuż przed przeniesieniem zarządzania urządzeniami do Android Device Policy. Nie zależy to od tego, jakie sieci Wi-Fi są przekazywane w migrationRequest.

Parametry
notificationServiceComponentName: ComponentName	ComponentName usługi przedłużonej o NotificationReceiverService. Musi to być prawidłowy komponent należący do aplikacji wywołującej i wyeksportowany w pliku manifestu. W przeciwnym razie zostanie zgłoszony IllegalArgumentException.
adminComponentName: ComponentName	ComponentName administratora DeviceAdminReceiver wywołującego DPC.
migrationRequest: DpcMigrationRequest	DpcMigrationRequest zawierający token migracji i skonfigurowane sieci Wi-Fi. Te ostatnie są wymagane tylko wtedy, gdy rozmówca jest właścicielem profilu na urządzeniu należącym do Ciebie i skonfigurował jakieś sieci.

Akcje powrotne

ListenableFuture<DpcMigrationAttempt>

Kod ListenableFuture obejmujący wynik. Może to być Powodzenia w przyszłości – DpcMigrationAttempt na wypadek sukcesu. Nie udało się dodać kodu SecurityException w przyszłości, jeśli rozmówca nie jest właścicielem urządzenia ani profilu. Niepowodzenie dodawania atrybutu IllegalArgumentException w przyszłości, jeśli token migracji jest pusty lub notificationServiceComponentName nie odnosi się do prawidłowego komponentu z rozszerzeniem NotificationReceiverService, który jest wyeksportowany w pliku manifestu, albo jeśli adminComponentName nie jest aktywnym administratorem należącym do bieżącego pakietu. Nieudane opakowanie elementu DpcMigrationException w przyszłości, jeśli wywołanie związane z migracją DPC nie powiedzie się. Więcej informacji o błędzie zawiera komunikat i podtyp wyjątku.

migrateDeviceManagementToAndroidManagementApiAwait

suspend fun migrateDeviceManagementToAndroidManagementApiAwait(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): DpcMigrationAttempt

Przenieś to urządzenie, aby było zarządzane w interfejsie Android Management API.

Po zakończeniu migracji aplikacja do połączeń utraci uprawnienia właściciela urządzenia lub właściciela profilu, ponieważ zostaną one przeniesione do Android Device Policy.

Uwaga: tej czynności nie można cofnąć. Ta funkcja wraca, gdy Android Device Policy otrzyma żądanie i przeprowadzi wstępne testy tokena migracji. W przypadku niepowodzenia wysyłany jest Exception.

Tę metodę może wywoływać tylko właściciel urządzenia lub profilu. W Androidzie 10 i starszych ta funkcja nie może być wywoływana z urządzenia, które ma jednocześnie właściciela urządzenia i właściciela profilu.

Skonfigurowane sieci Wi-Fi muszą przekazać w DpcMigrationRequest właściciel profilu (z wyjątkiem Androida 12) na urządzeniu należącym do Ciebie, jeśli na nim zostały skonfigurowane jakieś sieci Wi-Fi. Nie mogą być one przekazywane na urządzenie należące do firmy. Te sieci Wi-Fi zostaną usunięte tuż przed migracją zarządzania urządzeniami do Android Device Policy. Jeśli nie uda się usunąć sieci, migracja także się nie uda, a usunięcie sieci nie jest operacją niepodzielną, więc niektóre sieci mogły już zostać usunięte.

Na należących do firmy urządzeniach z profilem służbowym z Androidem 12 wszystkie sieci Wi-Fi skonfigurowane przez wywołującego DPC zostaną usunięte tuż przed przeniesieniem zarządzania urządzeniami do Android Device Policy. Nie zależy to od tego, jakie sieci Wi-Fi są przekazywane w migrationRequest.

Parametry
notificationServiceComponentName: ComponentName	ComponentName usługi przedłużonej o NotificationReceiverService. Musi to być prawidłowy komponent należący do aplikacji wywołującej i wyeksportowany w pliku manifestu. W przeciwnym razie zostanie zgłoszony IllegalArgumentException.
adminComponentName: ComponentName	ComponentName administratora DeviceAdminReceiver wywołującego DPC.
migrationRequest: DpcMigrationRequest	DpcMigrationRequest zawierający token migracji i skonfigurowane sieci Wi-Fi. Te ostatnie są wymagane tylko wtedy, gdy rozmówca jest właścicielem profilu na urządzeniu należącym do Ciebie i skonfigurował jakieś sieci.

Akcje powrotne
DpcMigrationAttempt	DpcMigrationException z bieżącym stanem migracji w przypadku powodzenia.

Rzuty
java.lang.SecurityException	Jeśli rozmówca nie jest właścicielem urządzenia ani profilu.
java.lang.IllegalArgumentException	Jeśli token migracji jest pusty lub notificationServiceComponentName nie odnosi się do prawidłowego komponentu z rozszerzeniem NotificationReceiverService, który jest eksportowany w pliku manifestu, lub jeśli adminComponentName nie jest aktywnym administratorem należącym do bieżącego pakietu.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Nie udało się wywołać wywołania dotyczącego migracji DPC. Więcej informacji o błędzie zawiera komunikat i podtyp wyjątku.