DpcMigrationClient

Kotlin |Java

interface DpcMigrationClient

---

Client zum Senden von Anfragen zur dpc-Migration.

Zusammenfassung

Öffentliche Funktionen
ListenableFuture<DpcMigrationAttempt?>	getMigrationAttempt(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Ruft einen Migrationsversuch ab.
suspend DpcMigrationAttempt?	getMigrationAttemptAwait(     getMigrationAttemptRequest: GetDpcMigrationAttemptRequest ) Ruft einen Migrationsversuch ab.
ListenableFuture<List<DpcMigrationAttempt>>	listMigrationAttempts() Gibt eine Liste aller Migrationsversuche zurück.
suspend List<DpcMigrationAttempt>	listMigrationAttemptsAwait() Gibt eine Liste aller Migrationsversuche zurück.
ListenableFuture<DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Migrieren Sie dieses Gerät, damit es von der Android Management API verwaltet wird.
suspend DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     notificationServiceComponentName: ComponentName,     adminComponentName: ComponentName,     migrationRequest: DpcMigrationRequest ) Migrieren Sie dieses Gerät, damit es von der Android Management API verwaltet wird.

Öffentliche Funktionen

getMigrationAttempt

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

Ruft einen Migrationsversuch ab.

Wenn in GetDpcMigrationAttemptRequest kein Name angegeben ist, wird der neueste DpcMigrationAttempt zurückgegeben.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder einem früheren Geräteinhaber oder Profilinhaber aufgerufen werden, der zur Android Management API migriert ist.

Gibt Folgendes zurück:

ListenableFuture<DpcMigrationAttempt?>

Ein ListenableFuture, der das Ergebnis umschließt. Dabei kann es sich um Eine erfolgreiche Zukunft, die im Erfolgsfall einen DpcMigrationAttempt umschließt. Ein erfolgreicher zukünftiger Null-Wrapping-Vorgang für den Fall, dass DpcMigrationAttempt nicht gefunden wird. Ein fehlgeschlagener zukünftiger Zusammenschluss eines SecurityException, für den Fall, dass der Aufrufer kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert wurde. Zukünftiges Wrapping fehlgeschlagen DpcMigrationException, wenn der Aufruf der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

Ruft einen Migrationsversuch ab.

Wenn in GetDpcMigrationAttemptRequest kein Name angegeben ist, wird der neueste DpcMigrationAttempt zurückgegeben.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder einem früheren Geräteinhaber oder Profilinhaber aufgerufen werden, der zur Android Management API migriert ist.

Gibt Folgendes zurück:
DpcMigrationAttempt?	Der angeforderte DpcMigrationAttempt oder null, wenn er nicht gefunden werden kann

Löst aus
java.lang.SecurityException	Wenn der Aufrufer kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert ist.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Wenn der Aufruf der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

listMigrationAttempts

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

Gibt eine Liste aller Migrationsversuche zurück.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder einem früheren Geräteinhaber oder Profilinhaber aufgerufen werden, der zur Android Management API migriert ist. Hinweis: Ältere Migrationsversuche werden automatisch gelöscht und nicht zurückgegeben.

Gibt Folgendes zurück:

ListenableFuture<List<DpcMigrationAttempt>>

Ein ListenableFuture, der das Ergebnis umschließt. Dabei kann es sich um Eine erfolgreiche Zukunft, die im Erfolgsfall eine Liste von DpcMigrationAttempt umfasst. Ein fehlgeschlagener zukünftiger Zusammenschluss eines SecurityException, für den Fall, dass der Aufrufer kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert wurde. Zukünftiges Wrapping fehlgeschlagen DpcMigrationException, wenn der Aufruf der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

Gibt eine Liste aller Migrationsversuche zurück.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber oder einem früheren Geräteinhaber oder Profilinhaber aufgerufen werden, der zur Android Management API migriert ist. Hinweis: Ältere Migrationsversuche werden automatisch gelöscht und nicht zurückgegeben.

Gibt Folgendes zurück:
List<DpcMigrationAttempt>	Eine Liste mit DpcMigrationAttempt

Löst aus
java.lang.SecurityException	Wenn der Aufrufer kein Geräteinhaber oder Profilinhaber oder ein früherer Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert ist.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Wenn der Aufruf der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

migrateDeviceManagementToAndroidManagementApi

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

Migrieren Sie dieses Gerät, damit es von der Android Management API verwaltet wird.

Nach Abschluss der Migration verliert die aufrufende App die Berechtigungen „Geräteinhaber“ oder „Profilinhaber“, da diese auf die Android Device Policy übertragen werden.

Warnung: Dieser Vorgang kann nicht rückgängig gemacht werden. Das zurückgegebene ListenableFuture wird abgeschlossen, wenn Android Device Policy die Anfrage erhalten und die vorläufigen Prüfungen des Migrationstokens abgeschlossen hat. Im Falle eines Fehlers wird ein Exception von ListenableFuture umschlossen.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber aufgerufen werden. Unter Android 10 und niedriger darf dies nicht auf einem Gerät mit einem Geräteinhaber und einem Profilinhaber gleichzeitig aufgerufen werden.

Konfigurierte WLANs müssen vom Profilinhaber (außer unter Android 12) in DpcMigrationRequest auf einem privaten Gerät übergeben werden, auf dem WLANs konfiguriert sind. Sie dürfen nicht auf einem unternehmenseigenen Gerät weitergegeben werden. Hinweis: Diese WLANs werden kurz vor der Migration der Geräteverwaltung zu Android Device Policy entfernt. Wenn ein Netzwerk nicht entfernt werden kann, schlägt auch die Migration fehl. Da das Entfernen der Netzwerke kein atomarer Vorgang ist, wurden möglicherweise einige Netzwerke bereits entfernt.

