API-Referenz für Autonomous AI Database on Dedicated Exadata Infrastructure
Mit der API können Sie die verschiedenen Infrastrukturressourcen einer autonomen KI-Datenbank auf einer dedizierten Exadata-Infrastruktur anzeigen und verwalten.
Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-APIs und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter Software Development Kits und Befehlszeilenschnittstelle (CLI).
API zur Verwaltung von Exadata-Infrastrukturressourcen
In der folgenden Tabelle sind die REST-API-Endpunkte zum Verwalten von Exadata-Infrastrukturressourcen in Oracle Public Cloud und Multicloud aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Exadata-Infrastrukturressource erstellen | CreateCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_CREATE VNIC_CREATE SUBNET_ATTACH VNIC_ATTACH |
| Liste der Exadata-Infrastrukturressourcen anzeigen | ListCloudExadataInfrastructures | CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
| Details einer Exadata-Infrastrukturressource anzeigen | GetCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
| Details einer Exadata-Infrastrukturressource aktualisieren. Mit dieser API können Sie Compute, Speicher, Kontakte, Tags und Wartungsfenster aktualisieren. | UpdateCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Exadata-Infrastrukturressource in ein anderes Compartment verschieben | ChangeCloudExadataInfrastructureCompartment | CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Exadata-Infrastrukturressource beenden | DeleteCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_DELETE VNIC_DELETE SUBNET_DETACH VNIC_DETACH |
in der folgenden Tabelle sind die REST-API-Endpunkte zur Verwaltung von Exadata-Infrastrukturressourcen auf Exadata Cloud@Customer aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Exadata-Infrastrukturressource erstellen | CreateExadataInfrastructure | EXADATA-INFRASTRUKTUR ERSTELLEN |
| Liste der Exadata-Infrastrukturressourcen anzeigen | ListExadataInfrastructures | EXADATA-INFRASTRUKTURPRÜFUNG |
| Details einer Exadata-Infrastrukturressource anzeigen | GetExadataInfrastructure | EXADATA-INFRASTRUKTURPRÜFUNG |
| Details einer Exadata-Infrastrukturressource aktualisieren. Mit dieser API können Sie Compute, Speicher, Kontakte, Tags und Wartungsfenster aktualisieren. | UpdateExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
| Exadata-Infrastrukturressource in ein anderes Compartment verschieben | ExadataInfrastructureCompartment ändern | EXADATA_INFRASTRUCTURE_INSPECT und EXADATA_INFRASTRUCTURE_UPDATE |
| Exadata-Infrastrukturressource beenden | DeleteExadataInfrastructure | EXADATA_INFRASTRUCTURE_DELETE |
| Konfigurationsdatei für Exadata-Infrastrukturressourcen herunterladen | DownloadExadataInfrastructureConfigFile | EXADATA-INFRASTRUCTURE-INHALT-LESEN |
| Speicherkapazität zu einer Exadata-Infrastruktur hinzufügen | AddStorageCapacityExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
| Exadata-Infrastruktur aktivieren | ActivateExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
API zum Verwalten autonomer Exadata-VM-Cluster
in der folgenden Tabelle sind die REST-API-Endpunkte zur Verwaltung von autonomen Exadata-VM-Clustern in Oracle Public Cloud und Multicloud aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Autonomes Exadata-VM-Cluster erstellen | CreateCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_CREATE und CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Details eines autonomen Exadata-VM-Clusters anzeigen | GetCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| Liste der autonomen Exadata-VM-Cluster anzeigen | ListCloudAutonomousVmClusters | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| Autonomes Exadata-VM-Cluster in ein anderes Compartment verschieben | ChangeCloudAutonomousVmClusterCompartment | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT und CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Autonomes Exadata-VM-Cluster beenden | DeleteCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_DELETE |
| ORDS-Zertifikate rotieren | RotateCloudAutonomousVmClusterOrdsCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| SSL-Zertifikate rotieren | RotateCloudAutonomousVmClusterSslCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Details von autonomen Exadata-VM-Clustern aktualisieren. Sie können mit dieser API die Tags, das Lizenzmodell oder Netzwerksicherheitsgruppen (NSG) ändern. | UpdateCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Rufen Sie die Ressourcennutzungsdetails eines autonomen Exadata-VM-Clusters und die Nutzungsstatistiken der darin enthaltenen autonomen Containerdatenbanken ab. | GetAutonomousVMClusterResourceUsage | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
In dieser Tabelle sind die REST-API-Endpunkte zur Verwaltung von autonomen Exadata-VM-Clustern auf Exadata Cloud@Customer aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Autonomes Exadata-VM-Cluster erstellen | CreateAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_CREATE und EXADATA_INFRASTRUCTURE_INSPECT und EXADATA_INFRASTRUCTURE_UPDATE |
| Liste der autonomen Exadata-VM-Cluster anzeigen | ListAutonomousVmClusters | AUTONOMOUS_VM_CLUSTER_INSPECT |
| Details eines autonomen Exadata-VM-Clusters anzeigen | GetAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_INSPECT |
| Lizenztyp eines autonomen Exadata-VM-Clusters ändern | UpdateAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_UPDATE und EXADATA_INFRASTRUCTURE_INSPECT und EXADATA_INFRASTRUCTURE_UPDATE |
| Autonomes Exadata-VM-Cluster in ein anderes Compartment verschieben | ChangeAutonomousVmClusterCompartment | AUTONOMOUS_VM_CLUSTER_INSPECT und AUTONOMOUS_VM_CLUSTER_UPDATE |
| Autonomes Exadata-VM-Cluster beenden | DeleteAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_DELETE |
Autonome Containerdatenbanken mit API verwalten
In der folgenden Tabelle werden die REST-API-Endpunkte für die Verwaltung von autonomen Containerdatenbanken aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Autonome Containerdatenbank erstellen | CreateAutonomousContainerDatabase | In Oracle Public Cloud und Multicloud: CLOUD_EXADATA_INFRASTRUCTURE_UPDATE und CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE und AUTONOMOUS_CONTAINER_DATABASE_CREATE Auf Exadata Cloud@Customer: EXADATA_INFRASTRUCTURE_UPDATE und AUTONOMOUS_VM_CLUSTER_UPDATE und AUTONOMOUS_CONTAINER_DATABASE_CREATE |
| Liste der autonomen Containerdatenbanken anzeigen | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
| Details einer autonomen Containerdatenbank anzeigen | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
Backupaufbewahrungs-Policy einer autonomen Containerdatenbank ändern Oder Wartungsvoreinstellungen einer autonomen Containerdatenbank bearbeiten |
UpdateAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Autonome Containerdatenbank neu starten | RestartAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Autonome Containerdatenbank in ein anderes Compartment verschieben | ChangeAutonomousContainerDatabaseCompartment | AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Schlüssel einer autonomen Containerdatenbank rotieren | AutonomousContainerDatabaseEncryptionKey rotieren | AUTONOMOUS_CONTAINER_DATABASE_UPDATE und AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| Autonome Containerdatenbank beenden | TerminateAutonomousContainerDatabase | In Oracle Public Cloud und Multicloud: CLOUD_EXADATA_INFRASTRUCTURE_UPDATE und CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE und AUTONOMOUS_CONTAINER_DATABASE_DELETE Auf Exadata Cloud@Customer: EXADATA_INFRASTRUCTURE_UPDATE und AUTONOMOUS_VM_CLUSTER_UPDATE und AUTONOMOUS_CONTAINER_DATABASE_DELETE |
| Ressourcenauslastungsstatistiken einer autonomen Containerdatenbank abrufen | GetAutonomousContainerDatabaseResourceUsage | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
| Liste der Backups der autonomen Containerdatenbank anzeigen | ListenAutonomousContainerDatabaseBackups | AUTONOMER CONTAINER (DB) |
API zur Verwaltung autonomer KI-Datenbanken
In dieser Tabelle werden die REST-API-Endpunkte für die Verwaltung von autonomen KI-Datenbanken aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
Autonome KI-Datenbank erstellen Oder Autonome KI-Datenbank klonen |
CreateAutonomousDatabase | AUTONOMOUS_DATABASE_CREATE |
| Liste der autonomen KI-Datenbanken anzeigen | ListAutonomousDatabases | AUTONOMOUS_DATABASE_INSPECT |
| Details einer autonomen KI-Datenbank anzeigen | GetAutonomousDatabase | AUTONOMOUS_DATABASE_INSPECT |
| Liste der von der autonomen KI-Datenbank unterstützten Zeichensätze anzeigen. | ListAutonomousDatabaseCharacterSets | Kein Wert |
Kennwort des ADMIN-Benutzers einer autonomen KI-Datenbank festlegen Oder CPU-Coreanzahl oder -Speicher einer autonomen KI-Datenbank skalieren Oder Autoscaling für eine autonome KI-Datenbank aktivieren oder deaktivieren |
UpdateAutonomousDatabase | AUTONOMOUS_DATABASE_UPDATE |
| Autonome KI-Datenbank in ein anderes Compartment verschieben | ChangeAutonomousDatabaseCompartment | AUTONOMOUS_DATABASE_UPDATE und AUTONOMOUS_DB_BACKUP_INSPECT und AUTONOMOUS_DB_BACKUP_CONTENT_READ und AUTONOMOUS_DATABASE_CONTENT_WRITE |
| Autonomen KI-Datenbankschlüssel rotieren | AutonomousDatabaseEncryptionKey rotieren | AUTONOMOUS_DATABASE_UPDATE |
| Autonome KI-Datenbank starten | StartAutonomousDatabase | AUTONOMOUS_DATABASE_UPDATE |
| Autonome KI-Datenbank stoppen | StopAutonomousDatabase | AUTONOMOUS_DATABASE_UPDATE |
| Autonome KI-Datenbank neu starten | RestartAutonomousDatabase | AUTONOMOUS_DATABASE_UPDATE |
| Autonome KI-Datenbank beenden | DeleteAutonomousDatabase | AUTONOMOUS_DATABASE_DELETE |
| Autonome KI-Datenbank wiederherstellen | RestoreAutonomousDatabase | AUTONOMOUS_DB_BACKUP_CONTENT_READ und AUTONOMOUS_DATABASE_CONTENT_WRITE |
| Autonome KI-Datenbank manuell sichern | CreateAutonomousDatabaseBackup | AUTONOMOUS_DB_BACKUP_CREATE und AUTONOMOUS_DATABASE_CONTENT_READ |
| Liste der Backups der autonomen KI-Datenbank anzeigen | ListAutonomousDatabaseBackups | AUTONOMOUS_DB_BACKUP_INSPECT |
| Details eines Backups einer autonomen KI-Datenbank abrufen | GetAutonomousDatabaseBackup | AUTONOMOUS_DB_BACKUP_INSPECT |
| Längerfristiges Backup löschen | AutonomousDatabaseBackup löschen | AUTONOME_DB_BACKUP_LÖSCHEN |
| Aufbewahrungszeitraum eines langfristigen Backups aktualisieren | UpdateAutonomousDatabaseBackup | AUTONOMES_DB_BACKUP_UPDATE |
API zum Verwalten der Autonomous Data Guard-Konfiguration
In der folgenden Tabelle sind die REST-API-Endpunkte zum Verwalten einer Autonomous Data Guard-Konfiguration aufgeführt.
Hinweis: In der folgenden Tabelle sind die in der zweiten Spalte aufgeführten REST-API-Endpunkte veraltet und werden durch neue API-Endpunkte ersetzt, die in der dritten Spalte aufgeführt sind. Die veralteten APIs werden bis März 2026 unterstützt. Danach können Sie die neuen API-Endpunkte nur zur Verwaltung der Autonomous Data Guard-Konfiguration verwenden. Weitere Informationen finden Sie in der Knowledge Base.
Um Ihre vorhandenen Autonomous Data Guard-Ressourcen mit den unten aufgeführten Ersatz-APIs in das neue Modell zu migrieren, das zwei autonome Standbycontainerdatenbanken (ACD) unterstützt, verwenden Sie MigrateAutonomousContainerDatabaseDataguardAssociation. Vollständige Details finden Sie unter MigrateAutonomousContainerDatabaseDataguardAssociation.
| Vorgang | API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Autonomous Data Guard-Assoziation mit einer ACD anzeigen. | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
| Listen Sie die mit Autonomous Data Guard aktivierten ACDs auf, die mit der angegebenen ACD- oder autonomen KI-Datenbank verknüpft sind. | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
| Reaktivieren Sie die deaktivierte Standbydatenbank in einer aktiven Standby-ACD. | AutonomousContainerDatabaseDataguard wiederherstellen | AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Switch-Rollen der primären und Standby-ACDs. | SwitchoverAutonomousContainerDatabaseDatenschutzerklärung | AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Failover zu Standby-ACD. Diese Standby-ACD wird zur neuen primären ACD, wenn das Failover erfolgreich abgeschlossen wird. | FailoverAutonomousContainerDatabaseDatenschutzerklärung | AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Autonomous Data Guard-Einstellungen wie Schutzmodus, automatisches Failover und Fast-Start Failover-Lag-Limit ändern. | AutonomousContainerDatabaseDataguard bearbeiten | AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Rufen Sie eine Autonomous Data Guard-fähige Datenbank ab, die mit der angegebenen autonomen KI-Datenbank verknüpft ist. | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
| Data Guard-Verknüpfungen der autonomen KI-Datenbank auflisten. | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATENBANK_INSPECT |
| Aktivieren Sie Autonomous Data Guard auf einer ACD. | StandbyAutonomousContainerDatabase hinzufügen | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT, AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Konvertieren Sie die Standby-ACD zwischen physischer Standby- und Snapshot Standby-ACD. | StandbyAutonomousContainerDatabase konvertieren | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT, AUTONOMOUS_CONTAINER_DATABASE_INSPECT und AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
API zur Verwaltung autonomer virtueller Maschinen
In dieser Tabelle sind die REST-API-Endpunkte für die Verwaltung autonomer virtueller Maschinen aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Ruft die Details einer bestimmten autonomen virtuellen Maschine ab. | GetAutonomousVirtualMaschine | AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
| Listet die autonomen virtuellen Maschinen im angegebenen autonomen VM-Cluster und Compartment auf. | ListAutonomousVirtualMachines | AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
API zur Verwaltung des Images der autonomen KI-Datenbanksoftware
In dieser Tabelle sind die REST-API-Endpunkte zum Verwalten eines Autonomous AI Database-Softwareimages aufgeführt.
| Vorgang | REST-API-Endpunkt | Erforderliche IAM-Berechtigungen |
|---|---|---|
| Erstellen Sie ein Softwareimage für die autonome KI-Datenbank im angegebenen Compartment. | AutonomousDatabaseSoftwareImage erstellen | AUTO_DB_SOFTWARE_IMG_CREATE |
| Verschieben Sie ein Softwareimage einer autonomen KI-Datenbank und die zugehörigen abhängigen Ressourcen in das angegebene Compartment. | AutonomousDatabaseSoftwareImageCompartment ändern | AUTO_DB_SOFTWARE_IMG_UPDATE |
| Softwareimage einer autonomen KI-Datenbank löschen. | AutonomousDatabaseSoftwareImage löschen | AUTO_DB_SOFTWARE_IMG_DELETE |
| Informationen zum angegebenen Softwareimage für die autonome KI-Datenbank abrufen. | GetAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_INSPECT |
| Rufen Sie eine Liste der Softwareimages der autonomen KI-Datenbank im angegebenen Compartment ab. | ListeAutonomousDatabaseSoftwareImages | AUTO_DB_SOFTWARE_IMG_INSPECT |
| Aktualisieren Sie die Details eines Softwareimages einer autonomen KI-Datenbank. | UpdateAutonomousDatabaseSoftwareImage | AUTO_DB_SOFTWARE_IMG_UPDATE |