専用Exadataインフラストラクチャ上のAutonomous AI DatabaseのAPIリファレンス
APIを使用して、専用Exadataインフラストラクチャ上のAutonomous AI Databaseの様々なインフラストラクチャ・リソースを表示および管理できます。
APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。
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 |
Autonomous Exadata VMクラスタを管理するためのAPI
次の表に、Oracle Public CloudおよびマルチクラウドでAutonomous Exadata VMクラスタを管理するためのREST APIエンドポイントを示します、
| 操作 | REST APIエンドポイント | 必要なIAM権限 |
|---|---|---|
| Autonomous Exadata VMクラスタの作成 | CreateCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_CREATEおよびCLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Autonomous Exadata VMクラスタの詳細の表示 | GetCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| Autonomous Exadata VMクラスタのリストの表示 | ListCloudAutonomousVmClusters | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| 別のコンパートメントへのAutonomous Exadata VMクラスタの移動 | ChangeCloudAutonomousVmClusterCompartment | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECTおよびCLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Autonomous Exadata VMクラスタの終了 | DeleteCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_DELETE |
| ORDS証明書のローテーション | RotateCloudAutonomousVmClusterOrdsCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| SSL証明書のローテーション | RotateCloudAutonomousVmClusterSslCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Autonomous Exadata VMクラスタの詳細を更新します。このAPIを使用して、タグ、ライセンス・モデルまたはネットワーク・セキュリティ・グループ(NSG)を変更できます。 | UpdateCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Autonomous Exadata VMクラスタのリソース使用状況の詳細、およびその中のAutonomous Container Databaseの使用状況統計を取得します。 | AutonomousVMClusterResourceUsageの取得 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
次の表に、Exadata Cloud@CustomerのAutonomous Exadata VMクラスタを管理するためのREST APIエンドポイントを示します、
| 操作 | REST APIエンドポイント | 必要なIAM権限 |
|---|---|---|
| Autonomous Exadata VMクラスタの作成 | CreateAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_CREATE、EXADATA_INFRASTRUCTURE_INSPECTおよびEXADATA_INFRASTRUCTURE_UPDATE |
| Autonomous Exadata VMクラスタのリストの表示 | ListAutonomousVmClusters | AUTONOMOUS_VM_CLUSTER_INSPECT |
| Autonomous Exadata VMクラスタの詳細の表示 | GetAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_INSPECT |
| Autonomous Exadata VMクラスタのライセンス・タイプの変更 | UpdateAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_UPDATEとEXADATA_INFRASTRUCTURE_INSPECTとEXADATA_INFRASTRUCTURE_UPDATE |
| 別のコンパートメントへのAutonomous Exadata VMクラスタの移動 | ChangeAutonomousVmClusterCompartment | AUTONOMOUS_VM_CLUSTER_INSPECTおよびAUTONOMOUS_VM_CLUSTER_UPDATE |
| Autonomous Exadata VMクラスタの終了 | DeleteAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_DELETE |
Autonomous Container Databaseを管理するためのAPI
次の表に、Autonomous Container Databaseを管理するためのREST APIエンドポイントを示します。
| 操作 | REST APIエンドポイント | 必要なIAM権限 |
|---|---|---|
| Autonomous Container Databaseの作成 | CreateAutonomousContainerDatabase | Oracle Public CloudおよびMulticloudの場合: 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のリストの表示 | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| Autonomous Container Databaseの詳細の表示 | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
Autonomous Container Databaseのバックアップ保持ポリシーの変更 または Autonomous Container Databaseのメンテナンス・プリファレンスの編集 |
UpdateAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Autonomous Container Databaseの再起動 | RestartAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 別のコンパートメントへのAutonomous Container Databaseの移動 | ChangeAutonomousContainerDatabaseCompartment | AUTONOMOUS_CONTAINER_DATABASE_INSPECTとAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Autonomous Container Databaseキーのローテーション | AutonomousContainerDatabaseEncryptionKeyのローテーション | AUTONOMOUS_CONTAINER_DATABASE_UPDATEとAUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| Autonomous Container Databaseの終了 | TerminateAutonomousContainerDatabase | Oracle Public CloudおよびMulticloudの場合: 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のリソース使用状況統計の取得 | GetAutonomousContainerDatabaseResourceUsage | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| Autonomous Container Databaseバックアップのリストの表示 | リストAutonomousContainerDatabaseBackups | AUTONOMOUS_CONTAINER_DATABASE_BACKUP_INSPECT |
Autonomous AI Databaseを管理するためのAPI
次の表に、Autonomous AIデータベースを管理するためのREST APIエンドポイントを示します。
| 操作 | REST APIエンドポイント | 必要なIAM権限 |
|---|---|---|
Autonomous AI Databaseの作成 または Autonomous AI Databaseのクローニング |
CreateAutonomousDatabase | AUTONOMOUS_DATABASE_CREATE |
| Autonomous AIデータベースのリストの表示 | ListAutonomousDatabases | AUTONOMOUS_DATABASE_INSPECT |
| Autonomous AI Databaseの詳細の表示 | GetAutonomousDatabase | AUTONOMOUS_DATABASE_INSPECT |
| Autonomous AI Databaseでサポートされている文字セットのリストを表示します。 | ListAutonomousDatabaseCharacterSets | なし |
Autonomous AI DatabaseのADMINユーザーのパスワードの設定 または Autonomous AI DatabaseのCPUコア数またはストレージをスケーリングする または Autonomous AI Databaseの自動スケーリングの有効化または無効化 |
UpdateAutonomousDatabase | 自律型データベース更新 |
| 別のコンパートメントへのAutonomous AI Databaseの移動 | ChangeAutonomousDatabaseCompartment | AUTONOMOUS_DATABASE_UPDATE、AUTONOMOUS_DB_BACKUP_INSPECT、AUTONOMOUS_DB_BACKUP_CONTENT_READ、AUTONOMOUS_DATABASE_CONTENT_WRITE |
| Autonomous AI Databaseキーのローテーション | AutonomousDatabaseEncryptionKeyのローテーション | 自律型データベース更新 |
| Autonomous AI Databaseの起動 | StartAutonomousDatabase | 自律型データベース更新 |
| Autonomous AI Databaseの停止 | StopAutonomousDatabase | 自律型データベース更新 |
| Autonomous AI Databaseの再起動 | RestartAutonomousDatabase | 自律型データベース更新 |
| Autonomous AI Databaseの終了 | DeleteAutonomousDatabase | AUTONOMOUS_DATABASE_DELETE |
| Autonomous AI Databaseのリストア | RestoreAutonomousDatabase | AUTONOMOUS_DB_BACKUP_CONTENT_READとAUTONOMOUS_DATABASE_CONTENT_WRITE |
| Autonomous AI Databaseの手動バックアップ | CreateAutonomousDatabaseBackup | AUTONOMOUS_DB_BACKUP_CREATEとAUTONOMOUS_DATABASE_CONTENT_READ |
| Autonomous AI Databaseバックアップのリストの表示 | ListAutonomousDatabaseBackups | AUTONOMOUS_DB_BACKUP_INSPECT |
| Autonomous AI Databaseバックアップの詳細の取得 | AutonomousDatabaseBackupの取得 | AUTONOMOUS_DB_BACKUP_INSPECT |
| 長期のバックアップの削除 | AutonomousDatabaseBackupの削除 | 自律型データベース・バックアップ削除 |
| 長期バックアップの保存期間の更新 | AutonomousDatabaseBackupの更新 | AUTONOMOUS_DB_BACKUP_UPDATE |
Autonomous Data Guard構成を管理するためのAPI
次の表に、Autonomous Data Guard構成を管理するためのREST APIエンドポイントを示します。
ノート:次の表では、2番目の列にリストされているREST APIエンドポイントは非推奨になり、3番目の列にリストされている新しいAPIエンドポイントに置き換えられます。非推奨のAPIは2026年3月までサポートされ、その後はAutonomous Data Guard構成の管理に新規APIエンドポイントのみを使用できます。詳細は、ナレッジ・ベースを参照してください。
次に示す置換APIを使用して、2つのスタンバイAutonomous Container Database (ACD)をサポートする新しいモデルに既存のAutonomous Data Guardリソースを移行するには、MigrateAutonomousContainerDatabaseDataguardAssociationを使用します。詳細は、MigrateAutonomousContainerDatabaseDataguardAssociationを参照してください。
| 操作 | APIエンドポイント | 必要なIAM権限 |
|---|---|---|
| ACDとのAutonomous Data Guardアソシエーションを表示します。 | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 指定したACDまたはAutonomous AIデータベースに関連付けられたAutonomous Data Guardで有効になっているACDをリストします。 | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| 無効化されたスタンバイをアクティブ・スタンバイACDに回復します。 | AutonomousContainerDatabaseDataguardの回復 | AUTONOMOUS_CONTAINER_DATABASE_INSPECTとAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| プライマリACDとスタンバイACDのロールを切り替えます。 | スイッチオーバーAutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECTとAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| スタンバイACDにフェイルオーバーします。フェイルオーバーが正常に完了すると、このスタンバイACDが新しいプライマリACDになります。 | フェイルオーバーAutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECTとAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 保護モード、自動フェイルオーバー、ファスト・スタート・フェイルオーバーのラグ制限などのAutonomous Data Guard設定を変更します。 | AutonomousContainerDatabaseDataguardの編集 | AUTONOMOUS_CONTAINER_DATABASE_INSPECTとAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| 指定されたAutonomous AI Databaseに関連付けられたAutonomous Data Guard対応データベースを取得します。 | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| Autonomous AI Databaseのデータ・ガード・アソシエーションをリストします。 | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| ACDでAutonomous Data Guardを有効にします。 | スタンバイAutonomousContainerDatabaseの追加 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECTおよびAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| フィジカル・スタンバイACDとスナップショット・スタンバイACD間のスタンバイACDを変換します。 | StandbyAutonomousContainerDatabaseの変換 | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT、AUTONOMOUS_CONTAINER_DATABASE_INSPECTおよびAUTONOMOUS_CONTAINER_DATABASE_UPDATE |
Autonomous Virtual Machinesを管理するAPI
次の表は、Autonomous Virtual Machinesを管理するためのREST APIエンドポイントを示しています。
| 操作 | REST APIエンドポイント | 必要なIAM権限 |
|---|---|---|
| 特定のAutonomous Virtual Machineの詳細を取得します。 | 自律型仮想マシンの取得 | AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
| 指定されたAutonomous VMクラスタおよびコンパートメント内のAutonomous Virtual Machinesをリストします。 | 自律型仮想マシンのリスト | AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
Autonomous AI Databaseソフトウェア・イメージを管理するためのAPI
次の表は、Autonomous AI Databaseソフトウェア・イメージを管理するためのREST APIエンドポイントを示しています。
| 操作 | REST APIエンドポイント | 必要なIAM権限 |
|---|---|---|
| 指定されたコンパートメントにAutonomous AI Databaseソフトウェア・イメージを作成します。 | AutonomousDatabaseSoftwareImageの作成 | 自動データベース・ソフトウェア作成 |
| Autonomous AI Databaseソフトウェア・イメージとその依存リソースを、指定されたコンパートメントに移動します。 | 自律データベース・ソフトウェア・イメージ・コンパートメントの変更 | 自動データベース・ソフトウェア更新 |
| Autonomous AI Databaseソフトウェア・イメージを削除します。 | AutonomousDatabaseSoftwareImageの削除 | 自動DB_ソフトウェア_IMG_DELETE |
| 指定されたAutonomous AI Databaseソフトウェア・イメージに関する情報を取得します。 | 自律データベースソフトウェアイメージの取得 | 自動DB_ソフトウェア_IMG_INSPECT |
| 指定されたコンパートメント内のAutonomous AI Databaseソフトウェア・イメージのリストを取得します。 | 自律型データベース・ソフトウェア・イメージのリスト | 自動DB_ソフトウェア_IMG_INSPECT |
| Autonomous AI Databaseソフトウェア・イメージの詳細を更新します。 | AutonomousDatabaseSoftwareImageの更新 | 自動データベース・ソフトウェア更新 |