Auf privaten Geräten mit einem Arbeitsprofil mit Android 12 werden alle vom aufrufenden DPC konfigurierten WLANs entfernt, kurz bevor die Geräteverwaltung zu Android Device Policy migriert wird – unabhängig von den in migrationRequest übergebenen WLANs.

Parameter
notificationServiceComponentName: ComponentName	Die ComponentName des Dienstes, der NotificationReceiverService erweitert. Sie muss eine gültige Komponente sein, die zur aufrufenden App gehört und in das Manifest exportiert wurde. Andernfalls wird ein IllegalArgumentException ausgelöst.
adminComponentName: ComponentName	Die ComponentName des Administrators (DeviceAdminReceiver) des aufrufenden DPC.
migrationRequest: DpcMigrationRequest	Die DpcMigrationRequest mit dem Migrationstoken und den konfigurierten WLANs. Letztere sind nur erforderlich, wenn der Aufrufer der Profilinhaber auf einem privaten Gerät ist und Netzwerke konfiguriert hat.

Gibt Folgendes zurück:

ListenableFuture<DpcMigrationAttempt>

Ein ListenableFuture, der das Ergebnis umschließt. Dabei kann es sich um Eine erfolgreiche Zukunft, die im Erfolgsfall einen DpcMigrationAttempt umschließt. Ein fehlgeschlagener zukünftiger Zusammenschluss eines SecurityException, wenn der Aufrufer kein Geräteinhaber oder Profilinhaber ist. Ein Fehler beim zukünftigen Wrapping eines IllegalArgumentException, wenn das Migrationstoken leer ist oder wenn notificationServiceComponentName keine gültige Komponente zur Erweiterung von NotificationReceiverService angibt, die im Manifest exportiert wird, oder wenn adminComponentName kein aktiver Administrator ist, der zum aktuellen Paket gehört. Ein zukünftiger Wrapping von DpcMigrationException ist fehlgeschlagen, wenn ein Aufruf der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.

migrateDeviceManagementToAndroidManagementApiAwait

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

Migrieren Sie dieses Gerät, damit es von der Android Management API verwaltet wird.

Nach Abschluss der Migration verliert die aufrufende App die Berechtigungen „Geräteinhaber“ oder „Profilinhaber“, da diese auf die Android Device Policy übertragen werden.

Warnung: Dieser Vorgang kann nicht rückgängig gemacht werden. Dieser Vorgang wird zurückgegeben, wenn Android Device Policy die Anfrage erhalten und die vorläufigen Prüfungen des Migrationstokens abgeschlossen hat. Im Falle eines Fehlers wird ein Exception ausgelöst.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber aufgerufen werden. Unter Android 10 und niedriger darf dies nicht auf einem Gerät mit einem Geräteinhaber und einem Profilinhaber gleichzeitig aufgerufen werden.

Konfigurierte WLANs müssen vom Profilinhaber (außer unter Android 12) in DpcMigrationRequest auf einem privaten Gerät übergeben werden, auf dem WLANs konfiguriert sind. Sie dürfen nicht auf einem unternehmenseigenen Gerät weitergegeben werden. Hinweis: Diese WLANs werden kurz vor der Migration der Geräteverwaltung zu Android Device Policy entfernt. Wenn ein Netzwerk nicht entfernt werden kann, schlägt auch die Migration fehl. Da das Entfernen der Netzwerke kein atomarer Vorgang ist, wurden möglicherweise einige Netzwerke bereits entfernt.

Auf privaten Geräten mit einem Arbeitsprofil mit Android 12 werden alle vom aufrufenden DPC konfigurierten WLANs entfernt, kurz bevor die Geräteverwaltung zu Android Device Policy migriert wird – unabhängig von den in migrationRequest übergebenen WLANs.

Parameter
notificationServiceComponentName: ComponentName	Die ComponentName des Dienstes, der NotificationReceiverService erweitert. Sie muss eine gültige Komponente sein, die zur aufrufenden App gehört und in das Manifest exportiert wurde. Andernfalls wird ein IllegalArgumentException ausgelöst.
adminComponentName: ComponentName	Die ComponentName des Administrators (DeviceAdminReceiver) des aufrufenden DPC.
migrationRequest: DpcMigrationRequest	Die DpcMigrationRequest mit dem Migrationstoken und den konfigurierten WLANs. Letztere sind nur erforderlich, wenn der Aufrufer der Profilinhaber auf einem privaten Gerät ist und Netzwerke konfiguriert hat.

Gibt Folgendes zurück:
DpcMigrationAttempt	DpcMigrationException durch den aktuellen Status der Migration im Erfolgsfall.

Löst aus
java.lang.SecurityException	Wenn der Aufrufer kein Geräteinhaber oder Profilinhaber ist.
java.lang.IllegalArgumentException	Wenn das Migrationstoken leer ist oder notificationServiceComponentName keine gültige Komponente zur Erweiterung von NotificationReceiverService angibt, die im Manifest exportiert wird, oder wenn adminComponentName kein aktiver Administrator ist, der zum aktuellen Paket gehört.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Wenn der Aufruf der dpc-Migration fehlgeschlagen ist. Die Nachricht und der Untertyp der Ausnahme enthalten weitere Details zum Fehler.