APIを使用した保護されたデータベースの管理

保護されたデータベースを管理するためのREST APIエンドポイントのリストを確認します。

APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してくださいSDKの詳細は、ソフトウェア開発キットおよびコマンドライン・インタフェースを参照してください

保護されたデータベースを管理するには、次のREST APIエンドポイントを使用します。

  • 保護されたデータベースの作成: CreateProtectedDatabase

    CreateProtectedDatabase APIの予行演習を実行して、保護されたデータベースを実際に作成する前にすべての前提条件が満たされていることを確認できます。

    「保護されたデータベースを作成するための準備状況を確認するためのドライ・ランの実行」を参照してください。

  • 保護されたデータベースの削除: DeleteProtectedDatabase
  • 保護されたデータベースの詳細の表示: GetProtectedDatabase
  • 保護されたデータベース構成の詳細を取得します: FetchProtectedDatabaseConfiguration
  • 保護されたデータベースの変更: UpdateProtectedDatabase
  • 保護されたデータベース・コンパートメントの変更: ChangeProtectedDatabaseCompartment
  • 保護されたデータベースの削除の取消し:CancelProtectedDatabaseDeletion
  • 保護されたデータベースの削除をスケジュールします:ScheduleProtectedDatabaseDeletion

保護されたデータベースの作成準備状況を確認するためのドライ・ランの実行

opc-dry-runオプションをTRUEに設定してCreateProtectedDatabase APIを実行すると、保護されたデータベースを作成する前に、欠落している前提条件をチェックするリクエストが予行演習であることを示します。予行演習中、CreateProtectedDatabase APIは、保護されたデータベースを実際に作成せずに、不足している要件について警告するエラー・メッセージを返します。エラーが発生した場合は、CreateProtectedDatabaseリクエストがエラーを返さないまで、予行演習を確認、修正および繰り返すことができます。

CreateProtectedDatabase APIの予行演習を実行することで特定できる一般的な問題は次のとおりです。

  • リカバリ・サービス・サブネットの空きIPアドレスが不足しているため、必要な数のプライベート・エンドポイントをサポートできません。

    データベースVCNのリカバリ・サービス操作に使用されるサブネットで、十分な未割当てのIPアドレスが使用可能であることを確認します。

    「リカバリ・サービス・サブネットの登録」を参照してください

  • リカバリ・サービスには、選択したコンパートメント内のネットワーク・リソースを管理する権限がありません。

    必要なポリシーをレビューして割り当てます。リカバリ・サービスおよび関連リソースへのアクセスを許可するポリシーの割当てを参照してください

  • リカバリ・サービスの容量が不足しています。

    テナンシのサービス制限を確認し、増加をリクエストします

    自律型リカバリ・サービスの制限を参照してください

  • リカバリ・サービス・リソースが割当て制限を超えています

    コンパートメント内のリカバリ・サービス・リソース消費を確認および管理します。「Autonomous Recovery Quotas」を参照してください。

  • 同じデータベースIDを持つ保護されたデータベースがすでに存在します

    リカバリ・サービスを使用する別のデータベースを選択します

  • 指定された保護ポリシーが存在しないか、「アクティブ」状態ではありません

    関連項目: 保護ポリシーの管理

  • リカバリ・サービス・サブネットの登録の前提条件を満たしていません

    リカバリ・サービスへの自動バックアップを有効にする前に、必ずリカバリ・サービス・サブネットを登録してください

    「リカバリ・サービス・サブネットの登録」を参照してください

例8-1 CreateProtectedDatabase APIのドライ・ラン・リクエスト

この例は、ドライラン リクエストの例です。

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

これは予行演習のサンプル出力です。

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.
「リカバリ・サービスの構成」で説明されているすべての前提条件タスクを確認して実行してください。