DpcMigrationClient
public interface DpcMigrationClient
PC 마이그레이션 관련 요청을 하는 클라이언트입니다.
요약
공개 메서드
getMigrationAttempt
abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
@NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)
마이그레이션 시도를 가져옵니다.
GetDpcMigrationAttemptRequest에 이름이 지정되지 않은 경우 가장 최근의 DpcMigrationAttempt이 반환됩니다.
이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다.
| 반환 값 | |
|---|---|
@NonNull ListenableFuture<DpcMigrationAttempt> |
결과를 래핑하는
|
getMigrationAttemptAwait
abstract DpcMigrationAttempt getMigrationAttemptAwait(
@NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)
마이그레이션 시도를 가져옵니다.
GetDpcMigrationAttemptRequest에 이름이 지정되지 않은 경우 가장 최근의 DpcMigrationAttempt이 반환됩니다.
이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다.
| 반환 값 | |
|---|---|
DpcMigrationAttempt |
요청된 |
| 생성 값 | |
|---|---|
java.lang.SecurityException |
발신자가 기기 소유자, 프로필 소유자 또는 Android Management API로 이전한 이전 기기 소유자 또는 프로필 소유자가 아닌 경우 |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
VPC 이전 관련 호출에 실패한 경우 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다. |
listMigrationAttempts
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()
모든 이전 시도 목록을 반환합니다.
이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다. 참고: 이전 이전 시도는 자동으로 삭제되며 반환되지 않습니다.
| 반환 값 | |
|---|---|
@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> |
결과를 래핑하는
|
listMigrationAttemptsAwait
abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()
모든 이전 시도 목록을 반환합니다.
이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다. 참고: 이전 이전 시도는 자동으로 삭제되며 반환되지 않습니다.
| 반환 값 | |
|---|---|
@NonNull List<@NonNull DpcMigrationAttempt> |
| 생성 값 | |
|---|---|
java.lang.SecurityException |
발신자가 기기 소유자, 프로필 소유자 또는 Android Management API로 이전한 이전 기기 소유자 또는 프로필 소유자가 아닌 경우 |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
VPC 이전 관련 호출에 실패한 경우 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다. |
migrateDeviceManagementToAndroidManagementApi
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
@NonNull ComponentName notificationServiceComponentName,
@NonNull ComponentName adminComponentName,
@NonNull DpcMigrationRequest migrationRequest
)
이 기기를 Android Management API에서 관리하도록 이전합니다.
이전이 완료되면 통화 앱이 Android Device Policy로 이전되어 통화 앱이 기기 소유자 또는 프로필 소유자 권한을 잃게 됩니다.
경고: 이 작업은 되돌릴 수 없습니다. 반환된 ListenableFuture는 Android Device Policy가 요청을 수신하고 이전 토큰에 대한 예비 검사를 완료하면 완료됩니다. 실패하면 ListenableFuture가 Exception를 래핑합니다.
이 메서드는 기기 소유자 또는 프로필 소유자만 호출할 수 있습니다. Android 10 이하에서는 기기 소유자와 프로필 소유자가 모두 있는 기기에서 이 메서드를 호출하면 안 됩니다.
Wi-Fi 네트워크가 구성된 경우 개인 소유 기기에서 프로필 소유자가 DpcMigrationRequest에 구성된 Wi-Fi 네트워크를 전달해야 합니다 (Android 12 제외). 회사 소유 기기로 전달되면 안 됩니다. 이러한 Wi-Fi 네트워크는 기기 관리가 Android Device Policy로 이전되기 직전에 삭제됩니다. 네트워크 삭제에 실패한 경우 이전도 실패하며 네트워크 삭제는 원자적인 작업이 아니므로 일부 네트워크가 이미 삭제되었을 수 있습니다.
Android 12를 실행하는 직장 프로필을 사용하는 개인 소유 기기의 경우 migrationRequest에 전달된 Wi-Fi 네트워크와 관계없이 기기 관리가 Android Device Policy로 이전되기 직전에 호출 DPC로 구성된 모든 Wi-Fi 네트워크가 삭제됩니다.
| 매개변수 | |
|---|---|
@NonNull ComponentName notificationServiceComponentName |
|
@NonNull ComponentName adminComponentName |
호출하는 DPC의 관리자 |
@NonNull DpcMigrationRequest migrationRequest |
이전 토큰 및 구성된 Wi-Fi 네트워크가 포함된 |
| 반환 값 | |
|---|---|
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt> |
결과를 래핑하는
|
migrateDeviceManagementToAndroidManagementApiAwait
abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
@NonNull ComponentName notificationServiceComponentName,
@NonNull ComponentName adminComponentName,
@NonNull DpcMigrationRequest migrationRequest
)
이 기기를 Android Management API에서 관리하도록 이전합니다.
이전이 완료되면 통화 앱이 Android Device Policy로 이전되어 통화 앱이 기기 소유자 또는 프로필 소유자 권한을 잃게 됩니다.
경고: 이 작업은 되돌릴 수 없습니다. Android Device Policy가 요청을 수신하고 이전 토큰에 대한 예비 검사를 완료하면 이 정지 혜택이 반환됩니다. 실패하면 Exception이 발생합니다.
이 메서드는 기기 소유자 또는 프로필 소유자만 호출할 수 있습니다. Android 10 이하에서는 기기 소유자와 프로필 소유자가 모두 있는 기기에서 이 메서드를 호출하면 안 됩니다.
Wi-Fi 네트워크가 구성된 경우 개인 소유 기기에서 프로필 소유자가 DpcMigrationRequest에 구성된 Wi-Fi 네트워크를 전달해야 합니다 (Android 12 제외). 회사 소유 기기로 전달되면 안 됩니다. 이러한 Wi-Fi 네트워크는 기기 관리가 Android Device Policy로 이전되기 직전에 삭제됩니다. 네트워크 삭제에 실패한 경우 이전도 실패하며 네트워크 삭제는 원자적인 작업이 아니므로 일부 네트워크가 이미 삭제되었을 수 있습니다.
Android 12를 실행하는 직장 프로필을 사용하는 개인 소유 기기의 경우 migrationRequest에 전달된 Wi-Fi 네트워크와 관계없이 기기 관리가 Android Device Policy로 이전되기 직전에 호출 DPC로 구성된 모든 Wi-Fi 네트워크가 삭제됩니다.
| 매개변수 | |
|---|---|
@NonNull ComponentName notificationServiceComponentName |
|
@NonNull ComponentName adminComponentName |
호출하는 DPC의 관리자 |
@NonNull DpcMigrationRequest migrationRequest |
이전 토큰 및 구성된 Wi-Fi 네트워크가 포함된 |
| 반환 값 | |
|---|---|
@NonNull DpcMigrationAttempt |
|
| 생성 값 | |
|---|---|
java.lang.SecurityException |
발신자가 기기 소유자 또는 프로필 소유자가 아닌 경우 |
java.lang.IllegalArgumentException |
이전 토큰이 비어 있거나 |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
VPC 이전 관련 호출에 실패한 경우 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다. |