专用 Exadata 基础结构上自治 AI 数据库的 API 参考
您可以使用 API 查看和管理 Autonomous AI Database on Dedicated Exadata Infrastructure 的不同基础结构资源。
有关使用 API 和签名请求的信息，请参阅 REST API 和安全身份证明。有关 SDK 的信息，请参见 Software Development Kits and Command Line Interface 。
相关主题
用于管理 Exadata 基础结构资源的 API
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
创建 Exadata 基础结构资源 |
CLOUD_EXADATA_INFRASTRUCTURE_CREATE VNIC_CREATE SUBNET_ATTACH VNIC_ATTACH |
|
|
查看 Exadata 基础结构资源列表 |
CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
|
|
查看 Exadata 基础结构资源的详细信息 |
CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
|
|
更新 Exadata 基础结构资源的详细信息。您可以使用此 API 更新计算、存储、联系人、标记和维护窗口。 |
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
|
|
将 Exadata 基础结构资源移至其他区间 |
CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
|
|
终止 Exadata 基础结构资源 |
CLOUD_EXADATA_INFRASTRUCTURE_DELETE VNIC_DELETE SUBNET_DETACH VNIC_DETACH |
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
创建 Exadata 基础结构资源 |
EXADATA_INFRASTRUCTURE_CREATE |
|
|
查看 Exadata 基础结构资源列表 |
EXADATA_INFRASTRUCTURE_INSPECT |
|
|
查看 Exadata 基础结构资源的详细信息 |
EXADATA_INFRASTRUCTURE_INSPECT |
|
|
更新 Exadata 基础结构资源的详细信息。您可以使用此 API 更新计算、存储、联系人、标记和维护窗口。 |
EXADATA_INFRASTRUCTURE_UPDATE |
|
|
将 Exadata 基础结构资源移至其他区间 |
EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
|
|
终止 Exadata 基础结构资源 |
EXADATA_INFRASTRUCTURE_DELETE |
|
|
下载 Exadata 基础结构资源配置文件 |
EXADATA_INFRASTRUCTURE_CONTENT_READ |
|
|
向 Exadata 基础结构添加存储容量 |
EXADATA_INFRASTRUCTURE_UPDATE |
|
|
激活 Exadata 基础结构 |
EXADATA_INFRASTRUCTURE_UPDATE |
用于管理自治 Exadata VM 集群的 API
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
创建自治 Exadata VM 集群 |
CLOUD_AUTONOMOUS_VM_CLUSTER_CREATE 和 CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
|
|
查看自治 Exadata VM 集群的详细信息 |
CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
|
|
查看自治 Exadata VM 集群列表 |
CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
|
|
将自治 Exadata VM 集群移至其他区间 |
CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT 和 CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
|
|
终止自治 Exadata VM 集群 |
CLOUD_AUTONOMOUS_VM_CLUSTER_DELETE |
|
|
轮换 ORDS 证书 |
CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
|
|
轮换 SSL 证书 |
CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
|
|
更新自治 Exadata VM 集群的详细信息。您可以使用此 API 修改标记、许可证模型或网络安全组 (NSG)。 |
CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
|
|
获取自治 Exadata VM 集群的资源使用情况详细信息及其内部自治容器数据库的使用情况统计信息。 |
CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
下表列出了用于管理 Exadata Cloud@Customer 上的自治 Exadata VM 集群的 REST API 端点。
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
创建自治 Exadata VM 集群 |
AUTONOMOUS_VM_CLUSTER_CREATE、EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE | |
|
查看自治 Exadata VM 集群列表 |
AUTONOMOUS_VM_CLUSTER_INSPECT |
|
|
查看自治 Exadata VM 集群的详细信息 |
AUTONOMOUS_VM_CLUSTER_INSPECT |
|
|
更改自治 Exadata VM 集群的许可证类型 |
AUTONOMOUS_VM_CLUSTER_UPDATE、EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
|
|
将自治 Exadata VM 集群移至其他区间 |
AUTONOMOUS_VM_CLUSTER_INSPECT 和 AUTONOMOUS_VM_CLUSTER_UPDATE |
|
|
终止自治 Exadata VM 集群 |
AUTONOMOUS_VM_CLUSTER_DELETE |
用于管理自治容器数据库的 API
下表列出了用于管理自治容器数据库的 REST API 端点。
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
创建自治容器数据库 |
在 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 |
|
|
查看自治容器数据库列表 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
|
|
查看自治容器数据库的详细信息 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
|
|
更改自治容器数据库的备份保留策略 或者 编辑自治容器数据库的维护首选项 |
AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
|
|
重新启动自治容器数据库 |
AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
|
|
将自治容器数据库移至其他区间 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
|
|
轮换自治容器数据库密钥 |
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 |
|
|
获取自治容器数据库的资源使用情况统计信息 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
|
|
查看自治容器数据库备份的列表 |
AUTONOMOUS_CONTAINER_DATABASE_BACKUP_INSPECT |
用于管理自治 AI 数据库的 API
下表列出了用于管理 Autonomous AI Database 的 REST API 端点。
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
创建自治 AI 数据库 或者 克隆自治 AI 数据库 |
AUTONOMOUS_DATABASE_CREATE |
|
|
查看 Autonomous AI Database 列表 |
AUTONOMOUS_DATABASE_INSPECT |
|
|
查看自治 AI 数据库的详细信息 |
AUTONOMOUS_DATABASE_INSPECT |
|
|
查看 Autonomous AI Database 支持的字符集列表。 |
无 |
|
|
设置自治 AI 数据库的 ADMIN 用户的密码 或者 扩展 自治 AI 数据库的 CPU 核心计数或存储 或者 为自治 AI 数据库启用或禁用自动缩放 |
AUTONOMOUS_DATABASE_UPDATE |
|
|
将自治 AI 数据库移至其他区间 |
AUTONOMOUS_DATABASE_UPDATE 和 AUTONOMOUS_DB_BACKUP_INSPECT 以及 AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE |
|
|
轮换自治 AI 数据库密钥 |
AUTONOMOUS_DATABASE_UPDATE |
|
|
启动自治 AI 数据库 |
AUTONOMOUS_DATABASE_UPDATE |
|
|
停止自治 AI 数据库 |
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 数据库备份列表 |
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 。
| 操作 | 已废弃 REST API 端点 | 替换 API 端点 | 所需的 IAM 权限 |
|---|---|---|---|
|
查看与 ACD 的 Autonomous Data Guard 关联。 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
||
|
列出启用了与指定 ACD 或 Autonomous AI Database 关联的 Autonomous Data Guard 的 ACD。 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
||
|
将禁用的备用数据库恢复到活动的备用 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 设置，例如保护模式、自动故障转移和快速启动故障转移滞后限制。 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
||
|
获取与指定的 Autonomous AI Database 关联的启用了 Autonomous Data Guard 的数据库。 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
||
|
列出 Autonomous AI Database Data Guard 关联。 |
AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
||
| 在 ACD 上启用 Autonomous Data Guard。 |
CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
||
| 在物理备用 ACD 和快照备用 ACD 之间转换备用 ACD。 |
CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
用于管理自治虚拟机的 API
下表列出了用于管理自治虚拟机的 REST API 端点。
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
|
获取特定自治虚拟机的详细信息。 |
AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
|
|
列出指定自治 VM 集群和区间中的自治虚拟机。 |
AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
用于管理 Autonomous AI Database Software Image 的 API
下表列出了用于管理自治 AI 数据库软件映像的 REST API 端点。
| 操作 | REST API 端点 | 所需的 IAM 权限 |
|---|---|---|
| 在指定区间中创建自治 AI 数据库软件映像。 | CreateAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_CREATE |
| 将 Autonomous AI Database Software Image 及其从属资源移至指定的区间。 | ChangeAutonomousDatabaseSoftwareImageCompartment | AUTO_DB_SOFTWARE_IMG_UPDATE |
| 删除自治 AI 数据库软件映像。 | DeleteAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_DELETE |
| 获取有关指定 Autonomous AI Database 软件映像的信息。 | GetAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_INSPECT |
| 获取指定区间中的自治 AI 数据库软件映像列表。 | ListAutonomousDatabaseSoftwareImages | AUTO_DB_SOFTWARE_IMG_INSPECT |
| 更新 Autonomous AI Database 软件映像的详细信息。 | UpdateAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_UPDATE |