DpcMigrationClient

public interface DpcMigrationClient

Client zum Senden von Anfragen zur dpc-Migration.

Zusammenfassung

Öffentliche Methoden
abstract @NonNull ListenableFuture<DpcMigrationAttempt>
getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Ruft einen Migrationsversuch ab.
abstract DpcMigrationAttempt
getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Ruft einen Migrationsversuch ab.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Gibt eine Liste aller Migrationsversuche zurück.
abstract @NonNull List<@NonNull DpcMigrationAttempt>

Gibt eine Liste aller Migrationsversuche zurück.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>
migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Migrieren Sie dieses Gerät, damit es von der Android Management API verwaltet wird.
abstract @NonNull DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

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

Öffentliche Methoden

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

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:
@NonNull 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

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

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

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

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:
@NonNull ListenableFuture<@NonNull List<@NonNull 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

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

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:
@NonNull List<@NonNull 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

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

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
@NonNull ComponentName notificationServiceComponentName

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.
@NonNull ComponentName adminComponentName

Die ComponentName des Administrators (DeviceAdminReceiver) des aufrufenden DPC.
@NonNull DpcMigrationRequest migrationRequest

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:
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Ein ListenableFuture, der das Ergebnis umschließt. Dabei kann es sich um

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

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
@NonNull ComponentName notificationServiceComponentName

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.
@NonNull ComponentName adminComponentName

Die ComponentName des Administrators (DeviceAdminReceiver) des aufrufenden DPC.
@NonNull DpcMigrationRequest migrationRequest

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:
@NonNull 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.