专用 Exadata 基础结构上 Autonomous Database 的 API 参考

您可以使用 API 查看和管理基于专用 Exadata 基础设施的 Autonomous Database 的不同基础设施资源。

有关使用 API 和签名请求的信息，请参阅 REST API 和安全身份证明。有关 SDK 的信息，请参见 Software Development Kits and Command Line Interface 。

相关主题

用于管理 Exadata 基础结构资源的 API

下表列出了用于管理 Oracle Public Cloud 和多云上的 Exadata 基础结构资源的 REST API 端点。
操作 REST API 端点 所需的 IAM 权限

创建 Exadata 基础结构资源

CreateCloudExadataInfrastructure

CLOUD_EXADATA_INFRASTRUCTURE_CREATE

VNIC_CREATE

SUBNET_ATTACH

VNIC_ATTACH

查看 Exadata 基础结构资源列表

ListCloudExadataInfrastructures

CLOUD_EXADATA_INFRASTRUCTURE_INSPECT

查看 Exadata 基础结构资源的详细信息

GetCloudExadataInfrastructure

CLOUD_EXADATA_INFRASTRUCTURE_INSPECT

更新 Exadata 基础结构资源的详细信息。您可以使用此 API 更新计算、存储、联系人、标记和维护窗口。

UpdateCloudExadataInfrastructure

CLOUD_EXADATA_INFRASTRUCTURE_UPDATE

将 Exadata 基础结构资源移至其他区间

ChangeCloudExadataInfrastructureCompartment

CLOUD_EXADATA_INFRASTRUCTURE_UPDATE

终止 Exadata 基础结构资源

DeleteCloudExadataInfrastructure

CLOUD_EXADATA_INFRASTRUCTURE_DELETE

VNIC_DELETE

SUBNET_DETACH

VNIC_DETACH
下表列出了用于管理 Exadata Cloud@Customer 上的 Exadata 基础结构资源的 REST API 端点。
操作 REST API 端点 所需的 IAM 权限

创建 Exadata 基础结构资源

CreateExadataInfrastructure

EXADATA_INFRASTRUCTURE_CREATE

查看 Exadata 基础结构资源列表

ListExadataInfrastructures

EXADATA_INFRASTRUCTURE_INSPECT

查看 Exadata 基础结构资源的详细信息

GetExadataInfrastructure

EXADATA_INFRASTRUCTURE_INSPECT

更新 Exadata 基础结构资源的详细信息。您可以使用此 API 更新计算、存储、联系人、标记和维护窗口。

UpdateExadataInfrastructure

EXADATA_INFRASTRUCTURE_UPDATE

将 Exadata 基础结构资源移至其他区间

ChangeExadataInfrastructureCompartment

EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE

终止 Exadata 基础结构资源

DeleteExadataInfrastructure

EXADATA_INFRASTRUCTURE_DELETE

下载 Exadata 基础结构资源配置文件

DownloadExadataInfrastructureConfigFile

EXADATA_INFRASTRUCTURE_CONTENT_READ

向 Exadata 基础结构添加存储容量

AddStorageCapacityExadataInfrastructure

EXADATA_INFRASTRUCTURE_UPDATE

激活 Exadata 基础结构

ActivateExadataInfrastructure

EXADATA_INFRASTRUCTURE_UPDATE

用于管理自治 Exadata VM 集群的 API

下表列出了用于管理 Oracle Public Cloud 和 Multicloud 上的自治 Exadata VM 集群的 REST API 端点。
操作 REST API 端点 所需的 IAM 权限

创建自治 Exadata VM 集群

CreateCloudAutonomousVmCluster

CLOUD_AUTONOMOUS_VM_CLUSTER_CREATE 和 CLOUD_EXADATA_INFRASTRUCTURE_UPDATE

查看自治 Exadata VM 集群的详细信息

GetCloudAutonomousVmCluster

CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT

查看自治 Exadata VM 集群列表

ListCloudAutonomousVmClusters

CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT

将自治 Exadata VM 集群移至其他区间

ChangeCloudAutonomousVmClusterCompartment

CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT 和 CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE

终止自治 Exadata VM 集群

DeleteCloudAutonomousVmCluster

CLOUD_AUTONOMOUS_VM_CLUSTER_DELETE

轮换 ORDS 证书

