APIを使用した保護されたデータベースの管理
REST APIエンドポイントのリストを確認して、保護されたデータベースを管理します。
次の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アドレスが使用可能であることを確認します。
- リカバリ・サービスには、選択したコンパートメント内のネットワーク・リソースを管理する権限がありません。
必要なポリシーを確認して割り当てます。 「リカバリ・サービスを使用するためにOCIのOracle Databasesに必要な権限」 を参照
- Recovery Serviceの容量が不足しています。
テナンシのサービス制限を確認し、引上げをリクエスト
See, 「自律型リカバリ・サービスの制限」
- リカバリ・サービス・リソースが割当て制限を超えています
コンパートメント内の「リカバリ・サービス」リソース消費を確認および管理します。 「自律型リカバリの割当て」を参照してください。
- 同じデータベースIDを持つ保護されたデータベースがすでに存在
「リカバリ・サービス」を使用する別のデータベースを選択
- 指定された保護ポリシーが存在しないか、「アクティブ」状態ではありません
See, 「保護ポリシーの管理」
- リカバリ・サービス・サブネットの登録の前提条件を満たしていません
「リカバリ・サービス」への自動バックアップを有効にする前に、必ずリカバリ・サービス・サブネットを登録してください
例8-1 CreateProtectedDatabase
APIのDry Runリクエスト
この例は、サンプルのドライ・ラン・リクエストです。
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.