DpcMigrationClient

public interface DpcMigrationClient

Client für Anfragen im Zusammenhang mit der 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
)

Dieses Gerät zur Verwaltung durch die Android Management API migrieren
abstract @NonNull DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Dieses Gerät zur Verwaltung durch die Android Management API migrieren

Öffentliche Methoden

getMigrationAttempt

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

Ruft einen Migrationsversuch ab.

Wenn im GetDpcMigrationAttemptRequest kein Name angegeben ist, wird die letzte 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.

Ausgabe
@NonNull ListenableFuture<DpcMigrationAttempt>

Ein ListenableFuture, das das Ergebnis umschließt. Das kann

  • Ein erfolgreiches Future-Wrapping für DpcMigrationAttempt im Erfolgsfall.

  • Ein erfolgreiches Future, das null zurückgibt, falls DpcMigrationAttempt nicht gefunden wird.

  • Ein fehlgeschlagenes Future, das SecurityException umschließt, wenn der Aufrufer kein Geräteinhaber oder Profilinhaber ist oder ein ehemaliger Geräteinhaber oder Profilinhaber, der zur Android Management API migriert ist.

  • Eine fehlgeschlagene Future-Umschließung DpcMigrationException, wenn ein DPC-Migrationsaufruf fehlgeschlagen ist. Die Nachricht und der Subtyp der Ausnahme enthalten weitere Details zum Fehler.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Ruft einen Migrationsversuch ab.

Wenn im GetDpcMigrationAttemptRequest kein Name angegeben ist, wird die letzte 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.

Ausgabe
DpcMigrationAttempt

Die angeforderte DpcMigrationAttempt oder „null“, wenn sie nicht gefunden werden kann
Löst
java.lang.SecurityException

Wenn der Aufrufer kein Geräteinhaber, Profilinhaber oder ehemaliger Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert wurde.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Wenn ein Anruf im Zusammenhang mit der DPC-Migration fehlgeschlagen ist. Die Nachricht und der Subtyp 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.

Ausgabe
@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Ein ListenableFuture, das das Ergebnis umschließt. Das kann

  • Ein erfolgreiches Future, das im Erfolgsfall eine Liste von DpcMigrationAttempt umschließt.

  • Ein fehlgeschlagenes Future, das SecurityException umschließt, wenn der Aufrufer kein Geräteinhaber oder Profilinhaber ist oder ein ehemaliger Geräteinhaber oder Profilinhaber, der zur Android Management API migriert ist.

  • Eine fehlgeschlagene Future-Umschließung DpcMigrationException, wenn ein DPC-Migrationsaufruf fehlgeschlagen ist. Die Nachricht und der Subtyp 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.

Ausgabe
@NonNull List<@NonNull DpcMigrationAttempt>

Eine Liste mit DpcMigrationAttempt
Löst
java.lang.SecurityException

Wenn der Aufrufer kein Geräteinhaber, Profilinhaber oder ehemaliger Geräteinhaber oder Profilinhaber ist, der zur Android Management API migriert wurde.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Wenn ein Anruf im Zusammenhang mit der DPC-Migration fehlgeschlagen ist. Die Nachricht und der Subtyp der Ausnahme enthalten weitere Details zum Fehler.

migrateDeviceManagementToAndroidManagementApi

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

Dieses Gerät zur Verwaltung durch die Android Management API migrieren

Nach Abschluss der Migration verliert die Anruf-App ihre Berechtigungen als Geräteinhaber oder Profilinhaber, da diese auf Android Device Policy übertragen werden.

Achtung: Dieser Vorgang kann nicht rückgängig gemacht werden. Das zurückgegebene ListenableFuture wird abgeschlossen, wenn Android Device Policy die Anfrage erhalten und vorläufige Prüfungen des Migrationstokens abgeschlossen hat. Im Fehlerfall umschließt das ListenableFuture ein Exception.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber aufgerufen werden. Unter Android 10 und niedriger darf diese Funktion nicht auf einem Gerät mit sowohl einem Geräteeigentümer als auch einem Profilinhaber aufgerufen werden.

Konfigurierte WLANs müssen vom Profilinhaber (außer unter Android 12) auf einem privaten Gerät, auf dem WLANs konfiguriert sind, in DpcMigrationRequest übergeben werden. Diese dürfen nicht auf einem unternehmenseigenen Gerät übergeben werden. Diese WLANs werden kurz vor der Migration der Geräteverwaltung zur 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 bereits einige Netzwerke entfernt.