RotateCloudAutonomousVmClusterOrdsCerts

CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE

轮换 SSL 证书

RotateCloudAutonomousVmClusterSslCerts

CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE

更新自治 Exadata VM 集群的详细信息。您可以使用此 API 修改标记、许可证模型或网络安全组 (NSG)。

UpdateCloudAutonomousVmCluster

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 集群

CreateAutonomousVmCluster

 AUTONOMOUS_VM_CLUSTER_CREATE、EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE

查看自治 Exadata VM 集群列表

ListAutonomousVmClusters

AUTONOMOUS_VM_CLUSTER_INSPECT

查看自治 Exadata VM 集群的详细信息

GetAutonomousVmCluster

AUTONOMOUS_VM_CLUSTER_INSPECT

更改自治 Exadata VM 集群的许可证类型

UpdateAutonomousVmCluster

AUTONOMOUS_VM_CLUSTER_UPDATE、EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE

将自治 Exadata VM 集群移至其他区间

ChangeAutonomousVmClusterCompartment

AUTONOMOUS_VM_CLUSTER_INSPECT 和 AUTONOMOUS_VM_CLUSTER_UPDATE

终止自治 Exadata VM 集群

DeleteAutonomousVmCluster

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

查看自治容器数据库的详细信息

GetAutonomousContainerDatabase

AUTONOMOUS_CONTAINER_DATABASE_INSPECT

更改自治容器数据库的备份保留策略

或者

编辑自治容器数据库的维护首选项

UpdateAutonomousContainerDatabase

AUTONOMOUS_CONTAINER_DATABASE_UPDATE

重新启动自治容器数据库

RestartAutonomousContainerDatabase

AUTONOMOUS_CONTAINER_DATABASE_UPDATE

将自治容器数据库移至其他区间

ChangeAutonomousContainerDatabaseCompartment

AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE

轮换自治容器数据库密钥

RotateAutonomousContainerDatabaseEncryptionKey

AUTONOMOUS_CONTAINER_DATABASE_UPDATE 和 AUTONOMOUS_CONTAINER_DATABASE_INSPECT

终止自治容器数据库

TerminateAutonomousContainerDatabase

在 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

用于管理自治数据库的 API

下表列出了用于管理自治数据库的 REST API 端点。

操作 REST API 端点 所需的 IAM 权限

创建自治数据库

或者

克隆自治数据库

CreateAutonomousDatabase

AUTONOMOUS_DATABASE_CREATE

查看自治数据库列表

ListAutonomousDatabases

AUTONOMOUS_DATABASE_INSPECT

查看 Autonomous Database 的详细信息

GetAutonomousDatabase

AUTONOMOUS_DATABASE_INSPECT

查看 Autonomous Database 支持的字符集列表。

ListAutonomousDatabaseCharacterSets

无

设置 Autonomous Database ADMIN 用户的密码

或者

扩展 Autonomous Database 的 CPU 核心数或存储

或者

为 Autonomous Database 启用或禁用自动缩放

UpdateAutonomousDatabase

AUTONOMOUS_DATABASE_UPDATE

将 Autonomous Database 移至其他区间

ChangeAutonomousDatabaseCompartment

AUTONOMOUS_DATABASE_UPDATE 和 AUTONOMOUS_DB_BACKUP_INSPECT 以及 AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE

轮换 Autonomous Database 密钥

RotateAutonomousDatabaseEncryptionKey

AUTONOMOUS_DATABASE_UPDATE

启动 Autonomous Database

StartAutonomousDatabase

AUTONOMOUS_DATABASE_UPDATE

停止 Autonomous Database

StopAutonomousDatabase

AUTONOMOUS_DATABASE_UPDATE

重新启动 Autonomous Database

RestartAutonomousDatabase

AUTONOMOUS_DATABASE_UPDATE

终止 Autonomous Database

DeleteAutonomousDatabase

AUTONOMOUS_DATABASE_DELETE

恢复 Autonomous Database

RestoreAutonomousDatabase

AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE

手动备份 Autonomous Database

CreateAutonomousDatabaseBackup

AUTONOMOUS_DB_BACKUP_CREATE 和 AUTONOMOUS_DATABASE_CONTENT_READ

查看 Autonomous Database 备份的列表

ListAutonomousDatabaseBackups

