專用 Exadata 基礎架構上自治式 AI 資料庫的 API 參考資料
您可以使用 API 檢視及管理專用 Exadata 基礎架構上自治式 AI 資料庫的不同基礎架構資源。
如需有關使用 API 和簽署要求的資訊，請參閱 REST API 和安全證明資料。如需 SDK 的相關資訊，請參閱軟體開發套件與命令行介面。
管理 Exadata 基礎架構資源的 API
下表列出管理 Oracle Public Cloud 和多雲端上 Exadata 基礎架構資源的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 建立 Exadata 基礎架構資源 | 建立雲端 ExadataInfrastructure | CLOUD_EXADATA_ 基礎架構 _ 建立 種族建立 子網路附加 種族附件 |
| 檢視 Exadata 基礎架構資源清單 | 列出雲端 Exadata 基礎架構 | 雲端中繼資料基礎建設檢查 |
| 檢視 Exadata 基礎架構資源詳細資訊 | 取得 CloudExadataInfrastructure | 雲端中繼資料基礎建設檢查 |
| 更新 Exadata 基礎架構資源詳細資訊。您可以使用此 API 來更新運算、儲存、聯絡人、標記以及維護時段。 | 更新雲端 ExadataInfrastructure | CLOUD_EXADATA_ 基礎建設 _ 更新 |
| 將 Exadata 基礎架構資源搬移至其他區間 | ChangeCloudExadataInfrastructure 區間 | CLOUD_EXADATA_ 基礎建設 _ 更新 |
| 終止 Exadata 基礎架構資源 | 刪除 CloudExadataInfrastructure | CLOUD_EXADATA_ 基礎建設 _ 刪除 刪除種族 子網路分離 種族分離 |
下表列出管理 Exadata Cloud@Customer 上 Exadata 基礎架構資源的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 建立 Exadata 基礎架構資源 | 建立 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_ 建立 |
| 檢視 Exadata 基礎架構資源清單 | 列出 ExadataInfrastruct | EXADATA_INFRASTRUCTURE_ 檢查 |
| 檢視 Exadata 基礎架構資源詳細資訊 | 取得 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_ 檢查 |
| 更新 Exadata 基礎架構資源詳細資訊。您可以使用此 API 來更新運算、儲存、聯絡人、標記以及維護時段。 | 更新 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_ 更新 |
| 將 Exadata 基礎架構資源搬移至其他區間 | 變更 ExadataInfrastructure 區間 | EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
| 終止 Exadata 基礎架構資源 | 刪除 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_ 刪除 |
| 下載 Exadata 基礎架構資源組態檔 | 下載 ExadataInfrastructureConfigFile | EXADATA_ 基礎建設 _ 內容 _ 閱讀 |
| 新增 Exadata 基礎架構的儲存容量 | 新增儲存體容量 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_ 更新 |
| 啟用 Exadata 基礎架構 | 啟用 ExadataInfrastructure | EXADATA_INFRASTRUCTURE_ 更新 |
用於管理自治式 Exadata VM 叢集的 API
下表列出管理 Oracle Public Cloud 和多雲上自治式 Exadata VM 叢集的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 建立自治式 Exadata VM 叢集中 | 建立雲端自治式 VM 叢集 | CLOUD_AUTONOMOUS_VM_CLUSTER_CREATE 和 CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| 檢視自治式 Exadata VM 叢集的詳細資訊 | 取得雲端自治式 VM 叢集 | 雲端自主檢視叢集檢查 |
| 檢視自治式 Exadata VM 叢集清單 | 清單雲端自治式 VM 叢集 | 雲端自主檢視叢集檢查 |
| 將自治式 Exadata VM 叢集搬移至其他區間 | 變更雲端自治式 VM 叢集區間 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT 和 CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| 終止自治式 Exadata VM 叢集中 | 刪除雲端自治式 VM 叢集 | 雲端自主檢視叢集刪除 |
| 輪換 ORDS 證書 | 輪換 CloudAutonomousVmClusterOrdsCerts | 雲端自治式檢視叢集更新 |
| 輪換 SSL 證書 | 輪換 CloudAutonomousVmClusterSslCerts | 雲端自治式檢視叢集更新 |
| 更新自治式 Exadata VM 叢集的詳細資訊。您可以使用此 API 修改標記、授權模型或網路安全群組 (NSG)。 | 更新雲端自治式 VM 叢集 | 雲端自治式檢視叢集更新 |
| 取得自治式 Exadata VM 叢集的資源使用狀況詳細資訊，以及自治式容器資料庫的使用狀況統計資料。 | 取得自治式 VMCluster 資源用量 | 雲端自主檢視叢集檢查 |
下表列出管理 Exadata Cloud@Customer 上自治式 Exadata VM 叢集的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 建立自治式 Exadata VM 叢集中 | 建立自治式 VM 叢集 | AUTONOMOUS_VM_CLUSTER_CREATE 和 EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
| 檢視自治式 Exadata VM 叢集清單 | 清單自治式 VM 叢集 | 自治式 VM 叢集檢查 |
| 檢視自治式 Exadata VM 叢集的詳細資訊 | 取得自治式 VM 叢集 | 自治式 VM 叢集檢查 |
| 變更自治式 Exadata VM 叢集的授權類型 | 更新自治式 VM 叢集 | AUTONOMOUS_VM_CLUSTER_UPDATE 和 EXADATA_INFRASTRUCTURE_INSPECT 和 EXADATA_INFRASTRUCTURE_UPDATE |
| 將自治式 Exadata VM 叢集搬移至其他區間 | 變更自治式 VM 叢集區間 | AUTONOMOUS_VM_CLUSTER_INSPECT 和 AUTONOMOUS_VM_CLUSTER_UPDATE |
| 終止自治式 Exadata VM 叢集中 | 刪除自治式 VM 叢集 | 自治式 VM 叢集刪除 |
管理自治式容器資料庫的 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_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 |
| 取得自治式容器資料庫的資源使用狀況統計資料 | 取得自治式容器資料庫資源用量 | 自治式容器資料庫檢查 |
| 檢視自治式容器資料庫備份清單 | 清單自治式容器資料庫備份 | 自治式容器資料庫備份檢查 |
管理自治式 AI 資料庫的 API
下表列出管理自治式 AI 資料庫的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
建立自治式 AI 資料庫 或 複製自治式 AI 資料庫 |
建立自治式資料庫 | 自治式資料庫建立 |
| 檢視自治式 AI 資料庫清單 | 清單自治式資料庫 | 自治式資料庫檢查 |
| 檢視自治式 AI 資料庫的詳細資訊 | 取得自治式資料庫 | 自治式資料庫檢查 |
| 檢視自治式 AI 資料庫支援的字元集清單。 | 清單自治式資料庫字元集 | 無。 |
設定自治式 AI 資料庫 ADMIN 使用者的密碼 或 調整自治式 AI 資料庫的 CPU 核心數目或儲存 或 啟用或停用自治式 AI 資料庫的自動調整功能 |
更新自治式資料庫 | 更新自治式資料庫 |
| 將自治式 AI 資料庫搬移至其他區間 | 變更自治式資料庫區間 | AUTONOMOUS_DATABASE_UPDATE 和 AUTONOMOUS_DB_BACKUP_INSPECT 和 AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE |
| 輪換自治式 AI 資料庫金鑰 | 輪換自治式資料庫加密金鑰 | 更新自治式資料庫 |
| 啟動自治式 AI 資料庫 | 啟動自治式資料庫 | 更新自治式資料庫 |
| 停止自治式 AI 資料庫 | 停止自治式資料庫 | 更新自治式資料庫 |
| 重新啟動自治式 AI 資料庫 | 重新啟動自治式資料庫 | 更新自治式資料庫 |
| 終止自治式 AI 資料庫 | 刪除自治式資料庫 | 自治式資料庫刪除 |
| 回復自治式 AI 資料庫 | 回復自治式資料庫 | AUTONOMOUS_DB_BACKUP_CONTENT_READ 和 AUTONOMOUS_DATABASE_CONTENT_WRITE |
| 手動備份自治式 AI 資料庫 | 建立自治式資料庫備份 | AUTONOMOUS_DB_BACKUP_CREATE 和 AUTONOMOUS_DATABASE_CONTENT_READ |
| 檢視自治式 AI 資料庫備份清單 | 列出自治式資料庫備份 | 自治資料庫備份檢查 |
| 取得自治式 AI 資料庫備份的詳細資訊 | 取得自治式資料庫備份 | 自治資料庫備份檢查 |
| 刪除長期備份 | 刪除自治式資料庫備份 | 刪除自治式資料庫備份 |
| 更新長期備份的保留期間 | 更新自治式資料庫備份 | 更新自治式資料庫備份 |
管理自治式資料保全組態的 API
下表列出管理自治式資料保全組態的 REST API 端點。
注意：下表中的第二欄所列的 REST API 端點已不再使用，並取代為第三欄所列的新 API 端點。已不再使用的 API 將於 2026 年 3 月前提供支援，之後您只能使用新的 API 端點管理自治式資料保全組態。如需詳細資訊，請參閱知識庫。
若要使用下方所列的取代 API 將現有的 Autonomous Data Guard 資源移轉至支援兩個待命自治式容器資料庫 (ACD) 的新模型，請使用 MigrateAutonomousContainerDatabaseDataguardAssociation。如需完整詳細資訊，請參閱 MigrateAutonomousContainerDatabaseDataguardAssociation 。
| 操作 | API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 檢視與 ACD 的自治式資料保全關聯。 | 取得自治式容器資料庫 | 自治式容器資料庫檢查 |
| 列出已啟用與指定 ACD 或自治式 AI 資料庫關聯之自治式資料保全的 ACD。 | 清單自治式容器資料庫 | 自治式容器資料庫檢查 |
| 將「停用的待命」恢復成作用中的待命 ACD。 | 恢復自治式容器資料庫資料保全 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 主要和待命 ACD 的「切換角色」。 | 切換自治式容器資料庫資料保全 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 容錯移轉至待命 ACD。容錯移轉順利完成時，此待命 ACD 將會成為新的主要 ACD。 | FailoverAutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 修改自治式資料保全設定值，例如保護模式、自動容錯移轉以及快速啟動容錯移轉延遲限制。 | 編輯自治式容器資料庫資料保全 | AUTONOMOUS_CONTAINER_DATABASE_INSPECT 和 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 取得與指定自治式 AI 資料庫關聯的啟用自治式資料保全資料庫。 | 取得自治式容器資料庫 | 自治式容器資料庫檢查 |
| 列出自治式 AI 資料庫資料保全關聯。 | 取得自治式容器資料庫 | 自治式容器資料庫檢查 |
| 對 ACD 啟用自治式資料保全。 | 新增待命資料庫自治式容器資料庫 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 及 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 在實體待命和快照待命 ACD 之間轉換待命 ACD。 | 轉換待命自治式容器資料庫 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECT 及 AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
管理自治式虛擬機器的 API
下表列出管理自治式虛擬機器的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 取得特定自治式虛擬機器的詳細資訊。 | 取得自治式虛擬機器 | 自治式虛擬機器檢查 |
| 列出指定自治式 VM 叢集和區間中的自治式虛擬機器。 | 清單自治式虛擬機器 | 自治式虛擬機器檢查 |
管理自治式 AI 資料庫軟體映像檔的 API
下表列出管理自治式 AI 資料庫軟體映像檔的 REST API 端點。
| 操作 | REST API 端點 | 必要的 IAM 權限 |
|---|---|---|
| 在指定的區間中建立自治式 AI 資料庫軟體映像檔。 | 建立自治式資料庫軟體映像檔 | 自動建立資料庫軟體映像檔 |
| 將自治式 AI 資料庫軟體映像檔與其相依資源搬移至指定的區間。 | 變更自治式資料庫軟體映像檔區間 | 自動更新資料庫軟體影像檔 |
| 刪除自治式 AI 資料庫軟體映像檔。 | 刪除自治式資料庫軟體影像 | 自動刪除資料庫軟體圖示 |
| 取得指定之自治式 AI 資料庫軟體映像檔的相關資訊。 | 取得自治式資料庫軟體影像 | 自動檢查資料庫軟體影像檔 |
| 取得指定區間中的自治式 AI 資料庫軟體映像檔清單。 | 清單自治式資料庫軟體影像 | 自動檢查資料庫軟體影像檔 |
| 更新自治式 AI 資料庫軟體映像檔的詳細資訊。 | 更新自治式資料庫軟體影像 | 自動更新資料庫軟體影像檔 |