使用 API 管理受保护数据库

查看 REST API 端点列表以管理受保护数据库。

有关使用 API 和签名请求的信息,请参阅 REST API安全身份证明。有关 SDK 的信息,请参阅软件开发套件和命令行界面

使用以下 REST API 端点管理受保护数据库。

  • 创建受保护数据库:CreateProtectedDatabase

    您可以对 CreateProtectedDatabase API 执行模拟运行,以便在实际创建受保护数据库之前验证是否满足所有先决条件。

    请参见 Performing a Dry Run to Check the Preparedness for Creating a Protected Database

  • 删除受保护数据库:DeleteProtectedDatabase
  • 查看受保护数据库的详细信息:GetProtectedDatabase
  • 检索受保护的数据库配置详细信息:FetchProtectedDatabaseConfiguration
  • 修改受保护数据库:UpdateProtectedDatabase
  • 更改受保护的数据库区间:ChangeProtectedDatabaseCompartment
  • 取消删除受保护数据库:CancelProtectedDatabaseDeletion
  • 安排删除受保护数据库:ScheduleProtectedDatabaseDeletion

执行模拟运行以检查创建受保护数据库的准备情况

在将 opc-dry-run 选项设置为 TRUE 的情况下运行 CreateProtectedDatabase API 时,它表示请求是在创建受保护数据库之前检查任何缺少的先决条件。在模拟运行期间,CreateProtectedDatabase API 将返回错误消息,以警告您任何缺少的需求,而无需实际创建受保护的数据库。如果发生错误,您可以查看、更正和重复模拟运行,直到 CreateProtectedDatabase 请求未返回任何错误。

以下是您可以通过执行 CreateProtectedDatabase API 的模拟运行来识别的常见问题:

  • 恢复服务子网的可用 IP 地址不足,无法支持所需数量的专用端点。

    确保在数据库 VCN 中用于恢复服务操作的子网中,仍有足够的未分配 IP 地址可用。

    请参阅注册恢复服务子网

  • 恢复服务无权管理所选区间中的网络资源。

    查看并分配所需的策略。请参阅 OCI 中的 Oracle 数据库使用恢复服务所需的权限

  • 恢复服务已超出容量。

    查看租户的服务限制并请求提高

    请参阅自治恢复服务限制

  • 恢复服务资源超过限额限制

    复核和管理区间内的恢复服务资源使用量。请参阅自治恢复配额

  • 已存在具有相同数据库 ID 的受保护数据库

    选择要使用恢复服务的其他数据库

  • 指定的保护策略不存在,或者它未处于活动状态

    请参阅管理保护策略

  • 不满足注册恢复服务子网的先决条件

    在为恢复服务启用自动备份之前,请确保注册恢复服务子网

    请参阅注册恢复服务子网

示例 9-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.
确保查看并执行 Configuring Recovery Service 中介绍的所有先决条件任务。