DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

Il cliente deve effettuare richieste relative alla migrazione DPC.

Riepilogo

Metodi pubblici
abstract @NonNull ListenableFuture<DpcMigrationAttempt>	getMigrationAttempt(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Recupera un tentativo di migrazione.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Recupera un tentativo di migrazione.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>	listMigrationAttempts() Restituisce un elenco di tutti i tentativi di migrazione.
abstract @NonNull List<@NonNull DpcMigrationAttempt>	listMigrationAttemptsAwait() Restituisce un elenco di tutti i tentativi di migrazione.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Esegui la migrazione di questo dispositivo in modo che venga gestito dall'API Android Management.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Esegui la migrazione di questo dispositivo in modo che venga gestito dall'API Android Management.

Metodi pubblici

getMigrationAttempt

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

Recupera un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito l'ultimo DpcMigrationAttempt.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.

Resi

@NonNull ListenableFuture<DpcMigrationAttempt>

Un ListenableFuture che racchiude il risultato. Può essere Un futuro riuscito che racchiude un DpcMigrationAttempt, in caso di successo. Un futuro wrapping nullo riuscito, nel caso in cui DpcMigrationAttempt non venga trovato. Un futuro non riuscito che racchiude un SecurityException, nel caso in cui il chiamante non sia un proprietario del dispositivo o un proprietario del profilo oppure un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Un wrapping futuro non riuscito DpcMigrationException Se la chiamata relativa alla migrazione DPC non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Recupera un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito l'ultimo DpcMigrationAttempt.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.

Resi
DpcMigrationAttempt	Il valore DpcMigrationAttempt richiesto o null, se non è possibile trovarlo

Genera
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo oppure un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Se la chiamata relativa alla migrazione di DPC non è andata a buon fine. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

listMigrationAttempts

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

Restituisce un elenco di tutti i tentativi di migrazione.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Nota: i tentativi di migrazione precedenti vengono eliminati automaticamente e non vengono restituiti.

Resi

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

Un ListenableFuture che racchiude il risultato. Può essere Un futuro riuscito che racchiude un elenco di DpcMigrationAttempt, in caso di esito positivo. Un futuro non riuscito che racchiude un SecurityException, nel caso in cui il chiamante non sia un proprietario del dispositivo o un proprietario del profilo oppure un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Un wrapping futuro non riuscito DpcMigrationException Se la chiamata relativa alla migrazione DPC non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

listMigrationAttemptsAwait

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

Restituisce un elenco di tutti i tentativi di migrazione.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo oppure da un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Nota: i tentativi di migrazione precedenti vengono eliminati automaticamente e non vengono restituiti.

Resi
@NonNull List<@NonNull DpcMigrationAttempt>	Un elenco di DpcMigrationAttempt

Genera
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo oppure un precedente proprietario del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Se la chiamata relativa alla migrazione di DPC non è andata a buon fine. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

migrateDeviceManagementToAndroidManagementApi

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

Esegui la migrazione di questo dispositivo in modo che venga gestito dall'API Android Management.

Una volta completata la migrazione, l'app di chiamate perde i privilegi di proprietario del dispositivo o proprietario del profilo, in quanto vengono trasferiti ad Android Device Policy.

Attenzione: questa operazione non può essere annullata. ListenableFuture restituito viene completato quando Android Device Policy ha ricevuto la richiesta e ha completato i controlli preliminari sul token di migrazione. In caso di errore, ListenableFuture includerà un Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo. Su Android 10 e versioni precedenti, questa operazione non deve essere chiamata su un dispositivo con un proprietario del dispositivo e un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse in DpcMigrationRequest dal proprietario del profilo (tranne su Android 12) su un dispositivo di proprietà personale se sono state configurate reti Wi-Fi. Questi non devono essere passati su un dispositivo di proprietà aziendale. Tieni presente che queste reti Wi-Fi verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy. In caso di mancata rimozione di una rete, anche la migrazione non andrà a buon fine e, poiché la rimozione delle reti non è un'operazione atomica, alcune reti potrebbero essere già state rimosse.

Sui dispositivi di proprietà personale con un profilo di lavoro che esegue Android 12, tutte le reti Wi-Fi configurate dal DPC chiamante verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse in migrationRequest.

Parametri
@NonNull ComponentName notificationServiceComponentName	Il ComponentName del servizio che estende NotificationReceiverService. Deve essere un componente valido appartenente all'app chiamante ed esportato nel manifest, altrimenti verrà generato un IllegalArgumentException.
@NonNull ComponentName adminComponentName	Il ComponentName dell'amministratore DeviceAdminReceiver del DPC chiamante.
@NonNull DpcMigrationRequest migrationRequest	Il file DpcMigrationRequest contenente il token di migrazione e le reti Wi-Fi configurate. Questi ultimi sono necessari solo se il chiamante è il proprietario del profilo su un dispositivo di proprietà personale e ha configurato delle reti.

Resi

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Un ListenableFuture che racchiude il risultato. Può essere Un futuro riuscito che racchiude un DpcMigrationAttempt, in caso di successo. Un futuro non riuscito che racchiude un SecurityException, se il chiamante non è un proprietario del dispositivo o un proprietario del profilo. Un futuro non riuscito che racchiude un IllegalArgumentException, se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService esportato nel manifest o se adminComponentName non è un amministratore attivo appartenente al pacchetto corrente. Un futuro non riuscito che racchiude un DpcMigrationException, se la chiamata relativa alla migrazione DPC non è riuscita. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.

migrateDeviceManagementToAndroidManagementApiAwait

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

Esegui la migrazione di questo dispositivo in modo che venga gestito dall'API Android Management.

Una volta completata la migrazione, l'app di chiamate perde i privilegi di proprietario del dispositivo o proprietario del profilo, in quanto vengono trasferiti ad Android Device Policy.

Attenzione: questa operazione non può essere annullata. Questa funzione di sospensione viene restituita quando Android Device Policy ha ricevuto la richiesta e ha completato i controlli preliminari sul token di migrazione. In caso di errore, viene generato un Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o del profilo. Su Android 10 e versioni precedenti, questa operazione non deve essere chiamata su un dispositivo con un proprietario del dispositivo e un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse in DpcMigrationRequest dal proprietario del profilo (tranne su Android 12) su un dispositivo di proprietà personale se sono state configurate reti Wi-Fi. Questi non devono essere passati su un dispositivo di proprietà aziendale. Tieni presente che queste reti Wi-Fi verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy. In caso di mancata rimozione di una rete, anche la migrazione non andrà a buon fine e, poiché la rimozione delle reti non è un'operazione atomica, alcune reti potrebbero essere già state rimosse.

Sui dispositivi di proprietà personale con un profilo di lavoro che esegue Android 12, tutte le reti Wi-Fi configurate dal DPC chiamante verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse in migrationRequest.

Parametri
@NonNull ComponentName notificationServiceComponentName	Il ComponentName del servizio che estende NotificationReceiverService. Deve essere un componente valido appartenente all'app chiamante ed esportato nel manifest, altrimenti verrà generato un IllegalArgumentException.
@NonNull ComponentName adminComponentName	Il ComponentName dell'amministratore DeviceAdminReceiver del DPC chiamante.
@NonNull DpcMigrationRequest migrationRequest	Il file DpcMigrationRequest contenente il token di migrazione e le reti Wi-Fi configurate. Questi ultimi sono necessari solo se il chiamante è il proprietario del profilo su un dispositivo di proprietà personale e ha configurato delle reti.

Resi
@NonNull DpcMigrationAttempt	DpcMigrationException con lo stato attuale della migrazione in caso di esito positivo.

Genera
java.lang.SecurityException	Se il chiamante non è il proprietario del dispositivo o del profilo.
kotlin.IllegalArgumentException	Se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService esportato nel manifest oppure se adminComponentName non è un amministratore attivo appartenente al pacchetto corrente.
com.google.android.managementapi.dpcmigration.DpcMigrationException	Se la chiamata relativa alla migrazione di DPC non è andata a buon fine. Il messaggio e il sottotipo dell'eccezione contengono ulteriori dettagli sull'errore.