API를 사용하여 보호 데이터베이스 관리

보호된 데이터베이스를 관리하려면 REST API 끝점 목록을 검토하십시오.

API 사용 및 서명 요청에 대한 자세한 내용은 REST API보안 인증서를 참조하십시오. SDK에 대한 자세한 내용은 Software Development Kits and Command Line Interface를 참조하십시오.

다음 REST API 끝점을 사용하여 보호된 데이터베이스를 관리합니다.

  • 보호된 데이터베이스 생성: CreateProtectedDatabase

    CreateProtectedDatabase API의 Dry Run을 수행하여 보호된 데이터베이스를 실제로 만들기 전에 모든 필수 조건이 충족되는지 확인할 수 있습니다.

    Performing a Dry Run to Check the Preparedness for Creating a Protected Database을 참조하십시오.

  • 보호된 데이터베이스 삭제: DeleteProtectedDatabase
  • 보호된 데이터베이스의 세부 정보 보기: GetProtectedDatabase
  • 보호된 데이터베이스 구성 세부 정보 검색: FetchProtectedDatabaseConfiguration
  • 보호된 데이터베이스 수정: UpdateProtectedDatabase
  • 보호된 데이터베이스 컴파트먼트 변경: ChangeProtectedDatabaseCompartment
  • 보호된 데이터베이스 삭제 취소:CancelProtectedDatabaseDeletion
  • 보호된 데이터베이스 삭제 일정 잡기:ScheduleProtectedDatabaseDeletion

Dry Run을 수행하여 보호 데이터베이스 만들기에 대한 준비 상태 확인

opc-dry-run 옵션이 TRUE로 설정된 상태에서 CreateProtectedDatabase API를 실행하면 보호된 데이터베이스를 생성하기 전에 요청이 누락된 필요 조건을 확인하는 dry run임을 나타냅니다. dry-run 중 CreateProtectedDatabase API는 오류 메시지를 반환하여 실제로 보호된 데이터베이스를 생성하지 않고 누락된 요구사항에 대해 경고합니다. 오류가 발생하면 CreateProtectedDatabase 요청이 오류를 반환하지 않을 때까지 dry-run을 검토, 수정 및 반복할 수 있습니다.

다음은 CreateProtectedDatabase API의 Dry Run을 수행하여 식별할 수 있는 일반적인 문제입니다.

  • 복구 서비스 서브넷에 필요한 수의 프라이빗 끝점을 지원하기 위한 사용 가능한 IP 주소가 부족합니다.

    데이터베이스 VCN의 복구 서비스 작업에 사용되는 서브넷에서 충분한 할당되지 않은 IP 주소를 계속 사용할 수 있는지 확인합니다.

    참조: 복구 서비스 서브넷 등록

  • 복구 서비스에 선택한 컴파트먼트의 네트워크 리소스를 관리할 수 있는 권한이 없습니다.

    필요한 정책을 검토하고 지정합니다. 참조: OCI의 Oracle Databases에 대한 선택적 권한

  • 복구 서비스의 용량이 부족합니다.

    테넌시에 대한 서비스 제한을 검토하고 증가를 요청하십시오.

    참조: 자율운영 복구 서비스 한도

  • 복구 서비스 리소스가 할당량 제한을 초과합니다.

    구획 내에서 복구 서비스 리소스 소비를 검토하고 관리합니다. 자율 복구 할당량을 참조하십시오.

  • 데이터베이스 ID가 동일한 보호 데이터베이스가 이미 있습니다.

    복구 서비스를 사용할 다른 데이터베이스 선택

  • 지정된 보호 정책이 존재하지 않거나 Active 상태가 아닙니다.

    보호 정책 관리를 참조하십시오.

  • 복구 서비스 서브넷 등록의 필요 조건이 충족되지 않습니다.

    복구 서비스에 대한 자동 백업을 사용으로 설정하기 전에 복구 서비스 서브넷을 등록해야 합니다.

    참조: 복구 서비스 서브넷 등록

CreateProtectedDatabase API의 9-1 Dry Run 요청 예

이 예는 샘플 Dry Run 요청입니다.

CreateProtectedDatabaseRequest createProtectedDatabaseRequest = CreateProtectedDatabaseRequest.builder()
.createProtectedDatabaseDetails(createProtectedDatabaseDetails)
.opcRetryToken("EXAMPLE-opcRetryToken-Value")
.opcDryRun(true)
.opcRequestId("UCCBPPQDHXIF5I7A11SS<unique_ID>").build();

Dry Run의 샘플 출력입니다.

Status Code : 409
Service Code: IncorrectState
Error Message:
Authorization failed. Autonomous Recovery Service does not have the required security policies to 
manage virtual-network-family in the chosen compartment. 
See, 'Prerequisites for Using Recovery Service as a Automatic Backup Destination' in the 
Recovery Service documentation.

The following compartment quotas were exceeded: 
protected-database-backup-storage-gb in policy 'example-policy' by 1.

The prerequisite of registering a Recovery Service subnet is not met. 
Ensure that you register a Recovery Service subnet before enabling automatic backups. 
See, 'Register Recovery Service Subnet' in the Recovery Service documentation.
Onboarding Oracle Database to Recovery Service에 설명된 모든 필요 조건 작업을 검토하고 수행해야 합니다.