DpcMigrationClient

interface DpcMigrationClient


PC 마이그레이션 관련 요청을 하는 클라이언트입니다.

요약

공개 함수

ListenableFuture<DpcMigrationAttempt?>
getMigrationAttempt(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
)

마이그레이션 시도를 가져옵니다.

suspend DpcMigrationAttempt?
getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
)

마이그레이션 시도를 가져옵니다.

ListenableFuture<List<DpcMigrationAttempt>>

모든 이전 시도 목록을 반환합니다.

suspend List<DpcMigrationAttempt>

모든 이전 시도 목록을 반환합니다.

ListenableFuture<DpcMigrationAttempt>
migrateDeviceManagementToAndroidManagementApi(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
)

이 기기를 Android Management API에서 관리하도록 이전합니다.

suspend DpcMigrationAttempt
migrateDeviceManagementToAndroidManagementApiAwait(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
)

이 기기를 Android Management API에서 관리하도록 이전합니다.

공개 함수

getMigrationAttempt

fun getMigrationAttempt(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): ListenableFuture<DpcMigrationAttempt?>

마이그레이션 시도를 가져옵니다.

GetDpcMigrationAttemptRequest에 이름이 지정되지 않은 경우 가장 최근의 DpcMigrationAttempt이 반환됩니다.

이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다.

반환 값
ListenableFuture<DpcMigrationAttempt?>

결과를 래핑하는 ListenableFuture 이는

  • 성공한 경우 DpcMigrationAttempt를 래핑하는 성공적인 향후

  • DpcMigrationAttempt를 찾을 수 없는 경우 향후 성공적으로 null을 래핑합니다.

  • 호출자가 기기 소유자나 프로필 소유자이거나 Android Management API로 이전한 이전 기기 소유자 또는 프로필 소유자가 아닌 경우 향후 SecurityException 래핑에 실패했습니다.

  • 실패한 향후 래핑 DpcMigrationException: VPC 이전 관련 호출이 실패한 경우입니다. 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다.

getMigrationAttemptAwait

suspend fun getMigrationAttemptAwait(
    getMigrationAttemptRequest: GetDpcMigrationAttemptRequest
): DpcMigrationAttempt?

마이그레이션 시도를 가져옵니다.

GetDpcMigrationAttemptRequest에 이름이 지정되지 않은 경우 가장 최근의 DpcMigrationAttempt이 반환됩니다.

이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다.

반환 값
DpcMigrationAttempt?

요청된 DpcMigrationAttempt 또는 null(찾을 수 없는 경우)

생성 값
java.lang.SecurityException

발신자가 기기 소유자, 프로필 소유자 또는 Android Management API로 이전한 이전 기기 소유자 또는 프로필 소유자가 아닌 경우

com.google.android.managementapi.dpcmigration.DpcMigrationException

VPC 이전 관련 호출에 실패한 경우 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다.

listMigrationAttempts

fun listMigrationAttempts(): ListenableFuture<List<DpcMigrationAttempt>>

모든 이전 시도 목록을 반환합니다.

이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다. 참고: 이전 이전 시도는 자동으로 삭제되며 반환되지 않습니다.

반환 값
ListenableFuture<List<DpcMigrationAttempt>>

결과를 래핑하는 ListenableFuture 이는

  • 성공한 경우 향후 DpcMigrationAttempt 목록을 래핑합니다.

  • 호출자가 기기 소유자나 프로필 소유자이거나 Android Management API로 이전한 이전 기기 소유자 또는 프로필 소유자가 아닌 경우 향후 SecurityException 래핑에 실패했습니다.

  • 실패한 향후 래핑 DpcMigrationException: VPC 이전 관련 호출이 실패한 경우입니다. 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다.

listMigrationAttemptsAwait

suspend fun listMigrationAttemptsAwait(): List<DpcMigrationAttempt>

모든 이전 시도 목록을 반환합니다.

이 메서드는 기기 소유자나 프로필 소유자 또는 Android Management API로 이전한 기존 기기 소유자나 프로필 소유자만 호출할 수 있습니다. 참고: 이전 이전 시도는 자동으로 삭제되며 반환되지 않습니다.

생성 값
java.lang.SecurityException

발신자가 기기 소유자, 프로필 소유자 또는 Android Management API로 이전한 이전 기기 소유자 또는 프로필 소유자가 아닌 경우

com.google.android.managementapi.dpcmigration.DpcMigrationException

VPC 이전 관련 호출에 실패한 경우 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다.

migrateDeviceManagementToAndroidManagementApi

fun migrateDeviceManagementToAndroidManagementApi(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): ListenableFuture<DpcMigrationAttempt>

이 기기를 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 네트워크가 삭제됩니다.

매개변수
notificationServiceComponentName: ComponentName

NotificationReceiverService를 확장하는 서비스의 ComponentName입니다. 호출 앱에 속한 유효한 구성요소여야 하고 매니페스트에서 내보내야 합니다. 그렇지 않으면 IllegalArgumentException이 발생합니다.

adminComponentName: ComponentName

호출하는 DPC의 관리자 DeviceAdminReceiverComponentName입니다.

migrationRequest: DpcMigrationRequest

이전 토큰 및 구성된 Wi-Fi 네트워크가 포함된 DpcMigrationRequest. 후자는 호출자가 개인 소유 기기의 프로필 소유자이고 네트워크를 구성한 경우에만 필요합니다.

반환 값
ListenableFuture<DpcMigrationAttempt>

결과를 래핑하는 ListenableFuture 이는

migrateDeviceManagementToAndroidManagementApiAwait

suspend fun migrateDeviceManagementToAndroidManagementApiAwait(
    notificationServiceComponentName: ComponentName,
    adminComponentName: ComponentName,
    migrationRequest: DpcMigrationRequest
): DpcMigrationAttempt

이 기기를 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 네트워크가 삭제됩니다.

매개변수
notificationServiceComponentName: ComponentName

NotificationReceiverService를 확장하는 서비스의 ComponentName입니다. 호출 앱에 속한 유효한 구성요소여야 하고 매니페스트에서 내보내야 합니다. 그렇지 않으면 IllegalArgumentException이 발생합니다.

adminComponentName: ComponentName

호출하는 DPC의 관리자 DeviceAdminReceiverComponentName입니다.

migrationRequest: DpcMigrationRequest

이전 토큰 및 구성된 Wi-Fi 네트워크가 포함된 DpcMigrationRequest. 후자는 호출자가 개인 소유 기기의 프로필 소유자이고 네트워크를 구성한 경우에만 필요합니다.

반환 값
DpcMigrationAttempt

DpcMigrationException를 성공 시 마이그레이션의 현재 상태로 바꿉니다.

생성 값
java.lang.SecurityException

발신자가 기기 소유자 또는 프로필 소유자가 아닌 경우

java.lang.IllegalArgumentException

이전 토큰이 비어 있거나 notificationServiceComponentName이 매니페스트에서 내보낸 NotificationReceiverService를 확장하는 유효한 구성요소를 참조하지 않거나 adminComponentName이 현재 패키지에 속한 활성 관리자가 아닌 경우

com.google.android.managementapi.dpcmigration.DpcMigrationException

VPC 이전 관련 호출에 실패한 경우 메시지 및 예외의 하위 유형에 실패에 대한 자세한 내용이 포함되어 있습니다.