DpcMigrationClient

Котлин | Джава

public interface DpcMigrationClient

---

Клиент для выполнения запросов, связанных с миграцией ЦОД.

Краткое содержание

Публичные методы
abstract @ NonNull ListenableFuture < DpcMigrationAttempt >	getMigrationAttempt ( @ NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Получает попытку миграции.
abstract DpcMigrationAttempt	getMigrationAttemptAwait ( @ NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Получает попытку миграции.
abstract @ NonNull ListenableFuture <@ NonNull List <@ NonNull DpcMigrationAttempt >>	listMigrationAttempts () Возвращает список всех попыток миграции.
abstract @ NonNull List <@ NonNull DpcMigrationAttempt >	listMigrationAttemptsAwait () Возвращает список всех попыток миграции.
abstract @ NonNull ListenableFuture <@ NonNull DpcMigrationAttempt >	migrateDeviceManagementToAndroidManagementApi ( @ NonNull ComponentName notificationServiceComponentName, @ NonNull ComponentName adminComponentName, @ NonNull DpcMigrationRequest migrationRequest ) Перенесите это устройство под управление с помощью Android Management API.
abstract @ NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait ( @ NonNull ComponentName notificationServiceComponentName, @ NonNull ComponentName adminComponentName, @ NonNull DpcMigrationRequest migrationRequest ) Перенесите это устройство под управление с помощью Android Management API.

Публичные методы

GetMigrationAttempt

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

Получает попытку миграции.

Если в GetDpcMigrationAttemptRequest не указано имя, возвращается самый последний DpcMigrationAttempt .

Этот метод может вызвать только владелец устройства или владелец профиля, а также предыдущий владелец устройства или владелец профиля, который перешел на Android Management API.

Возврат

@ NonNull ListenableFuture < DpcMigrationAttempt >

ListenableFuture , обертывающий результат. Это может быть Успешное будущее с оберткой DpcMigrationAttempt в случае успеха. Успешная будущая нулевая упаковка, если DpcMigrationAttempt не найден. Неудачная будущая упаковка SecurityException , если вызывающий абонент не является владельцем устройства или владельцем профиля или предыдущим владельцем устройства или владельцем профиля, который перешел на Android Management API. Неудачная будущая упаковка DpcMigrationException Если вызов, связанный с миграцией dpc, не удался. Сообщение и подтип исключения содержат более подробную информацию об ошибке.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Получает попытку миграции.

Если в GetDpcMigrationAttemptRequest не указано имя, возвращается самый последний DpcMigrationAttempt .

Этот метод может вызвать только владелец устройства или владелец профиля, а также предыдущий владелец устройства или владелец профиля, который перешел на Android Management API.

Возврат
DpcMigrationAttempt	Запрошенный DpcMigrationAttempt или значение NULL, если его невозможно найти.

Броски
java.lang.SecurityException	Если вызывающий абонент не является владельцем устройства или владельцем профиля, а также предыдущим владельцем устройства или владельцем профиля, который перешел на Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Если вызов, связанный с миграцией dpc, не удался. Сообщение и подтип исключения содержат более подробную информацию об ошибке.

списокПопытки миграции

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

Возвращает список всех попыток миграции.

Этот метод может вызвать только владелец устройства или владелец профиля, а также предыдущий владелец устройства или владелец профиля, который перешел на Android Management API. Примечание. Более старые попытки миграции автоматически удаляются и не возвращаются.

Возврат

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

ListenableFuture , обертывающий результат. Это может быть Успешное будущее, оборачивающее список DpcMigrationAttempt в случае успеха. Неудачная будущая упаковка SecurityException , если вызывающий абонент не является владельцем устройства или владельцем профиля или предыдущим владельцем устройства или владельцем профиля, который перешел на Android Management API. Неудачная будущая упаковка DpcMigrationException Если вызов, связанный с миграцией dpc, не удался. Сообщение и подтип исключения содержат более подробную информацию об ошибке.

listMigrationAwait

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

Возвращает список всех попыток миграции.

Этот метод может вызвать только владелец устройства или владелец профиля, а также предыдущий владелец устройства или владелец профиля, который перешел на Android Management API. Примечание. Более старые попытки миграции автоматически удаляются и не возвращаются.

Возврат
@ NonNull List <@ NonNull DpcMigrationAttempt >	Список DpcMigrationAttempt

Броски
java.lang.SecurityException	Если вызывающий абонент не является владельцем устройства или владельцем профиля, а также предыдущим владельцем устройства или владельцем профиля, который перешел на Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Если вызов, связанный с миграцией dpc, не удался. Сообщение и подтип исключения содержат более подробную информацию об ошибке.

МигрироватьDeviceManagementToAndroidManagementApi

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

Перенесите это устройство под управление с помощью Android Management API.

После завершения миграции вызывающее приложение теряет свои права владельца устройства или владельца профиля, поскольку они передаются в политику устройств Android.

Внимание: это действие нельзя отменить! Возвращенное ListenableFuture завершается, когда Android Device Policy получает запрос и завершает предварительную проверку токена миграции. В случае сбоя ListenableFuture обернет Exception .

Этот метод может вызвать только владелец устройства или владелец профиля. В Android 10 и более ранних версиях эту функцию нельзя вызывать на устройстве, у которого есть одновременно владелец устройства и владелец профиля.

Настроенные сети Wi-Fi должны быть переданы в DpcMigrationRequest владельцем профиля (за исключением Android 12) на личном устройстве, если оно настроило какие-либо сети Wi-Fi. Их нельзя передавать на корпоративное устройство. Обратите внимание, что эти сети Wi-Fi будут удалены непосредственно перед переносом управления устройствами в политику устройств Android. В случае неудачи при удалении сети миграция также завершится неудачей, а поскольку удаление сетей не является атомарной операцией, некоторые сети могли быть уже удалены.

На личных устройствах с рабочим профилем под управлением Android 12 все сети Wi-Fi, настроенные вызывающим центром обработки данных, будут удалены непосредственно перед переносом управления устройством в политику устройств Android, независимо от сетей Wi-Fi, переданных migrationRequest .

Параметры
@ NonNull ComponentName notificationServiceComponentName	ComponentName службы, расширяющей NotificationReceiverService . Это должен быть действительный компонент, принадлежащий вызывающему приложению и экспортированный в манифест, в противном случае будет выдано исключение IllegalArgumentException .
@ NonNull ComponentName adminComponentName	ComponentName администратора DeviceAdminReceiver вызывающего центра обработки данных.
@ NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest , содержащий токен миграции и настроенные сети Wi-Fi. Последние требуются только в том случае, если вызывающий абонент является владельцем профиля на личном устройстве и настроил какие-либо сети.

Возврат

@ NonNull ListenableFuture <@ NonNull DpcMigrationAttempt >

ListenableFuture , обертывающий результат. Это может быть Успешное будущее с оберткой DpcMigrationAttempt в случае успеха. Неудачная будущая упаковка SecurityException , если вызывающий абонент не является владельцем устройства или владельцем профиля. Неудачная будущая упаковка IllegalArgumentException , если токен миграции пуст, или notificationServiceComponentName не ссылается на допустимый компонент, расширяющий NotificationReceiverService , который экспортируется в манифест, или если adminComponentName не является активным администратором, принадлежащим текущему пакету. Неудачная будущая оболочка DpcMigrationException , если вызов, связанный с миграцией dpc, завершился неудачно. Сообщение и подтип исключения содержат более подробную информацию об ошибке.

МигрироватьDeviceManagementToAndroidManagementApiAwait

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

Перенесите это устройство под управление с помощью Android Management API.

После завершения миграции вызывающее приложение теряет свои права владельца устройства или владельца профиля, поскольку они передаются в политику устройств Android.

Внимание: это действие нельзя отменить! Функция приостановки возвращается, когда Android Device Policy получает запрос и завершает предварительную проверку токена миграции. В случае неудачи выдается Exception .

Этот метод может вызвать только владелец устройства или владелец профиля. В Android 10 и более ранних версиях эту функцию нельзя вызывать на устройстве, у которого есть одновременно владелец устройства и владелец профиля.

Настроенные сети Wi-Fi должны быть переданы в DpcMigrationRequest владельцем профиля (за исключением Android 12) на личном устройстве, если оно настроило какие-либо сети Wi-Fi. Их нельзя передавать на корпоративное устройство. Обратите внимание, что эти сети Wi-Fi будут удалены непосредственно перед переносом управления устройствами в политику устройств Android. В случае неудачи при удалении сети миграция также завершится неудачей, а поскольку удаление сетей не является атомарной операцией, некоторые сети могли быть уже удалены.

На личных устройствах с рабочим профилем под управлением Android 12 все сети Wi-Fi, настроенные вызывающим центром обработки данных, будут удалены непосредственно перед переносом управления устройством в политику устройств Android, независимо от сетей Wi-Fi, переданных migrationRequest .

Параметры
@ NonNull ComponentName notificationServiceComponentName	ComponentName службы, расширяющей NotificationReceiverService . Это должен быть действительный компонент, принадлежащий вызывающему приложению и экспортированный в манифест, в противном случае будет выдано исключение IllegalArgumentException .
@ NonNull ComponentName adminComponentName	ComponentName администратора DeviceAdminReceiver вызывающего центра обработки данных.
@ NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest , содержащий токен миграции и настроенные сети Wi-Fi. Последние требуются только в том случае, если вызывающий абонент является владельцем профиля на личном устройстве и настроил какие-либо сети.

Возврат
@ NonNull DpcMigrationAttempt	DpcMigrationException с текущим статусом миграции в случае успеха.

Броски
java.lang.SecurityException	Если вызывающий абонент не является владельцем устройства или владельцем профиля.
java.lang.IllegalArgumentException	Если токен миграции пуст, или notificationServiceComponentName не ссылается на допустимый компонент, расширяющий NotificationReceiverService , который экспортируется в манифест, или если adminComponentName не является активным администратором, принадлежащим текущему пакету.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Если вызов, связанный с миграцией dpc, не удался. Сообщение и подтип исключения содержат более подробную информацию об ошибке.