专用 Exadata 基础结构上自治 AI 数据库的 API 参考
您可以使用 API 在专用 Exadata 基础结构上查看和管理自治 AI 数据库的不同基础结构资源。
有关使用 API 和签名请求的信息，请参阅 REST API 和安全身份证明。有关 SDK 的信息，请参见 Software Development Kits and Command Line Interface 。
用于管理 Exadata 基础结构资源的 API
下表列出了用于管理 Oracle Public Cloud 和多云上的 Exadata 基础结构资源的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 创建 Exadata 基础结构资源 | 创建 CloudExadata 基础结构 | CLOUD_EXADATA_INFRASTRUCTURE_CREATE 创建 子网附加 VNIC_ATTACH |
| 查看 Exadata 基础结构资源列表 | ListCloudExadataInfrastructures | CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
| 查看 Exadata 基础结构资源的详细信息 | GetCloudExadata 基础结构 | CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
| 更新 Exadata 基础结构资源的详细信息。您可以使用此 API 更新计算、存储、联系人、标记和维护窗口。 | 更新 CloudExadata 基础结构 | CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| 将 Exadata 基础结构资源移至其他区间 | 更改 CloudExadataInfrastructureCompartment | CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| 终止 Exadata 基础结构资源 | 删除 CloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_DELETE VNIC_DELETE 子网/分离 VNIC_DETACH |
下表列出了用于管理 Exadata Cloud@Customer 上的 Exadata 基础结构资源的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 创建 Exadata 基础结构资源 | 创建 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_CREATE |
| 查看 Exadata 基础结构资源列表 | 列出 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_INSPECT |
| 查看 Exadata 基础结构资源的详细信息 | 获取 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_INSPECT |
| 更新 Exadata 基础结构资源的详细信息。您可以使用此 API 更新计算、存储、联系人、标记和维护窗口。 | 更新 Exadata 基础结构 | EXADATA_INFRASTRUCTURE_UPDATE |
| 将 Exadata 基础结构资源移至其他区间 | 更改 ExadataInfrastructureCompartment | EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
| 终止 Exadata 基础结构资源 | 删除 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_DELETE |
| 下载 Exadata 基础结构资源配置文件 | 下载 ExadataInfrastructureConfigFile | EXADATA_INFRASTRUCTURE_CONTENT_READ |
| 向 Exadata 基础结构添加存储容量 | AddStorageCapacityExadata 基础结构 | EXADATA_INFRASTRUCTURE_UPDATE |
| 激活 Exadata 基础结构 | 激活 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
用于管理自治 Exadata VM 集群的 API
下表列出了用于管理 Oracle Public Cloud 和多云上的自治 Exadata VM 集群的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 创建自治 Exadata VM 集群 | 创建 CloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_CREATE 和 CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| 查看自治 Exadata VM 集群的详细信息 | 获取 CloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| 查看自治 Exadata VM 集群列表 | ListCloudAutonomousVm 集群 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| 将自治 Exadata VM 集群移至其他区间 | ChangeCloudAutonomousVmCluster 区间 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT 和 CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| 终止自治 Exadata VM 集群 | 删除 CloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_DELETE |
| 轮换 ORDS 证明 | RotateCloudAutonomousVmClusterOrdsCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| 轮换 SSL 认证 | RotateCloudAutonomousVmClusterSslCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| 更新自治 Exadata VM 集群的详细信息。您可以使用此 API 修改标记、许可证模型或网络安全组 (NSG)。 | 更新 CloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| 获取自治 Exadata VM 集群的资源使用情况详细信息及其中的自治容器数据库的使用情况统计信息。 | GetAutonomousVMClusterResourceUsage | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
下表列出了用于管理 Exadata Cloud@Customer 上的自治 Exadata VM 集群的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 创建自治 Exadata VM 集群 | 创建自治 VmCluster | AUTONOMOUS_VM_CLUSTER_CREATE 和 EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
| 查看自治 Exadata VM 集群列表 | ListAutonomousVmClusters | AUTONOMOUS_VM_CLUSTER_INSPECT |
| 查看自治 Exadata VM 集群的详细信息 | 获取自治 VmCluster | AUTONOMOUS_VM_CLUSTER_INSPECT |
| 更改自治 Exadata VM 集群的许可证类型 | 更新自治 VmCluster | AUTONOMOUS_VM_CLUSTER_UPDATE 和 EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
| 将自治 Exadata VM 集群移至其他区间 | ChangeAutonomousVmCluster 区间 | AUTONOMOUS_VM_CLUSTER_INSPECT 和 AUTONOMOUS_VM_CLUSTER_UPDATE |
| 终止自治 Exadata VM 集群 | 删除自治 VmCluster | AUTONOMOUS_VM_CLUSTER_DELETE |
用于管理自治容器数据库的 API
下表列出了用于管理自治容器数据库的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 创建自治容器数据库 | CreateAutonomousContainerDatabase | 在 Oracle Public Cloud 和多云上： CLOUD_EXADATA_INFRASTRUCTURE_UPDATE 和 CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE 以及 AUTONOMOUS_CONTAINER_DATABASE_CREATE 在 Exadata Cloud@Customer 上： EXADATA_INFRASTRUCTURE_UPDATE 和 AUTONOMOUS_VM_CLUSTER_UPDATE 以及 AUTONOMOUS_CONTAINER_DATABASE_CREATE |
| 查看自治容器数据库列表 | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 查看自治容器数据库的详细信息 | 获取自治容器数据库 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
更改自治容器数据库的备份保留策略 或者 编辑自治容器数据库的维护首选项 |
UpdateAutonomousContainerDatabase | 自治容器 _ 数据库 _ 更新 |
| 重新启动自治容器数据库 | 重新启动自治容器数据库 | 自治容器 _ 数据库 _ 更新 |
| 将自治容器数据库移至其他区间 | ChangeAutonomousContainerDatabaseCompartment | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 轮换自治容器数据库密钥 | RotateAutonomousContainer 数据库加密密钥 | AUTONOMOUS_CONTAINER_DATABASE_UPDATE 和 AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 终止自治容器数据 | 终止自治容器数据库 | 在 Oracle Public Cloud 和多云上： CLOUD_EXADATA_INFRASTRUCTURE_UPDATE 和 CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE 以及 AUTONOMOUS_CONTAINER_DATABASE_DELETE 在 Exadata Cloud@Customer 上： EXADATA_INFRASTRUCTURE_UPDATE 和 AUTONOMOUS_VM_CLUSTER_UPDATE 以及 AUTONOMOUS_CONTAINER_DATABASE_DELETE |
| 获取自治容器数据库的资源使用情况统计信息 | GetAutonomousContainerDatabaseResourceUsage | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 查看自治容器数据库备份的列表 | ListAutonomousContainerDatabaseBackups | AUTONOMOUS_CONTAINER_DATABASE_BACKUP_INSPECT |
用于管理自治 AI 数据库的 API
下表列出了用于管理自治 AI 数据库的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
创建自治 AI 数据库 或者 克隆自治 AI 数据库 |
CreateAutonomousDatabase | AUTONOMOUS_DATABASE_CREATE |
| 查看自治 AI 数据库列表 | ListAutonomous Database | AUTONOMOUS_DATABASE_INSPECT |
| 查看自治 AI 数据库的详细信息 | 获取自治数据库 | 自治数据库检查 |
| 查看自治 AI 数据库支持的字符集列表。 | 列出自治数据库字符集 | 无 |
设置自治 AI 数据库 ADMIN 用户的密码 或者 扩展自治 AI 数据库的 CPU 核心计数或存储 或者 为自治 AI 数据库启用或禁用自动缩放 |
更新自治数据库 | AUTONOMOUS_DATABASE_UPDATE |
| 将自治 AI 数据库移至其他区间 | ChangeAutonomousDatabaseCompartment | AUTONOMOUS_DATABASE_UPDATE 和 AUTONOMOUS_DB_BACKUP_INSPECT 以及 AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE |
| 轮换自治 AI 数据库密钥 | RotateAutonomousDatabaseEncryptionKey | AUTONOMOUS_DATABASE_UPDATE |
| 启动自治 AI 数据库 | 启动自治数据库 | AUTONOMOUS_DATABASE_UPDATE |
| 停止自治 AI 数据库 | StopAutonomousDatabase | AUTONOMOUS_DATABASE_UPDATE |
| 重新启动自治 AI 数据库 | 重新启动自治数据库 | AUTONOMOUS_DATABASE_UPDATE |
| 终止自治 AI 数据库 | 删除自治数据库 | AUTONOMOUS_DATABASE_DELETE |
| 还原自治 AI 数据库 | 还原自治数据库 | AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE |
| 手动备份自治 AI 数据库 | 创建自治数据库备份 | AUTONOMOUS_DB_BACKUP_CREATE 和 AUTONOMOUS_DATABASE_CONTENT_READ |
| 查看自治 AI 数据库备份列表 | ListAutonomousDatabase 备份 | AUTONOMOUS_DB_BACKUP_INSPECT |
| 获取自治 AI 数据库备份的详细信息 | 获取自治数据库备份 | AUTONOMOUS_DB_BACKUP_INSPECT |
| 删除长期备份 | 删除自治数据库备份 | AUTONOMOUS_DB_BACKUP_DELETE |
| 更新长期备份的保留期 | 更新自治数据库备份 | AUTONOMOUS_DB_BACKUP_UPDATE |
用于管理 Autonomous Data Guard 配置的 API
下表列出了用于管理 Autonomous Data Guard 配置的 REST API 端点。
注：在下表中，第二列中列出的 REST API 端点已弃用，并替换为第三列中列出的新 API 端点。到 2026 年 3 月，将支持废弃的 API。之后，您只能使用新的 API 端点来管理 Autonomous Data Guard 配置。有关详细信息，请参阅知识库。
要使用下面列出的替换 API 将现有 Autonomous Data Guard 资源迁移到支持两个备用自治容器数据库 (ACD) 的新模型，请使用 MigrateAutonomousContainerDatabaseDataguardAssociation。有关完整详细信息，请参阅 MigrateAutonomousContainerDatabaseDataguardAssociation 。
| 操作 | API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 查看 Autonomous Data Guard 与 ACD 的关联。 | 获取自治容器数据库 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 列出启用了与指定 ACD 或 Autonomous AI Database 关联的 Autonomous Data Guard 的 ACD。 | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 将 "Disabled Standby"（禁用的备用）恢复为活动的备用 ACD。 | 恢复自治容器数据库数据卫士 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 切换主 ACD 和备用 ACD 的角色。 | 切换自治容器数据库数据卫士 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 故障转移到备用 ACD。当故障转移成功完成时，此备用 ACD 将成为新的主 ACD。 | 故障转移自治容器数据库数据卫士 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 修改 Autonomous Data Guard 设置，例如保护模式、自动故障转移和快速启动故障转移滞后限制。 | EditAutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 获取与指定自治 AI 数据库关联的启用了 Autonomous Data Guard 的数据库。 | 获取自治容器数据库 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 列出 Autonomous AI Database Data Guard 关联。 | 获取自治容器数据库 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 在 ACD 上启用 Autonomous Data Guard。 | AddStandbyAutonomousContainer 数据库 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 在物理备用 ACD 和快照备用 ACD 之间转换备用 ACD。 | ConvertStandbyAutonomousContainer 数据库 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
用于管理自治虚拟机的 API
下表列出了用于管理自治虚拟机的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 获取特定自治虚拟机的详细信息。 | 获取自治虚拟机 | 自治 _ 虚拟 _ 机器 _ 检查 |
| 列出指定自治 VM 集群和区间中的自治虚拟机。 | ListAutonomousVirtualMachine | 自治 _ 虚拟 _ 机器 _ 检查 |
用于管理自治 AI 数据库软件映像的 API
下表列出了用于管理自治 AI 数据库软件映像的 REST API 端点。
| 操作 | REST API 端点 | 必需的 IAM 权限 |
|---|---|---|
| 在指定的区间中创建自治 AI 数据库软件映像。 | CreateAutonomousDatabaseSoftwareImage | 自动 _DB_SOFTWARE_IMG_CREATE |
| 将自治 AI 数据库软件映像及其从属资源移至指定的区间。 | ChangeAutonomousDatabaseSoftwareImageCompartment | AUTO_DB_SOFTWARE_IMG_UPDATE |
| 删除自治 AI 数据库软件映像。 | DeleteAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_DELETE |
| 获取有关指定自治 AI 数据库软件映像的信息。 | 获取自治数据库软件映像 | AUTO_DB_SOFTWARE_IMG_INSPECT |
| 获取指定区间中的自治 AI 数据库软件映像列表。 | ListAutonomousDatabaseSoftware Image | AUTO_DB_SOFTWARE_IMG_INSPECT |
| 更新自治 AI 数据库软件映像的详细信息。 | 更新自治数据库软件映像 | AUTO_DB_SOFTWARE_IMG_UPDATE |