AUTONOMOUS_DB_BACKUP_INSPECT

获取 Autonomous Database 备份的详细信息

GetAutonomousDatabaseBackup

AUTONOMOUS_DB_BACKUP_INSPECT

删除长期备份

DeleteAutonomousDatabaseBackup

AUTONOMOUS_DB_BACKUP_DELETE

更新长期备份的保留期

UpdateAutonomousDatabaseBackup

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 关联。

GetAutonomousContainerDatabaseDataguardAssociation

GetAutonomousContainerDatabase

AUTONOMOUS_CONTAINER_DATABASE_INSPECT

列出使用与指定 ACD 或 Autonomous Database 关联的 Autonomous Data Guard 启用的 ACD。

ListAutonomousContainerDatabaseDataguardAssociations

ListAutonomousContainerDatabases

AUTONOMOUS_CONTAINER_DATABASE_INSPECT

将禁用的备用数据库恢复到活动的备用 ACD。

ReinstateAutonomousContainerDatabaseDataguardAssociation

ReinstateAutonomousContainerDatabaseDataguard

AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE

主 ACD 和备用 ACD 的切换角色。

SwitchoverAutonomousContainerDatabaseDataguardAssociation

SwitchoverAutonomousContainerDatabaseDataguard

AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE

故障转移到备用 ACD。当故障转移成功完成时，此备用 ACD 将成为新的主 ACD。

FailoverAutonomousContainerDatabaseDataguardAssociation

FailoverAutonomousContainerDatabaseDataguard

AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE

修改 Autonomous Data Guard 设置，例如保护模式、自动故障转移和快速启动故障转移滞后限制。

UpdateAutonomousContainerDatabaseDataguardAssociation

EditAutonomousContainerDatabaseDataguard

AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE

获取与指定的 Autonomous Database 关联的启用 Autonomous Data Guard 的数据库

GetAutonomousDatabaseDataguardAssociation

GetAutonomousContainerDatabase

AUTONOMOUS_CONTAINER_DATABASE_INSPECT

列出 Autonomous Database Data Guard 关联。

ListAutonomousDatabaseDataguardAssociations

GetAutonomousContainerDatabase

AUTONOMOUS_CONTAINER_DATABASE_INSPECT
在 ACD 上启用 Autonomous Data Guard。

CreateAutonomousContainerDatabaseDataguardAssociation

AddStandbyAutonomousContainerDatabase

CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE
在物理备用 ACD 和快照备用 ACD 之间转换备用 ACD。

ChangeDataguardRole

ConvertStandbyAutonomousContainerDatabase

CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE

用于管理自治虚拟机的 API

下表列出了用于管理自治虚拟机的 REST API 端点。

操作 REST API 端点 所需的 IAM 权限

获取特定自治虚拟机的详细信息。

GetAutonomousVirtualMachine

AUTONOMOUS_VIRTUAL_MACHINE_INSPECT

列出指定自治 VM 集群和区间中的自治虚拟机。

ListAutonomousVirtualMachines

AUTONOMOUS_VIRTUAL_MACHINE_INSPECT

用于管理 Autonomous Database Software Image 的 API

下表列出了用于管理 Autonomous Database 软件映像的 REST API 端点。

操作 REST API 端点 所需的 IAM 权限
在指定区间中创建 Autonomous Database 软件映像。 CreateAutonomousDatabaseSoftwareImage AUTO_DB_SOFTWARE_IMG_CREATE
将 Autonomous Database 软件映像及其从属资源移至指定的区间。 ChangeAutonomousDatabaseSoftwareImageCompartment AUTO_DB_SOFTWARE_IMG_UPDATE
删除 Autonomous Database 软件映像。 DeleteAutonomousDatabaseSoftwareImage AUTO_DB_SOFTWARE_IMG_DELETE
获取有关指定 Autonomous Database 软件映像的信息。 GetAutonomousDatabaseSoftwareImage AUTO_DB_SOFTWARE_IMG_INSPECT
获取指定区间中 Autonomous Database 软件映像的列表。 ListAutonomousDatabaseSoftwareImages AUTO_DB_SOFTWARE_IMG_INSPECT
更新 Autonomous Database 软件映像的详细信息。 UpdateAutonomousDatabaseSoftwareImage AUTO_DB_SOFTWARE_IMG_UPDATE