DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

El cliente realiza solicitudes relacionadas con la migración de dpc.

Resumen

Métodos públicos
abstract @NonNull ListenableFuture<DpcMigrationAttempt>	getMigrationAttempt(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Obtiene un intento de migración.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Obtiene un intento de migración.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>	listMigrationAttempts() Muestra una lista de todos los intentos de migración.
abstract @NonNull List<@NonNull DpcMigrationAttempt>	listMigrationAttemptsAwait() Muestra una lista de todos los intentos de migración.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Migra este dispositivo a que lo administre la API de Android Management.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Migra este dispositivo a que lo administre la API de Android Management.

Métodos públicos

getMigrationAttempt

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

Obtiene un intento de migración.

Si no se especifica ningún nombre en GetDpcMigrationAttemptRequest, se mostrará el DpcMigrationAttempt más reciente.

Solo el propietario del dispositivo o del perfil, o el propietario del dispositivo o el propietario del perfil anterior que hayan migrado a la API de Android Management

Devuelve

@NonNull ListenableFuture<DpcMigrationAttempt>

Es un elemento ListenableFuture que une el resultado. Puede Un futuro exitoso que une un DpcMigrationAttempt, en caso de éxito. Un futuro de unión exitoso, en caso de que no se encuentre DpcMigrationAttempt Un futuro con un error uniendo un SecurityException, en caso de que el llamador no sea un propietario del dispositivo o del perfil, o un propietario del dispositivo o propietario del perfil anterior que migró a la API de Android Management Falló una unión futura DpcMigrationException Si falló la llamada relacionada con la migración de dpc. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Obtiene un intento de migración.

Si no se especifica ningún nombre en GetDpcMigrationAttemptRequest, se mostrará el DpcMigrationAttempt más reciente.

Solo el propietario del dispositivo o del perfil, o el propietario del dispositivo o el propietario del perfil anterior que hayan migrado a la API de Android Management

Devuelve
DpcMigrationAttempt	El DpcMigrationAttempt solicitado o nulo, si no se puede encontrar

Arroja
java.lang.SecurityException	Si el emisor no es un propietario del dispositivo o del perfil, ni un propietario del dispositivo o propietario del perfil anterior que migró a la API de Android Management
com.google.android.managementapi.dpcmigration.DpcMigrationException	Si falló la llamada relacionada con la migración de dpc. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.

listMigrationAttempts

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

Muestra una lista de todos los intentos de migración.

Solo el propietario del dispositivo o del perfil, o el propietario del dispositivo o el propietario del perfil anterior que hayan migrado a la API de Android Management Nota: Los intentos de migración anteriores se borran automáticamente y no se devuelven.

Devuelve

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

Es un elemento ListenableFuture que une el resultado. Puede Un futuro exitoso que une una lista de DpcMigrationAttempt, en caso de éxito. Un futuro con un error uniendo un SecurityException, en caso de que el llamador no sea un propietario del dispositivo o del perfil, o un propietario del dispositivo o propietario del perfil anterior que migró a la API de Android Management Falló una unión futura DpcMigrationException Si falló la llamada relacionada con la migración de dpc. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.

listMigrationAttemptsAwait

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

Muestra una lista de todos los intentos de migración.

Solo el propietario del dispositivo o del perfil, o el propietario del dispositivo o el propietario del perfil anterior que hayan migrado a la API de Android Management Nota: Los intentos de migración anteriores se borran automáticamente y no se devuelven.

Devuelve
@NonNull List<@NonNull DpcMigrationAttempt>	Una lista de DpcMigrationAttempt

Arroja
java.lang.SecurityException	Si el emisor no es un propietario del dispositivo o del perfil, ni un propietario del dispositivo o propietario del perfil anterior que migró a la API de Android Management
com.google.android.managementapi.dpcmigration.DpcMigrationException	Si falló la llamada relacionada con la migración de dpc. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.

migrateDeviceManagementToAndroidManagementApi

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

Migra este dispositivo a que lo administre la API de Android Management.

Una vez que se completa la migración, la app que realiza la llamada pierde sus privilegios de propietario del dispositivo o propietario del perfil, ya que se transfieren a Android Device Policy.

Advertencia: Esta acción no se puede deshacer. El ListenableFuture que se muestra se completa cuando Android Device Policy recibe la solicitud y completa las verificaciones preliminares del token de migración. En caso de fallas, ListenableFuture unirá un Exception.

Solo el propietario del dispositivo o el propietario del perfil puede llamar a este método. En Android 10 y versiones anteriores, no se debe llamar a esta función en dispositivos que tengan un propietario de dispositivo y un propietario de perfil.

El propietario del perfil (excepto en Android 12) debe pasar las redes Wi-Fi configuradas en DpcMigrationRequest (excepto en Android 12) en un dispositivo de propiedad personal si este configuró alguna red Wi-Fi. No deben pasarse en un dispositivo de la empresa. Ten en cuenta que estas redes Wi-Fi se quitarán justo antes de que se migre la administración de dispositivos a Android Device Policy. En caso de que no se quite una red, la migración también fallará. Como la eliminación de las redes no es una operación atómica, es posible que algunas redes ya se hayan quitado.

En los dispositivos de propiedad personal con un perfil de trabajo que ejecute Android 12, todas las redes Wi-Fi configuradas por el DPC que realiza la llamada se quitarán justo antes de que se migre la administración del dispositivo a Android Device Policy, independientemente de las redes Wi-Fi pasadas en migrationRequest.

Parámetros
@NonNull ComponentName notificationServiceComponentName	El ComponentName del servicio que extiende NotificationReceiverService. Debe ser un componente válido que pertenezca a la app que realiza la llamada y exportarse al manifiesto; de lo contrario, se arrojará una IllegalArgumentException.
@NonNull ComponentName adminComponentName	El ComponentName del DeviceAdminReceiver del administrador del DPC que realiza la llamada
@NonNull DpcMigrationRequest migrationRequest	El DpcMigrationRequest que contiene el token de migración y las redes Wi-Fi configuradas. Estas últimas solo se requieren si el emisor es el propietario del perfil en un dispositivo de propiedad personal y configuró alguna red.

Devuelve

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Es un elemento ListenableFuture que une el resultado. Puede Un futuro exitoso que une un DpcMigrationAttempt, en caso de éxito. Un futuro fallido uniendo un SecurityException, si el emisor no es propietario del dispositivo ni del perfil Un error futuro uniendo un IllegalArgumentException si el token de migración está vacío, si notificationServiceComponentName no hace referencia a un componente válido que extiende NotificationReceiverService que se exporta en el manifiesto, o si adminComponentName no es un administrador activo que pertenezca al paquete actual. Una falla futura uniendo un DpcMigrationException, si falla la llamada relacionada con la migración de dpc El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.

migrateDeviceManagementToAndroidManagementApiAwait

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

Migra este dispositivo a que lo administre la API de Android Management.

Una vez que se completa la migración, la app que realiza la llamada pierde sus privilegios de propietario del dispositivo o propietario del perfil, ya que se transfieren a Android Device Policy.

Advertencia: Esta acción no se puede deshacer. Esta diversión de suspensión se muestra cuando Android Device Policy recibe la solicitud y completa las comprobaciones preliminares del token de migración. En caso de fallas, se arroja una Exception.

Solo el propietario del dispositivo o el propietario del perfil puede llamar a este método. En Android 10 y versiones anteriores, no se debe llamar a esta función en dispositivos que tengan un propietario de dispositivo y un propietario de perfil.

El propietario del perfil (excepto en Android 12) debe pasar las redes Wi-Fi configuradas en DpcMigrationRequest (excepto en Android 12) en un dispositivo de propiedad personal si este configuró alguna red Wi-Fi. No deben pasarse en un dispositivo de la empresa. Ten en cuenta que estas redes Wi-Fi se quitarán justo antes de que se migre la administración de dispositivos a Android Device Policy. En caso de que no se quite una red, la migración también fallará. Como la eliminación de las redes no es una operación atómica, es posible que algunas redes ya se hayan quitado.

En los dispositivos de propiedad personal con un perfil de trabajo que ejecute Android 12, todas las redes Wi-Fi configuradas por el DPC que realiza la llamada se quitarán justo antes de que se migre la administración del dispositivo a Android Device Policy, independientemente de las redes Wi-Fi pasadas en migrationRequest.

Parámetros
@NonNull ComponentName notificationServiceComponentName	El ComponentName del servicio que extiende NotificationReceiverService. Debe ser un componente válido que pertenezca a la app que realiza la llamada y exportarse al manifiesto; de lo contrario, se arrojará una IllegalArgumentException.
@NonNull ComponentName adminComponentName	El ComponentName del DeviceAdminReceiver del administrador del DPC que realiza la llamada
@NonNull DpcMigrationRequest migrationRequest	El DpcMigrationRequest que contiene el token de migración y las redes Wi-Fi configuradas. Estas últimas solo se requieren si el emisor es el propietario del perfil en un dispositivo de propiedad personal y configuró alguna red.

Devuelve
@NonNull DpcMigrationAttempt	DpcMigrationException con el estado actual de la migración en caso de éxito

Arroja
java.lang.SecurityException	Si el emisor no es propietario del dispositivo o propietario del perfil.
java.lang.IllegalArgumentException	Si el token de migración está vacío o si notificationServiceComponentName no hace referencia a un componente válido que extiende NotificationReceiverService y que se exporta en el manifiesto, o si adminComponentName no es un administrador activo que pertenezca al paquete actual.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Si falló la llamada relacionada con la migración de dpc. El mensaje y el subtipo de la excepción contienen más detalles sobre la falla.