Auf privaten Geräten mit Arbeitsprofil unter Android 12 werden alle vom aufrufenden DPC konfigurierten WLANs kurz vor der Migration der Geräteverwaltung zu Android Device Policy entfernt, unabhängig von den in migrationRequest übergebenen WLANs.

Parameter
@NonNull ComponentName notificationServiceComponentName

Die ComponentName des Dienstes, der NotificationReceiverService erweitert. Es muss sich um eine gültige Komponente der aufrufenden App handeln, die im Manifest exportiert wird. Andernfalls wird eine IllegalArgumentException ausgelöst.
@NonNull ComponentName adminComponentName

Die ComponentName des Administrators DeviceAdminReceiver des aufrufenden Geräteinhabers.
@NonNull DpcMigrationRequest migrationRequest

Das DpcMigrationRequest mit dem Migrationstoken und den konfigurierten WLANs. Letztere sind nur erforderlich, wenn der Anrufer der Profilinhaber auf einem privaten Gerät ist und Netzwerke konfiguriert hat.
Ausgabe
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Ein ListenableFuture, das das Ergebnis umschließt. Das kann

migrateDeviceManagementToAndroidManagementApiAwait

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

Dieses Gerät zur Verwaltung durch die Android Management API migrieren

Nach Abschluss der Migration verliert die Anruf-App ihre Berechtigungen als Geräteinhaber oder Profilinhaber, da diese auf Android Device Policy übertragen werden.

Achtung: Dieser Vorgang kann nicht rückgängig gemacht werden. Diese Funktion wird zurückgegeben, wenn Android Device Policy die Anfrage erhalten und vorläufige Prüfungen des Migrationstokens abgeschlossen hat. Im Fehlerfall wird eine Exception ausgelöst.

Diese Methode kann nur von einem Geräteinhaber oder Profilinhaber aufgerufen werden. Unter Android 10 und niedriger darf diese Funktion nicht auf einem Gerät mit sowohl einem Geräteeigentümer als auch einem Profilinhaber aufgerufen werden.

Konfigurierte WLANs müssen vom Profilinhaber (außer unter Android 12) auf einem privaten Gerät, auf dem WLANs konfiguriert sind, in DpcMigrationRequest übergeben werden. Diese dürfen nicht auf einem unternehmenseigenen Gerät übergeben werden. Diese WLANs werden kurz vor der Migration der Geräteverwaltung zur 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 bereits einige Netzwerke entfernt.

Auf privaten Geräten mit Arbeitsprofil unter Android 12 werden alle vom aufrufenden DPC konfigurierten WLANs kurz vor der Migration der Geräteverwaltung zu Android Device Policy entfernt, unabhängig von den in migrationRequest übergebenen WLANs.

Parameter
@NonNull ComponentName notificationServiceComponentName

Die ComponentName des Dienstes, der NotificationReceiverService erweitert. Es muss sich um eine gültige Komponente der aufrufenden App handeln, die im Manifest exportiert wird. Andernfalls wird eine IllegalArgumentException ausgelöst.
@NonNull ComponentName adminComponentName

Die ComponentName des Administrators DeviceAdminReceiver des aufrufenden Geräteinhabers.
@NonNull DpcMigrationRequest migrationRequest

Das DpcMigrationRequest mit dem Migrationstoken und den konfigurierten WLANs. Letztere sind nur erforderlich, wenn der Anrufer der Profilinhaber auf einem privaten Gerät ist und Netzwerke konfiguriert hat.
Ausgabe
@NonNull DpcMigrationAttempt

DpcMigrationException mit dem aktuellen Status der Migration im Erfolgsfall.
Löst
java.lang.SecurityException

Wenn der Aufrufer kein Geräteinhaber oder Profilinhaber ist.
kotlin.IllegalArgumentException

Wenn das Migrationstoken leer ist oder notificationServiceComponentName nicht auf eine gültige Komponente verweist, die NotificationReceiverService erweitert und im Manifest exportiert wird, oder wenn adminComponentName kein aktiver Administrator des aktuellen Pakets ist.
com.google.android.managementapi.dpcmigration.DpcMigrationException

Wenn ein Anruf im Zusammenhang mit der DPC-Migration fehlgeschlagen ist. Die Nachricht und der Subtyp der Ausnahme enthalten weitere Details zum Fehler.