Referencia de API para base de datos de IA autónoma en infraestructura de Exadata dedicada
Puede utilizar la API para ver y gestionar los diferentes recursos de infraestructura de una base de datos de IA autónoma en una infraestructura de Exadata dedicada.
Para obtener más información sobre el uso de la API y la firma de solicitudes, consulte API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Software development kits e interfaz de línea de comandos.
API para gestionar recursos del infraestructura de Exadata
En la siguiente tabla, se muestran los puntos finales de la API de REST para gestionar los recursos de infraestructura de Exadata en Oracle Public Cloud y Multicloud.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Creación de un recurso de infraestructura de Exadata | CreateCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_CREATE VNIC_CREATE SUBNET_ATTACH VNIC_ATTACH |
| Visualización de una lista de recursos de infraestructura de Exadata | ListCloudExadataInfrastructures | CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
| Visualización de detalles de un recurso de infraestructura de Exadata | GetCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_INSPECT |
| Actualización de detalles de un recurso de infraestructura de Exadata. Puede utilizar esta API para actualizar los recursos informáticos, el almacenamiento, los contactos, las etiquetas y la ventana de mantenimiento. | UpdateCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Traslado de un recurso de infraestructura de Exadata a otro compartimento | ChangeCloudExadataInfrastructureCompartment | CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Terminar un recurso de infraestructura de Exadata | DeleteCloudExadataInfrastructure | CLOUD_EXADATA_INFRASTRUCTURE_DELETE VNIC_DELETE SUBNET_DETACH VNIC_DETACH |
En las siguientes tablas se muestran los puntos finales de REST API para gestionar recursos de la infraestructura de Exadata en Exadata Cloud@Customer.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Creación de un recurso de infraestructura de Exadata | CreateExadataInfrastructure | EXADATA_INFRASTRUCTURE_CREATE |
| Visualización de una lista de recursos de infraestructura de Exadata | ListExadataInfrastructures | EXADATA_INFRASTRUCTURE_INSPECT |
| Visualización de detalles de un recurso de infraestructura de Exadata | GetExadataInfrastructure | EXADATA_INFRASTRUCTURE_INSPECT |
| Actualización de detalles de un recurso de infraestructura de Exadata. Puede utilizar esta API para actualizar los recursos informáticos, el almacenamiento, los contactos, las etiquetas y la ventana de mantenimiento. | UpdateExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
| Traslado de un recurso de infraestructura de Exadata a otro compartimento | Cambiar compartimento de infraestructura deExadataInfrastructure | EXADATA_INFRASTRUCTURE_INSPECT y EXADATA_INFRASTRUCTURE_UPDATE |
| Terminar un recurso de infraestructura de Exadata | DeleteExadataInfrastructure | EXADATA_INFRASTRUCTURE_DELETE |
| Descargar un archivo de configuración de recursos de infraestructura de Exadata | DownloadExadataInfrastructureConfigFile | EXADATA_INFRASTRUCTURE_CONTENT_READ |
| Agregar capacidad de almacenamiento a una infraestructura de Exadata | AddStorageCapacityExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
| Activación de una infraestructura de Exadata | ActivateExadataInfrastructure | EXADATA_INFRASTRUCTURE_UPDATE |
API para gestionar clusters de VM de Exadata autónomos
En las siguientes tablas, se muestran los puntos finales de las API de de REST para gestionar los clusteres de máquina virtual de Exadata autónomos en Oracle Public Cloud y Multicloud.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Creación de un cluster de VM de Exadata autónomo | CreateCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_CREATE y CLOUD_EXADATA_INFRASTRUCTURE_UPDATE |
| Visualización de detalles de un cluster de VM de Exadata autónomo | GetCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| Visualización de una lista de los clusters de VM de Exadata autónomos | ListCloudAutonomousVmClusters | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
| Traslado de un cluster de VM de Exadata autónomo a otro compartimento | ChangeCloudAutonomousVmClusterCompartment | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT y CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Terminación de un cluster de VM de Exadata autónomo | DeleteCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_DELETE |
| Rotación de certificados ORDS | RotateCloudAutonomousVmClusterOrdsCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Rotación de certificados SSL | RotateCloudAutonomousVmClusterSslCerts | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Actualización de detalles de los clusters de VM de Exadata autónomos. Puede modificar las etiquetas, el modelo de licencia o los grupos de seguridad de red (NSG) mediante esta API. | UpdateCloudAutonomousVmCluster | CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE |
| Obtenga los detalles de uso de recursos de un cluster de VM de Exadata autónomo y las estadísticas de uso de las bases de datos de contenedores autónomas que contiene. | GetAutonomousVMClusterResourceUsage | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT |
En las siguientes tablas se muestran los puntos finales de las API de de REST para gestionar los clusteres de VM deExadata autónomos en Exadata Cloud@Customer.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Creación de un cluster de VM de Exadata autónomo | CreateAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_CREATE y EXADATA_INFRASTRUCTURE_INSPECT y EXADATA_INFRASTRUCTURE_UPDATE |
| Visualización de una lista de los clusters de VM de Exadata autónomos | ListAutonomousVmClusters | AUTONOMOUS_VM_CLUSTER_INSPECT |
| Visualización de detalles de un cluster de VM de Exadata autónomo | GetAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_INSPECT |
| Cambio del tipo de licencia de un cluster de VM de Exadata autónomo | UpdateAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_UPDATE y EXADATA_INFRASTRUCTURE_INSPECT y EXADATA_INFRASTRUCTURE_UPDATE |
| Traslado de un cluster de VM de Exadata autónomo a otro compartimento | ChangeAutonomousVmClusterCompartment | AUTONOMOUS_VM_CLUSTER_INSPECT y AUTONOMOUS_VM_CLUSTER_UPDATE |
| Terminación de un cluster de VM de Exadata autónomo | DeleteAutonomousVmCluster | AUTONOMOUS_VM_CLUSTER_DELETE |
Interfaz de programación de aplicaciones (API) para gestionar bases datos de contenedores autónomas
En la siguiente tabla, se muestran los puntos finales de la API de REST para gestionar las bases de datos de contenedores autónomas.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Creación de una base de datos de contenedores autónoma | CreateAutonomousContainerDatabase | En Oracle Public Cloud y la multinube: CLOUD_EXADATA_INFRASTRUCTURE_UPDATE y CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE y AUTONOMOUS_CONTAINER_DATABASE_CREATE En Exadata Cloud@Customer: EXADATA_INFRAASTRUCTURE_UPDATE y AUTONOMOUS_VM_CLUSTER_UPDATE y AUTONOMOUS_CONTAINER_DATABASE_CREATE |
| Visualización de una lista de las bases de datos de contenedores autónomas | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
| Visualización de detalles de una base de datos de contenedores autónoma | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
Cambio de la política de retención de copias de seguridad de una base de datos de contenedores autónoma o bien, Editar las preferencias de mantenimiento de una base de datos de contenedores autónoma |
UpdateAutonomousContainerDatabase | ACTUALIZACIÓN_DE_BASE_DATOS_CONTENEDORES_AUTONOMÍA |
| Reinicio de una base de datos de contenedores autónoma | RestartAutonomousContainerDatabase | ACTUALIZACIÓN_DE_BASE_DATOS_CONTENEDORES_AUTONOMÍA |
| Traslado de una base de datos de contenedores autónoma a otro compartimento | ChangeAutonomousContainerDatabaseCompartment | AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Rotación de una clave de base de datos de contenedores autónoma | Rotar clave de cifrado de base de datos de contenedores autónoma | AUTONOMOUS_CONTAINER_DATABASE_UPDATE y AUTONOMOUS_CONTAINER_DATABASE_INSPECT |
| Terminación de una base de datos de contenedores autónoma | TerminateAutonomousContainerDatabase | En Oracle Public Cloud y la multinube: CLOUD_EXADATA_INFRASTRUCTURE_UPDATE y CLOUD_AUTONOMOUS_VM_CLUSTER_UPDATE y AUTONOMOUS_CONTAINER_DATABASE_DELETE En Exadata Cloud@Customer: EXADATA_INFRAASTRUCTURE_UPDATE y AUTONOMOUS_VM_CLUSTER_UPDATE y AUTONOMOUS_CONTAINER_DATABASE_DELETE |
| Obtener las estadísticas de uso de recursos de una base de datos de contenedores autónoma | Uso de recursos de GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
| Ver una lista de copias de seguridad de la base de datos de contenedores autónoma | Copias de seguridad de bases de datos de contenedores autónomas de listas | AUTONOMOUS_CONTAINER_DATABASE_BACKUP_INSPECT |
API para gestionar bases de datos de IA autónomas
En las siguientes tablas, se muestran los Puntos finales de las API REST para gestionar las bases de datos de IA autónomas.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
Creación de una base de datos de IA autónoma o bien, Clonación de una base de datos de IA autónoma |
CreateAutonomousDatabase | CREACIÓN_BASE_DATOS_AUTÓNOMA |
| Visualización de la lista de las bases de datos de IA autónomas | ListAutonomousDatabases | AUTONOMOUS_DATABASE_INSPECT (INSPECCIONAR BASE DE DATOS AUTÓNOMA) |
| Ver detalles de una base de datos de IA autónoma | GetAutonomousDatabase | AUTONOMOUS_DATABASE_INSPECT (INSPECCIONAR BASE DE DATOS AUTÓNOMA) |
| Visualización de una lista de juegos de caracteres soportados por Autonomous AI Database. | ListAutonomousDatabaseCharacterSets | ninguno |
Definir la contraseña de un usuario ADMIN de una base de datos de IA autónoma o bien, Escala el recuento de núcleos de CPU o el almacenamiento de una base de datos de IA autónoma o bien, Activar o desactivar la escala automática para una base de datos de IA autónoma |
UpdateAutonomousDatabase | ACTUALIZACIÓN_BASE_DATOS_AUTÓNOMA |
| Mover una base de datos de IA autónoma a otro compartimento | ChangeAutonomousDatabaseCompartment | AUTONOMOUS_DATABASE_UPDATE, AUTONOMOUS_DB_BACKUP_INSPECT y AUTONOMOUS_DB_BACKUP_CONTENT_READ y AUTONOMOUS_DATABASE_CONTENT_WRITE |
| Rotación de una clave de base de datos de IA autónoma | Rotación de AutonomousDatabaseEncryptionKey | ACTUALIZACIÓN_BASE_DATOS_AUTÓNOMA |
| Inicio de una base de datos de IA autónoma | StartAutonomousDatabase | ACTUALIZACIÓN_BASE_DATOS_AUTÓNOMA |
| Parada de una base de datos de IA autónoma | StopAutonomousDatabase | ACTUALIZACIÓN_BASE_DATOS_AUTÓNOMA |
| Reinicio de una base de datos de IA autónoma | RestartAutonomousDatabase | ACTUALIZACIÓN_BASE_DATOS_AUTÓNOMA |
| Terminación de una base de datos de IA autónoma | DeleteAutonomousDatabase | AUTONOMOUS_DATABASE_DELETE |
| Restauración de una base de datos de IA autónoma | RestoreAutonomousDatabase | AUTONOMOUS_DB_BACKUP_CONTENT_READ y AUTONOMOUS_DATABASE_CONTENT_WRITE |
| Realizar copias de seguridad de una base de datos de IA autónoma manualmente | CreateAutonomousDatabaseBackup | AUTONOMOUS_DB_BACKUP_CREATE y AUTONOMOUS_DATABASE_CONTENT_READ |
| Visualización de la lista de copias de seguridad de bases de datos de IA autónomas | ListAutonomousDatabaseBackups | AUTONOMOUS_DB_BACKUP_INSPECT |
| Obtén los detalles de una copia de seguridad de una base de datos de IA autónoma | Obtener copia de seguridad de AutonomousDatabase | AUTONOMOUS_DB_BACKUP_INSPECT |
| Supresión de copias de seguridad a largo plazo | Suprimir copia de seguridad de AutonomousDatabase | AUTONOMOUS_DB_BACKUP_DELETE |
| Actualizar el período de retención de una copia de seguridad a largo plazo | Actualizar copia de seguridad de AutonomousDatabase | ACTUALIZACIÓN DE COPIA DE SEGURIDAD DE BASE DE DATOS AUTÓNOMA |
API para gestionar la Configuración de Autonomous Data Guard
En la siguiente tabla se muestran los puntos finales de la API de REST para gestionar la configuración de Autonomous Data Guard.
Nota: En la siguiente tabla, los puntos finales de API de REST que se muestran en la segunda columna están en desuso y se sustituyen por nuevos puntos finales de API que se muestran en la tercera columna. Las API en desuso estarán soportadas hasta marzo de 2026, tras lo cual solo podrá utilizar los nuevos puntos finales de API para gestionar la configuración de Autonomous Data Guard. Consulte Base de conocimientos para obtener más información.
Para migrar los recursos de Autonomous Data Guard existentes al nuevo modelo que soporta dos bases de datos de contenedores autónomas (ACD) en espera mediante las API de sustitución que se muestran a continuación, utilice MigrateAutonomousContainerDatabaseDataguardAssociation. Para obtener más información, consulte MigrateAutonomousContainerDatabaseDataguardAssociation.
| Operación | Punto final de API | Permisos de IAM necesarios |
|---|---|---|
| Ver la asociación de Autonomous Data Guard a una ACD. | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
| Muestre las bases de datos autónomas activadas con Autonomous Data Guard asociadas a la base de datos de IA autónoma o ACD especificada. | ListAutonomousContainerDatabases | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
| Vuelva a instanciar la base de datos en espera desactivada a una ACD en espera activa. | Reintegrar AutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Cambiar roles de las ACD principal y en espera. | Switchover de AutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Failover a la ACD en espera. Esta ACD en espera se convertirá en la nueva ACD principal cuando el failover se complete correctamente. | FailoverAutonomousContainerDatabaseDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Modifique la configuración de Autonomous Data Guard, como el modo de protección, el failover automático y el límite de demora de failover de inicio rápido. | Editar base de datos de AutonomousContainerDataguard | AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Obtener una base de Datos con Autonomous Data Guard activado asociada a la base de Datos de IA autónoma especificada. | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
| Muestra las asociaciones de Data Guard de la base de datos de IA autónoma. | GetAutonomousContainerDatabase | AUTONOMOUS_CONTAINER_DATABASE_INSPECT (INSPECCIÓN DE BASE DE DATOS DE CONTENEDORES AUTÓNOMA) |
| Active Autonomous Data Guard en una base de datos autónoma. | Agregarbase de datos de contenedores autónoma en espera | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT, AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
| Convierta la ACD en espera entre la ACD física en espera y la ACD de instantánea en espera. | Convertir base de datos de contenedores autónoma en espera | CLOUD_AUTONOMOUS_VM_CLUSTER_INSPECT, AUTONOMOUS_CONTAINER_DATABASE_INSPECT y AUTONOMOUS_CONTAINER_DATABASE_UPDATE |
API para gestionar máquinas virtuales autónomas
En las siguientes tablas, se muestran los Puntos finales de las API REST para gestionar las máquinas virtuales autónomas.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Obtiene los detalles de una máquina virtual autónoma específica. | Obtener máquina virtual autónoma | AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
| Muestra las máquinas virtuales autónomas en el compartimento y el cluster de VM autónomo especificados. | Lista de máquinas virtuales autónomas | AUTONOMOUS_VIRTUAL_MACHINE_INSPECT |
API para gestionar imágenes de software de base de datos de IA autónoma
En las siguientes tablas se muestran los puntos finales de REST API para gestionar una imagen de software de base de datos de IA autónoma.
| Operación | Punto final de la API de REST | Permisos de IAM necesarios |
|---|---|---|
| Cree una imagen de software de base de datos de IA autónoma en el compartimento especificado. | Crear imagen de software de base de datos autónoma | AUTO_DB_SOFTWARE_IMG_CREATE |
| Mueva una imagen de software de base de datos de IA autónoma y sus recursos dependientes al compartimento especificado. | Cambiar compartimento de imagen de software de base de datos autónoma | AUTO_DB_SOFTWARE_IMG_UPDATE |
| Suprimir una imagen de software de base de datos de IA autónoma. | Suprimir imagen de software de base de datos autónoma | AUTO_DB_SOFTWARE_IMG_DELETE |
| Obtenga información sobre la imagen de software de la base de datos de IA autónoma especificada. | Obtener imagen de software de base de datos autónoma | AUTO_DB_SOFTWARE_IMG_INSPECT |
| Obtenga una lista de las imágenes de software de la base de datos de IA autónoma en el compartimento especificado. | Mostrar imágenes de software de base de datos autónoma | AUTO_DB_SOFTWARE_IMG_INSPECT |
| Actualizar detalles de una imagen de software de base de datos de IA autónoma. | Actualizar imagen de software de base de datos autónoma | AUTO_DB_SOFTWARE_IMG_UPDATE |