DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

Client per effettuare richieste relative alla migrazione dpc.

Riepilogo

Metodi pubblici
abstract @NonNull ListenableFuture<DpcMigrationAttempt>	getMigrationAttempt(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Riceve un tentativo di migrazione.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Riceve 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 affinché sia gestito dall'API Android Management.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Esegui la migrazione di questo dispositivo affinché sia gestito dall'API Android Management.

Metodi pubblici

getMigrationAttempt

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

Riceve un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito il valore DpcMigrationAttempt più recente.

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

Ritorni

@NonNull ListenableFuture<DpcMigrationAttempt>

Un ListenableFuture a capo del risultato. Può essere Un futuro con successo per l'invio di un DpcMigrationAttempt, in caso di successo. Un wrapping futuro riuscito è nullo nel caso in cui DpcMigrationAttempt non venga trovato. Impossibile eseguire il wrapping di SecurityException in futuro, nel caso in cui il chiamante non sia un proprietario del dispositivo o del profilo, oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management. 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
)

Riceve un tentativo di migrazione.

Se non viene specificato alcun nome in GetDpcMigrationAttemptRequest, viene restituito il valore DpcMigrationAttempt più recente.

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

Ritorni
DpcMigrationAttempt	Il valore DpcMigrationAttempt richiesto o nullo, se non è possibile trovarlo

Lanci
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo oppure un proprietario precedente 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 dpc non è riuscita. 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 proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Nota: i tentativi di migrazione meno recenti vengono eliminati automaticamente e non vengono restituiti.

Ritorni

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

Un ListenableFuture a capo del risultato. Può essere Un'operazione futura con esito positivo di un elenco di DpcMigrationAttempt, in caso di esito positivo. Impossibile eseguire il wrapping di SecurityException in futuro, nel caso in cui il chiamante non sia un proprietario del dispositivo o del profilo, oppure un proprietario precedente del dispositivo o del profilo di cui è stata eseguita la migrazione all'API Android Management. 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 proprietario precedente del dispositivo o del profilo che ha eseguito la migrazione all'API Android Management. Nota: i tentativi di migrazione meno recenti vengono eliminati automaticamente e non vengono restituiti.

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

Lanci
java.lang.SecurityException	Se il chiamante non è un proprietario del dispositivo o del profilo oppure un proprietario precedente 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 dpc non è riuscita. 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 affinché sia gestito dall'API Android Management.

Al termine della migrazione, l'app per le chiamate perde i privilegi Proprietario dispositivo o Proprietario del profilo, che vengono trasferiti ad Android Device Policy.

Attenzione: l'operazione non può essere annullata! Il valore AscoltaableFuture restituito viene completato quando Android Device Policy ha ricevuto la richiesta e ha completato i controlli preliminari del token di migrazione. In caso di errore, AscoltaableFuture aggrega un Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o di un profilo. Su Android 10 e versioni precedenti, questa funzionalità non deve essere effettuata su un dispositivo che dispone sia di un proprietario del dispositivo sia di un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse su DpcMigrationRequest dal proprietario del profilo (tranne su Android 12) su un dispositivo di proprietà personale, se sono state configurate delle reti Wi-Fi. Questi dati non devono essere trasmessi su un dispositivo di proprietà dell'azienda. 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 avrà esito negativo 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 con Android 12, tutte le reti Wi-Fi configurate dal DPC delle chiamate verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse nel migrationRequest.

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

Ritorni

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Un ListenableFuture a capo del risultato. Può essere Un futuro con successo per l'invio di un DpcMigrationAttempt, in caso di successo. Impossibile eseguire il wrapping di un SecurityException in futuro, se il chiamante non è un proprietario del dispositivo o del profilo. Un wrapping futuro di IllegalArgumentException non riuscito se il token di migrazione è vuoto o se notificationServiceComponentName non fa riferimento a un componente valido che estende NotificationReceiverService che viene esportato nel file manifest o se adminComponentName non è un amministratore attivo appartenente al pacchetto corrente. Impossibile eseguire il wrapping futuro di DpcMigrationException, se la chiamata relativa alla migrazione del VPC 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 affinché sia gestito dall'API Android Management.

Al termine della migrazione, l'app per le chiamate perde i privilegi Proprietario dispositivo o Proprietario del profilo, che vengono trasferiti ad Android Device Policy.

Attenzione: l'operazione non può essere annullata! Questa operazione sospende il ritorno divertente quando Android Device Policy ha ricevuto la richiesta e ha completato i controlli preliminari del token di migrazione. In caso di errore, viene generato un valore Exception.

Questo metodo può essere chiamato solo da un proprietario del dispositivo o di un profilo. Su Android 10 e versioni precedenti, questa funzionalità non deve essere effettuata su un dispositivo che dispone sia di un proprietario del dispositivo sia di un proprietario del profilo.

Le reti Wi-Fi configurate devono essere trasmesse su DpcMigrationRequest dal proprietario del profilo (tranne su Android 12) su un dispositivo di proprietà personale, se sono state configurate delle reti Wi-Fi. Questi dati non devono essere trasmessi su un dispositivo di proprietà dell'azienda. 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 avrà esito negativo 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 con Android 12, tutte le reti Wi-Fi configurate dal DPC delle chiamate verranno rimosse poco prima della migrazione della gestione dei dispositivi ad Android Device Policy, indipendentemente dalle reti Wi-Fi trasmesse nel migrationRequest.

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

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

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