DatabaseClient

class oci.database.DatabaseClient(config, **kwargs)

The API for the Database Service. Use this API to manage resources such as databases and DB Systems. For more information, see [Overview of the Database Service](/iaas/Content/Database/Concepts/databaseoverview.htm).

Methods:

__init__(config, **kwargs)	Creates a new service client
activate_exadata_infrastructure(...)	Activates the specified Exadata infrastructure resource.
add_dbnode_snapshots_for_exadb_vm_cluster(...)	Add a database node snapshots to the Exadb VM cluster..
add_standby_autonomous_container_database(...)	Add a standby Autonomous Container Database.
add_storage_capacity_cloud_exadata_infrastructure(...)	Makes the storage capacity from additional storage servers available for Cloud VM Cluster consumption.
add_storage_capacity_exadata_infrastructure(...)	Makes the storage capacity from additional storage servers available for VM Cluster consumption.
add_virtual_machine_to_cloud_vm_cluster(...)	Add Virtual Machines to the Cloud VM cluster.
add_virtual_machine_to_vm_cluster(...)	Add Virtual Machines to the VM cluster.
autonomous_database_manual_refresh(...)	Initiates a data refresh for an Autonomous AI Database refreshable clone.
cancel_backup(backup_id, **kwargs)	Cancel automatic/standalone full/incremental create backup workrequests specified by the backup Id.
cancel_execution_window(execution_window_id, ...)	Cancels the in progress maintenance activity under this execution window.
cascading_delete_scheduling_plan(...)	Delete the scheduling plan resource along with all the scheduled actions associated with this resource.
change_autonomous_container_database_compartment(...)	Move the Autonomous Container Database and its dependent resources to the specified compartment.
change_autonomous_database_compartment(...)	Move the Autonomous AI Database and its dependent resources to the specified compartment.
change_autonomous_database_software_image_compartment(...)	Move the Autonomous AI Database Software Image and its dependent resources to the specified compartment.
change_autonomous_database_subscription(...)	Associate an Autonomous AI Database with a different subscription.
change_autonomous_exadata_infrastructure_compartment(...)	Deprecated. Use the change_cloud_exadata_infrastructure_compartment() operation to move an Exadata infrastructure resource to a different compartment and change_cloud_autonomous_vm_cluster_compartment() operation to move an Autonomous Exadata VM cluster to a different compartment.
change_autonomous_vm_cluster_compartment(...)	Moves an Autonomous VM cluster and its dependent resources to another compartment.
change_backup_destination_compartment(...)	Move the backup destination and its dependent resources to the specified compartment.
change_basecc_vm_cluster_compartment(...)	Moves a BaseDB-C@C VM cluster and its dependent resources to another compartment.
change_cloud_autonomous_vm_cluster_compartment(...)	Moves an Autonomous Exadata VM cluster in the Oracle cloud and its dependent resources to another compartment.
change_cloud_autonomous_vm_cluster_subscription(...)	Associate a Cloud Autonomous VM cluster with a different subscription.
change_cloud_db_system_subscription(...)	Associate a cloud DB system with a different subscription.
change_cloud_exadata_infrastructure_compartment(...)	Moves a cloud Exadata infrastructure resource and its dependent resources to another compartment.
change_cloud_exadata_infrastructure_subscription(...)	Associate a cloud Exadata infrastructure with a different subscription.
change_cloud_vm_cluster_compartment(...)	Moves a cloud VM cluster and its dependent resources to another compartment.
change_cloud_vm_cluster_subscription(...)	Associate a cloud VM cluster with a different subscription.
change_database_software_image_compartment(...)	Move the Database Software Image and its dependent resources to the specified compartment.
change_dataguard_role(...)	Deprecated. Use the convert_standby_autonomous_container_database() operation to switch the Autonomous Container Database (ACD) role between Standby and Snapshot Standby.
change_db_system_compartment(...)	Moves the DB system and its dependent resources to the specified compartment.
change_disaster_recovery_configuration(...)	This operation updates the cross-region disaster recovery (DR) details of the standby Autonomous AI Database Serverless database, and must be run on the standby side.
change_encryption_key_location(database_id, ...)	Update the encryption key management location for the database
change_exadata_infrastructure_compartment(...)	Moves an Exadata infrastructure resource and its dependent resources to another compartment.
change_exadb_vm_cluster_compartment(...)	Moves a Exadata VM cluster on Exascale Infrastructure and its dependent resources to another compartment.
change_exadb_vm_cluster_subscription(...)	Associate a Exadata VM cluster on Exascale Infrastructure with a different subscription.
change_exascale_db_storage_vault_compartment(...)	Moves a Exadata Database Storage Vault to another compartment.
change_exascale_db_storage_vault_subscription(...)	Associate a Exadata Database Storage Vault with a different subscription.
change_external_container_database_compartment(...)	Move the create_external_container_database_details() and its dependent resources to the specified compartment.
change_external_non_container_database_compartment(...)	Move the external non-container database and its dependent resources to the specified compartment.
change_external_pluggable_database_compartment(...)	Move the create_external_pluggable_database_details() and its dependent resources to the specified compartment.
change_key_store_compartment(...)	Move the key store resource to the specified compartment.
change_key_store_type(database_id, ...)	Changes encryption key management type
change_oneoff_patch_compartment(...)	Move the one-off patch to the specified compartment.
change_scheduling_plan_compartment(...)	Moves an scheduling plan resource to another compartment.
change_scheduling_policy_compartment(...)	Moves an scheduling policy resource to another compartment.
change_vm_cluster_compartment(...)	Moves a VM cluster and its dependent resources to another compartment.
check_external_database_connector_connection_status(...)	Check the status of the external database connection specified in this connector.
complete_external_backup_job(backup_id, ...)	Changes the status of the standalone backup resource to ACTIVE after the backup is created from the on-premises database and placed in Oracle Cloud Infrastructure Object Storage.
configure_autonomous_database_vault_key(...)	Configures the Autonomous AI Database Vault service `key`__.
configure_exascale_cloud_exadata_infrastructure(...)	Configures Exascale on Cloud exadata infrastructure resource.
configure_exascale_exadata_infrastructure(...)	Configures Exascale on Exadata infrastructure resource.
configure_saas_admin_user(...)	This operation updates SaaS administrative user configuration of the Autonomous AI Database.
confirm_key_store_details_are_correct(...)	This is for user to confirm to DBaaS that the Oracle Key Valut (OKV) connection IPs, username and password are all correct.
convert_standby_autonomous_container_database(...)	Convert the standby Autonomous Container Database (ACD) between physical standby and snapshot standby ACD.
convert_standby_database_type(database_id, ...)	Performs transition from standby database into a snapshot standby and vice versa.
convert_to_pdb(database_id, ...)	Converts a non-container database to a pluggable database.
convert_to_regular_pluggable_database(...)	Converts a Refreshable clone to Regular pluggable database (PDB).
convert_to_standalone(database_id, ...)	Disassociate the standby database identified by the databaseId parameter from existing Data Guard group.
create_advanced_cluster_file_system(...)	Creates an advanced cluster file system resource.
create_application_vip(...)	Creates a new application virtual IP (VIP) address in the specified cloud VM cluster based on the request parameters you provide.
create_autonomous_container_database(...)	Creates an Autonomous Container Database in the specified Autonomous Exadata Infrastructure.
create_autonomous_container_database_dataguard_association(...)	Deprecated. Use the add_standby_autonomous_container_database() operation to create a new Autonomous Data Guard association.
create_autonomous_database(...)	Creates a new Autonomous AI Database.
create_autonomous_database_backup(...)	Creates a new Autonomous AI Database backup for the specified database based on the provided request parameters.
create_autonomous_database_software_image(...)	create Autonomous AI Database Software Image in the specified compartment.
create_autonomous_vm_cluster(...)	Creates an Autonomous VM cluster for Exadata Cloud@Customer.
create_backup(create_backup_details, **kwargs)	Creates a new backup in the specified database based on the request parameters you provide.
create_backup_destination(...)	Creates a backup destination in an Exadata Cloud@Customer system.
create_basecc_vm_cluster(...)	Creates a BaseDB-C@C VM cluster.
create_cloud_autonomous_vm_cluster(...)	Creates an Autonomous Exadata VM cluster in the Oracle cloud.
create_cloud_exadata_infrastructure(...)	Creates a cloud Exadata infrastructure resource.
create_cloud_vm_cluster(...)	Creates a cloud VM cluster.
create_console_connection(...)	Creates a new console connection to the specified database node.
create_console_history(...)	Captures the most recent serial console data (up to a megabyte) for the specified database node.
create_data_guard_association(database_id, ...)	Creates a new Data Guard association.
create_database(create_new_database_details, ...)	Creates a new database in the specified Database Home.
create_database_snapshot(...)	Creates a Database Snapshot
create_database_software_image(...)	create database software image in the specified compartment.
create_db_home(...)	Creates a new Database Home in the specified database system based on the request parameters you provide.
create_exadata_infrastructure(...)	Creates an Exadata infrastructure resource.
create_exadb_vm_cluster(...)	Creates an Exadata VM cluster on Exascale Infrastructure
create_exascale_db_storage_vault(...)	Creates an Exadata Database Storage Vault
create_execution_action(...)	Creates an execution action resource.
create_execution_window(...)	Creates an execution window resource.
create_external_backup_job(...)	Creates a new backup resource and returns the information the caller needs to back up an on-premises Oracle Database to Oracle Cloud Infrastructure.
create_external_container_database(...)	Creates a new external container database resource.
create_external_database_connector(...)	Creates a new external database connector.
create_external_non_container_database(...)	Creates a new ExternalNonContainerDatabase resource
create_external_pluggable_database(...)	Registers a new create_external_pluggable_database_details() resource.
create_gi_home(create_gi_home_details, **kwargs)	Creates a new Grid Infrastructure Home in the specified database system based on the request parameters you provide.
create_key_store(create_key_store_details, ...)	Creates a Key Store.
create_maintenance_run(...)	Creates a maintenance run with one of the following: 1.
create_oneoff_patch(...)	Creates one-off patch for specified database version to download.
create_pluggable_database(...)	Creates and starts a pluggable database in the specified container database.
create_pluggable_database_snapshot(...)	Creates a Pluggable Database Snapshot
create_scheduled_action(...)	Creates a Scheduled Action resource.
create_scheduling_plan(...)	Creates a Scheduling Plan resource.
create_scheduling_policy(...)	Creates a Scheduling Policy resource.
create_scheduling_window(...)	Creates a Scheduling Window resource.
create_vm_cluster(create_vm_cluster_details, ...)	Creates an Exadata Cloud@Customer VM cluster.
create_vm_cluster_network(...)	Creates the VM cluster network.
db_node_action(db_node_id, action, **kwargs)	Performs one of the following power actions on the specified DB node: - start - power on - stop - power off gracefully - forcestop - power off forcefully - forcereset - ACPI shutdown and power on forcefully - softreset - ACPI shutdown and power on - reset - power off and power on
delete_advanced_cluster_file_system(...)	Deletes the advanced cluster file system.
delete_application_vip(application_vip_id, ...)	Deletes and deregisters the specified application virtual IP (VIP) address.
delete_autonomous_database(...)	Deletes the specified Autonomous AI Database.
delete_autonomous_database_backup(...)	Deletes a long-term backup.
delete_autonomous_database_software_image(...)	Delete an Autonomous AI Database Software Image
delete_autonomous_vm_cluster(...)	Deletes the specified Autonomous VM cluster in an Exadata Cloud@Customer system.
delete_backup(backup_id, **kwargs)	Deletes a full backup.
delete_backup_destination(...)	Deletes a backup destination in an Exadata Cloud@Customer system.
delete_basecc_vm_cluster(...)	Deletes the specified BaseDB-C@C VM cluster.
delete_cloud_autonomous_vm_cluster(...)	Deletes the specified Autonomous Exadata VM cluster in the Oracle cloud.
delete_cloud_exadata_infrastructure(...)	Deletes the cloud Exadata infrastructure resource.
delete_cloud_vm_cluster(cloud_vm_cluster_id, ...)	Deletes the specified cloud VM cluster.
delete_console_connection(db_node_id, ...)	Deletes the specified database node console connection.
delete_console_history(db_node_id, ...)	Deletes the specified database node console history.
delete_database(database_id, **kwargs)	Deletes the specified database.
delete_database_snapshot(...)	Deletes the specified Exadata Database Snapshot.
delete_database_software_image(...)	Delete a database software image
delete_db_home(db_home_id, **kwargs)	Deletes a Database Home.
delete_dbnode_snapshot(dbnode_snapshot_id, ...)	Deletes the specified Exadata Database Node Snapshot.
delete_exadata_infrastructure(...)	Deletes the Exadata Cloud@Customer infrastructure.
delete_exadb_vm_cluster(exadb_vm_cluster_id, ...)	Deletes the specified Exadata VM cluster on Exascale Infrastructure.
delete_exascale_db_storage_vault(...)	Deletes the specified Exadata Database Storage Vault.
delete_execution_action(execution_action_id, ...)	Deletes the execution action.
delete_execution_window(execution_window_id, ...)	Deletes the execution window.
delete_external_container_database(...)	Deletes the create_external_container_database_details() resource.
delete_external_database_connector(...)	Deletes an external database connector.
delete_external_non_container_database(...)	Deletes the Oracle Cloud Infrastructure resource representing an external non-container database.
delete_external_pluggable_database(...)	Deletes the create_external_pluggable_database_details().
delete_gi_home(gi_home_id, **kwargs)	Deletes a Grid Infrastructure Home.
delete_key_store(key_store_id, **kwargs)	Deletes a key store.
delete_oneoff_patch(oneoff_patch_id, **kwargs)	Deletes a one-off patch.
delete_pluggable_database(...)	Deletes the specified pluggable database.
delete_pluggable_database_snapshot(...)	Deletes the specified Exadata Pluggable Database Snapshot.
delete_scheduled_action(scheduled_action_id, ...)	Deletes the scheduled action.
delete_scheduling_plan(scheduling_plan_id, ...)	Deletes the scheduling plan.
delete_scheduling_policy(...)	Deletes the scheduling policy.
delete_scheduling_window(...)	Deletes the scheduling window.
delete_vm_cluster(vm_cluster_id, **kwargs)	Deletes the specified VM cluster.
delete_vm_cluster_network(...)	Deletes the specified VM cluster network.
deregister_autonomous_database_data_safe(...)	Asynchronously deregisters this Autonomous AI Database with Data Safe.
disable_autonomous_database_management(...)	Disables Database Management for the Autonomous AI Database resource.
disable_autonomous_database_operations_insights(...)	Disables Operations Insights for the Autonomous AI Database resource.
disable_database_management(database_id, ...)	Disables the Database Management service for the database.
disable_external_container_database_database_management(...)	Disable Database Management service for the external container database.
disable_external_container_database_stack_monitoring(...)	Disable Stack Monitoring for the external container database.
disable_external_non_container_database_database_management(...)	Disable Database Management Service for the external non-container database.
disable_external_non_container_database_operations_insights(...)	Disable Operations Insights for the external non-container database.
disable_external_non_container_database_stack_monitoring(...)	Disable Stack Monitoring for the external non-container database.
disable_external_pluggable_database_database_management(...)	Disable Database Management Service for the external pluggable database.
disable_external_pluggable_database_operations_insights(...)	Disable Operations Insights for the external pluggable database.
disable_external_pluggable_database_stack_monitoring(...)	Disable Stack Monitoring for the external pluggable database.
disable_pluggable_database_management(...)	Disables the Database Management service for the pluggable database.
download_db_connection_bundle(...)	Downloads the specified database connection bundle content.
download_exadata_infrastructure_config_file(...)	Downloads the configuration file for the specified Exadata Cloud@Customer infrastructure.
download_oneoff_patch(oneoff_patch_id, **kwargs)	Download one-off patch.
download_validation_report(...)	Downloads the network validation report file for the specified VM cluster network.
download_vm_cluster_network_config_file(...)	Downloads the configuration file for the specified VM cluster network.
edit_autonomous_container_database_dataguard(...)	Modify Autonomous Container Database Data Guard settings such as protection mode, automatic failover, and fast start failover lag limit.
enable_autonomous_database_management(...)	Enables Database Management for Autonomous AI Database.
enable_autonomous_database_operations_insights(...)	Enables the specified Autonomous AI Database with Operations Insights.
enable_database_management(database_id, ...)	Enables the Database Management service for an Oracle Database located in Oracle Cloud Infrastructure.
enable_external_container_database_database_management(...)	Enables Database Management Service for the external container database.
enable_external_container_database_stack_monitoring(...)	Enable Stack Monitoring for the external container database.
enable_external_non_container_database_database_management(...)	Enable Database Management Service for the external non-container database.
enable_external_non_container_database_operations_insights(...)	Enable Operations Insights for the external non-container database.
enable_external_non_container_database_stack_monitoring(...)	Enable Stack Monitoring for the external non-container database.
enable_external_pluggable_database_database_management(...)	Enable Database Management Service for the external pluggable database.
enable_external_pluggable_database_operations_insights(...)	Enable Operations Insights for the external pluggable database.
enable_external_pluggable_database_stack_monitoring(...)	Enable Stack Monitoring for the external pluggable database.
enable_pluggable_database_management(...)	Enables the Database Management service for an Oracle Pluggable Database located in Oracle Cloud Infrastructure.
execute_db_system_os_patch(...)	Execute an operating system (OS) patch action on a DB system.
fail_over_autonomous_database(...)	Initiates a failover of the specified Autonomous AI Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. This API should be called in the remote region where the peer database resides. Below parameter is optional: - peerDbId Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. If this parameter is not provided, the failover will happen in the same region.
failover_autonomous_container_database_dataguard(...)	Performs failover to a standby Autonomous Container Database (ACD) identified by the autonomousContainerDatabaseId parameter.
failover_autonomous_container_database_dataguard_association(...)	Deprecated. Use the failover_autonomous_container_database_dataguard() operation to fail over the standby Autonomous Container Database (ACD) to the primary ACD after the existing primary ACD fails or becomes unreachable.
failover_data_guard(database_id, ...)	Performs a failover to transition the standby database identified by the databaseId path parameter into the primary role after the existing primary database fails or becomes unreachable.
failover_data_guard_association(database_id, ...)	Performs a failover to transition the standby database identified by the databaseId parameter into the specified Data Guard association's primary role after the existing primary database fails or becomes unreachable.
generate_autonomous_database_wallet(...)	Creates and downloads a wallet for the specified Autonomous AI Database.
generate_recommended_vm_cluster_network(...)	Generates a recommended Cloud@Customer VM cluster network configuration.
get_advanced_cluster_file_system(...)	Gets information about the specified advanced cluster file systems.
get_application_vip(application_vip_id, **kwargs)	Gets information about a specified application virtual IP (VIP) address.
get_autonomous_container_database(...)	Gets information about the specified Autonomous Container Database.
get_autonomous_container_database_backup(...)	Gets information about the specified Autonomous Container Database backup.
get_autonomous_container_database_dataguard_association(...)	Deprecated. Use the get_autonomous_container_database() operation to get the details of an Autonomous Container Database (ACD) enabled with Autonomous Data Guard associated with the specified ACD.
get_autonomous_container_database_resource_usage(...)	Get resource usage details for the specified Autonomous Container Database.
get_autonomous_database(...)	Gets the details of the specified Autonomous AI Database.
get_autonomous_database_backup(...)	Gets information about the specified Autonomous AI Database backup.
get_autonomous_database_dataguard_association(...)	Deprecated. Use the get_autonomous_container_database() operation to gets an Autonomous Data Guard-enabled database associated with the specified Autonomous AI Database.
get_autonomous_database_regional_wallet(**kwargs)	Gets the Autonomous AI Database regional wallet details.
get_autonomous_database_software_image(...)	Gets information about the specified Autonomous AI Database Software Image.
get_autonomous_database_wallet(...)	Gets the wallet details for the specified Autonomous AI Database.
get_autonomous_exadata_infrastructure(...)	Deprecated. Use the get_cloud_exadata_infrastructure() operation to get details of an Exadata Infrastructure resource and the get_cloud_autonomous_vm_cluster() operation to get details of an Autonomous Exadata VM cluster.
get_autonomous_patch(autonomous_patch_id, ...)	Gets information about a specific autonomous patch.
get_autonomous_virtual_machine(...)	Gets the details of specific Autonomous Virtual Machine.
get_autonomous_vm_cluster(...)	Gets information about the specified Autonomous VM cluster for an Exadata Cloud@Customer system.
get_autonomous_vm_cluster_resource_usage(...)	Get the resource usage details for the specified Autonomous Exadata VM cluster.
get_backup(backup_id, **kwargs)	Gets information about the specified backup.
get_backup_destination(...)	Gets information about the specified backup destination in an Exadata Cloud@Customer system.
get_basecc_vm_cluster(basecc_vm_cluster_id, ...)	Gets information about the BaseDB-C@C VM cluster.
get_basecc_vm_cluster_update(...)	Gets information about a specified maintenance update package for a BaseDB-C@C VM cluster.
get_basecc_vm_cluster_update_history_entry(...)	Gets the maintenance update history details for the specified update history entry.
get_cloud_autonomous_vm_cluster(...)	Gets information about the specified Autonomous Exadata VM cluster in the Oracle cloud.
get_cloud_autonomous_vm_cluster_resource_usage(...)	Get the resource usage details for the specified Cloud Autonomous Exadata VM cluster.
get_cloud_exadata_infrastructure(...)	Gets information about the specified cloud Exadata infrastructure resource.
get_cloud_exadata_infrastructure_unallocated_resources(...)	Gets unallocated resources information for the specified Cloud Exadata infrastructure.
get_cloud_vm_cluster(cloud_vm_cluster_id, ...)	Gets information about the specified cloud VM cluster.
get_cloud_vm_cluster_iorm_config(...)	Gets the IORM configuration for the specified cloud VM cluster in an Exadata Cloud Service instance.
get_cloud_vm_cluster_update(...)	Gets information about a specified maintenance update package for a cloud VM cluster.
get_cloud_vm_cluster_update_history_entry(...)	Gets the maintenance update history details for the specified update history entry.
get_console_connection(db_node_id, ...)	Gets the specified database node console connection's information.
get_console_history(db_node_id, ...)	Gets information about the specified database node console history.
get_console_history_content(db_node_id, ...)	Retrieves the specified database node console history contents upto a megabyte.
get_data_guard_association(database_id, ...)	Gets the specified Data Guard association's configuration information.
get_database(database_id, **kwargs)	Gets information about the specified database.
get_database_snapshot(database_snapshot_id, ...)	Gets information about the specified Exadata Database Snapshot.
get_database_software_image(...)	Gets information about the specified database software image.
get_database_upgrade_history_entry(...)	gets the upgrade history for a specified database.
get_db_connection_bundle(...)	Gets information about the specified database connection bundle.
get_db_home(db_home_id, **kwargs)	Gets information about the specified Database Home.
get_db_home_patch(db_home_id, patch_id, **kwargs)	Gets information about a specified patch package.
get_db_home_patch_history_entry(db_home_id, ...)	Gets the patch history details for the specified patchHistoryEntryId
get_db_node(db_node_id, **kwargs)	Gets information about the specified database node.
get_db_server(exadata_infrastructure_id, ...)	Gets information about the Exadata Db server.
get_db_system(db_system_id, **kwargs)	Gets information about the specified DB system.
get_db_system_os_patch_history_entry(...)	Gets the details of the specified OS patch action for the specified DB system.
get_db_system_patch(db_system_id, patch_id, ...)	Gets information the specified patch.
get_db_system_patch_history_entry(...)	Gets the details of the specified patch operation on the specified DB system.
get_db_system_upgrade_history_entry(...)	Gets the details of the specified operating system upgrade operation for the specified DB system.
get_dbnode_snapshot(dbnode_snapshot_id, **kwargs)	Gets information about the specified Exadata Database Node Snapshot in the specified compartment.
get_exadata_infrastructure(...)	Gets information about the specified Exadata infrastructure.
get_exadata_infrastructure_ocpus(...)	Gets details of the available and consumed OCPUs for the specified Autonomous Exadata Infrastructure resource.
get_exadata_infrastructure_un_allocated_resources(...)	Gets un allocated resources information for the specified Exadata infrastructure.
get_exadata_iorm_config(db_system_id, **kwargs)	Gets the IORM configuration settings for the specified cloud Exadata DB system.
get_exadb_vm_cluster(exadb_vm_cluster_id, ...)	Gets information about the specified Exadata VM cluster on Exascale Infrastructure.
get_exadb_vm_cluster_update(...)	Gets information about a specified maintenance update package for a Exadata VM cluster on Exascale Infrastructure.
get_exadb_vm_cluster_update_history_entry(...)	Gets the maintenance update history details for the specified update history entry.
get_exascale_db_storage_vault(...)	Gets information about the specified Exadata Database Storage Vaults in the specified compartment.
get_execution_action(execution_action_id, ...)	Gets information about the specified execution action.
get_execution_window(execution_window_id, ...)	Gets information about the specified execution window.
get_external_backup_job(backup_id, **kwargs)	Gets information about the specified external backup job.
get_external_container_database(...)	Gets information about the specified external container database.
get_external_database_connector(...)	Gets information about the specified external database connector.
get_external_non_container_database(...)	Gets information about a specific external non-container database.
get_external_pluggable_database(...)	Gets information about a specific create_external_pluggable_database_details() resource.
get_gi_home(gi_home_id, **kwargs)	Gets information about the specified Grid Infrastructure Home.
get_infrastructure_target_versions(...)	Gets details of the Exadata Infrastructure target system software versions that can be applied to the specified infrastructure resource for maintenance updates.
get_key_store(key_store_id, **kwargs)	Gets information about the specified key store.
get_maintenance_run(maintenance_run_id, **kwargs)	Gets information about the specified maintenance run.
get_maintenance_run_history(...)	Gets information about the specified maintenance run history.
get_oneoff_patch(oneoff_patch_id, **kwargs)	Gets information about the specified one-off patch.
get_pdb_conversion_history_entry(...)	Gets the details of operations performed to convert the specified database from non-container (non-CDB) to pluggable (PDB).
get_pluggable_database(...)	Gets information about the specified pluggable database.
get_pluggable_database_snapshot(...)	Gets information about the specified Exadata Pluggable Database Snapshot in the specified compartment.
get_scheduled_action(scheduled_action_id, ...)	Gets information about the specified Scheduled Action.
get_scheduling_plan(scheduling_plan_id, **kwargs)	Gets information about the specified Scheduling Plan.
get_scheduling_policy(scheduling_policy_id, ...)	Gets information about the specified Scheduling Policy.
get_scheduling_window(scheduling_policy_id, ...)	Gets information about the specified Scheduling Window.
get_vm_cluster(vm_cluster_id, **kwargs)	Gets information about the VM cluster.
get_vm_cluster_network(...)	Gets information about the specified VM cluster network.
get_vm_cluster_patch(vm_cluster_id, ...)	Gets information about a specified patch package.
get_vm_cluster_patch_history_entry(...)	Gets the patch history details for the specified patch history entry.
get_vm_cluster_update(vm_cluster_id, ...)	Gets information about a specified maintenance update package for a VM cluster.
get_vm_cluster_update_history_entry(...)	Gets the maintenance update history details for the specified update history entry.
import_transportable_tablespace(...)	Imports transportable tablespace for the specified Autonomous AI Database.
launch_autonomous_exadata_infrastructure(...)	Deprecated To create a new Autonomous AI Database system on dedicated Exadata Infrastructure, use the create_cloud_exadata_infrastructure() and create_cloud_autonomous_vm_cluster() operations instead.
launch_db_system(launch_db_system_details, ...)	Creates a new DB system in the specified compartment and availability domain.
list_advanced_cluster_file_systems(...)	Lists the advanced cluster file system resources in the specified compartment.
list_application_vips(compartment_id, ...)	Gets a list of application virtual IP (VIP) addresses on a cloud VM cluster.
list_autonomous_container_database_backups(...)	Gets a list of Autonomous Container Database backups by using either the 'autonomousDatabaseId' or 'compartmentId' as your query parameter.
list_autonomous_container_database_dataguard_associations(...)	Deprecated. Use the list_autonomous_container_databases() operation to get a list of the Autonomous Container Databases (ACDs)with Autonomous Data Guard-enabled associated with the specified ACD.
list_autonomous_container_database_versions(...)	Gets a list of supported Autonomous Container Database versions.
list_autonomous_container_databases(...)	Gets a list of the Autonomous Container Databases in the specified compartment.
list_autonomous_database_backups(**kwargs)	Gets a list of Autonomous AI Database backups based on either the autonomousDatabaseId or compartmentId specified as a query parameter.
list_autonomous_database_character_sets(**kwargs)	Gets a list of supported character sets.
list_autonomous_database_clones(...)	Lists the Autonomous AI Database clones for the specified Autonomous AI Database.
list_autonomous_database_dataguard_associations(...)	Deprecated. Use the get_autonomous_container_database() operation to get a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous AI Database.
list_autonomous_database_peers(...)	Lists the Autonomous AI Database peers for the specified Autonomous AI Database.
list_autonomous_database_refreshable_clones(...)	Lists the OCIDs of the Autonomous AI Database local and connected remote refreshable clones with the region where they exist for the specified source database.
list_autonomous_database_software_images(...)	Gets a list of the Autonomous AI Database Software Images in the specified compartment.
list_autonomous_databases(compartment_id, ...)	Gets a list of Autonomous AI Databases based on the query parameters specified.
list_autonomous_databases_in_autonomous_container_database_backup(...)	Gets a list of Autonomous Databases associated with backups at the given timestamp for the specified Autonomous Container Database.
list_autonomous_db_preview_versions(...)	Gets a list of supported Autonomous AI Database versions.
list_autonomous_db_versions(compartment_id, ...)	Gets a list of supported Autonomous AI Database versions.
list_autonomous_exadata_infrastructure_shapes(...)	Deprecated.
list_autonomous_exadata_infrastructures(...)	Deprecated. Use the list_cloud_exadata_infrastructures() operation to list Exadata Infrastructures in the Oracle cloud and the list_cloud_autonomous_vm_clusters() operation to list Autonomous Exadata VM clusters.
list_autonomous_virtual_machines(...)	Lists the Autonomous Virtual Machines in the specified Autonomous VM Cluster and Compartment.
list_autonomous_vm_cluster_acd_resource_usage(...)	Gets the list of resource usage details for all the Autonomous Container Database in the specified Autonomous Exadata VM cluster.
list_autonomous_vm_clusters(compartment_id, ...)	Gets a list of Exadata Cloud@Customer Autonomous VM clusters in the specified compartment.
list_available_maintenance_windows(...)	Retrieves the list of available maintenance window options for the specified Autonomous AI Database.
list_backup_destination(compartment_id, **kwargs)	Gets a list of backup destinations in the specified compartment.
list_backups(**kwargs)	Gets a list of backups based on the databaseId or compartmentId specified.
list_basecc_vm_cluster_update_history_entries(...)	Gets the history of the maintenance update actions performed on the specified BaseDB-C@C VM cluster.
list_basecc_vm_cluster_updates(...)	Lists the maintenance updates that can be applied to the specified BaseDB-C@C VM cluster.
list_basecc_vm_clusters(compartment_id, **kwargs)	Lists the BaseDB-C@C VM clusters in the specified compartment.
list_cloud_autonomous_vm_cluster_acd_resource_usage(...)	Gets the list of resource usage details for all the Cloud Autonomous Container Database in the specified Cloud Autonomous Exadata VM cluster.
list_cloud_autonomous_vm_clusters(...)	Lists Autonomous Exadata VM clusters in the Oracle cloud.
list_cloud_exadata_infrastructures(...)	Gets a list of the cloud Exadata infrastructure resources in the specified compartment.
list_cloud_vm_cluster_update_history_entries(...)	Gets the history of the maintenance update actions performed on the specified cloud VM cluster.
list_cloud_vm_cluster_updates(...)	Lists the maintenance updates that can be applied to the specified cloud VM cluster.
list_cloud_vm_clusters(compartment_id, **kwargs)	Gets a list of the cloud VM clusters in the specified compartment.
list_console_connections(db_node_id, **kwargs)	Lists the console connections for the specified database node.
list_console_histories(db_node_id, **kwargs)	Lists the console histories for the specified database node.
list_container_database_patches(...)	Lists the patches applicable to the requested container database.
list_data_guard_associations(database_id, ...)	Lists all Data Guard associations for the specified database.
list_database_snapshots(**kwargs)	Gets a list of the Exadata Database Snapshots in the specified compartment.
list_database_software_images(...)	Gets a list of the database software images in the specified compartment.
list_database_upgrade_history_entries(...)	Gets the upgrade history for a specified database in a bare metal or virtual machine DB system.
list_databases(compartment_id, **kwargs)	Gets a list of the databases in the specified Database Home.
list_db_connection_bundles(compartment_id, ...)	Lists all database connection bundles that match the query parameters.
list_db_home_patch_history_entries(...)	Lists the history of patch operations on the specified Database Home.
list_db_home_patches(db_home_id, **kwargs)	Lists patches applicable to the requested Database Home.
list_db_homes(compartment_id, **kwargs)	Lists the Database Homes in the specified DB system and compartment.
list_db_nodes(compartment_id, **kwargs)	Lists the database nodes in the specified DB system and compartment.
list_db_servers(compartment_id, ...)	Lists the Exadata DB servers in the ExadataInfrastructureId and specified compartment.
list_db_system_compute_performances(**kwargs)	Gets a list of expected compute performance parameters for a virtual machine DB system based on system configuration.
list_db_system_os_patch_history_entries(...)	Gets the history of the OS patch actions performed on the specified DB system.
list_db_system_patch_history_entries(...)	Gets the history of the patch actions performed on the specified DB system.
list_db_system_patches(db_system_id, **kwargs)	Lists the patches applicable to the specified DB system.
list_db_system_shapes(compartment_id, **kwargs)	Gets a list of the shapes that can be used to launch a new DB system.
list_db_system_storage_performances(...)	Gets a list of possible expected storage performance parameters of a VMDB System based on Configuration.
list_db_system_upgrade_history_entries(...)	Gets the history of the upgrade actions performed on the specified DB system.
list_db_system_upgrades(db_system_id, **kwargs)	Lists the applicable upgrade components for a DB systems.
list_db_systems(compartment_id, **kwargs)	Lists the DB systems in the specified compartment.
list_db_versions(compartment_id, **kwargs)	Gets a list of supported Oracle Database versions.
list_dbnode_snapshots(compartment_id, **kwargs)	Gets a list of the Exadata Database Node Snapshots in the specified compartment.
list_estimate_cost_savings(is_cpu_autoscale, ...)	Gets the estimate cost savings of the Autonomous AI Database.
list_exadata_infrastructures(compartment_id, ...)	Lists the Exadata infrastructure resources in the specified compartment.
list_exadb_vm_cluster_update_history_entries(...)	Gets the history of the maintenance update actions performed on the specified Exadata VM cluster on Exascale Infrastructure.
list_exadb_vm_cluster_updates(...)	Lists the maintenance updates that can be applied to the specified Exadata VM cluster on Exascale Infrastructure.
list_exadb_vm_clusters(compartment_id, **kwargs)	Gets a list of the Exadata VM clusters on Exascale Infrastructure in the specified compartment.
list_exascale_db_storage_vaults(...)	Gets a list of the Exadata Database Storage Vaults in the specified compartment.
list_execution_actions(compartment_id, **kwargs)	Lists the execution action resources in the specified compartment.
list_execution_windows(compartment_id, **kwargs)	Lists the execution window resources in the specified compartment.
list_external_container_databases(...)	Gets a list of the external container databases in the specified compartment.
list_external_database_connectors(...)	Gets a list of the external database connectors in the specified compartment.
list_external_non_container_databases(...)	Gets a list of the ExternalNonContainerDatabases in the specified compartment.
list_external_pluggable_databases(...)	Gets a list of the create_external_pluggable_database_details() resources in the specified compartment.
list_flex_components(compartment_id, **kwargs)	Gets a list of the flex components that can be used to launch a new DB system.
list_gi_homes(compartment_id, **kwargs)	Lists the Grid Infrastructure Homes.
list_gi_version_minor_versions(version, **kwargs)	Gets a list of supported Oracle Grid Infrastructure minor versions for the given major version and shape family.
list_gi_versions(compartment_id, **kwargs)	Gets a list of supported GI versions.
list_key_stores(compartment_id, **kwargs)	Gets a list of key stores in the specified compartment.
list_maintenance_run_history(compartment_id, ...)	Gets a list of the maintenance run histories in the specified compartment.
list_maintenance_runs(compartment_id, **kwargs)	Gets a list of the maintenance runs in the specified compartment.
list_oneoff_patches(compartment_id, **kwargs)	Lists one-off patches in the specified compartment.
list_params_for_action_type(type, **kwargs)	List all the action params and their possible values for a given action type
list_pdb_conversion_history_entries(...)	Gets the pluggable database conversion history for a specified database in a bare metal or virtual machine DB system.
list_pluggable_database_snapshots(**kwargs)	Gets a list of the Exadata Pluggable Database Snapshots in the specified compartment.
list_pluggable_databases(**kwargs)	Gets a list of the pluggable databases in a database or compartment.
list_recommended_scheduled_actions(...)	Returns a recommended Scheduled Actions configuration for a given resource, plan intent and scheduling policy.
list_resource_pool_members(...)	Lists the OCIDs of the Autonomous AI Database resource pool members for the specified Autonomous AI Database leader.
list_scheduled_actions(compartment_id, **kwargs)	Lists the Scheduled Action resources in the specified compartment.
list_scheduling_plans(compartment_id, **kwargs)	Lists the Scheduling Plan resources in the specified compartment.
list_scheduling_policies(compartment_id, ...)	Lists the Scheduling Policy resources in the specified compartment.
list_scheduling_windows(...)	Lists the Scheduling Window resources in the specified compartment.
list_system_version_minor_versions(...)	Retrieves a list of supported minor versions for the specified Exadata System Software major version.
list_system_versions(compartment_id, ...)	Gets a list of supported Exadata system versions for a given shape and GI version.
list_vm_cluster_networks(...)	Gets a list of the VM cluster networks in the specified compartment.
list_vm_cluster_patch_history_entries(...)	Gets the history of the patch actions performed on the specified VM cluster in an Exadata Cloud@Customer system.
list_vm_cluster_patches(vm_cluster_id, **kwargs)	Lists the patches applicable to the specified VM cluster in an Exadata Cloud@Customer system.
list_vm_cluster_update_history_entries(...)	Gets the history of the maintenance update actions performed on the specified VM cluster.
list_vm_cluster_updates(vm_cluster_id, **kwargs)	Lists the maintenance updates that can be applied to the specified VM cluster.
list_vm_clusters(compartment_id, **kwargs)	Lists the VM clusters in the specified compartment.
local_clone_pluggable_database(...)	Deprecated. Use create_pluggable_database() for Pluggable Database LocalClone Operation.
migrate_autonomous_container_database_dataguard_association(...)	Migrate Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter.
migrate_data_guard_association_to_multi_data_guards(...)	Migrates the existing Data Guard association to new Data Guard model to support multiple standby databases functionality.
migrate_exadata_db_system_resource_model(...)	Migrates the Exadata DB system to the new `Exadata resource model`__.
migrate_vault_key(database_id, ...)	Changes encryption key management from customer-managed, using the `Vault service`__, to Oracle-managed.
modify_database_management(database_id, ...)	Updates one or more attributes of the Database Management service for the database.
modify_pluggable_database_management(...)	Updates one or more attributes of the Database Management service for the pluggable database.
mount_advanced_cluster_file_system(...)	Mounts the advanced cluster file system to all the virtual machines within a vmcluster.
mount_dbnode_snapshot(...)	Mounts the snapshot for the provided dbNode.
move_execution_action_member(...)	Moves an execution action member to this execution action resource from another.
refresh_data_guard_health_status(...)	Refreshes the Data Guard health status for the specified database.
refresh_pluggable_database(...)	Refreshes a pluggable database (PDB) Refreshable clone.
register_autonomous_database_data_safe(...)	Asynchronously registers this Autonomous AI Database with Data Safe.
register_cloud_autonomous_vm_cluster_pkcs(...)	Install the PKCS11 driver for given keystore type
register_cloud_vm_cluster_pkcs(...)	Install the PKCS11 driver for given keystore type
register_exadb_vm_cluster_pkcs(...)	Install the PKCS11 driver for given keystore type
reinstate_autonomous_container_database_dataguard(...)	Reinstates a disabled standby Autonomous Container Database (ACD), identified by the autonomousContainerDatabaseId parameter to an active standby ACD.
reinstate_autonomous_container_database_dataguard_association(...)	Deprecated. Use the reinstate_autonomous_container_database_dataguard() operation to reinstate a disabled standby Autonomous Container Database (ACD), identified by the autonomousContainerDatabaseId parameter, to an active standby ACD.
reinstate_data_guard(database_id, ...)	Reinstates the database identified by the databaseId parameter into the standby role in a Data Guard association.
reinstate_data_guard_association(...)	Reinstates the database identified by the databaseId parameter into the standby role in a Data Guard association.
remote_clone_pluggable_database(...)	Deprecated. Use create_pluggable_database() for Pluggable Database RemoteClone Operation.
remove_virtual_machine_from_cloud_vm_cluster(...)	Remove Virtual Machines from the Cloud VM cluster.
remove_virtual_machine_from_exadb_vm_cluster(...)	Remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure.
remove_virtual_machine_from_vm_cluster(...)	Remove Virtual Machines from the VM cluster.
reorder_execution_actions(...)	Reorders the execution actions under this execution window resource.
reorder_scheduled_actions(...)	Re-order the scheduled actions under this scheduling plan resource.
reschedule_managed_db_software_update(...)	Reschedule the Managed Database Software Update
resize_vm_cluster_network(...)	Adds or removes Db server network nodes to extend or shrink the existing VM cluster network.
resource_pool_shapes(**kwargs)	Lists available resource pools shapes.
restart_autonomous_container_database(...)	Rolling restarts the specified Autonomous Container Database.
restart_autonomous_database(...)	Restarts the specified Autonomous AI Database.
restart_autonomous_vm_cluster_ords(...)	Restarts Oracle REST Data Services (ORDS) for Autonomous Exadata VM cluster.
restart_cloud_autonomous_vm_cluster_ords(...)	Restarts Oracle REST Data Services (ORDS) for a cloud Autonomous Exadata VM cluster.
restore_autonomous_database(...)	Restores an Autonomous AI Database based on the provided request parameters.
restore_database(database_id, ...)	Restore a Database based on the request parameters you provide.
rotate_autonomous_container_database_encryption_key(...)	Creates a new version of an existing `Vault service`__ key.
rotate_autonomous_database_encryption_key(...)	Rotate existing AutonomousDatabase `Vault service`__ key.
rotate_autonomous_vm_cluster_ords_certs(...)	Rotates the Oracle REST Data Services (ORDS) certificates for Autonomous Exadata VM cluster.
rotate_autonomous_vm_cluster_ssl_certs(...)	Rotates the SSL certificates for Autonomous Exadata VM cluster.
rotate_cloud_autonomous_vm_cluster_ords_certs(...)	Rotates the Oracle REST Data Services (ORDS) certificates for a cloud Autonomous Exadata VM cluster.
rotate_cloud_autonomous_vm_cluster_ssl_certs(...)	Rotates the SSL certficates for a cloud Autonomous Exadata VM cluster.
rotate_ords_certs(...)	Deprecated. Use the rotate_cloud_autonomous_vm_cluster_ords_certs() to rotate Oracle REST Data Services (ORDS) certs for an Autonomous Exadata VM cluster instead.
rotate_pluggable_database_encryption_key(...)	Create a new version of the existing encryption key.
rotate_ssl_certs(...)	Deprecated. Use the rotate_cloud_autonomous_vm_cluster_ssl_certs() to rotate SSL certs for an Autonomous Exadata VM cluster instead.
rotate_vault_key(database_id, **kwargs)	Creates a new version of an existing `Vault service`__ key.
run_data_patch(database_id, **kwargs)	Run datapatch on the specified Oracle Database and optionally on the specified Pluggable databases.
saas_admin_user_status(...)	This operation gets SaaS administrative user status of the Autonomous AI Database.
scan_external_container_database_pluggable_databases(...)	Scans for pluggable databases in the specified external container database.
set_db_key_version(database_id, ...)	Sets a new version of an existing `Vault service`__ key.
set_pdb_key_version(pluggable_database_id, ...)	Sets a new version of an existing `Vault service`__ key.
shrink_autonomous_database(...)	This operation shrinks the current allocated storage down to the current actual used data storage (actualUsedDataStorageSizeInTBs).
start_autonomous_database(...)	Starts the specified Autonomous AI Database.
start_pluggable_database(...)	Starts a stopped pluggable database.
stop_autonomous_database(...)	Stops the specified Autonomous AI Database.
stop_pluggable_database(...)	Stops a pluggable database.
switch_over_data_guard(database_id, ...)	Performs a switchover to transition primary database of this Data Guard association into a standby role.
switchover_autonomous_container_database_dataguard(...)	Switchover an Autonomous Container Database (ACD), identified by the autonomousContainerDatabaseId parameter, to an active standby ACD.
switchover_autonomous_container_database_dataguard_association(...)	Deprecated. Use the switchover_autonomous_container_database_dataguard() operation to switches over the primary Autonomous Container Database (ACD) of an Autonomous Data Guard peer association to standby role.
switchover_autonomous_database(...)	Initiates a switchover of the specified Autonomous AI Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. This API should be called in the remote region where the peer database resides. Below parameter is optional: - peerDbId Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. If this parameter is not provided, the switchover will happen in the same region.
switchover_data_guard_association(...)	Performs a switchover to transition the primary database of a Data Guard association into a standby role.
terminate_autonomous_container_database(...)	Terminates an Autonomous Container Database, which permanently deletes the container database and any databases within the container database.
terminate_autonomous_exadata_infrastructure(...)	Deprecated. To terminate an Exadata Infrastructure resource in the Oracle cloud, use the delete_cloud_exadata_infrastructure() operation.
terminate_db_system(db_system_id, **kwargs)	Terminates a DB system and permanently deletes it and any databases running on it, and any storage volumes attached to it.
unmount_advanced_cluster_file_system(...)	Unmounts the advanced cluster file system from all the virtual machines within a vmcluster.
unmount_dbnode_snapshot(...)	Unmounts the snapshot for the provided dbNode.
unregister_cloud_autonomous_vm_cluster_pkcs(...)	Uninstall the PKCS11 driver for given keystore type
unregister_cloud_vm_cluster_pkcs(...)	Uninstall the PKCS11 driver for given keystore type
unregister_exadb_vm_cluster_pkcs(...)	Uninstall the PKCS11 driver for given keystore type
update_advanced_cluster_file_system(...)	Updates the advanced cluster file system resource.
update_autonomous_container_database(...)	Updates the properties of an Autonomous Container Database, such as display name, maintenance preference, backup retention, and tags.
update_autonomous_container_database_dataguard_association(...)	Deprecated. Use the edit_autonomous_container_database_dataguard() operation to update an Autonomous Data Guard association.
update_autonomous_database(...)	Updates one or more attributes of the specified Autonomous AI Database.
update_autonomous_database_backup(...)	Updates the Autonomous AI Database backup of the specified database based on the request parameters.
update_autonomous_database_regional_wallet(...)	Updates the Autonomous AI Database regional wallet.
update_autonomous_database_software_image(...)	Updates the properties of an Autonomous AI Database Software Image, like add tags
update_autonomous_database_wallet(...)	Updates the wallet for the specified Autonomous AI Database.
update_autonomous_exadata_infrastructure(...)	Deprecated. Use the update_cloud_exadata_infrastructure() operation to update an Exadata Infrastructure resource and update_cloud_autonomous_vm_cluster() operation to update an Autonomous Exadata VM cluster.
update_autonomous_vm_cluster(...)	Updates the specified Autonomous VM cluster for the Exadata Cloud@Customer system.To update an Autonomous VM Cluster in the Oracle cloud, see update_cloud_autonomous_vm_cluster().
update_backup(backup_id, ...)	Updates database backup details.
update_backup_destination(...)	If no database is associated with the backup destination: - For a RECOVERY_APPLIANCE backup destination, updates the connection string and/or the list of VPC users.
update_basecc_vm_cluster(...)	Updates the specified BaseDB-C@C VM cluster.
update_cloud_autonomous_vm_cluster(...)	Updates the specified Autonomous Exadata VM cluster in the Oracle cloud.
update_cloud_exadata_infrastructure(...)	Updates the Cloud Exadata infrastructure resource.
update_cloud_vm_cluster(cloud_vm_cluster_id, ...)	Updates the specified cloud VM cluster.
update_cloud_vm_cluster_iorm_config(...)	Updates the IORM settings for the specified cloud VM cluster in an Exadata Cloud Service instance.
update_console_connection(db_node_id, ...)	Updates the specified database node console connection.
update_console_history(db_node_id, ...)	Updates the specified database node console history.
update_data_guard(database_id, ...)	Update an existing Data Guard member.
update_data_guard_association(database_id, ...)	Updates the Data Guard association the specified database.
update_database(database_id, ...)	Update the specified database based on the request parameters provided.
update_database_snapshot(...)	Updates a Database Snapshot
update_database_software_image(...)	Updates the properties of a Database Software Image, like Display Nmae
update_db_home(db_home_id, ...)	Patches the specified Database Home.
update_db_node(db_node_id, ...)	Updates the specified database node.
update_db_system(db_system_id, ...)	Updates the properties of the specified DB system.
update_exadata_infrastructure(...)	Updates the Exadata infrastructure resource.
update_exadata_iorm_config(db_system_id, ...)	Updates IORM settings for the specified Exadata DB system.
update_exadb_vm_cluster(exadb_vm_cluster_id, ...)	Updates the specified Exadata VM cluster on Exascale Infrastructure.
update_exascale_db_storage_vault(...)	Updates the specified Exadata Database Storage Vault.
update_execution_action(execution_action_id, ...)	Updates the execution action resource.
update_execution_window(execution_window_id, ...)	Updates the execution window resource.
update_external_container_database(...)	Updates the properties of an create_external_container_database_details() resource, such as the display name.
update_external_database_connector(...)	Updates the properties of an external database connector, such as the display name.
update_external_non_container_database(...)	Updates the properties of an external non-container database, such as the display name.
update_external_pluggable_database(...)	Updates the properties of an create_external_pluggable_database_details() resource, such as the display name.
update_gi_home(gi_home_id, ...)	Updates the tags and display name of a specified Grid Infrastructure Home.
update_key_store(key_store_id, ...)	Edit the key store.
update_maintenance_run(maintenance_run_id, ...)	Updates the properties of a maintenance run, such as the state of a maintenance run.
update_oneoff_patch(oneoff_patch_id, ...)	Updates the properties of the specified one-off patch.
update_pluggable_database(...)	Updates the specified pluggable database.
update_scheduled_action(scheduled_action_id, ...)	Updates the Scheduled Action resource.
update_scheduling_policy(...)	Updates the Scheduling Policy resource.
update_scheduling_window(...)	Updates the Scheduling Window resource.
update_vm_cluster(vm_cluster_id, ...)	Updates the specified VM cluster.
update_vm_cluster_network(...)	Updates the specified VM cluster network.
upgrade_database(database_id, ...)	Upgrades the specified Oracle Database instance.
upgrade_db_system(db_system_id, ...)	Upgrades the operating system and grid infrastructure of the DB system.
validate_vm_cluster_network(...)	Validates the specified VM cluster network.

__init__(config, **kwargs)

Creates a new service client

Parameters

• config (dict) – Configuration keys and values as per SDK and Tool Configuration. The from_file() method can be used to load configuration from a file. Alternatively, a dict can be passed. You can validate_config the dict using validate_config()

• service_endpoint (str) – (optional) The endpoint of the service to call using this client. For example https://iaas.us-ashburn-1.oraclecloud.com. If this keyword argument is not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit need to specify a service endpoint.

• timeout (float or tuple(float, float)) – (optional) The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout.

• signer (AbstractBaseSigner) –

  (optional) The signer to use when signing requests made by the service client. The default is to use a Signer based on the values provided in the config parameter.

  One use case for this parameter is for Instance Principals authentication by passing an instance of InstancePrincipalsSecurityTokenSigner as the value for this keyword argument

• retry_strategy (obj) –

  (optional) A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. Retry strategies can also be applied at the operation level by passing a retry_strategy keyword argument as part of calling the operation. Any value provided at the operation level will override whatever is specified at the client level.

  This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

• circuit_breaker_strategy (obj) – (optional) A circuit breaker strategy to apply to all calls made by this service client (i.e. at the client level). This client uses DEFAULT_CIRCUIT_BREAKER_STRATEGY as default if no circuit breaker strategy is provided. The specifics of circuit breaker strategy are described here.

• circuit_breaker_callback (function) – (optional) Callback function to receive any exceptions triggerred by the circuit breaker.

• client_level_realm_specific_endpoint_template_enabled (bool) – (optional) A boolean flag to indicate whether or not this client should be created with realm specific endpoint template enabled or disable. By default, this will be set as None.

• allow_control_chars – (optional) allow_control_chars is a boolean to indicate whether or not this client should allow control characters in the response object. By default, the client will not allow control characters to be in the response object.

• enable_strict_url_encoding – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this client should enable strict url encoding in path params of a request. By default, the client will not enable strict url encoding

activate_exadata_infrastructure(exadata_infrastructure_id, activate_exadata_infrastructure_details, **kwargs)

Activates the specified Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• activate_exadata_infrastructure_details (oci.database.models.ActivateExadataInfrastructureDetails) – (required) The activation details for the Exadata infrastructure and the additional storage servers requested.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use activate_exadata_infrastructure API.

add_dbnode_snapshots_for_exadb_vm_cluster(add_dbnode_snapshots_for_exadb_vm_cluster_details, exadb_vm_cluster_id, **kwargs)

Add a database node snapshots to the Exadb VM cluster..

Parameters

• add_dbnode_snapshots_for_exadb_vm_cluster_details (oci.database.models.AddDbnodeSnapshotsForExadbVmClusterDetails) – (required) Request to add a database node snapshots to the Exadb VM cluster..

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbnodeSnapshots

Return type

Response

Example

Click here to see an example of how to use add_dbnode_snapshots_for_exadb_vm_cluster API.

add_standby_autonomous_container_database(add_standby_autonomous_container_database_details, autonomous_container_database_id, **kwargs)

Add a standby Autonomous Container Database. For more information about Autonomous Data Guard,see `Protect Critical Databases from Failures and Disasters Using Autonomous Data Guard`__.

Parameters

• add_standby_autonomous_container_database_details (oci.database.models.AddStandbyAutonomousContainerDatabaseDetails) – (required) Request to Add Standy Autonomous Container Database Dataguard.

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use add_standby_autonomous_container_database API.

add_storage_capacity_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, **kwargs)

Makes the storage capacity from additional storage servers available for Cloud VM Cluster consumption. Applies to Exadata Cloud Service instances and Autonomous AI Database on dedicated Exadata infrastructure only.

Parameters

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use add_storage_capacity_cloud_exadata_infrastructure API.

add_storage_capacity_exadata_infrastructure(exadata_infrastructure_id, **kwargs)

Makes the storage capacity from additional storage servers available for VM Cluster consumption. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use add_storage_capacity_exadata_infrastructure API.

add_virtual_machine_to_cloud_vm_cluster(add_virtual_machine_to_cloud_vm_cluster_details, cloud_vm_cluster_id, **kwargs)

Add Virtual Machines to the Cloud VM cluster. Applies to Exadata Cloud instances only.

Parameters

• add_virtual_machine_to_cloud_vm_cluster_details (oci.database.models.AddVirtualMachineToCloudVmClusterDetails) – (required) Request to add Virtual Machines to the Cloud VM cluster.

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudVmCluster

Return type

Response

Example

Click here to see an example of how to use add_virtual_machine_to_cloud_vm_cluster API.

add_virtual_machine_to_vm_cluster(add_virtual_machine_to_vm_cluster_details, vm_cluster_id, **kwargs)

Add Virtual Machines to the VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• add_virtual_machine_to_vm_cluster_details (oci.database.models.AddVirtualMachineToVmClusterDetails) – (required) Request to add Virtual Machines to the VM cluster.

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmCluster

Return type

Response

Example

Click here to see an example of how to use add_virtual_machine_to_vm_cluster API.

autonomous_database_manual_refresh(autonomous_database_id, autonomous_database_manual_refresh_details, **kwargs)

Initiates a data refresh for an Autonomous AI Database refreshable clone. Data is refreshed from the source database to the point of a specified timestamp.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• autonomous_database_manual_refresh_details (oci.database.models.AutonomousDatabaseManualRefreshDetails) – (required) Request details for manually refreshing an Autonomous AI Database refreshable clone.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use autonomous_database_manual_refresh API.

cancel_backup(backup_id, **kwargs)

Cancel automatic/standalone full/incremental create backup workrequests specified by the backup Id.

Parameters

• backup_id (str) –

  (required) The backup `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use cancel_backup API.

cancel_execution_window(execution_window_id, cancel_execution_window_details, **kwargs)

Cancels the in progress maintenance activity under this execution window.

Parameters

• execution_window_id (str) –

  (required) The execution window `OCID`__.

• cancel_execution_window_details (oci.database.models.CancelExecutionWindowDetails) – (required) Request to cancel the in progress maintenance activity under this execution window.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionWindow

Return type

Response

Example

Click here to see an example of how to use cancel_execution_window API.

cascading_delete_scheduling_plan(scheduling_plan_id, **kwargs)

Delete the scheduling plan resource along with all the scheduled actions associated with this resource.

Parameters

• scheduling_plan_id (str) –

  (required) The Schedule Plan `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use cascading_delete_scheduling_plan API.

change_autonomous_container_database_compartment(change_compartment_details, autonomous_container_database_id, **kwargs)

Move the Autonomous Container Database and its dependent resources to the specified compartment. For more information about moving Autonomous Container Databases, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move Autonomous Container Database to a different compartment

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_autonomous_container_database_compartment API.

change_autonomous_database_compartment(change_compartment_details, autonomous_database_id, **kwargs)

Move the Autonomous AI Database and its dependent resources to the specified compartment. For more information about moving Autonomous AI Databases, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move Autonomous AI Database to a different compartment

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_autonomous_database_compartment API.

change_autonomous_database_software_image_compartment(change_autonomous_database_software_image_compartment_details, autonomous_database_software_image_id, **kwargs)

Move the Autonomous AI Database Software Image and its dependent resources to the specified compartment.

Parameters

• change_autonomous_database_software_image_compartment_details (oci.database.models.ChangeAutonomousDatabaseSoftwareImageCompartmentDetails) – (required) Request to move Autonomous AI Database Software Image to a different compartment

• autonomous_database_software_image_id (str) –

  (required) The Autonomous AI Database Software Image `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_autonomous_database_software_image_compartment API.

change_autonomous_database_subscription(change_autonomous_database_subscription_details, autonomous_database_id, **kwargs)

Associate an Autonomous AI Database with a different subscription.

Parameters

• change_autonomous_database_subscription_details (oci.database.models.ChangeAutonomousDatabaseSubscriptionDetails) – (required) Associate an Autonomous AI Database with a different subscription.

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_autonomous_database_subscription API.

change_autonomous_exadata_infrastructure_compartment(change_compartment_details, autonomous_exadata_infrastructure_id, **kwargs)

Deprecated. Use the change_cloud_exadata_infrastructure_compartment() operation to move an Exadata infrastructure resource to a different compartment and change_cloud_autonomous_vm_cluster_compartment() operation to move an Autonomous Exadata VM cluster to a different compartment. For more information, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move an Autonomous Exadata Infrastructure resource to a different compartment.

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_autonomous_exadata_infrastructure_compartment API.

change_autonomous_vm_cluster_compartment(change_autonomous_vm_cluster_compartment_details, autonomous_vm_cluster_id, **kwargs)

Moves an Autonomous VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud@Customer only. For systems in the Oracle cloud, see change_autonomous_vm_cluster_compartment().

Parameters

• change_autonomous_vm_cluster_compartment_details (oci.database.models.ChangeAutonomousVmClusterCompartmentDetails) – (required) Request to move Autonomous VM cluster to a different compartment

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_autonomous_vm_cluster_compartment API.

change_backup_destination_compartment(change_compartment_details, backup_destination_id, **kwargs)

Move the backup destination and its dependent resources to the specified compartment. For more information, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move backup destination to a different compartment.

• backup_destination_id (str) –

  (required) The `OCID`__ of the backup destination.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_backup_destination_compartment API.

change_basecc_vm_cluster_compartment(change_basecc_vm_cluster_compartment_details, basecc_vm_cluster_id, **kwargs)

Moves a BaseDB-C@C VM cluster and its dependent resources to another compartment. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• change_basecc_vm_cluster_compartment_details (oci.database.models.ChangeBaseccVmClusterCompartmentDetails) – (required) Request to move the BaseDB-C@C VM cluster to a different compartment.

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_basecc_vm_cluster_compartment API.

change_cloud_autonomous_vm_cluster_compartment(change_cloud_autonomous_vm_cluster_compartment_details, cloud_autonomous_vm_cluster_id, **kwargs)

Moves an Autonomous Exadata VM cluster in the Oracle cloud and its dependent resources to another compartment. For Exadata Cloud@Customer systems, see change_autonomous_vm_cluster_compartment().

Parameters

• change_cloud_autonomous_vm_cluster_compartment_details (oci.database.models.ChangeCloudAutonomousVmClusterCompartmentDetails) – (required) Request to move cloud Autonomous VM cluster to a different compartment

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_autonomous_vm_cluster_compartment API.

change_cloud_autonomous_vm_cluster_subscription(change_cloud_autonomous_vm_cluster_subscription_details, cloud_autonomous_vm_cluster_id, **kwargs)

Associate a Cloud Autonomous VM cluster with a different subscription.

Parameters

• change_cloud_autonomous_vm_cluster_subscription_details (oci.database.models.ChangeCloudAutonomousVmClusterSubscriptionDetails) – (required) Associate a Cloud Autonomous VM cluster with a different subscription.

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_autonomous_vm_cluster_subscription API.

change_cloud_db_system_subscription(change_cloud_db_system_subscription_details, db_system_id, **kwargs)

Associate a cloud DB system with a different subscription.

Parameters

• change_cloud_db_system_subscription_details (oci.database.models.ChangeCloudDbSystemSubscriptionDetails) – (required) Associate a cloud DB system with a different subscription.

• db_system_id (str) –

  (required) The DB system `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_db_system_subscription API.

change_cloud_exadata_infrastructure_compartment(change_cloud_exadata_infrastructure_compartment_details, cloud_exadata_infrastructure_id, **kwargs)

Moves a cloud Exadata infrastructure resource and its dependent resources to another compartment. Applies to Exadata Cloud Service instances and Autonomous AI Database on dedicated Exadata infrastructure only.For more information about moving resources to a different compartment, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_cloud_exadata_infrastructure_compartment_details (oci.database.models.ChangeCloudExadataInfrastructureCompartmentDetails) – (required) Request to move cloud Exadata infrastructure resource to a different compartment.

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_exadata_infrastructure_compartment API.

change_cloud_exadata_infrastructure_subscription(change_cloud_exadata_infrastructure_subscription_details, cloud_exadata_infrastructure_id, **kwargs)

Associate a cloud Exadata infrastructure with a different subscription.

Parameters

• change_cloud_exadata_infrastructure_subscription_details (oci.database.models.ChangeCloudExadataInfrastructureSubscriptionDetails) – (required) Associate a cloud Exadata infrastructure with a different subscription.

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_exadata_infrastructure_subscription API.

change_cloud_vm_cluster_compartment(change_cloud_vm_cluster_compartment_details, cloud_vm_cluster_id, **kwargs)

Moves a cloud VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.

Parameters

• change_cloud_vm_cluster_compartment_details (oci.database.models.ChangeCloudVmClusterCompartmentDetails) – (required) Request to move cloud VM cluster to a different compartment

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_vm_cluster_compartment API.

change_cloud_vm_cluster_subscription(change_cloud_vm_cluster_subscription_details, cloud_vm_cluster_id, **kwargs)

Associate a cloud VM cluster with a different subscription.

Parameters

• change_cloud_vm_cluster_subscription_details (oci.database.models.ChangeCloudVmClusterSubscriptionDetails) – (required) Associate a cloud VM cluster with a different subscription.

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_cloud_vm_cluster_subscription API.

change_database_software_image_compartment(change_compartment_details, database_software_image_id, **kwargs)

Move the Database Software Image and its dependent resources to the specified compartment. For more information about moving Databse Software Images, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move Database Software Image to a different compartment

• database_software_image_id (str) –

  (required) The DB system `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_database_software_image_compartment API.

change_dataguard_role(change_dataguard_role_details, autonomous_container_database_id, **kwargs)

Deprecated. Use the convert_standby_autonomous_container_database() operation to switch the Autonomous Container Database (ACD) role between Standby and Snapshot Standby. For more information about changing ACD Role, see `Convert Physical Standby to Snapshot Standby`__ and `Convert Snapshot Standby to Physical Standby`__.

Parameters

• change_dataguard_role_details (oci.database.models.ChangeDataguardRoleDetails) – (required) Request to Change the Autonomous Container Database Dataguard role.

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use change_dataguard_role API.

change_db_system_compartment(change_compartment_details, db_system_id, **kwargs)

Moves the DB system and its dependent resources to the specified compartment. For more information about moving DB systems, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) –

  (required) Request to move the DB system to a different compartment.

  Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

  For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

• db_system_id (str) –

  (required) The DB system `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_db_system_compartment API.

change_disaster_recovery_configuration(autonomous_database_id, change_disaster_recovery_configuration_details, **kwargs)

This operation updates the cross-region disaster recovery (DR) details of the standby Autonomous AI Database Serverless database, and must be run on the standby side.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• change_disaster_recovery_configuration_details (oci.database.models.ChangeDisasterRecoveryConfigurationDetails) – (required) Request to update the cross-region disaster recovery (DR) details of the standby Autonomous AI Database Serverless database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use change_disaster_recovery_configuration API.

change_encryption_key_location(database_id, encryption_key_location_details, **kwargs)

Update the encryption key management location for the database

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• encryption_key_location_details (oci.database.models.EncryptionKeyLocationDetails) – (required) Request to change the source of the encryption key for the database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_encryption_key_location API.

change_exadata_infrastructure_compartment(change_exadata_infrastructure_compartment_details, exadata_infrastructure_id, **kwargs)

Moves an Exadata infrastructure resource and its dependent resources to another compartment. Applies to Exadata Cloud@Customer instances only. To move an Exadata Cloud Service infrastructure resource to another compartment, use the change_cloud_exadata_infrastructure_compartment() operation.

Parameters

• change_exadata_infrastructure_compartment_details (oci.database.models.ChangeExadataInfrastructureCompartmentDetails) – (required) Request to move Exadata infrastructure to a different compartment

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_exadata_infrastructure_compartment API.

change_exadb_vm_cluster_compartment(change_exadb_vm_cluster_compartment_details, exadb_vm_cluster_id, **kwargs)

Moves a Exadata VM cluster on Exascale Infrastructure and its dependent resources to another compartment. Applies to Exadata Database Service on Exascale Infrastructure only.

Parameters

• change_exadb_vm_cluster_compartment_details (oci.database.models.ChangeExadbVmClusterCompartmentDetails) – (required) Request to move Exadata VM cluster on Exascale Infrastructure to a different compartment

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_exadb_vm_cluster_compartment API.

change_exadb_vm_cluster_subscription(change_exadb_vm_cluster_subscription_details, exadb_vm_cluster_id, **kwargs)

Associate a Exadata VM cluster on Exascale Infrastructure with a different subscription.

Parameters

• change_exadb_vm_cluster_subscription_details (oci.database.models.ChangeExadbVmClusterSubscriptionDetails) – (required) Associate a Exadata VM cluster on Exascale Infrastructure with a different subscription.

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_exadb_vm_cluster_subscription API.

change_exascale_db_storage_vault_compartment(change_exascale_db_storage_vault_compartment_details, exascale_db_storage_vault_id, **kwargs)

Moves a Exadata Database Storage Vault to another compartment.

Parameters

• change_exascale_db_storage_vault_compartment_details (oci.database.models.ChangeExascaleDbStorageVaultCompartmentDetails) – (required) Request to move Exadata Database Storage Vault to a different compartment

• exascale_db_storage_vault_id (str) –

  (required) The Exadata Database Storage Vault `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_exascale_db_storage_vault_compartment API.

change_exascale_db_storage_vault_subscription(change_exascale_db_storage_vault_subscription_details, exascale_db_storage_vault_id, **kwargs)

Associate a Exadata Database Storage Vault with a different subscription.

Parameters

• change_exascale_db_storage_vault_subscription_details (oci.database.models.ChangeExascaleDbStorageVaultSubscriptionDetails) – (required) Associate a Exadata Database Storage Vault with a different subscription.

• exascale_db_storage_vault_id (str) –

  (required) The Exadata Database Storage Vault `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_exascale_db_storage_vault_subscription API.

change_external_container_database_compartment(change_compartment_details, external_container_database_id, **kwargs)

Move the create_external_container_database_details() and its dependent resources to the specified compartment. For more information about moving external container databases, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move the external container database to a different compartment.

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_external_container_database_compartment API.

change_external_non_container_database_compartment(change_compartment_details, external_non_container_database_id, **kwargs)

Move the external non-container database and its dependent resources to the specified compartment. For more information about moving external non-container databases, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move the external non-container database to a different compartment.

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_external_non_container_database_compartment API.

change_external_pluggable_database_compartment(change_compartment_details, external_pluggable_database_id, **kwargs)

Move the create_external_pluggable_database_details() and its dependent resources to the specified compartment. For more information about moving external pluggable databases, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move the create_external_pluggable_database_details() resource to a different compartment.

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_external_pluggable_database_compartment API.

change_key_store_compartment(change_key_store_compartment_details, key_store_id, **kwargs)

Move the key store resource to the specified compartment. For more information about moving key stores, see `Moving Database Resources to a Different Compartment`__.

Parameters

• change_key_store_compartment_details (oci.database.models.ChangeKeyStoreCompartmentDetails) – (required) Request to move key store to a different compartment

• key_store_id (str) –

  (required) The `OCID`__ of the key store.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_key_store_compartment API.

change_key_store_type(database_id, change_key_store_type_details, **kwargs)

Changes encryption key management type

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• change_key_store_type_details (oci.database.models.ChangeKeyStoreTypeDetails) – (required) Request to change the source of the encryption key for the database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_key_store_type API.

change_oneoff_patch_compartment(change_compartment_details, oneoff_patch_id, **kwargs)

Move the one-off patch to the specified compartment.

Parameters

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move one-off patch to a different compartment

• oneoff_patch_id (str) –

  (required) The one-off patch `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_oneoff_patch_compartment API.

change_scheduling_plan_compartment(change_scheduling_plan_compartment_details, scheduling_plan_id, **kwargs)

Moves an scheduling plan resource to another compartment.

Parameters

• change_scheduling_plan_compartment_details (oci.database.models.ChangeSchedulingPlanCompartmentDetails) – (required) Request to move scheduling plan to a different compartment

• scheduling_plan_id (str) –

  (required) The Schedule Plan `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_scheduling_plan_compartment API.

change_scheduling_policy_compartment(change_scheduling_policy_compartment_details, scheduling_policy_id, **kwargs)

Moves an scheduling policy resource to another compartment.

Parameters

• change_scheduling_policy_compartment_details (oci.database.models.ChangeSchedulingPolicyCompartmentDetails) – (required) Request to move scheduling policy to a different compartment

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_scheduling_policy_compartment API.

change_vm_cluster_compartment(change_vm_cluster_compartment_details, vm_cluster_id, **kwargs)

Moves a VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud@Customer instances only. To move a cloud VM cluster in an Exadata Cloud Service instance to another compartment, use the change_cloud_vm_cluster_compartment() operation.

Parameters

• change_vm_cluster_compartment_details (oci.database.models.ChangeVmClusterCompartmentDetails) – (required) Request to move the Exadata Cloud@Customer VM cluster to a different compartment.

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use change_vm_cluster_compartment API.

check_external_database_connector_connection_status(external_database_connector_id, **kwargs)

Check the status of the external database connection specified in this connector. This operation will refresh the connectionStatus and timeConnectionStatusLastUpdated fields.

Parameters

• external_database_connector_id (str) –

  (required) The `OCID`__ of the external database connector resource (ExternalDatabaseConnectorId).

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use check_external_database_connector_connection_status API.

complete_external_backup_job(backup_id, complete_external_backup_job_details, **kwargs)

Changes the status of the standalone backup resource to ACTIVE after the backup is created from the on-premises database and placed in Oracle Cloud Infrastructure Object Storage.

Note: This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information.

Parameters

• backup_id (str) –

  (required) The backup `OCID`__.

• complete_external_backup_job_details (oci.database.models.CompleteExternalBackupJobDetails) – (required) Updates the status of the backup resource.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalBackupJob

Return type

Response

Example

Click here to see an example of how to use complete_external_backup_job API.

configure_autonomous_database_vault_key(autonomous_database_id, configure_autonomous_database_vault_key_details, **kwargs)

Configures the Autonomous AI Database Vault service `key`__.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• configure_autonomous_database_vault_key_details (oci.database.models.ConfigureAutonomousDatabaseVaultKeyDetails) –

  (required) Configuration details for the Autonomous AI Database Vault service `key`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use configure_autonomous_database_vault_key API.

configure_exascale_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, configure_exascale_cloud_exadata_infrastructure_details, **kwargs)

Configures Exascale on Cloud exadata infrastructure resource. Applies to Exadata Cloud Service instances only.

Parameters

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• configure_exascale_cloud_exadata_infrastructure_details (oci.database.models.ConfigureExascaleCloudExadataInfrastructureDetails) – (required) The exascale config details for the Exadata infrastructure with the total storage needed.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use configure_exascale_cloud_exadata_infrastructure API.

configure_exascale_exadata_infrastructure(exadata_infrastructure_id, configure_exascale_exadata_infrastructure_details, **kwargs)

Configures Exascale on Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• configure_exascale_exadata_infrastructure_details (oci.database.models.ConfigureExascaleExadataInfrastructureDetails) – (required) The exascale config details for the Exadata infrastructure with the total storage needed.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use configure_exascale_exadata_infrastructure API.

configure_saas_admin_user(autonomous_database_id, configure_saas_admin_user_details, **kwargs)

This operation updates SaaS administrative user configuration of the Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• configure_saas_admin_user_details (oci.database.models.ConfigureSaasAdminUserDetails) – (required) Request to update SaaS administrative user configuration of the Autonomous AI Database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use configure_saas_admin_user API.

confirm_key_store_details_are_correct(key_store_id, **kwargs)

This is for user to confirm to DBaaS that the Oracle Key Valut (OKV) connection IPs, username and password are all correct. This operation will put the Key Store back into Active state. If details are incorrect, your OKV account may get locked after some unsuccessful attempts to connect.

Parameters

• key_store_id (str) –

  (required) The `OCID`__ of the key store.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use confirm_key_store_details_are_correct API.

convert_standby_autonomous_container_database(convert_standby_autonomous_container_database_details, autonomous_container_database_id, **kwargs)

Convert the standby Autonomous Container Database (ACD) between physical standby and snapshot standby ACD. For more information about converting standby ACDs, see `Convert Physical Standby to Snapshot Standby`__ and `Convert Snapshot Standby to Physical Standby`__.

Parameters

• convert_standby_autonomous_container_database_details (oci.database.models.ConvertStandbyAutonomousContainerDatabaseDetails) – (required) Request to Convert Standby Autonomous Container Database .

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use convert_standby_autonomous_container_database API.

convert_standby_database_type(database_id, convert_standby_database_type_details, **kwargs)

Performs transition from standby database into a snapshot standby and vice versa. The transition performed based on the current role of the database, if the current role is standby then this operation will convert it to snapshot standby and if the current role is snapshot standby then this operation will convert it to standby.

This operation should be performed on respective standby/snapshot standby database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• convert_standby_database_type_details (oci.database.models.ConvertStandbyDatabaseTypeDetails) – (required) Request parameters needed to convert Standby to snapshot standby and vice-versa.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use convert_standby_database_type API.

convert_to_pdb(database_id, convert_to_pdb_details, **kwargs)

Converts a non-container database to a pluggable database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• convert_to_pdb_details (oci.database.models.ConvertToPdbDetails) – (required) Request to convert a non-container database to a pluggable database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use convert_to_pdb API.

convert_to_regular_pluggable_database(convert_to_regular_pluggable_database_details, pluggable_database_id, **kwargs)

Converts a Refreshable clone to Regular pluggable database (PDB). Pluggable Database will be in READ_WRITE openmode after conversion.

Parameters

• convert_to_regular_pluggable_database_details (oci.database.models.ConvertToRegularPluggableDatabaseDetails) – (required) Request to convert a Refreshable clone pluggable database (PDB) to a Regular pluggable database.

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use convert_to_regular_pluggable_database API.

convert_to_standalone(database_id, convert_to_standalone_details, **kwargs)

Disassociate the standby database identified by the databaseId parameter from existing Data Guard group.

Convert the standby to a standalone database.

This operation should be performed on respective standby database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• convert_to_standalone_details (oci.database.models.ConvertToStandaloneDetails) – (required) A request to update an existing Data Guard member.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use convert_to_standalone API.

create_advanced_cluster_file_system(create_advanced_cluster_file_system_details, **kwargs)

Creates an advanced cluster file system resource.

Parameters

• create_advanced_cluster_file_system_details (oci.database.models.CreateAdvancedClusterFileSystemDetails) – (required) Request to an advanced cluster file system.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AdvancedClusterFileSystem

Return type

Response

Example

Click here to see an example of how to use create_advanced_cluster_file_system API.

create_application_vip(create_application_vip_details, **kwargs)

Creates a new application virtual IP (VIP) address in the specified cloud VM cluster based on the request parameters you provide.

Parameters

• create_application_vip_details (oci.database.models.CreateApplicationVipDetails) – (required) Request to create a new application virtual IP (VIP) address.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ApplicationVip

Return type

Response

Example

Click here to see an example of how to use create_application_vip API.

create_autonomous_container_database(create_autonomous_container_database_details, **kwargs)

Creates an Autonomous Container Database in the specified Autonomous Exadata Infrastructure.

Parameters

• create_autonomous_container_database_details (oci.database.models.CreateAutonomousContainerDatabaseBase) – (required) Request to create an Autonomous Container Database in a specified Autonomous Exadata Infrastructure or in Autonomous VM Cluster.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use create_autonomous_container_database API.

create_autonomous_container_database_dataguard_association(autonomous_container_database_id, create_autonomous_container_database_dataguard_association_details, **kwargs)

Deprecated. Use the add_standby_autonomous_container_database() operation to create a new Autonomous Data Guard association. An Autonomous Data Guard association represents the replication relationship between the specified Autonomous Container database and a peer Autonomous Container database. For more information, see `Using Oracle Data Guard`__.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• create_autonomous_container_database_dataguard_association_details (oci.database.models.CreateAutonomousContainerDatabaseDataguardAssociationDetails) – (required) A request to create an Autonomous Data Guard association.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use create_autonomous_container_database_dataguard_association API.

create_autonomous_database(create_autonomous_database_details, **kwargs)

Creates a new Autonomous AI Database.

Parameters

• create_autonomous_database_details (oci.database.models.CreateAutonomousDatabaseBase) – (required) Request to create a new Autonomous AI Database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use create_autonomous_database API.

create_autonomous_database_backup(create_autonomous_database_backup_details, **kwargs)

Creates a new Autonomous AI Database backup for the specified database based on the provided request parameters.

Parameters

• create_autonomous_database_backup_details (oci.database.models.CreateAutonomousDatabaseBackupDetails) – (required) Request to create a new Autonomous AI Database backup.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseBackup

Return type

Response

Example

Click here to see an example of how to use create_autonomous_database_backup API.

create_autonomous_database_software_image(create_autonomous_database_software_image_details, **kwargs)

create Autonomous AI Database Software Image in the specified compartment.

Parameters

• create_autonomous_database_software_image_details (oci.database.models.CreateAutonomousDatabaseSoftwareImageDetails) – (required) Request to create Autonomous AI Database Software Image.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseSoftwareImage

Return type

Response

Example

Click here to see an example of how to use create_autonomous_database_software_image API.

create_autonomous_vm_cluster(create_autonomous_vm_cluster_details, **kwargs)

Creates an Autonomous VM cluster for Exadata Cloud@Customer. To create an Autonomous VM Cluster in the Oracle cloud, see create_cloud_autonomous_vm_cluster().

Parameters

• create_autonomous_vm_cluster_details (oci.database.models.CreateAutonomousVmClusterDetails) – (required) Request to create an Autonomous VM cluster.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousVmCluster

Return type

Response

Example

Click here to see an example of how to use create_autonomous_vm_cluster API.

create_backup(create_backup_details, **kwargs)

Creates a new backup in the specified database based on the request parameters you provide. If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work.

Parameters

• create_backup_details (oci.database.models.CreateBackupDetails) – (required) Request to create a new database backup.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Backup

Return type

Response

Example

Click here to see an example of how to use create_backup API.

create_backup_destination(create_backup_destination_details, **kwargs)

Creates a backup destination in an Exadata Cloud@Customer system.

Parameters

• create_backup_destination_details (oci.database.models.CreateBackupDestinationDetails) – (required) Request to create a new backup destination.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BackupDestination

Return type

Response

Example

Click here to see an example of how to use create_backup_destination API.

create_basecc_vm_cluster(create_basecc_vm_cluster_details, **kwargs)

Creates a BaseDB-C@C VM cluster.

Parameters

• create_basecc_vm_cluster_details (oci.database.models.CreateBaseccVmClusterDetails) – (required) Request to create a BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BaseccVmCluster

Return type

Response

Example

Click here to see an example of how to use create_basecc_vm_cluster API.

create_cloud_autonomous_vm_cluster(create_cloud_autonomous_vm_cluster_details, **kwargs)

Creates an Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see create_autonomous_vm_cluster().

Parameters

• create_cloud_autonomous_vm_cluster_details (oci.database.models.CreateCloudAutonomousVmClusterDetails) – (required) Request to create a cloud Autonomous VM cluster.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudAutonomousVmCluster

Return type

Response

Example

Click here to see an example of how to use create_cloud_autonomous_vm_cluster API.

create_cloud_exadata_infrastructure(create_cloud_exadata_infrastructure_details, **kwargs)

Creates a cloud Exadata infrastructure resource. This resource is used to create either an `Exadata Cloud Service`__ instance or an Autonomous AI Database on dedicated Exadata infrastructure.

Parameters

• create_cloud_exadata_infrastructure_details (oci.database.models.CreateCloudExadataInfrastructureDetails) –

  (required) Request to create a cloud Exadata infrastructure resource in an `Exadata Cloud Service`__ instance.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use create_cloud_exadata_infrastructure API.

create_cloud_vm_cluster(create_cloud_vm_cluster_details, **kwargs)

Creates a cloud VM cluster.

Parameters

• create_cloud_vm_cluster_details (oci.database.models.CreateCloudVmClusterDetails) –

  (required) Request to create a cloud VM cluster. Applies to Exadata Cloud Service instances only. See `The New Exadata Cloud Service Resource Model`__ for information on this resource type.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudVmCluster

Return type

Response

Example

Click here to see an example of how to use create_cloud_vm_cluster API.

create_console_connection(create_console_connection_details, db_node_id, **kwargs)

Creates a new console connection to the specified database node. After the console connection has been created and is available, you connect to the console using SSH.

Parameters

• create_console_connection_details (oci.database.models.CreateConsoleConnectionDetails) – (required) Request object for creating an CreateConsoleConnection

• db_node_id (str) –

  (required) The database node `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleConnection

Return type

Response

Example

Click here to see an example of how to use create_console_connection API.

create_console_history(create_console_history_details, db_node_id, **kwargs)

Captures the most recent serial console data (up to a megabyte) for the specified database node.

Parameters

• create_console_history_details (oci.database.models.CreateConsoleHistoryDetails) – (required) Request object for creating a console history.

• db_node_id (str) –

  (required) The database node `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleHistory

Return type

Response

Example

Click here to see an example of how to use create_console_history API.

create_data_guard_association(database_id, create_data_guard_association_details, **kwargs)

Creates a new Data Guard association. A Data Guard association represents the replication relationship between the specified database and a peer database. For more information, see `Using Oracle Data Guard`__.

All Oracle Cloud Infrastructure resources, including Data Guard associations, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource’s OCID by using a List API operation on that resource type, or by viewing the resource in the Console. For more information, see `Resource Identifiers`__.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• create_data_guard_association_details (oci.database.models.CreateDataGuardAssociationDetails) – (required) A request to create a Data Guard association.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DataGuardAssociation

Return type

Response

Example

Click here to see an example of how to use create_data_guard_association API.

create_database(create_new_database_details, **kwargs)

Creates a new database in the specified Database Home. If the database version is provided, it must match the version of the Database Home. Applies to Exadata and Exadata Cloud@Customer systems.

Parameters

• create_new_database_details (oci.database.models.CreateDatabaseBase) – (required) Request to create a new database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use create_database API.

create_database_snapshot(create_database_snapshot_details, **kwargs)

Creates a Database Snapshot

Parameters

• create_database_snapshot_details (oci.database.models.CreateDatabaseSnapshotDetails) – (required) Request to create a database snapshot.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSnapshot

Return type

Response

Example

Click here to see an example of how to use create_database_snapshot API.

create_database_software_image(create_database_software_image_details, **kwargs)

create database software image in the specified compartment.

Parameters

• create_database_software_image_details (oci.database.models.CreateDatabaseSoftwareImageDetails) – (required) Request to create database software image.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSoftwareImage

Return type

Response

Example

Click here to see an example of how to use create_database_software_image API.

create_db_home(create_db_home_with_db_system_id_details, **kwargs)

Creates a new Database Home in the specified database system based on the request parameters you provide. Applies to bare metal DB systems, Exadata systems, and Exadata Cloud@Customer systems.

Parameters

• create_db_home_with_db_system_id_details (oci.database.models.CreateDbHomeBase) – (required) Request to create a new Database Home.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbHome

Return type

Response

Example

Click here to see an example of how to use create_db_home API.

create_exadata_infrastructure(create_exadata_infrastructure_details, **kwargs)

Creates an Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only. To create an Exadata Cloud Service infrastructure resource, use the create_cloud_exadata_infrastructure() operation.

Parameters

• create_exadata_infrastructure_details (oci.database.models.CreateExadataInfrastructureDetails) – (required) Request to create Exadata Cloud@Customer infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use create_exadata_infrastructure API.

create_exadb_vm_cluster(create_exadb_vm_cluster_details, **kwargs)

Creates an Exadata VM cluster on Exascale Infrastructure

Parameters

• create_exadb_vm_cluster_details (oci.database.models.CreateExadbVmClusterDetails) –

  (required) Request to create a Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. See `The New Exadata Cloud Service Resource Model`__ for information on this resource type.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadbVmCluster

Return type

Response

Example

Click here to see an example of how to use create_exadb_vm_cluster API.

create_exascale_db_storage_vault(create_exascale_db_storage_vault_details, **kwargs)

Creates an Exadata Database Storage Vault

Parameters

• create_exascale_db_storage_vault_details (oci.database.models.CreateExascaleDbStorageVaultDetails) – (required) Request to create a Exadata Database Storage Vault.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExascaleDbStorageVault

Return type

Response

Example

Click here to see an example of how to use create_exascale_db_storage_vault API.

create_execution_action(create_execution_action_details, **kwargs)

Creates an execution action resource.

Parameters

• create_execution_action_details (oci.database.models.CreateExecutionActionDetails) – (required) Request to create execution action.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionAction

Return type

Response

Example

Click here to see an example of how to use create_execution_action API.

create_execution_window(create_execution_window_details, **kwargs)

Creates an execution window resource.

Parameters

• create_execution_window_details (oci.database.models.CreateExecutionWindowDetails) – (required) Request to create execution window.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionWindow

Return type

Response

Example

Click here to see an example of how to use create_execution_window API.

create_external_backup_job(create_external_backup_job_details, **kwargs)

Creates a new backup resource and returns the information the caller needs to back up an on-premises Oracle Database to Oracle Cloud Infrastructure.

Note: This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information.

Parameters

• create_external_backup_job_details (oci.database.models.CreateExternalBackupJobDetails) – (required) Request to create a cloud backup resource for a database running outside the cloud.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalBackupJob

Return type

Response

Example

Click here to see an example of how to use create_external_backup_job API.

create_external_container_database(create_external_container_database_details, **kwargs)

Creates a new external container database resource.

Parameters

• create_external_container_database_details (oci.database.models.CreateExternalContainerDatabaseDetails) – (required) Request to create a new external container database resource.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalContainerDatabase

Return type

Response

Example

Click here to see an example of how to use create_external_container_database API.

create_external_database_connector(create_external_database_connector_details, **kwargs)

Creates a new external database connector.

Parameters

• create_external_database_connector_details (oci.database.models.CreateExternalDatabaseConnectorDetails) – (required) Request to create a connector to an external database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalDatabaseConnector

Return type

Response

Example

Click here to see an example of how to use create_external_database_connector API.

create_external_non_container_database(create_external_non_container_database_details, **kwargs)

Creates a new ExternalNonContainerDatabase resource

Parameters

• create_external_non_container_database_details (oci.database.models.CreateExternalNonContainerDatabaseDetails) – (required) Request to create a new external non-container database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalNonContainerDatabase

Return type

Response

Example

Click here to see an example of how to use create_external_non_container_database API.

create_external_pluggable_database(create_external_pluggable_database_details, **kwargs)

Registers a new create_external_pluggable_database_details() resource.

Parameters

• create_external_pluggable_database_details (oci.database.models.CreateExternalPluggableDatabaseDetails) – (required) Request to create a new external pluggable database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalPluggableDatabase

Return type

Response

Example

Click here to see an example of how to use create_external_pluggable_database API.

create_gi_home(create_gi_home_details, **kwargs)

Creates a new Grid Infrastructure Home in the specified database system based on the request parameters you provide.

Parameters

• create_gi_home_details (oci.database.models.CreateGiHomeDetails) – (required) Request to create a new Grid Infrastructure Home.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type GiHome

Return type

Response

Example

Click here to see an example of how to use create_gi_home API.

create_key_store(create_key_store_details, **kwargs)

Creates a Key Store.

Parameters

• create_key_store_details (oci.database.models.CreateKeyStoreDetails) – (required) Request to create a new key store.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type KeyStore

Return type

Response

Example

Click here to see an example of how to use create_key_store API.

create_maintenance_run(create_maintenance_run_details, **kwargs)

Creates a maintenance run with one of the following: 1. The latest available release update patch (RUP) for the Autonomous Container Database. 2. The latest available RUP and DST time-zone (TZ) file updates for the Autonomous Container Database. 3. The DST TZ file updates for the Autonomous Container Database.

Parameters

• create_maintenance_run_details (oci.database.models.CreateMaintenanceRunDetails) – (required) Request to create a Maintenance Run for the resource.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type MaintenanceRun

Return type

Response

Example

Click here to see an example of how to use create_maintenance_run API.

create_oneoff_patch(create_oneoff_patch_details, **kwargs)

Creates one-off patch for specified database version to download.

Parameters

• create_oneoff_patch_details (oci.database.models.CreateOneoffPatchDetails) – (required) Request to create a one-off patch to download.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type OneoffPatch

Return type

Response

Example

Click here to see an example of how to use create_oneoff_patch API.

create_pluggable_database(create_pluggable_database_details, **kwargs)

Creates and starts a pluggable database in the specified container database. Pluggable Database can be created using different operations (e.g. LocalClone, RemoteClone, Relocate ) with this API. Use the start_pluggable_database() and stop_pluggable_database() APIs to start and stop the pluggable database.

Parameters

• create_pluggable_database_details (oci.database.models.CreatePluggableDatabaseDetails) – (required) Request to create pluggable database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use create_pluggable_database API.

create_pluggable_database_snapshot(create_pluggable_database_snapshot_details, **kwargs)

Creates a Pluggable Database Snapshot

Parameters

• create_pluggable_database_snapshot_details (oci.database.models.CreatePluggableDatabaseSnapshotDetails) – (required) Request to create a pluggable database snapshot.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabaseSnapshot

Return type

Response

Example

Click here to see an example of how to use create_pluggable_database_snapshot API.

create_scheduled_action(create_scheduled_action_details, **kwargs)

Creates a Scheduled Action resource.

Parameters

• create_scheduled_action_details (oci.database.models.CreateScheduledActionDetails) – (required) Request to create Scheduled Action.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ScheduledAction

Return type

Response

Example

Click here to see an example of how to use create_scheduled_action API.

create_scheduling_plan(create_scheduling_plan_details, **kwargs)

Creates a Scheduling Plan resource.

Parameters

• create_scheduling_plan_details (oci.database.models.CreateSchedulingPlanDetails) – (required) Request to create Scheduling Plan.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPlan

Return type

Response

Example

Click here to see an example of how to use create_scheduling_plan API.

create_scheduling_policy(create_scheduling_policy_details, **kwargs)

Creates a Scheduling Policy resource.

Parameters

• create_scheduling_policy_details (oci.database.models.CreateSchedulingPolicyDetails) – (required) Request to create Scheduling Policy.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPolicy

Return type

Response

Example

Click here to see an example of how to use create_scheduling_policy API.

create_scheduling_window(scheduling_policy_id, create_scheduling_window_details, **kwargs)

Creates a Scheduling Window resource.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• create_scheduling_window_details (oci.database.models.CreateSchedulingWindowDetails) – (required) Request to create Scheduling Window.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingWindow

Return type

Response

Example

Click here to see an example of how to use create_scheduling_window API.

create_vm_cluster(create_vm_cluster_details, **kwargs)

Creates an Exadata Cloud@Customer VM cluster.

Parameters

• create_vm_cluster_details (oci.database.models.CreateVmClusterDetails) – (required) Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. See create_cloud_vm_cluster_details() for details on creating a cloud VM cluster in an Exadata Cloud Service instance.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmCluster

Return type

Response

Example

Click here to see an example of how to use create_vm_cluster API.

create_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_details, **kwargs)

Creates the VM cluster network. Applies to Exadata Cloud@Customer instances only. To create a cloud VM cluster in an Exadata Cloud Service instance, use the create_cloud_vm_cluster() operation.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_details (oci.database.models.VmClusterNetworkDetails) – (required) Request to create the Cloud@Customer VM cluster network.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterNetwork

Return type

Response

Example

Click here to see an example of how to use create_vm_cluster_network API.

db_node_action(db_node_id, action, **kwargs)

Performs one of the following power actions on the specified DB node: - start - power on - stop - power off gracefully - forcestop - power off forcefully - forcereset - ACPI shutdown and power on forcefully - softreset - ACPI shutdown and power on - reset - power off and power on

Note: Stopping a node affects billing differently, depending on the type of DB system: Bare metal and Exadata systems - The _stop_ state has no effect on the resources you consume. Billing continues for DB nodes that you stop, and related resources continue to apply against any relevant quotas. You must terminate the DB system (terminate_db_system()) to remove its resources from billing and quotas. Virtual machine DB systems - Stopping a node stops billing for all OCPUs associated with that node, and billing resumes when you restart the node.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• action (str) –

  (required) The action to perform on the DB Node.

  Allowed values are: “STOP”, “FORCESTOP”, “FORCERESET”, “START”, “SOFTRESET”, “RESET”

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbNode

Return type

Response

Example

Click here to see an example of how to use db_node_action API.

delete_advanced_cluster_file_system(advanced_cluster_file_system_id, **kwargs)

Deletes the advanced cluster file system.

Parameters

• advanced_cluster_file_system_id (str) –

  (required) The advanced cluster file system Id `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_advanced_cluster_file_system API.

delete_application_vip(application_vip_id, **kwargs)

Deletes and deregisters the specified application virtual IP (VIP) address.

Parameters

• application_vip_id (str) –

  (required) The `OCID`__ of the application virtual IP (VIP) address.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_application_vip API.

delete_autonomous_database(autonomous_database_id, **kwargs)

Deletes the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• must_delete_associated_long_term_backups (bool) – (optional) If set to true, terminating the Autonomous AI Database also deletes its associated long-term backups if the retention lock is not enabled.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_autonomous_database API.

delete_autonomous_database_backup(autonomous_database_backup_id, **kwargs)

Deletes a long-term backup. You cannot delete other backups using this API.

Parameters

• autonomous_database_backup_id (str) –

  (required) The `OCID`__ of the Autonomous AI Database backup.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_autonomous_database_backup API.

delete_autonomous_database_software_image(autonomous_database_software_image_id, **kwargs)

Delete an Autonomous AI Database Software Image

Parameters

• autonomous_database_software_image_id (str) –

  (required) The Autonomous AI Database Software Image `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_autonomous_database_software_image API.

delete_autonomous_vm_cluster(autonomous_vm_cluster_id, **kwargs)

Deletes the specified Autonomous VM cluster in an Exadata Cloud@Customer system. To delete an Autonomous VM Cluster in the Oracle cloud, see delete_cloud_autonomous_vm_cluster().

Parameters

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_autonomous_vm_cluster API.

delete_backup(backup_id, **kwargs)

Deletes a full backup. You cannot delete automatic backups using this API.

Parameters

• backup_id (str) –

  (required) The backup `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_backup API.

delete_backup_destination(backup_destination_id, **kwargs)

Deletes a backup destination in an Exadata Cloud@Customer system.

Parameters

• backup_destination_id (str) –

  (required) The `OCID`__ of the backup destination.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_backup_destination API.

delete_basecc_vm_cluster(basecc_vm_cluster_id, **kwargs)

Deletes the specified BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_basecc_vm_cluster API.

delete_cloud_autonomous_vm_cluster(cloud_autonomous_vm_cluster_id, **kwargs)

Deletes the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see delete_autonomous_vm_cluster().

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_cloud_autonomous_vm_cluster API.

delete_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, **kwargs)

Deletes the cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous AI Database on dedicated Exadata infrastructure only.

Parameters

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• is_delete_vm_clusters (bool) – (optional) If true, forces the deletion the specified cloud Exadata infrastructure resource as well as all associated VM clusters. If false, the cloud Exadata infrastructure resource can be deleted only if it has no associated VM clusters. Default value is false.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_cloud_exadata_infrastructure API.

delete_cloud_vm_cluster(cloud_vm_cluster_id, **kwargs)

Deletes the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_cloud_vm_cluster API.

delete_console_connection(db_node_id, console_connection_id, **kwargs)

Deletes the specified database node console connection.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_connection_id (str) – (required) The OCID of the console connection.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_console_connection API.

delete_console_history(db_node_id, console_history_id, **kwargs)

Deletes the specified database node console history.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_history_id (str) – (required) The OCID of the console history.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_console_history API.

delete_database(database_id, **kwargs)

Deletes the specified database. Applies only to Exadata systems.

The data in this database is local to the Exadata system and will be lost when the database is deleted. Oracle recommends that you back up any data in the Exadata system prior to deleting it. You can use the performFinalBackup parameter to have the Exadata system database backed up before it is deleted.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• perform_final_backup (bool) –

  (optional) Whether to perform a final backup of the database or not. Default is false.

  If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work.

  This parameter is used in multiple APIs. Refer to the API description for details on how the operation uses it.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_database API.

delete_database_snapshot(database_snapshot_id, **kwargs)

Deletes the specified Exadata Database Snapshot.

Parameters

• database_snapshot_id (str) –

  (required) The Exadata Database Snapshot `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_database_snapshot API.

delete_database_software_image(database_software_image_id, **kwargs)

Delete a database software image

Parameters

• database_software_image_id (str) –

  (required) The DB system `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_database_software_image API.

delete_db_home(db_home_id, **kwargs)

Deletes a Database Home. Applies to bare metal DB systems, Exadata Cloud Service, and Exadata Cloud@Customer systems.

Oracle recommends that you use the performFinalBackup parameter to back up any data on a bare metal DB system before you delete a Database Home. On an Exadata Cloud@Customer system or an Exadata Cloud Service system, you can delete a Database Home only when there are no databases in it and therefore you cannot use the performFinalBackup parameter to back up data.

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• perform_final_backup (bool) –

  (optional) Whether to perform a final backup of the database or not. Default is false.

  If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work.

  This parameter is used in multiple APIs. Refer to the API description for details on how the operation uses it.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_db_home API.

delete_dbnode_snapshot(dbnode_snapshot_id, **kwargs)

Deletes the specified Exadata Database Node Snapshot.

Parameters

• dbnode_snapshot_id (str) –

  (required) The Exadata Database Node Snapshot `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_dbnode_snapshot API.

delete_exadata_infrastructure(exadata_infrastructure_id, **kwargs)

Deletes the Exadata Cloud@Customer infrastructure.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_exadata_infrastructure API.

delete_exadb_vm_cluster(exadb_vm_cluster_id, **kwargs)

Deletes the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_exadb_vm_cluster API.

delete_exascale_db_storage_vault(exascale_db_storage_vault_id, **kwargs)

Deletes the specified Exadata Database Storage Vault.

Parameters

• exascale_db_storage_vault_id (str) –

  (required) The Exadata Database Storage Vault `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_exascale_db_storage_vault API.

delete_execution_action(execution_action_id, **kwargs)

Deletes the execution action.

Parameters

• execution_action_id (str) –

  (required) The execution action `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_execution_action API.

delete_execution_window(execution_window_id, **kwargs)

Deletes the execution window.

Parameters

• execution_window_id (str) –

  (required) The execution window `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_execution_window API.

delete_external_container_database(external_container_database_id, **kwargs)

Deletes the create_external_container_database_details() resource. Any external pluggable databases registered under this container database must be deleted in your Oracle Cloud Infrastructure tenancy prior to this operation.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_external_container_database API.

delete_external_database_connector(external_database_connector_id, **kwargs)

Deletes an external database connector. Any services enabled using the external database connector must be deleted prior to this operation.

Parameters

• external_database_connector_id (str) –

  (required) The `OCID`__ of the external database connector resource (ExternalDatabaseConnectorId).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_external_database_connector API.

delete_external_non_container_database(external_non_container_database_id, **kwargs)

Deletes the Oracle Cloud Infrastructure resource representing an external non-container database.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_external_non_container_database API.

delete_external_pluggable_database(external_pluggable_database_id, **kwargs)

Deletes the create_external_pluggable_database_details(). resource.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_external_pluggable_database API.

delete_gi_home(gi_home_id, **kwargs)

Deletes a Grid Infrastructure Home.

Parameters

• gi_home_id (str) –

  (required) The Grid Infrastructure Home `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_gi_home API.

delete_key_store(key_store_id, **kwargs)

Deletes a key store.

Parameters

• key_store_id (str) –

  (required) The `OCID`__ of the key store.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_key_store API.

delete_oneoff_patch(oneoff_patch_id, **kwargs)

Deletes a one-off patch.

Parameters

• oneoff_patch_id (str) –

  (required) The one-off patch `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_oneoff_patch API.

delete_pluggable_database(pluggable_database_id, **kwargs)

Deletes the specified pluggable database.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_pluggable_database API.

delete_pluggable_database_snapshot(pluggable_database_snapshot_id, **kwargs)

Deletes the specified Exadata Pluggable Database Snapshot.

Parameters

• pluggable_database_snapshot_id (str) –

  (required) The Exadata Pluggable Database Snapshot `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_pluggable_database_snapshot API.

delete_scheduled_action(scheduled_action_id, **kwargs)

Deletes the scheduled action.

Parameters

• scheduled_action_id (str) –

  (required) The Scheduled Action `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_scheduled_action API.

delete_scheduling_plan(scheduling_plan_id, **kwargs)

Deletes the scheduling plan.

Parameters

• scheduling_plan_id (str) –

  (required) The Schedule Plan `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_scheduling_plan API.

delete_scheduling_policy(scheduling_policy_id, **kwargs)

Deletes the scheduling policy.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_scheduling_policy API.

delete_scheduling_window(scheduling_policy_id, scheduling_window_id, **kwargs)

Deletes the scheduling window.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• scheduling_window_id (str) –

  (required) The Scheduling Window `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_scheduling_window API.

delete_vm_cluster(vm_cluster_id, **kwargs)

Deletes the specified VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_vm_cluster API.

delete_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, **kwargs)

Deletes the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. To delete a cloud VM cluster in an Exadata Cloud Service instance, use the delete_cloud_vm_cluster() operation.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use delete_vm_cluster_network API.

deregister_autonomous_database_data_safe(autonomous_database_id, **kwargs)

Asynchronously deregisters this Autonomous AI Database with Data Safe.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• deregister_autonomous_database_data_safe_details (oci.database.models.DeregisterAutonomousDatabaseDataSafeDetails) – (optional) Details for deregistering an Autonomous AI Database with Data Safe.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use deregister_autonomous_database_data_safe API.

disable_autonomous_database_management(autonomous_database_id, **kwargs)

Disables Database Management for the Autonomous AI Database resource.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_autonomous_database_management API.

disable_autonomous_database_operations_insights(autonomous_database_id, **kwargs)

Disables Operations Insights for the Autonomous AI Database resource.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_autonomous_database_operations_insights API.

disable_database_management(database_id, **kwargs)

Disables the Database Management service for the database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use disable_database_management API.

disable_external_container_database_database_management(external_container_database_id, **kwargs)

Disable Database Management service for the external container database.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_container_database_database_management API.

disable_external_container_database_stack_monitoring(external_container_database_id, **kwargs)

Disable Stack Monitoring for the external container database.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_container_database_stack_monitoring API.

disable_external_non_container_database_database_management(external_non_container_database_id, **kwargs)

Disable Database Management Service for the external non-container database. For more information about the Database Management Service, see `Database Management Service`__.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_non_container_database_database_management API.

disable_external_non_container_database_operations_insights(external_non_container_database_id, **kwargs)

Disable Operations Insights for the external non-container database.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_non_container_database_operations_insights API.

disable_external_non_container_database_stack_monitoring(external_non_container_database_id, **kwargs)

Disable Stack Monitoring for the external non-container database.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_non_container_database_stack_monitoring API.

disable_external_pluggable_database_database_management(external_pluggable_database_id, **kwargs)

Disable Database Management Service for the external pluggable database. For more information about the Database Management Service, see `Database Management Service`__.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_pluggable_database_database_management API.

disable_external_pluggable_database_operations_insights(external_pluggable_database_id, **kwargs)

Disable Operations Insights for the external pluggable database.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_pluggable_database_operations_insights API.

disable_external_pluggable_database_stack_monitoring(external_pluggable_database_id, **kwargs)

Disable Stack Monitoring for the external pluggable database.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use disable_external_pluggable_database_stack_monitoring API.

disable_pluggable_database_management(pluggable_database_id, **kwargs)

Disables the Database Management service for the pluggable database.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use disable_pluggable_database_management API.

download_db_connection_bundle(db_connection_bundle_id, download_db_connection_bundle_details, **kwargs)

Downloads the specified database connection bundle content. The bundle is returned as a binary file containing the connection details.

Parameters

• db_connection_bundle_id (str) – (required) The OCID of the database connection bundle.

• download_db_connection_bundle_details (oci.database.models.DownloadDbConnectionBundleDetails) – (required) Request to download a database connection bundle.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type stream

Return type

Response

Example

Click here to see an example of how to use download_db_connection_bundle API.

download_exadata_infrastructure_config_file(exadata_infrastructure_id, **kwargs)

Downloads the configuration file for the specified Exadata Cloud@Customer infrastructure.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type stream

Return type

Response

Example

Click here to see an example of how to use download_exadata_infrastructure_config_file API.

download_oneoff_patch(oneoff_patch_id, **kwargs)

Download one-off patch.

Parameters

• oneoff_patch_id (str) –

  (required) The one-off patch `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DownloadOneoffPatch

Return type

Response

Example

Click here to see an example of how to use download_oneoff_patch API.

download_validation_report(exadata_infrastructure_id, vm_cluster_network_id, **kwargs)

Downloads the network validation report file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type stream

Return type

Response

Example

Click here to see an example of how to use download_validation_report API.

download_vm_cluster_network_config_file(exadata_infrastructure_id, vm_cluster_network_id, **kwargs)

Downloads the configuration file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type stream

Return type

Response

Example

Click here to see an example of how to use download_vm_cluster_network_config_file API.

edit_autonomous_container_database_dataguard(edit_autonomous_container_database_dataguard_details, autonomous_container_database_id, **kwargs)

Modify Autonomous Container Database Data Guard settings such as protection mode, automatic failover, and fast start failover lag limit. For more information, see `Update Autonomous Container Database Dataguard`__.

Parameters

• edit_autonomous_container_database_dataguard_details (oci.database.models.EditAutonomousContainerDatabaseDataguardDetails) – (required) Request Edit Autonomous Container Database Dataguard.

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use edit_autonomous_container_database_dataguard API.

enable_autonomous_database_management(autonomous_database_id, **kwargs)

Enables Database Management for Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_autonomous_database_management API.

enable_autonomous_database_operations_insights(autonomous_database_id, **kwargs)

Enables the specified Autonomous AI Database with Operations Insights.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_autonomous_database_operations_insights API.

enable_database_management(database_id, enable_database_management_details, **kwargs)

Enables the Database Management service for an Oracle Database located in Oracle Cloud Infrastructure. This service allows the database to access tools including Metrics and Performance hub. Database Management is enabled at the container database (CDB) level.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• enable_database_management_details (oci.database.models.EnableDatabaseManagementDetails) – (required) Request to enable the Database Management service for an Oracle Database located in Oracle Cloud Infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use enable_database_management API.

enable_external_container_database_database_management(external_container_database_id, enable_external_container_database_database_management_details, **kwargs)

Enables Database Management Service for the external container database. For more information about the Database Management Service, see `Database Management Service`__.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• enable_external_container_database_database_management_details (oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails) – (required) Request to enable the Database Management Service for an external container database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_container_database_database_management API.

enable_external_container_database_stack_monitoring(external_container_database_id, enable_external_container_database_stack_monitoring_details, **kwargs)

Enable Stack Monitoring for the external container database.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• enable_external_container_database_stack_monitoring_details (oci.database.models.EnableExternalContainerDatabaseStackMonitoringDetails) – (required) Details to enable Stack Monitoring on the external container database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_container_database_stack_monitoring API.

enable_external_non_container_database_database_management(external_non_container_database_id, enable_external_non_container_database_database_management_details, **kwargs)

Enable Database Management Service for the external non-container database. For more information about the Database Management Service, see `Database Management Service`__.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• enable_external_non_container_database_database_management_details (oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails) – (required) Request to enable the Database Management Service for an external non-container database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_non_container_database_database_management API.

enable_external_non_container_database_operations_insights(external_non_container_database_id, enable_external_non_container_database_operations_insights_details, **kwargs)

Enable Operations Insights for the external non-container database.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• enable_external_non_container_database_operations_insights_details (oci.database.models.EnableExternalNonContainerDatabaseOperationsInsightsDetails) – (required) Details to enable Operations Insights on the external non-container database

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_non_container_database_operations_insights API.

enable_external_non_container_database_stack_monitoring(external_non_container_database_id, enable_external_non_container_database_stack_monitoring_details, **kwargs)

Enable Stack Monitoring for the external non-container database.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• enable_external_non_container_database_stack_monitoring_details (oci.database.models.EnableExternalNonContainerDatabaseStackMonitoringDetails) – (required) Details to enable Stack Monitoring on the external non-container database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_non_container_database_stack_monitoring API.

enable_external_pluggable_database_database_management(external_pluggable_database_id, enable_external_pluggable_database_database_management_details, **kwargs)

Enable Database Management Service for the external pluggable database. For more information about the Database Management Service, see `Database Management Service`__.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• enable_external_pluggable_database_database_management_details (oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails) – (required) Request to enable the Database Management Service for an external database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_pluggable_database_database_management API.

enable_external_pluggable_database_operations_insights(external_pluggable_database_id, enable_external_pluggable_database_operations_insights_details, **kwargs)

Enable Operations Insights for the external pluggable database.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• enable_external_pluggable_database_operations_insights_details (oci.database.models.EnableExternalPluggableDatabaseOperationsInsightsDetails) – (required) Details to enable Operations Insights on the external pluggable database

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_pluggable_database_operations_insights API.

enable_external_pluggable_database_stack_monitoring(external_pluggable_database_id, enable_external_pluggable_database_stack_monitoring_details, **kwargs)

Enable Stack Monitoring for the external pluggable database.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• enable_external_pluggable_database_stack_monitoring_details (oci.database.models.EnableExternalPluggableDatabaseStackMonitoringDetails) – (required) Details to enable Stack Monitoring on the external pluggable database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use enable_external_pluggable_database_stack_monitoring API.

enable_pluggable_database_management(pluggable_database_id, enable_pluggable_database_management_details, **kwargs)

Enables the Database Management service for an Oracle Pluggable Database located in Oracle Cloud Infrastructure. This service allows the pluggable database to access tools including Metrics and Performance hub. Database Management is enabled at the pluggable database (PDB) level.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• enable_pluggable_database_management_details (oci.database.models.EnablePluggableDatabaseManagementDetails) – (required) Request to enable the Database Management service for an Oracle Pluggable Database located in Oracle Cloud Infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use enable_pluggable_database_management API.

execute_db_system_os_patch(execute_db_system_os_patch_details, db_system_id, **kwargs)

Execute an operating system (OS) patch action on a DB system. Returns 202 and a work request. Some updates may require a reboot.

Parameters

• execute_db_system_os_patch_details (oci.database.models.ExecuteDbSystemOsPatchDetails) – (required) Details to execute an OS patch action on a DB System.

• db_system_id (str) –

  (required) The DB system `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use execute_db_system_os_patch API.

fail_over_autonomous_database(autonomous_database_id, **kwargs)

Initiates a failover of the specified Autonomous AI Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. This API should be called in the remote region where the peer database resides. Below parameter is optional:

• peerDbId Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. If this parameter is not provided, the failover will happen in the same region.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• peer_db_id (str) – (optional) The database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use fail_over_autonomous_database API.

failover_autonomous_container_database_dataguard(autonomous_container_database_id, **kwargs)

Performs failover to a standby Autonomous Container Database (ACD) identified by the autonomousContainerDatabaseId parameter. This standby ACD will become the new primary ACD when the failover completes successfully. For more information, see `Fail Over to the Standby in an Autonomous Data Guard Configuration`__.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use failover_autonomous_container_database_dataguard API.

failover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Deprecated. Use the failover_autonomous_container_database_dataguard() operation to fail over the standby Autonomous Container Database (ACD) to the primary ACD after the existing primary ACD fails or becomes unreachable.

A failover can result in data loss, depending on the protection mode in effect at the time the primary Autonomous Container Database fails.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• autonomous_container_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use failover_autonomous_container_database_dataguard_association API.

failover_data_guard(database_id, failover_data_guard_details, **kwargs)

Performs a failover to transition the standby database identified by the databaseId path parameter into the primary role after the existing primary database fails or becomes unreachable.

A failover might result in data loss depending on the protection mode in effect at the time of the primary database failure.

This operation should be performed on respective standby database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• failover_data_guard_details (oci.database.models.FailoverDataGuardDetails) – (required) A request to update an existing Data Guard member.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use failover_data_guard API.

failover_data_guard_association(database_id, data_guard_association_id, failover_data_guard_association_details, **kwargs)

Performs a failover to transition the standby database identified by the databaseId parameter into the specified Data Guard association’s primary role after the existing primary database fails or becomes unreachable.

A failover might result in data loss depending on the protection mode in effect at the time of the primary database failure.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• data_guard_association_id (str) –

  (required) The Data Guard association’s `OCID`__.

• failover_data_guard_association_details (oci.database.models.FailoverDataGuardAssociationDetails) – (required) A request to perform a failover, transitioning a standby database into a primary database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DataGuardAssociation

Return type

Response

Example

Click here to see an example of how to use failover_data_guard_association API.

generate_autonomous_database_wallet(autonomous_database_id, generate_autonomous_database_wallet_details, **kwargs)

Creates and downloads a wallet for the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• generate_autonomous_database_wallet_details (oci.database.models.GenerateAutonomousDatabaseWalletDetails) – (required) Request to create a new Autonomous AI Database wallet.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type stream

Return type

Response

Example

Click here to see an example of how to use generate_autonomous_database_wallet API.

generate_recommended_vm_cluster_network(exadata_infrastructure_id, generate_recommended_network_details, **kwargs)

Generates a recommended Cloud@Customer VM cluster network configuration.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• generate_recommended_network_details (oci.database.models.GenerateRecommendedNetworkDetails) – (required) Request to generate a recommended Cloud@Customer VM cluster network configuration.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterNetworkDetails

Return type

Response

Example

Click here to see an example of how to use generate_recommended_vm_cluster_network API.

get_advanced_cluster_file_system(advanced_cluster_file_system_id, **kwargs)

Gets information about the specified advanced cluster file systems.

Parameters

• advanced_cluster_file_system_id (str) –

  (required) The advanced cluster file system Id `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AdvancedClusterFileSystem

Return type

Response

Example

Click here to see an example of how to use get_advanced_cluster_file_system API.

get_application_vip(application_vip_id, **kwargs)

Gets information about a specified application virtual IP (VIP) address.

Parameters

• application_vip_id (str) –

  (required) The `OCID`__ of the application virtual IP (VIP) address.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ApplicationVip

Return type

Response

Example

Click here to see an example of how to use get_application_vip API.

get_autonomous_container_database(autonomous_container_database_id, **kwargs)

Gets information about the specified Autonomous Container Database.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use get_autonomous_container_database API.

get_autonomous_container_database_backup(autonomous_container_database_backup_id, **kwargs)

Gets information about the specified Autonomous Container Database backup.

Parameters

• autonomous_container_database_backup_id (str) –

  (required) The Autonomous Container Database backup `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseBackup

Return type

Response

Example

Click here to see an example of how to use get_autonomous_container_database_backup API.

get_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Deprecated. Use the get_autonomous_container_database() operation to get the details of an Autonomous Container Database (ACD) enabled with Autonomous Data Guard associated with the specified ACD.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• autonomous_container_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use get_autonomous_container_database_dataguard_association API.

get_autonomous_container_database_resource_usage(autonomous_container_database_id, **kwargs)

Get resource usage details for the specified Autonomous Container Database.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseResourceUsage

Return type

Response

Example

Click here to see an example of how to use get_autonomous_container_database_resource_usage API.

get_autonomous_database(autonomous_database_id, **kwargs)

Gets the details of the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use get_autonomous_database API.

get_autonomous_database_backup(autonomous_database_backup_id, **kwargs)

Gets information about the specified Autonomous AI Database backup.

Parameters

• autonomous_database_backup_id (str) –

  (required) The `OCID`__ of the Autonomous AI Database backup.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseBackup

Return type

Response

Example

Click here to see an example of how to use get_autonomous_database_backup API.

get_autonomous_database_dataguard_association(autonomous_database_id, autonomous_database_dataguard_association_id, **kwargs)

Deprecated. Use the get_autonomous_container_database() operation to gets an Autonomous Data Guard-enabled database associated with the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• autonomous_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use get_autonomous_database_dataguard_association API.

get_autonomous_database_regional_wallet(**kwargs)

Gets the Autonomous AI Database regional wallet details.

Parameters

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseWallet

Return type

Response

Example

Click here to see an example of how to use get_autonomous_database_regional_wallet API.

get_autonomous_database_software_image(autonomous_database_software_image_id, **kwargs)

Gets information about the specified Autonomous AI Database Software Image.

Parameters

• autonomous_database_software_image_id (str) –

  (required) The Autonomous AI Database Software Image `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseSoftwareImage

Return type

Response

Example

Click here to see an example of how to use get_autonomous_database_software_image API.

get_autonomous_database_wallet(autonomous_database_id, **kwargs)

Gets the wallet details for the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseWallet

Return type

Response

Example

Click here to see an example of how to use get_autonomous_database_wallet API.

get_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, **kwargs)

Deprecated. Use the get_cloud_exadata_infrastructure() operation to get details of an Exadata Infrastructure resource and the get_cloud_autonomous_vm_cluster() operation to get details of an Autonomous Exadata VM cluster.

Parameters

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use get_autonomous_exadata_infrastructure API.

get_autonomous_patch(autonomous_patch_id, **kwargs)

Gets information about a specific autonomous patch.

Parameters

• autonomous_patch_id (str) –

  (required) The autonomous patch `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousPatch

Return type

Response

Example

Click here to see an example of how to use get_autonomous_patch API.

get_autonomous_virtual_machine(autonomous_virtual_machine_id, **kwargs)

Gets the details of specific Autonomous Virtual Machine.

Parameters

• autonomous_virtual_machine_id (str) –

  (required) The Autonomous Virtual machine `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousVirtualMachine

Return type

Response

Example

Click here to see an example of how to use get_autonomous_virtual_machine API.

get_autonomous_vm_cluster(autonomous_vm_cluster_id, **kwargs)

Gets information about the specified Autonomous VM cluster for an Exadata Cloud@Customer system. To get information about an Autonomous VM Cluster in the Oracle cloud, see get_cloud_autonomous_vm_cluster().

Parameters

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousVmCluster

Return type

Response

Example

Click here to see an example of how to use get_autonomous_vm_cluster API.

get_autonomous_vm_cluster_resource_usage(autonomous_vm_cluster_id, **kwargs)

Get the resource usage details for the specified Autonomous Exadata VM cluster.

Parameters

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousVmClusterResourceUsage

Return type

Response

Example

Click here to see an example of how to use get_autonomous_vm_cluster_resource_usage API.

get_backup(backup_id, **kwargs)

Gets information about the specified backup.

Parameters

• backup_id (str) –

  (required) The backup `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Backup

Return type

Response

Example

Click here to see an example of how to use get_backup API.

get_backup_destination(backup_destination_id, **kwargs)

Gets information about the specified backup destination in an Exadata Cloud@Customer system.

Parameters

• backup_destination_id (str) –

  (required) The `OCID`__ of the backup destination.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BackupDestination

Return type

Response

Example

Click here to see an example of how to use get_backup_destination API.

get_basecc_vm_cluster(basecc_vm_cluster_id, **kwargs)

Gets information about the BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BaseccVmCluster

Return type

Response

Example

Click here to see an example of how to use get_basecc_vm_cluster API.

get_basecc_vm_cluster_update(basecc_vm_cluster_id, update_id, **kwargs)

Gets information about a specified maintenance update package for a BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• update_id (str) –

  (required) The `OCID`__ of the maintenance update.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BaseccVmClusterUpdate

Return type

Response

Example

Click here to see an example of how to use get_basecc_vm_cluster_update API.

get_basecc_vm_cluster_update_history_entry(basecc_vm_cluster_id, update_history_entry_id, **kwargs)

Gets the maintenance update history details for the specified update history entry. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• update_history_entry_id (str) –

  (required) The `OCID`__ of the maintenance update history entry.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BaseccVmClusterUpdateHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_basecc_vm_cluster_update_history_entry API.

get_cloud_autonomous_vm_cluster(cloud_autonomous_vm_cluster_id, **kwargs)

Gets information about the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Custustomer systems, see get_autonomous_vm_cluster().

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudAutonomousVmCluster

Return type

Response

Example

Click here to see an example of how to use get_cloud_autonomous_vm_cluster API.

get_cloud_autonomous_vm_cluster_resource_usage(cloud_autonomous_vm_cluster_id, **kwargs)

Get the resource usage details for the specified Cloud Autonomous Exadata VM cluster.

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudAutonomousVmClusterResourceUsage

Return type

Response

Example

Click here to see an example of how to use get_cloud_autonomous_vm_cluster_resource_usage API.

get_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, **kwargs)

Gets information about the specified cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous AI Database on dedicated Exadata infrastructure only.

Parameters

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use get_cloud_exadata_infrastructure API.

get_cloud_exadata_infrastructure_unallocated_resources(cloud_exadata_infrastructure_id, **kwargs)

Gets unallocated resources information for the specified Cloud Exadata infrastructure.

Parameters

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• db_servers (list[str]) –

  (optional) The list of `OCIDs`__ of the Db servers.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudExadataInfrastructureUnallocatedResources

Return type

Response

Example

Click here to see an example of how to use get_cloud_exadata_infrastructure_unallocated_resources API.

get_cloud_vm_cluster(cloud_vm_cluster_id, **kwargs)

Gets information about the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudVmCluster

Return type

Response

Example

Click here to see an example of how to use get_cloud_vm_cluster API.

get_cloud_vm_cluster_iorm_config(cloud_vm_cluster_id, **kwargs)

Gets the IORM configuration for the specified cloud VM cluster in an Exadata Cloud Service instance. If you have not specified an IORM configuration, the default configuration is returned.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataIormConfig

Return type

Response

Example

Click here to see an example of how to use get_cloud_vm_cluster_iorm_config API.

get_cloud_vm_cluster_update(cloud_vm_cluster_id, update_id, **kwargs)

Gets information about a specified maintenance update package for a cloud VM cluster. Applies to Exadata Cloud Service instances only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• update_id (str) –

  (required) The `OCID`__ of the maintenance update.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Update

Return type

Response

Example

Click here to see an example of how to use get_cloud_vm_cluster_update API.

get_cloud_vm_cluster_update_history_entry(cloud_vm_cluster_id, update_history_entry_id, **kwargs)

Gets the maintenance update history details for the specified update history entry. Applies to Exadata Cloud Service instances only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• update_history_entry_id (str) –

  (required) The `OCID`__ of the maintenance update history entry.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type UpdateHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_cloud_vm_cluster_update_history_entry API.

get_console_connection(db_node_id, console_connection_id, **kwargs)

Gets the specified database node console connection’s information.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_connection_id (str) – (required) The OCID of the console connection.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleConnection

Return type

Response

Example

Click here to see an example of how to use get_console_connection API.

get_console_history(db_node_id, console_history_id, **kwargs)

Gets information about the specified database node console history.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_history_id (str) – (required) The OCID of the console history.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleHistory

Return type

Response

Example

Click here to see an example of how to use get_console_history API.

get_console_history_content(db_node_id, console_history_id, **kwargs)

Retrieves the specified database node console history contents upto a megabyte.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_history_id (str) – (required) The OCID of the console history.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type stream

Return type

Response

Example

Click here to see an example of how to use get_console_history_content API.

get_data_guard_association(database_id, data_guard_association_id, **kwargs)

Gets the specified Data Guard association’s configuration information.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• data_guard_association_id (str) –

  (required) The Data Guard association’s `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DataGuardAssociation

Return type

Response

Example

Click here to see an example of how to use get_data_guard_association API.

get_database(database_id, **kwargs)

Gets information about the specified database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use get_database API.

get_database_snapshot(database_snapshot_id, **kwargs)

Gets information about the specified Exadata Database Snapshot.

Parameters

• database_snapshot_id (str) –

  (required) The Exadata Database Snapshot `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSnapshot

Return type

Response

Example

Click here to see an example of how to use get_database_snapshot API.

get_database_software_image(database_software_image_id, **kwargs)

Gets information about the specified database software image.

Parameters

• database_software_image_id (str) –

  (required) The DB system `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSoftwareImage

Return type

Response

Example

Click here to see an example of how to use get_database_software_image API.

get_database_upgrade_history_entry(database_id, upgrade_history_entry_id, **kwargs)

gets the upgrade history for a specified database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• upgrade_history_entry_id (str) –

  (required) The database/db system upgrade History `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseUpgradeHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_database_upgrade_history_entry API.

get_db_connection_bundle(db_connection_bundle_id, **kwargs)

Gets information about the specified database connection bundle.

Parameters

• db_connection_bundle_id (str) – (required) The OCID of the database connection bundle.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbConnectionBundle

Return type

Response

Example

Click here to see an example of how to use get_db_connection_bundle API.

get_db_home(db_home_id, **kwargs)

Gets information about the specified Database Home.

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbHome

Return type

Response

Example

Click here to see an example of how to use get_db_home API.

get_db_home_patch(db_home_id, patch_id, **kwargs)

Gets information about a specified patch package.

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• patch_id (str) –

  (required) The `OCID`__ of the patch.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Patch

Return type

Response

Example

Click here to see an example of how to use get_db_home_patch API.

get_db_home_patch_history_entry(db_home_id, patch_history_entry_id, **kwargs)

Gets the patch history details for the specified patchHistoryEntryId

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• patch_history_entry_id (str) –

  (required) The `OCID`__ of the patch history entry.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PatchHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_db_home_patch_history_entry API.

get_db_node(db_node_id, **kwargs)

Gets information about the specified database node.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbNode

Return type

Response

Example

Click here to see an example of how to use get_db_node API.

get_db_server(exadata_infrastructure_id, db_server_id, **kwargs)

Gets information about the Exadata Db server.

Parameters

• exadata_infrastructure_id (str) –

  (required) The `OCID`__ of the ExadataInfrastructure.

• db_server_id (str) –

  (required) The DB server `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbServer

Return type

Response

Example

Click here to see an example of how to use get_db_server API.

get_db_system(db_system_id, **kwargs)

Gets information about the specified DB system.

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystem

Return type

Response

Example

Click here to see an example of how to use get_db_system API.

get_db_system_os_patch_history_entry(db_system_id, os_patch_history_entry_id, **kwargs)

Gets the details of the specified OS patch action for the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• os_patch_history_entry_id (str) –

  (required) The `OCID`__ of the patch history entry.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystemOsPatchHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_db_system_os_patch_history_entry API.

get_db_system_patch(db_system_id, patch_id, **kwargs)

Gets information the specified patch.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• patch_id (str) –

  (required) The `OCID`__ of the patch.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Patch

Return type

Response

Example

Click here to see an example of how to use get_db_system_patch API.

get_db_system_patch_history_entry(db_system_id, patch_history_entry_id, **kwargs)

Gets the details of the specified patch operation on the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• patch_history_entry_id (str) –

  (required) The `OCID`__ of the patch history entry.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PatchHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_db_system_patch_history_entry API.

get_db_system_upgrade_history_entry(db_system_id, upgrade_history_entry_id, **kwargs)

Gets the details of the specified operating system upgrade operation for the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• upgrade_history_entry_id (str) –

  (required) The database/db system upgrade History `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystemUpgradeHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_db_system_upgrade_history_entry API.

get_dbnode_snapshot(dbnode_snapshot_id, **kwargs)

Gets information about the specified Exadata Database Node Snapshot in the specified compartment.

Parameters

• dbnode_snapshot_id (str) –

  (required) The Exadata Database Node Snapshot `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbnodeSnapshot

Return type

Response

Example

Click here to see an example of how to use get_dbnode_snapshot API.

get_exadata_infrastructure(exadata_infrastructure_id, **kwargs)

Gets information about the specified Exadata infrastructure. Applies to Exadata Cloud@Customer instances only. To get information on an Exadata Cloud Service infrastructure resource, use the get_cloud_exadata_infrastructure() operation.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• excluded_fields (list[str]) –

  (optional) If provided, the specified fields will be excluded in the response.

  Allowed values are: “multiRackConfigurationFile”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use get_exadata_infrastructure API.

get_exadata_infrastructure_ocpus(autonomous_exadata_infrastructure_id, **kwargs)

Gets details of the available and consumed OCPUs for the specified Autonomous Exadata Infrastructure resource.

Parameters

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type OCPUs

Return type

Response

Example

Click here to see an example of how to use get_exadata_infrastructure_ocpus API.

get_exadata_infrastructure_un_allocated_resources(exadata_infrastructure_id, **kwargs)

Gets un allocated resources information for the specified Exadata infrastructure. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• db_servers (list[str]) –

  (optional) The list of `OCIDs`__ of the Db servers.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructureUnAllocatedResources

Return type

Response

Example

Click here to see an example of how to use get_exadata_infrastructure_un_allocated_resources API.

get_exadata_iorm_config(db_system_id, **kwargs)

Gets the IORM configuration settings for the specified cloud Exadata DB system. All Exadata service instances have default IORM settings.

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

The get_cloud_vm_cluster_iorm_config() API is used for this operation with Exadata systems using the new resource model.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataIormConfig

Return type

Response

Example

Click here to see an example of how to use get_exadata_iorm_config API.

get_exadb_vm_cluster(exadb_vm_cluster_id, **kwargs)

Gets information about the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadbVmCluster

Return type

Response

Example

Click here to see an example of how to use get_exadb_vm_cluster API.

get_exadb_vm_cluster_update(exadb_vm_cluster_id, update_id, **kwargs)

Gets information about a specified maintenance update package for a Exadata VM cluster on Exascale Infrastructure.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• update_id (str) –

  (required) The `OCID`__ of the maintenance update.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadbVmClusterUpdate

Return type

Response

Example

Click here to see an example of how to use get_exadb_vm_cluster_update API.

get_exadb_vm_cluster_update_history_entry(exadb_vm_cluster_id, update_history_entry_id, **kwargs)

Gets the maintenance update history details for the specified update history entry.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• update_history_entry_id (str) –

  (required) The `OCID`__ of the maintenance update history entry.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadbVmClusterUpdateHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_exadb_vm_cluster_update_history_entry API.

get_exascale_db_storage_vault(exascale_db_storage_vault_id, **kwargs)

Gets information about the specified Exadata Database Storage Vaults in the specified compartment.

Parameters

• exascale_db_storage_vault_id (str) –

  (required) The Exadata Database Storage Vault `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExascaleDbStorageVault

Return type

Response

Example

Click here to see an example of how to use get_exascale_db_storage_vault API.

get_execution_action(execution_action_id, **kwargs)

Gets information about the specified execution action.

Parameters

• execution_action_id (str) –

  (required) The execution action `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionAction

Return type

Response

Example

Click here to see an example of how to use get_execution_action API.

get_execution_window(execution_window_id, **kwargs)

Gets information about the specified execution window.

Parameters

• execution_window_id (str) –

  (required) The execution window `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionWindow

Return type

Response

Example

Click here to see an example of how to use get_execution_window API.

get_external_backup_job(backup_id, **kwargs)

Gets information about the specified external backup job.

Note: This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information.

Parameters

• backup_id (str) –

  (required) The backup `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalBackupJob

Return type

Response

Example

Click here to see an example of how to use get_external_backup_job API.

get_external_container_database(external_container_database_id, **kwargs)

Gets information about the specified external container database.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalContainerDatabase

Return type

Response

Example

Click here to see an example of how to use get_external_container_database API.

get_external_database_connector(external_database_connector_id, **kwargs)

Gets information about the specified external database connector.

Parameters

• external_database_connector_id (str) –

  (required) The `OCID`__ of the external database connector resource (ExternalDatabaseConnectorId).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalDatabaseConnector

Return type

Response

Example

Click here to see an example of how to use get_external_database_connector API.

get_external_non_container_database(external_non_container_database_id, **kwargs)

Gets information about a specific external non-container database.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalNonContainerDatabase

Return type

Response

Example

Click here to see an example of how to use get_external_non_container_database API.

get_external_pluggable_database(external_pluggable_database_id, **kwargs)

Gets information about a specific create_external_pluggable_database_details() resource.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalPluggableDatabase

Return type

Response

Example

Click here to see an example of how to use get_external_pluggable_database API.

get_gi_home(gi_home_id, **kwargs)

Gets information about the specified Grid Infrastructure Home.

Parameters

• gi_home_id (str) –

  (required) The Grid Infrastructure Home `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type GiHome

Return type

Response

Example

Click here to see an example of how to use get_gi_home API.

get_infrastructure_target_versions(compartment_id, **kwargs)

Gets details of the Exadata Infrastructure target system software versions that can be applied to the specified infrastructure resource for maintenance updates. Applies to Exadata Cloud@Customer and Exadata Cloud instances only.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• target_resource_id (str) – (optional) The target resource ID.

• target_resource_type (str) –

  (optional) The type of the target resource.

  Allowed values are: “AUTONOMOUS_EXADATA_INFRASTRUCTURE”, “AUTONOMOUS_CONTAINER_DATABASE”, “EXADATA_DB_SYSTEM”, “CLOUD_EXADATA_INFRASTRUCTURE”, “EXACC_INFRASTRUCTURE”, “AUTONOMOUS_VM_CLUSTER”, “AUTONOMOUS_DATABASE”, “CLOUD_AUTONOMOUS_VM_CLUSTER”

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type InfrastructureTargetVersion

Return type

Response

Example

Click here to see an example of how to use get_infrastructure_target_versions API.

get_key_store(key_store_id, **kwargs)

Gets information about the specified key store.

Parameters

• key_store_id (str) –

  (required) The `OCID`__ of the key store.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type KeyStore

Return type

Response

Example

Click here to see an example of how to use get_key_store API.

get_maintenance_run(maintenance_run_id, **kwargs)

Gets information about the specified maintenance run.

Parameters

• maintenance_run_id (str) – (required) The maintenance run OCID.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type MaintenanceRun

Return type

Response

Example

Click here to see an example of how to use get_maintenance_run API.

get_maintenance_run_history(maintenance_run_history_id, **kwargs)

Gets information about the specified maintenance run history.

Parameters

• maintenance_run_history_id (str) – (required) The maintenance run history OCID.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type MaintenanceRunHistory

Return type

Response

Example

Click here to see an example of how to use get_maintenance_run_history API.

get_oneoff_patch(oneoff_patch_id, **kwargs)

Gets information about the specified one-off patch.

Parameters

• oneoff_patch_id (str) –

  (required) The one-off patch `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type OneoffPatch

Return type

Response

Example

Click here to see an example of how to use get_oneoff_patch API.

get_pdb_conversion_history_entry(database_id, pdb_conversion_history_entry_id, **kwargs)

Gets the details of operations performed to convert the specified database from non-container (non-CDB) to pluggable (PDB).

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• pdb_conversion_history_entry_id (str) –

  (required) The database conversion history `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PdbConversionHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_pdb_conversion_history_entry API.

get_pluggable_database(pluggable_database_id, **kwargs)

Gets information about the specified pluggable database.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use get_pluggable_database API.

get_pluggable_database_snapshot(pluggable_database_snapshot_id, **kwargs)

Gets information about the specified Exadata Pluggable Database Snapshot in the specified compartment.

Parameters

• pluggable_database_snapshot_id (str) –

  (required) The Exadata Pluggable Database Snapshot `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabaseSnapshot

Return type

Response

Example

Click here to see an example of how to use get_pluggable_database_snapshot API.

get_scheduled_action(scheduled_action_id, **kwargs)

Gets information about the specified Scheduled Action.

Parameters

• scheduled_action_id (str) –

  (required) The Scheduled Action `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ScheduledAction

Return type

Response

Example

Click here to see an example of how to use get_scheduled_action API.

get_scheduling_plan(scheduling_plan_id, **kwargs)

Gets information about the specified Scheduling Plan.

Parameters

• scheduling_plan_id (str) –

  (required) The Schedule Plan `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPlan

Return type

Response

Example

Click here to see an example of how to use get_scheduling_plan API.

get_scheduling_policy(scheduling_policy_id, **kwargs)

Gets information about the specified Scheduling Policy.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPolicy

Return type

Response

Example

Click here to see an example of how to use get_scheduling_policy API.

get_scheduling_window(scheduling_policy_id, scheduling_window_id, **kwargs)

Gets information about the specified Scheduling Window.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• scheduling_window_id (str) –

  (required) The Scheduling Window `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingWindow

Return type

Response

Example

Click here to see an example of how to use get_scheduling_window API.

get_vm_cluster(vm_cluster_id, **kwargs)

Gets information about the VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmCluster

Return type

Response

Example

Click here to see an example of how to use get_vm_cluster API.

get_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, **kwargs)

Gets information about the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. To get information about a cloud VM cluster in an Exadata Cloud Service instance, use the get_cloud_vm_cluster() operation.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterNetwork

Return type

Response

Example

Click here to see an example of how to use get_vm_cluster_network API.

get_vm_cluster_patch(vm_cluster_id, patch_id, **kwargs)

Gets information about a specified patch package.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• patch_id (str) –

  (required) The `OCID`__ of the patch.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Patch

Return type

Response

Example

Click here to see an example of how to use get_vm_cluster_patch API.

get_vm_cluster_patch_history_entry(vm_cluster_id, patch_history_entry_id, **kwargs)

Gets the patch history details for the specified patch history entry.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• patch_history_entry_id (str) –

  (required) The `OCID`__ of the patch history entry.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PatchHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_vm_cluster_patch_history_entry API.

get_vm_cluster_update(vm_cluster_id, update_id, **kwargs)

Gets information about a specified maintenance update package for a VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• update_id (str) –

  (required) The `OCID`__ of the maintenance update.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterUpdate

Return type

Response

Example

Click here to see an example of how to use get_vm_cluster_update API.

get_vm_cluster_update_history_entry(vm_cluster_id, update_history_entry_id, **kwargs)

Gets the maintenance update history details for the specified update history entry. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• update_history_entry_id (str) –

  (required) The `OCID`__ of the maintenance update history entry.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterUpdateHistoryEntry

Return type

Response

Example

Click here to see an example of how to use get_vm_cluster_update_history_entry API.

import_transportable_tablespace(autonomous_database_id, import_transportable_tablespace_details, **kwargs)

Imports transportable tablespace for the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• import_transportable_tablespace_details (oci.database.models.ImportTransportableTablespaceDetails) – (required) Details for importing transportable tablespace for the Autonomous AI Database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use import_transportable_tablespace API.

launch_autonomous_exadata_infrastructure(launch_autonomous_exadata_infrastructure_details, **kwargs)

Deprecated To create a new Autonomous AI Database system on dedicated Exadata Infrastructure, use the create_cloud_exadata_infrastructure() and create_cloud_autonomous_vm_cluster() operations instead. Note that to create an Autonomous VM cluster, you must have an existing Exadata Infrastructure resource to contain the VM cluster.

Parameters

• launch_autonomous_exadata_infrastructure_details (oci.database.models.LaunchAutonomousExadataInfrastructureDetails) – (required) Deprecated. Use the create_cloud_exadata_infrastructure() or create_cloud_autonomous_vm_cluster() operations instead.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use launch_autonomous_exadata_infrastructure API.

launch_db_system(launch_db_system_details, **kwargs)

Creates a new DB system in the specified compartment and availability domain. The Oracle Database edition that you specify applies to all the databases on that DB system. The selected edition cannot be changed.

An initial database is created on the DB system based on the request parameters you provide and some default options. For detailed information about default options, see `Bare metal and virtual machine DB system default options.`__

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

Use the create_cloud_exadata_infrastructure() and create_cloud_vm_cluster() APIs to provision a new Exadata Cloud Service instance.

Parameters

• launch_db_system_details (oci.database.models.LaunchDbSystemBase) –

  (required) Request to launch a DB system.

  Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

  For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystem

Return type

Response

Example

Click here to see an example of how to use launch_db_system API.

list_advanced_cluster_file_systems(compartment_id, **kwargs)

Lists the advanced cluster file system resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• vm_cluster_id (str) – (optional) A filter to return only ACFS that match the given vm cluster id exactly.

• resource_id (str) – (optional) If provided, filters the results for the specified resource Id.

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “AVAILABLE”, “CREATING”, “FAILED”, “UPDATING”, “DELETED”, “DELETING”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• name (str) – (optional) A filter to return only resources that match the entire name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AdvancedClusterFileSystemCollection

Return type

Response

Example

Click here to see an example of how to use list_advanced_cluster_file_systems API.

list_application_vips(compartment_id, cloud_vm_cluster_id, **kwargs)

Gets a list of application virtual IP (VIP) addresses on a cloud VM cluster.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• cloud_vm_cluster_id (str) –

  (required) The `OCID`__ of the cloud VM cluster associated with the application virtual IP (VIP) address.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “DISPLAYNAME”, “TIMECREATED”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “TERMINATING”, “TERMINATED”, “FAILED”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ApplicationVipSummary

Return type

Response

Example

Click here to see an example of how to use list_application_vips API.

list_autonomous_container_database_backups(**kwargs)

Gets a list of Autonomous Container Database backups by using either the ‘autonomousDatabaseId’ or ‘compartmentId’ as your query parameter.

Parameters

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• autonomous_container_database_id (str) –

  (optional) The Autonomous Container Database `OCID`__.

• is_remote (bool) – (optional) call for all remote backups

• infrastructure_type (str) –

  (optional) A filter to return only resources that match the given Infrastructure Type.

  Allowed values are: “CLOUD”, “CLOUD_AT_CUSTOMER”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “ACTIVE”, “DELETING”, “DELETED”, “FAILED”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseBackupCollection

Return type

Response

Example

Click here to see an example of how to use list_autonomous_container_database_backups API.

list_autonomous_container_database_dataguard_associations(autonomous_container_database_id, **kwargs)

Deprecated. Use the list_autonomous_container_databases() operation to get a list of the Autonomous Container Databases (ACDs)with Autonomous Data Guard-enabled associated with the specified ACD.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use list_autonomous_container_database_dataguard_associations API.

list_autonomous_container_database_versions(compartment_id, service_component, **kwargs)

Gets a list of supported Autonomous Container Database versions.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• service_component (str) –

  (required) The service component to use, either ADBD or EXACC.

  Allowed values are: “ADBD”, “EXACC”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousContainerDatabaseVersionSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_container_database_versions API.

list_autonomous_container_databases(compartment_id, **kwargs)

Gets a list of the Autonomous Container Databases in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• autonomous_exadata_infrastructure_id (str) –

  (optional) The Autonomous Exadata Infrastructure `OCID`__.

• autonomous_vm_cluster_id (str) –

  (optional) The Autonomous VM Cluster `OCID`__.

• infrastructure_type (str) –

  (optional) A filter to return only resources that match the given Infrastructure Type.

  Allowed values are: “CLOUD”, “CLOUD_AT_CUSTOMER”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “BACKUP_IN_PROGRESS”, “RESTORING”, “RESTORE_FAILED”, “RESTARTING”, “MAINTENANCE_IN_PROGRESS”, “ROLE_CHANGE_IN_PROGRESS”, “ENABLING_AUTONOMOUS_DATA_GUARD”, “UNAVAILABLE”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• service_level_agreement_type (str) – (optional) A filter to return only resources that match the given service-level agreement type exactly.

• cloud_autonomous_vm_cluster_id (str) –

  (optional) The cloud Autonomous VM Cluster `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousContainerDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_container_databases API.

list_autonomous_database_backups(**kwargs)

Gets a list of Autonomous AI Database backups based on either the autonomousDatabaseId or compartmentId specified as a query parameter.

Parameters

• autonomous_database_id (str) –

  (optional) The database `OCID`__.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “ACTIVE”, “DELETING”, “DELETED”, “FAILED”, “UPDATING”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• type (str) – (optional) A filter to return only backups that matches with the given type of Backup.

• backup_destination_id (str) – (optional) A filter to return only resources that have the given backup destination id.

• key_store_id (str) – (optional) A filter to return only resources that have the given key store id.

• infrastructure_type (str) –

  (optional) A filter to return only resources that match the given Infrastructure Type.

  Allowed values are: “CLOUD”, “CLOUD_AT_CUSTOMER”

• is_pitr_eligible (bool) – (optional) Filters backups based on the current Autonomous AI Database configuration; returns only those relevant for point-in-time recovery (PITR). Does not guarantee exclusion of backups in orphan ranges.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDatabaseBackupSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_backups API.

list_autonomous_database_character_sets(**kwargs)

Gets a list of supported character sets.

Parameters

• opc_request_id (str) – (optional) Unique identifier for the request.

• is_shared (bool) – (optional) Specifies whether this request is for an Autonomous AI Database Serverless instance. By default, this request will be for Autonomous AI Database on Dedicated Exadata Infrastructure.

• is_dedicated (bool) – (optional) Specifies if the request is for an Autonomous AI Database Dedicated instance. The default request is for an Autonomous AI Database Dedicated instance.

• character_set_type (str) –

  (optional) Specifies whether this request pertains to database character sets or national character sets.

  Allowed values are: “DATABASE”, “NATIONAL”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDatabaseCharacterSets

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_character_sets API.

list_autonomous_database_clones(compartment_id, autonomous_database_id, **kwargs)

Lists the Autonomous AI Database clones for the specified Autonomous AI Database.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “STOPPING”, “STOPPED”, “STARTING”, “TERMINATING”, “TERMINATED”, “UNAVAILABLE”, “RESTORE_IN_PROGRESS”, “RESTORE_FAILED”, “BACKUP_IN_PROGRESS”, “SCALE_IN_PROGRESS”, “AVAILABLE_NEEDS_ATTENTION”, “UPDATING”, “MAINTENANCE_IN_PROGRESS”, “RESTARTING”, “RECREATING”, “ROLE_CHANGE_IN_PROGRESS”, “UPGRADING”, “INACCESSIBLE”, “STANDBY”, “TRANSPORTING”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “NONE”, “TIMECREATED”, “DISPLAYNAME”

• clone_type (str) –

  (optional) A filter to return only resources that match the given clone type exactly.

  Allowed values are: “REFRESHABLE_CLONE”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_clones API.

list_autonomous_database_dataguard_associations(autonomous_database_id, **kwargs)

Deprecated. Use the get_autonomous_container_database() operation to get a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_dataguard_associations API.

list_autonomous_database_peers(autonomous_database_id, **kwargs)

Lists the Autonomous AI Database peers for the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabasePeerCollection

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_peers API.

list_autonomous_database_refreshable_clones(autonomous_database_id, **kwargs)

Lists the OCIDs of the Autonomous AI Database local and connected remote refreshable clones with the region where they exist for the specified source database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type RefreshableCloneCollection

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_refreshable_clones API.

list_autonomous_database_software_images(compartment_id, image_shape_family, **kwargs)

Gets a list of the Autonomous AI Database Software Images in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• image_shape_family (str) –

  (required) A filter to return only resources that match the given image shape family exactly.

  Allowed values are: “EXACC_SHAPE”, “EXADATA_SHAPE”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• sort_by (str) –

  (optional) parameter according to which Autonomous AI Database Software Images will be sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “AVAILABLE”, “FAILED”, “PROVISIONING”, “EXPIRED”, “TERMINATED”, “TERMINATING”, “UPDATING”

• opc_request_id (str) – (optional) Unique identifier for the request.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseSoftwareImageCollection

Return type

Response

Example

Click here to see an example of how to use list_autonomous_database_software_images API.

list_autonomous_databases(compartment_id, **kwargs)

Gets a list of Autonomous AI Databases based on the query parameters specified.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• autonomous_container_database_id (str) –

  (optional) The Autonomous Container Database `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• infrastructure_type (str) –

  (optional) A filter to return only resources that match the given Infrastructure Type.

  Allowed values are: “CLOUD”, “CLOUD_AT_CUSTOMER”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “STOPPING”, “STOPPED”, “STARTING”, “TERMINATING”, “TERMINATED”, “UNAVAILABLE”, “RESTORE_IN_PROGRESS”, “RESTORE_FAILED”, “BACKUP_IN_PROGRESS”, “SCALE_IN_PROGRESS”, “AVAILABLE_NEEDS_ATTENTION”, “UPDATING”, “MAINTENANCE_IN_PROGRESS”, “RESTARTING”, “RECREATING”, “ROLE_CHANGE_IN_PROGRESS”, “UPGRADING”, “INACCESSIBLE”, “STANDBY”, “TRANSPORTING”

• lifecycle_state_not_equal_to (str) –

  (optional) A filter to return only resources that not match the given lifecycle state.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “STOPPING”, “STOPPED”, “STARTING”, “TERMINATING”, “TERMINATED”, “UNAVAILABLE”, “RESTORE_IN_PROGRESS”, “RESTORE_FAILED”, “BACKUP_IN_PROGRESS”, “SCALE_IN_PROGRESS”, “AVAILABLE_NEEDS_ATTENTION”, “UPDATING”, “MAINTENANCE_IN_PROGRESS”, “RESTARTING”, “RECREATING”, “ROLE_CHANGE_IN_PROGRESS”, “UPGRADING”, “INACCESSIBLE”, “STANDBY”, “TRANSPORTING”

• db_workload (str) –

  (optional) A filter to return only Autonomous AI Database resources that match the specified workload type.

  Allowed values are: “OLTP”, “DW”, “AJD”, “APEX”, “LH”

• db_version (str) – (optional) A filter to return only Autonomous AI Database resources that match the specified dbVersion.

• is_free_tier (bool) – (optional) Filter on the value of the resource’s ‘isFreeTier’ property. A value of true returns only Always Free resources. A value of false excludes Always Free resources from the returned results. Omitting this parameter returns both Always Free and paid resources.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• is_refreshable_clone (bool) – (optional) Filter on the value of the resource’s ‘isRefreshableClone’ property. A value of true returns only refreshable clones. A value of false excludes refreshable clones from the returned results. Omitting this parameter returns both refreshable clones and databases that are not refreshable clones.

• is_data_guard_enabled (bool) – (optional) A filter to return only resources that have Data Guard enabled.

• is_resource_pool_leader (bool) – (optional) Filter if the resource is the resource pool leader. A value of true returns only resource pool leader.

• resource_pool_leader_id (str) –

  (optional) The database `OCID`__ of the resourcepool Leader Autonomous AI Database.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_databases API.

list_autonomous_databases_in_autonomous_container_database_backup(autonomous_container_database_id, time_stamp_requested, **kwargs)

Gets a list of Autonomous Databases associated with backups at the given timestamp for the specified Autonomous Container Database. If compartmentId is provided, filters to that compartment; otherwise, uses the container’s compartment.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• time_stamp_requested (datetime) – (required) The timestamp at which the list of autonomous databases present to be returned (ISO-8601 format, e.g., “2025-12-02T06:39:15Z”). The requested value must be after the end timestamp of the oldest available Autonomous Container Database backup.

• compartment_id (str) –

  (optional) The compartment `OCID`__. If not provided, uses the Autonomous Container Database’s compartment.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseInBackupCollection

Return type

Response

Example

Click here to see an example of how to use list_autonomous_databases_in_autonomous_container_database_backup API.

list_autonomous_db_preview_versions(compartment_id, **kwargs)

Gets a list of supported Autonomous AI Database versions. Note that preview version software is only available for Autonomous AI Database Serverless (https://docs.oracle.com/en/cloud/paas/autonomous-database/index.html) databases.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for DBWORKLOAD is ascending.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “DBWORKLOAD”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDbPreviewVersionSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_db_preview_versions API.

list_autonomous_db_versions(compartment_id, **kwargs)

Gets a list of supported Autonomous AI Database versions.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• db_workload (str) –

  (optional) A filter to return only Autonomous AI Database resources that match the specified workload type.

  Allowed values are: “OLTP”, “DW”, “AJD”, “APEX”, “LH”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousDbVersionSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_db_versions API.

list_autonomous_exadata_infrastructure_shapes(availability_domain, compartment_id, **kwargs)

Deprecated.

Parameters

• availability_domain (str) – (required) The name of the Availability Domain.

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousExadataInfrastructureShapeSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_exadata_infrastructure_shapes API.

list_autonomous_exadata_infrastructures(compartment_id, **kwargs)

Deprecated. Use the list_cloud_exadata_infrastructures() operation to list Exadata Infrastructures in the Oracle cloud and the list_cloud_autonomous_vm_clusters() operation to list Autonomous Exadata VM clusters.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousExadataInfrastructureSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_exadata_infrastructures API.

list_autonomous_virtual_machines(compartment_id, autonomous_vm_cluster_id, **kwargs)

Lists the Autonomous Virtual Machines in the specified Autonomous VM Cluster and Compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• autonomous_vm_cluster_id (str) –

  (required) The Autonomous Virtual machine `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousVirtualMachineSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_virtual_machines API.

list_autonomous_vm_cluster_acd_resource_usage(autonomous_vm_cluster_id, **kwargs)

Gets the list of resource usage details for all the Autonomous Container Database in the specified Autonomous Exadata VM cluster.

Parameters

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousContainerDatabaseResourceUsage

Return type

Response

Example

Click here to see an example of how to use list_autonomous_vm_cluster_acd_resource_usage API.

list_autonomous_vm_clusters(compartment_id, **kwargs)

Gets a list of Exadata Cloud@Customer Autonomous VM clusters in the specified compartment. To list Autonomous VM Clusters in the Oracle Cloud, see list_cloud_autonomous_vm_clusters().

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• exadata_infrastructure_id (str) – (optional) If provided, filters the results for the given Exadata Infrastructure.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousVmClusterSummary

Return type

Response

Example

Click here to see an example of how to use list_autonomous_vm_clusters API.

list_available_maintenance_windows(autonomous_database_id, **kwargs)

Retrieves the list of available maintenance window options for the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseMaintenanceWindowCollection

Return type

Response

Example

Click here to see an example of how to use list_available_maintenance_windows API.

list_backup_destination(compartment_id, **kwargs)

Gets a list of backup destinations in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• type (str) – (optional) A filter to return only resources that match the given type of the Backup Destination.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of BackupDestinationSummary

Return type

Response

Example

Click here to see an example of how to use list_backup_destination API.

list_backups(**kwargs)

Gets a list of backups based on the databaseId or compartmentId specified. Either one of these query parameters must be provided.

Parameters

• database_id (str) –

  (optional) The `OCID`__ of the database.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• shape_family (str) –

  (optional) If provided, filters the results to the set of database versions which are supported for the given shape family.

  Allowed values are: “SINGLENODE”, “YODA”, “VIRTUALMACHINE”, “EXADATA”, “EXACC”, “EXADB_XS”

• version (str) – (optional) A filter to return only resources that match the given database version.

• type (str) – (optional) A filter to return only backups that matches with the given type of Backup.

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “ACTIVE”, “DELETING”, “DELETED”, “FAILED”, “RESTORING”, “UPDATING”, “CANCELING”, “CANCELED”

• time_expiry_scheduled_greater_than_or_equal_to (datetime) – (optional) The start of date-time range of expiration for the long term backups to be fetched.

• time_expiry_scheduled_less_than (datetime) – (optional) The end of date-time range of expiration for the long term backups to be fetched.

• backup_destination_type (str) – (optional) A filter to return only resources that match the given backup destination type.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of BackupSummary

Return type

Response

Example

Click here to see an example of how to use list_backups API.

list_basecc_vm_cluster_update_history_entries(basecc_vm_cluster_id, **kwargs)

Gets the history of the maintenance update actions performed on the specified BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “IN_PROGRESS”, “SUCCEEDED”, “FAILED”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of BaseccVmClusterUpdateHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_basecc_vm_cluster_update_history_entries API.

list_basecc_vm_cluster_updates(basecc_vm_cluster_id, **kwargs)

Lists the maintenance updates that can be applied to the specified BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “AVAILABLE”, “SUCCESS”, “IN_PROGRESS”, “FAILED”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of BaseccVmClusterUpdateSummary

Return type

Response

Example

Click here to see an example of how to use list_basecc_vm_cluster_updates API.

list_basecc_vm_clusters(compartment_id, **kwargs)

Lists the BaseDB-C@C VM clusters in the specified compartment. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• base_infrastructure_id (str) – (optional) If provided, filters the results for the given Oracle Data Cloud@Customer Infrastructure.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• vm_cluster_type (str) –

  (optional) A filter to return only BaseDB-C@C VM clusters that match the given VM Cluster type exactly.

  Allowed values are: “REGULAR”, “DEVELOPER”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of BaseccVmClusterSummary

Return type

Response

Example

Click here to see an example of how to use list_basecc_vm_clusters API.

list_cloud_autonomous_vm_cluster_acd_resource_usage(cloud_autonomous_vm_cluster_id, **kwargs)

Gets the list of resource usage details for all the Cloud Autonomous Container Database in the specified Cloud Autonomous Exadata VM cluster.

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousContainerDatabaseResourceUsage

Return type

Response

Example

Click here to see an example of how to use list_cloud_autonomous_vm_cluster_acd_resource_usage API.

list_cloud_autonomous_vm_clusters(compartment_id, **kwargs)

Lists Autonomous Exadata VM clusters in the Oracle cloud. For Exadata Cloud@Customer systems, see list_autonomous_vm_clusters().

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• cloud_exadata_infrastructure_id (str) – (optional) If provided, filters the results for the specified cloud Exadata infrastructure.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of CloudAutonomousVmClusterSummary

Return type

Response

Example

Click here to see an example of how to use list_cloud_autonomous_vm_clusters API.

list_cloud_exadata_infrastructures(compartment_id, **kwargs)

Gets a list of the cloud Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud Service instances and Autonomous AI Database on dedicated Exadata infrastructure only.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• cluster_placement_group_id (str) – (optional) A filter to return only resources that match the given cluster placement group ID exactly.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of CloudExadataInfrastructureSummary

Return type

Response

Example

Click here to see an example of how to use list_cloud_exadata_infrastructures API.

list_cloud_vm_cluster_update_history_entries(cloud_vm_cluster_id, **kwargs)

Gets the history of the maintenance update actions performed on the specified cloud VM cluster. Applies to Exadata Cloud Service instances only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of UpdateHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_cloud_vm_cluster_update_history_entries API.

list_cloud_vm_cluster_updates(cloud_vm_cluster_id, **kwargs)

Lists the maintenance updates that can be applied to the specified cloud VM cluster. Applies to Exadata Cloud Service instances only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of UpdateSummary

Return type

Response

Example

Click here to see an example of how to use list_cloud_vm_cluster_updates API.

list_cloud_vm_clusters(compartment_id, **kwargs)

Gets a list of the cloud VM clusters in the specified compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• cloud_exadata_infrastructure_id (str) – (optional) If provided, filters the results for the specified cloud Exadata infrastructure.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only cloud VM clusters that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• vm_cluster_type (str) –

  (optional) A filter to return only cloud vmclusters that match the given cloud vmcluster type exactly.

  Allowed values are: “REGULAR”, “DEVELOPER”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of CloudVmClusterSummary

Return type

Response

Example

Click here to see an example of how to use list_cloud_vm_clusters API.

list_console_connections(db_node_id, **kwargs)

Lists the console connections for the specified database node.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ConsoleConnectionSummary

Return type

Response

Example

Click here to see an example of how to use list_console_connections API.

list_console_histories(db_node_id, **kwargs)

Lists the console histories for the specified database node.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “REQUESTED”, “GETTING_HISTORY”, “SUCCEEDED”, “FAILED”, “DELETED”, “DELETING”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleHistoryCollection

Return type

Response

Example

Click here to see an example of how to use list_console_histories API.

list_container_database_patches(autonomous_container_database_id, compartment_id, **kwargs)

Lists the patches applicable to the requested container database.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• autonomous_patch_type (str) –

  (optional) Autonomous patch type, either “QUARTERLY” or “TIMEZONE”.

  Allowed values are: “QUARTERLY”, “TIMEZONE”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of AutonomousPatchSummary

Return type

Response

Example

Click here to see an example of how to use list_container_database_patches API.

list_data_guard_associations(database_id, **kwargs)

Lists all Data Guard associations for the specified database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DataGuardAssociationSummary

Return type

Response

Example

Click here to see an example of how to use list_data_guard_associations API.

list_database_snapshots(**kwargs)

Gets a list of the Exadata Database Snapshots in the specified compartment.

Parameters

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for NAME is ascending. The NAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “NAME”

• name (str) – (optional) A filter to return only resources that match the entire name given. The match is not case sensitive.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only Exadata Database Snapshots that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “AVAILABLE”, “TERMINATING”, “TERMINATED”, “FAILED”

• database_id (str) – (optional) A filter to return only Exadata Database Snapshots that match the given Database Id.

• cluster_id (str) – (optional) A filter to return only Exadata Database Snapshots that match the given VM cluster.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSnapshotCollection

Return type

Response

Example

Click here to see an example of how to use list_database_snapshots API.

list_database_software_images(compartment_id, **kwargs)

Gets a list of the database software images in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. Default order for PATCHSET is descending.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”, “PATCHSET”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “DELETING”, “DELETED”, “FAILED”, “TERMINATING”, “TERMINATED”, “UPDATING”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• image_type (str) –

  (optional) A filter to return only resources that match the given image type exactly.

  Allowed values are: “GRID_IMAGE”, “DATABASE_IMAGE”

• image_shape_family (str) –

  (optional) A filter to return only resources that match the given image shape family exactly.

  Allowed values are: “VM_BM_SHAPE”, “EXADATA_SHAPE”, “EXACC_SHAPE”, “EXADBXS_SHAPE”, “BDBCC_SHAPE”

• patch_set_greater_than_or_equal_to (str) – (optional) A filter to return only resources with patchSet greater than or equal to given value.

• db_system_id (str) –

  (optional) The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system.

• is_upgrade_supported (bool) – (optional) If provided, filters the results to the set of database versions which are supported for Upgrade.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DatabaseSoftwareImageSummary

Return type

Response

Example

Click here to see an example of how to use list_database_software_images API.

list_database_upgrade_history_entries(database_id, **kwargs)

Gets the upgrade history for a specified database in a bare metal or virtual machine DB system.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• upgrade_action (str) –

  (optional) A filter to return only upgradeHistoryEntries that match the specified Upgrade Action.

  Allowed values are: “PRECHECK”, “UPGRADE”, “ROLLBACK”

• lifecycle_state (str) –

  (optional) A filter to return only upgradeHistoryEntries that match the given lifecycle state exactly.

  Allowed values are: “SUCCEEDED”, “FAILED”, “IN_PROGRESS”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is ascending.

  Allowed values are: “TIMESTARTED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DatabaseUpgradeHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_database_upgrade_history_entries API.

list_databases(compartment_id, **kwargs)

Gets a list of the databases in the specified Database Home.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• db_home_id (str) –

  (optional) A Database Home `OCID`__.

• system_id (str) –

  (optional) The `OCID`__ of the Exadata DB system that you want to filter the database results by. Applies only to Exadata DB systems.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DBNAME is ascending. The DBNAME sort order is case sensitive.

  Allowed values are: “DBNAME”, “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “BACKUP_IN_PROGRESS”, “UPGRADING”, “CONVERTING”, “TERMINATING”, “TERMINATED”, “RESTORE_FAILED”, “FAILED”

• db_name (str) – (optional) A filter to return only resources that match the entire database name given. The match is not case sensitive.

• managed_auto_failover (str) –

  (optional) Filter the databases by managed auto failover param.

  Allowed values are: “REGISTERED”, “UNREGISTERED”, “ALL”

• failover_targets (str) –

  (optional) Filter the databases by failoverTargets param.

  Allowed values are: “DEFINED”, “UNDEFINED”, “ALL”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_databases API.

list_db_connection_bundles(compartment_id, **kwargs)

Lists all database connection bundles that match the query parameters.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• sort_by (str) –

  (optional) The field to sort by. You can specify only one sort order. The default order for TIMECREATED is descending. The default order for TIMEREFRESHED is descending.

  Allowed values are: “TIMECREATED”, “TIMEREFRESHED”

• lifecycle_state (str) –

  (optional) A filter that returns only resources that match the given lifecycle state. The state value is case-insensitive.

  Allowed values are: “CREATING”, “ACTIVE”, “INACTIVE”, “UPDATING”, “DELETING”, “DELETED”, “FAILED”

• opc_request_id (str) – (optional) Unique identifier for the request.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• db_connection_bundle_type (str) –

  (optional) A filter that returns only resources that match the specified database connection bundle type.

  Allowed values are: “TLS”, “MTLS”

• associated_resource_id (str) – (optional) The OCID of the VM cluster associated with the connection bundle. If the parameter is set to null, all bundles are returned.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbConnectionBundleSummary

Return type

Response

Example

Click here to see an example of how to use list_db_connection_bundles API.

list_db_home_patch_history_entries(db_home_id, **kwargs)

Lists the history of patch operations on the specified Database Home.

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PatchHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_db_home_patch_history_entries API.

list_db_home_patches(db_home_id, **kwargs)

Lists patches applicable to the requested Database Home.

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PatchSummary

Return type

Response

Example

Click here to see an example of how to use list_db_home_patches API.

list_db_homes(compartment_id, **kwargs)

Lists the Database Homes in the specified DB system and compartment. A Database Home is a directory where Oracle Database software is installed.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• db_system_id (str) –

  (optional) The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system.

• vm_cluster_id (str) –

  (optional) The `OCID`__ of the VM cluster.

• backup_id (str) –

  (optional) The `OCID`__ of the backup. Specify a backupId to list only the DB systems or DB homes that support creating a database using this backup in this compartment.

• db_version (str) – (optional) A filter to return only DB Homes that match the specified dbVersion.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbHomeSummary

Return type

Response

Example

Click here to see an example of how to use list_db_homes API.

list_db_nodes(compartment_id, **kwargs)

Lists the database nodes in the specified DB system and compartment. In addition to the other required parameters, either ‘–db-system-id’ or ‘–vm-cluster-id’ also must be provided, depending on the service being accessed.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• db_system_id (str) –

  (optional) The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system.

• vm_cluster_id (str) –

  (optional) The `OCID`__ of the VM cluster.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) Sort by TIMECREATED. Default order for TIMECREATED is descending.

  Allowed values are: “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “STOPPING”, “STOPPED”, “STARTING”, “TERMINATING”, “TERMINATED”, “FAILED”

• db_server_id (str) –

  (optional) The `OCID`__ of the Exacc Db server.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbNodeSummary

Return type

Response

Example

Click here to see an example of how to use list_db_nodes API.

list_db_servers(compartment_id, exadata_infrastructure_id, **kwargs)

Lists the Exadata DB servers in the ExadataInfrastructureId and specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• exadata_infrastructure_id (str) –

  (required) The `OCID`__ of the ExadataInfrastructure.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) Sort by TIMECREATED. Default order for TIMECREATED is descending.

  Allowed values are: “TIMECREATED”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “AVAILABLE”, “UNAVAILABLE”, “DELETING”, “DELETED”, “MAINTENANCE_IN_PROGRESS”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbServerSummary

Return type

Response

Example

Click here to see an example of how to use list_db_servers API.

list_db_system_compute_performances(**kwargs)

Gets a list of expected compute performance parameters for a virtual machine DB system based on system configuration. Adding compartmentId does not affect results.

Parameters

• db_system_shape (str) – (optional) If provided, filters the results to the set of database versions which are supported for the given shape.

• opc_request_id (str) – (optional) Unique identifier for the request.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbSystemComputePerformanceSummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_compute_performances API.

list_db_system_os_patch_history_entries(db_system_id, **kwargs)

Gets the history of the OS patch actions performed on the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMESTARTED is descending.

  Allowed values are: “TIMESTARTED”, “ACTION”

• lifecycle_state (str) –

  (optional) A filter to return only OS patch history entries that match the given lifecycle state exactly.

  Allowed values are: “IN_PROGRESS”, “SUCCEEDED”, “FAILED”

• action (str) –

  (optional) A filter to return only OS patch history entries that match the specified OS patch action.

  Allowed values are: “PRECHECK”, “APPLY”

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystemOsPatchHistoryEntryCollection

Return type

Response

Example

Click here to see an example of how to use list_db_system_os_patch_history_entries API.

list_db_system_patch_history_entries(db_system_id, **kwargs)

Gets the history of the patch actions performed on the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PatchHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_patch_history_entries API.

list_db_system_patches(db_system_id, **kwargs)

Lists the patches applicable to the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PatchSummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_patches API.

list_db_system_shapes(compartment_id, **kwargs)

Gets a list of the shapes that can be used to launch a new DB system. The shape determines resources to allocate to the DB system - CPU cores and memory for VM shapes; CPU cores, memory and storage for non-VM (or bare metal) shapes.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• availability_domain (str) – (optional) The name of the Availability Domain.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• shape_attribute (str) – (optional) If provided and applicable, return DB System shape parameters based on the shapeAttribute provided

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbSystemShapeSummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_shapes API.

list_db_system_storage_performances(storage_management, **kwargs)

Gets a list of possible expected storage performance parameters of a VMDB System based on Configuration.

Parameters

• storage_management (str) –

  (required) The DB system storage management option. Used to list database versions available for that storage manager. Valid values are ASM and LVM. * ASM specifies Oracle Automatic Storage Management * LVM specifies logical volume manager, sometimes called logical disk manager.

  Allowed values are: “ASM”, “LVM”

• shape_type (str) – (optional) Optional. Filters the performance results by shape type.

• database_edition (str) –

  (optional) The database edition of quota (STANDARD_EDITION/ENTERPRISE_EDITION/ENTERPRISE_EDITION_HIGH_PERFORMANCE/ENTERPRISE_EDITION_EXTREME_PERFORMANCE/ENTERPRISE_EDITION_DEVELOPER)

  Allowed values are: “STANDARD_EDITION”, “ENTERPRISE_EDITION”, “ENTERPRISE_EDITION_HIGH_PERFORMANCE”, “ENTERPRISE_EDITION_EXTREME_PERFORMANCE”, “ENTERPRISE_EDITION_DEVELOPER”

• opc_request_id (str) – (optional) Unique identifier for the request.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbSystemStoragePerformanceSummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_storage_performances API.

list_db_system_upgrade_history_entries(db_system_id, **kwargs)

Gets the history of the upgrade actions performed on the specified DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is ascending.

  Allowed values are: “TIMESTARTED”

• upgrade_action (str) –

  (optional) A filter to return only upgradeHistoryEntries that match the specified Upgrade Action.

  Allowed values are: “PRECHECK”, “ROLLBACK”, “UPDATE_SNAPSHOT_RETENTION_DAYS”, “UPGRADE”

• lifecycle_state (str) –

  (optional) A filter to return only upgrade history entries that match the given lifecycle state exactly.

  Allowed values are: “IN_PROGRESS”, “SUCCEEDED”, “FAILED”, “NEEDS_ATTENTION”

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbSystemUpgradeHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_upgrade_history_entries API.

list_db_system_upgrades(db_system_id, **kwargs)

Lists the applicable upgrade components for a DB systems.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbSystemUpgradeSummary

Return type

Response

Example

Click here to see an example of how to use list_db_system_upgrades API.

list_db_systems(compartment_id, **kwargs)

Lists the DB systems in the specified compartment. You can specify a backupId to list only the DB systems that support creating a database using this backup in this compartment.

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• backup_id (str) –

  (optional) The `OCID`__ of the backup. Specify a backupId to list only the DB systems or DB homes that support creating a database using this backup in this compartment.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MIGRATED”, “MAINTENANCE_IN_PROGRESS”, “NEEDS_ATTENTION”, “UPGRADING”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbSystemSummary

Return type

Response

Example

Click here to see an example of how to use list_db_systems API.

list_db_versions(compartment_id, **kwargs)

Gets a list of supported Oracle Database versions.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• db_system_shape (str) – (optional) If provided, filters the results to the set of database versions which are supported for the given shape.

• db_system_id (str) –

  (optional) The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system.

• storage_management (str) –

  (optional) The DB system storage management option. Used to list database versions available for that storage manager. Valid values are ASM and LVM. * ASM specifies Oracle Automatic Storage Management * LVM specifies logical volume manager, sometimes called logical disk manager.

  Allowed values are: “ASM”, “LVM”

• shape_attribute (str) – (optional) If provided and applicable, return DB System shape parameters based on the shapeAttribute provided

• is_upgrade_supported (bool) – (optional) If provided, filters the results to the set of database versions which are supported for Upgrade.

• is_database_software_image_supported (bool) – (optional) If true, filters the results to the set of Oracle Database versions that are supported for OCI database software images.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbVersionSummary

Return type

Response

Example

Click here to see an example of how to use list_db_versions API.

list_dbnode_snapshots(compartment_id, **kwargs)

Gets a list of the Exadata Database Node Snapshots in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for NAME is ascending. The NAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “NAME”

• name (str) – (optional) A filter to return only resources that match the entire name given. The match is not case sensitive.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only Exadata Database Snapshots that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “AVAILABLE”, “TERMINATING”, “TERMINATED”, “FAILED”, “MOUNTED”, “MOUNTING”, “UNMOUNTING”

• cluster_id (str) – (optional) A filter to return only Exadata Database Node Snapshots that match the given VM cluster.

• source_dbnode_id (str) – (optional) A filter to return only Exadata Database Snapshots that match the given database node.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of DbnodeSnapshotSummary

Return type

Response

Example

Click here to see an example of how to use list_dbnode_snapshots API.

list_estimate_cost_savings(is_cpu_autoscale, autonomous_database_id, **kwargs)

Gets the estimate cost savings of the Autonomous AI Database.

Parameters

• is_cpu_autoscale (bool) – (required) If provided as true, cost estimate with cpu autoscaling.

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type EstimateCostSavingsSummaryCollection

Return type

Response

Example

Click here to see an example of how to use list_estimate_cost_savings API.

list_exadata_infrastructures(compartment_id, **kwargs)

Lists the Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud@Customer instances only. To list the Exadata Cloud Service infrastructure resources in a compartment, use the list_cloud_exadata_infrastructures() operation.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “REQUIRES_ACTIVATION”, “ACTIVATING”, “ACTIVE”, “ACTIVATION_FAILED”, “FAILED”, “UPDATING”, “DELETING”, “DELETED”, “DISCONNECTED”, “MAINTENANCE_IN_PROGRESS”, “WAITING_FOR_CONNECTIVITY”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• excluded_fields (list[str]) –

  (optional) If provided, the specified fields will be excluded in the response.

  Allowed values are: “multiRackConfigurationFile”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExadataInfrastructureSummary

Return type

Response

Example

Click here to see an example of how to use list_exadata_infrastructures API.

list_exadb_vm_cluster_update_history_entries(exadb_vm_cluster_id, **kwargs)

Gets the history of the maintenance update actions performed on the specified Exadata VM cluster on Exascale Infrastructure.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExadbVmClusterUpdateHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_exadb_vm_cluster_update_history_entries API.

list_exadb_vm_cluster_updates(exadb_vm_cluster_id, **kwargs)

Lists the maintenance updates that can be applied to the specified Exadata VM cluster on Exascale Infrastructure.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• version (str) – (optional) A filter to return only resources that match the given update version exactly.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExadbVmClusterUpdateSummary

Return type

Response

Example

Click here to see an example of how to use list_exadb_vm_cluster_updates API.

list_exadb_vm_clusters(compartment_id, **kwargs)

Gets a list of the Exadata VM clusters on Exascale Infrastructure in the specified compartment. Applies to Exadata Database Service on Exascale Infrastructure only.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only Exadata VM clusters on Exascale Infrastructure that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• exascale_db_storage_vault_id (str) – (optional) A filter to return only Exadata VM clusters on Exascale Infrastructure that match the given Exascale Database Storage Vault ID.

• cluster_placement_group_id (str) – (optional) A filter to return only resources that match the given cluster placement group ID exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExadbVmClusterSummary

Return type

Response

Example

Click here to see an example of how to use list_exadb_vm_clusters API.

list_exascale_db_storage_vaults(compartment_id, **kwargs)

Gets a list of the Exadata Database Storage Vaults in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only Exadata Database Storage Vaults that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”

• cluster_placement_group_id (str) – (optional) A filter to return only resources that match the given cluster placement group ID exactly.

• attached_shape_attributes_not_equal_to (str) – (optional) A filter to return only Exadata Database Storage Vaults which do not match the given attachedShapeAttributes

• attached_shape_attributes (str) – (optional) A filter to return only Exadata Database Storage Vaults which match the given attachedShapeAttributes or has null attachedShapeAttributes

• vm_cluster_count_less_than_or_equal_to (int) – (optional) A filter to return only Exadata Database Storage Vaults with associated Exadata VM Clusters less than or equal to the given count

• vm_cluster_count_greater_than_or_equal_to (int) – (optional) A filter to return only Exadata Database Storage Vaults with associated Exadata VM Clusters greater than or equal to the given count

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• exadata_infrastructure_id (str) – (optional) A filter to return only list of Vaults that are linked to the exadata infrastructure Id.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExascaleDbStorageVaultSummary

Return type

Response

Example

Click here to see an example of how to use list_exascale_db_storage_vaults API.

list_execution_actions(compartment_id, **kwargs)

Lists the execution action resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “SCHEDULED”, “IN_PROGRESS”, “FAILED”, “CANCELED”, “UPDATING”, “DELETED”, “SUCCEEDED”, “PARTIAL_SUCCESS”

• execution_window_id (str) – (optional) A filter to return only resources that match the given execution wondow id.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExecutionActionSummary

Return type

Response

Example

Click here to see an example of how to use list_execution_actions API.

list_execution_windows(compartment_id, **kwargs)

Lists the execution window resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• execution_resource_id (str) – (optional) A filter to return only resources that match the given resource id exactly.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATED”, “SCHEDULED”, “IN_PROGRESS”, “FAILED”, “CANCELED”, “UPDATING”, “DELETED”, “SUCCEEDED”, “PARTIAL_SUCCESS”, “CREATING”, “DELETING”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExecutionWindowSummary

Return type

Response

Example

Click here to see an example of how to use list_execution_windows API.

list_external_container_databases(compartment_id, **kwargs)

Gets a list of the external container databases in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “DISPLAYNAME”, “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the specified lifecycle state.

  Allowed values are: “PROVISIONING”, “NOT_CONNECTED”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExternalContainerDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_external_container_databases API.

list_external_database_connectors(compartment_id, external_database_id, **kwargs)

Gets a list of the external database connectors in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• external_database_id (str) –

  (required) The `OCID`__ of the external database whose connectors will be listed.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “DISPLAYNAME”, “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the specified lifecycle state.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExternalDatabaseConnectorSummary

Return type

Response

Example

Click here to see an example of how to use list_external_database_connectors API.

list_external_non_container_databases(compartment_id, **kwargs)

Gets a list of the ExternalNonContainerDatabases in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “DISPLAYNAME”, “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the specified lifecycle state.

  Allowed values are: “PROVISIONING”, “NOT_CONNECTED”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExternalNonContainerDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_external_non_container_databases API.

list_external_pluggable_databases(compartment_id, **kwargs)

Gets a list of the create_external_pluggable_database_details() resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• external_container_database_id (str) –

  (optional) The ExternalContainerDatabase `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “DISPLAYNAME”, “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the specified lifecycle state.

  Allowed values are: “PROVISIONING”, “NOT_CONNECTED”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of ExternalPluggableDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_external_pluggable_databases API.

list_flex_components(compartment_id, **kwargs)

Gets a list of the flex components that can be used to launch a new DB system. The flex component determines resources to allocate to the DB system - Database Servers and Storage Servers.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• name (str) – (optional) A filter to return only resources that match the entire name given. The match is not case sensitive.

• shape (str) – (optional) A filter to return only resources that belong to the entire shape name given. The match is not case sensitive.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for NAME is ascending. The NAME sort order is case sensitive.

  Allowed values are: “NAME”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type FlexComponentCollection

Return type

Response

Example

Click here to see an example of how to use list_flex_components API.

list_gi_homes(compartment_id, **kwargs)

Lists the Grid Infrastructure Homes.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• db_system_id (str) –

  (optional) The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system.

• gi_version (str) – (optional) The Grid Infrastructure version. If provided, filters the results matching the provided grid infrastructure version.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for timeCreated is descending. Default order for displayName is ascending. The displayName sort order is case sensitive.

  Allowed values are: “timeCreated”, “displayName”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “INACTIVE”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type GiHomeCollection

Return type

Response

Example

Click here to see an example of how to use list_gi_homes API.

list_gi_version_minor_versions(version, **kwargs)

Gets a list of supported Oracle Grid Infrastructure minor versions for the given major version and shape family.

Parameters

• version (str) – (required) The Oracle Grid Infrastructure major version.

• availability_domain (str) – (optional) The target availability domain. Only passed if the limit is AD-specific.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• exadata_infrastructure_id (str) – (optional) If provided, filters the results for the given Exadata Infrastructure.

• shape_family (str) –

  (optional) If provided, filters the results to the set of database versions which are supported for the given shape family.

  Allowed values are: “SINGLENODE”, “YODA”, “VIRTUALMACHINE”, “EXADATA”, “EXACC”, “EXADB_XS”

• is_gi_version_for_provisioning (bool) – (optional) If true, returns the Grid Infrastructure versions that can be used for provisioning a cluster

• shape (str) – (optional) If provided, filters the results for the given shape.

• sort_by (str) –

  (optional) Sort by VERSION. Default order for VERSION is descending.

  Allowed values are: “VERSION”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of GiMinorVersionSummary

Return type

Response

Example

Click here to see an example of how to use list_gi_version_minor_versions API.

list_gi_versions(compartment_id, **kwargs)

Gets a list of supported GI versions.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• shape (str) – (optional) If provided, filters the results for the given shape.

• availability_domain (str) – (optional) The target availability domain. Only passed if the limit is AD-specific.

• resource_id (str) – (optional) If provided, filters the results for the specified resource Id.

• shape_attribute (str) – (optional) If provided and applicable, return DB System shape parameters based on the shapeAttribute provided

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of GiVersionSummary

Return type

Response

Example

Click here to see an example of how to use list_gi_versions API.

list_key_stores(compartment_id, **kwargs)

Gets a list of key stores in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of KeyStoreSummary

Return type

Response

Example

Click here to see an example of how to use list_key_stores API.

list_maintenance_run_history(compartment_id, **kwargs)

Gets a list of the maintenance run histories in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• target_resource_id (str) – (optional) The target resource ID.

• target_resource_type (str) –

  (optional) The type of the target resource.

  Allowed values are: “AUTONOMOUS_EXADATA_INFRASTRUCTURE”, “AUTONOMOUS_CONTAINER_DATABASE”, “EXADATA_DB_SYSTEM”, “CLOUD_EXADATA_INFRASTRUCTURE”, “EXACC_INFRASTRUCTURE”, “AUTONOMOUS_VM_CLUSTER”, “AUTONOMOUS_DATABASE”, “CLOUD_AUTONOMOUS_VM_CLUSTER”

• maintenance_type (str) –

  (optional) The maintenance type.

  Allowed values are: “PLANNED”, “UNPLANNED”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIME_SCHEDULED and TIME_ENDED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIME_SCHEDULED”, “TIME_ENDED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) The state of the maintenance run history.

  Allowed values are: “SCHEDULED”, “IN_PROGRESS”, “SUCCEEDED”, “SKIPPED”, “FAILED”, “UPDATING”, “DELETING”, “DELETED”, “CANCELED”, “PARTIAL_SUCCESS”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• maintenance_subtype (str) –

  (optional) The sub-type of the maintenance run.

  Allowed values are: “QUARTERLY”, “HARDWARE”, “CRITICAL”, “INFRASTRUCTURE”, “DATABASE”, “ONEOFF”, “SECURITY_MONTHLY”, “TIMEZONE”, “CUSTOM_DATABASE_SOFTWARE_IMAGE”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of MaintenanceRunHistorySummary

Return type

Response

Example

Click here to see an example of how to use list_maintenance_run_history API.

list_maintenance_runs(compartment_id, **kwargs)

Gets a list of the maintenance runs in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• target_resource_id (str) – (optional) The target resource ID.

• target_resource_type (str) –

  (optional) The type of the target resource.

  Allowed values are: “AUTONOMOUS_EXADATA_INFRASTRUCTURE”, “AUTONOMOUS_CONTAINER_DATABASE”, “EXADATA_DB_SYSTEM”, “CLOUD_EXADATA_INFRASTRUCTURE”, “EXACC_INFRASTRUCTURE”, “AUTONOMOUS_VM_CLUSTER”, “AUTONOMOUS_DATABASE”, “CLOUD_AUTONOMOUS_VM_CLUSTER”

• maintenance_type (str) –

  (optional) The maintenance type.

  Allowed values are: “PLANNED”, “UNPLANNED”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• is_local_adg (bool) – (optional) A filter to return the maintenance history results for the local standby Autonomous AI Database Serverless only.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIME_SCHEDULED and TIME_ENDED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Note: If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted.

  Allowed values are: “TIME_SCHEDULED”, “TIME_ENDED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “SCHEDULED”, “IN_PROGRESS”, “SUCCEEDED”, “SKIPPED”, “FAILED”, “UPDATING”, “DELETING”, “DELETED”, “CANCELED”, “PARTIAL_SUCCESS”

• availability_domain (str) – (optional) A filter to return only resources that match the given availability domain exactly.

• maintenance_subtype (str) –

  (optional) The sub-type of the maintenance run.

  Allowed values are: “QUARTERLY”, “HARDWARE”, “CRITICAL”, “INFRASTRUCTURE”, “DATABASE”, “ONEOFF”, “SECURITY_MONTHLY”, “TIMEZONE”, “CUSTOM_DATABASE_SOFTWARE_IMAGE”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of MaintenanceRunSummary

Return type

Response

Example

Click here to see an example of how to use list_maintenance_runs API.

list_oneoff_patches(compartment_id, **kwargs)

Lists one-off patches in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly

  Allowed values are: “CREATING”, “AVAILABLE”, “UPDATING”, “INACTIVE”, “FAILED”, “EXPIRED”, “DELETING”, “DELETED”, “TERMINATING”, “TERMINATED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of OneoffPatchSummary

Return type

Response

Example

Click here to see an example of how to use list_oneoff_patches API.

list_params_for_action_type(type, **kwargs)

List all the action params and their possible values for a given action type

Parameters

• type (str) –

  (required) The type of the scheduled action

  Allowed values are: “DB_SERVER_FULL_SOFTWARE_UPDATE”, “STORAGE_SERVER_FULL_SOFTWARE_UPDATE”, “NETWORK_SWITCH_FULL_SOFTWARE_UPDATE”, “FSU_VM_CLUSTER_OS_SOFTWARE_UPDATE”, “FSU_VM_CLUSTER_GI_SOFTWARE_UPDATE”, “FSU_VM_CLUSTER_GI_OS_SOFTWARE_UPDATE”, “DB_SERVER_ONLINE_SOFTWARE_UPDATE”

• plan_intent (str) –

  (optional) The plan intent the action will be used for. Relevant to action type that can be used in multiple plans

  Allowed values are: “EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE”, “EXADATA_INFRASTRUCTURE_SECURITY_UPDATE”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ActionParamValuesCollection

Return type

Response

Example

Click here to see an example of how to use list_params_for_action_type API.

list_pdb_conversion_history_entries(database_id, **kwargs)

Gets the pluggable database conversion history for a specified database in a bare metal or virtual machine DB system.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• pdb_conversion_action (str) –

  (optional) A filter to return only the pluggable database conversion history entries that match the specified conversion action. For example, you can use this filter to return only entries for the precheck operation.

  Allowed values are: “PRECHECK”, “CONVERT”, “SYNC”, “SYNC_ROLLBACK”

• lifecycle_state (str) –

  (optional) A filter to return only the pluggable database conversion history entries that match the specified lifecycle state. For example, you can use this filter to return only entries in the “failed” lifecycle state.

  Allowed values are: “SUCCEEDED”, “FAILED”, “IN_PROGRESS”

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). The default order for TIMECREATED is ascending.

  Allowed values are: “TIMESTARTED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PdbConversionHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_pdb_conversion_history_entries API.

list_pluggable_database_snapshots(**kwargs)

Gets a list of the Exadata Pluggable Database Snapshots in the specified compartment.

Parameters

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for NAME is ascending. The NAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “NAME”

• name (str) – (optional) A filter to return only resources that match the entire name given. The match is not case sensitive.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only Exadata Pluggable Database Snapshots that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “AVAILABLE”, “TERMINATING”, “TERMINATED”, “FAILED”

• cluster_id (str) – (optional) A filter to return only Exadata Database Node Snapshots that match the given VM cluster.

• pluggable_database_id (str) –

  (optional) A filter to return only Exadata Pluggable Database Snapshots that match the given database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PluggableDatabaseSnapshotSummary

Return type

Response

Example

Click here to see an example of how to use list_pluggable_database_snapshots API.

list_pluggable_databases(**kwargs)

Gets a list of the pluggable databases in a database or compartment. You must provide either a databaseId or compartmentId value.

Parameters

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• database_id (str) –

  (optional) The `OCID`__ of the database.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for PDBNAME is ascending. The PDBNAME sort order is case sensitive.

  Allowed values are: “PDBNAME”, “TIMECREATED”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “TERMINATING”, “TERMINATED”, “UPDATING”, “FAILED”, “RELOCATING”, “RELOCATED”, “REFRESHING”, “RESTORE_IN_PROGRESS”, “RESTORE_FAILED”, “BACKUP_IN_PROGRESS”, “DISABLED”

• pdb_name (str) – (optional) A filter to return only pluggable databases that match the entire name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PluggableDatabaseSummary

Return type

Response

Example

Click here to see an example of how to use list_pluggable_databases API.

list_recommended_scheduled_actions(scheduling_policy_id, scheduling_policy_target_resource_id, plan_intent, **kwargs)

Returns a recommended Scheduled Actions configuration for a given resource, plan intent and scheduling policy.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• scheduling_policy_target_resource_id (str) –

  (required) The target resource `OCID`__ the scheduled actions will be for.

• plan_intent (str) –

  (required) The scheduling plan intent the scheduled actions will be for.

  Allowed values are: “EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE”, “EXADATA_INFRASTRUCTURE_SECURITY_UPDATE”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type RecommendedScheduledActionsCollection

Return type

Response

Example

Click here to see an example of how to use list_recommended_scheduled_actions API.

list_resource_pool_members(autonomous_database_id, **kwargs)

Lists the OCIDs of the Autonomous AI Database resource pool members for the specified Autonomous AI Database leader.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ResourcePoolMemberCollection

Return type

Response

Example

Click here to see an example of how to use list_resource_pool_members API.

list_scheduled_actions(compartment_id, **kwargs)

Lists the Scheduled Action resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• service_type (str) – (optional) A filter to return only resources that match the given service type exactly.

• scheduling_plan_id (str) – (optional) A filter to return only resources that match the given scheduling policy id exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• id (str) – (optional) A filter to return only resources that match the given Scheduled Action id exactly.

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “NEEDS_ATTENTION”, “AVAILABLE”, “UPDATING”, “FAILED”, “DELETING”, “DELETED”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ScheduledActionCollection

Return type

Response

Example

Click here to see an example of how to use list_scheduled_actions API.

list_scheduling_plans(compartment_id, **kwargs)

Lists the Scheduling Plan resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “NEEDS_ATTENTION”, “AVAILABLE”, “UPDATING”, “FAILED”, “DELETING”, “DELETED”

• scheduling_policy_id (str) – (optional) A filter to return only resources that match the given scheduling policy id exactly.

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• resource_id (str) – (optional) A filter to return only resources that match the given resource id exactly.

• id (str) – (optional) A filter to return only resources that match the given Schedule Plan id exactly.

• plan_intent (str) –

  (optional) A filter to return only resources that match the given plan intent exactly.

  Allowed values are: “EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE”, “EXADATA_INFRASTRUCTURE_SECURITY_UPDATE”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPlanCollection

Return type

Response

Example

Click here to see an example of how to use list_scheduling_plans API.

list_scheduling_policies(compartment_id, **kwargs)

Lists the Scheduling Policy resources in the specified compartment.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “NEEDS_ATTENTION”, “AVAILABLE”, “UPDATING”, “FAILED”, “DELETING”, “DELETED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• cadence (str) –

  (optional) A filter to return only resources that match the given cadence period exactly.

  Allowed values are: “HALFYEARLY”, “QUARTERLY”, “MONTHLY”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of SchedulingPolicySummary

Return type

Response

Example

Click here to see an example of how to use list_scheduling_policies API.

list_scheduling_windows(scheduling_policy_id, **kwargs)

Lists the Scheduling Window resources in the specified compartment.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• compartment_id (str) –

  (optional) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “AVAILABLE”, “UPDATING”, “FAILED”, “DELETING”, “DELETED”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of SchedulingWindowSummary

Return type

Response

Example

Click here to see an example of how to use list_scheduling_windows API.

list_system_version_minor_versions(major_version, compartment_id, gi_version, **kwargs)

Retrieves a list of supported minor versions for the specified Exadata System Software major version. You must provide either a shape or resourceId value.

Parameters

• major_version (str) – (required) The System major version.

• compartment_id (str) –

  (required) The compartment `OCID`__.

• gi_version (str) – (required) Specifies gi version query parameter.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• opc_request_id (str) – (optional) Unique identifier for the request.

• shape (str) – (optional) If provided, filters the results for the given shape.

• resource_id (str) – (optional) If provided, filters the results for the specified resource Id.

• is_latest (bool) – (optional) If provided, return highest versions from each major version family.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SystemVersionMinorVersionCollection

Return type

Response

Example

Click here to see an example of how to use list_system_version_minor_versions API.

list_system_versions(compartment_id, gi_version, **kwargs)

Gets a list of supported Exadata system versions for a given shape and GI version.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• gi_version (str) – (required) Specifies gi version query parameter.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• opc_request_id (str) – (optional) Unique identifier for the request.

• shape (str) – (optional) If provided, filters the results for the given shape.

• is_latest (bool) – (optional) If provided, return highest versions from each major version family.

• resource_id (str) – (optional) If provided, filters the results for the specified resource Id.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SystemVersionCollection

Return type

Response

Example

Click here to see an example of how to use list_system_versions API.

list_vm_cluster_networks(exadata_infrastructure_id, compartment_id, **kwargs)

Gets a list of the VM cluster networks in the specified compartment. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• compartment_id (str) –

  (required) The compartment `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “CREATING”, “REQUIRES_VALIDATION”, “VALIDATING”, “VALIDATED”, “VALIDATION_FAILED”, “UPDATING”, “ALLOCATED”, “TERMINATING”, “TERMINATED”, “FAILED”, “NEEDS_ATTENTION”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of VmClusterNetworkSummary

Return type

Response

Example

Click here to see an example of how to use list_vm_cluster_networks API.

list_vm_cluster_patch_history_entries(vm_cluster_id, **kwargs)

Gets the history of the patch actions performed on the specified VM cluster in an Exadata Cloud@Customer system.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PatchHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_vm_cluster_patch_history_entries API.

list_vm_cluster_patches(vm_cluster_id, **kwargs)

Lists the patches applicable to the specified VM cluster in an Exadata Cloud@Customer system.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of PatchSummary

Return type

Response

Example

Click here to see an example of how to use list_vm_cluster_patches API.

list_vm_cluster_update_history_entries(vm_cluster_id, **kwargs)

Gets the history of the maintenance update actions performed on the specified VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “IN_PROGRESS”, “SUCCEEDED”, “FAILED”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of VmClusterUpdateHistoryEntrySummary

Return type

Response

Example

Click here to see an example of how to use list_vm_cluster_update_history_entries API.

list_vm_cluster_updates(vm_cluster_id, **kwargs)

Lists the maintenance updates that can be applied to the specified VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• update_type (str) –

  (optional) A filter to return only resources that match the given update type exactly.

  Allowed values are: “GI_UPGRADE”, “GI_PATCH”, “OS_UPDATE”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “AVAILABLE”, “SUCCESS”, “IN_PROGRESS”, “FAILED”

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of VmClusterUpdateSummary

Return type

Response

Example

Click here to see an example of how to use list_vm_cluster_updates API.

list_vm_clusters(compartment_id, **kwargs)

Lists the VM clusters in the specified compartment. Applies to Exadata Cloud@Customer instances only. To list the cloud VM clusters in an Exadata Cloud Service instance, use the list_cloud_vm_clusters() operation.

Parameters

• compartment_id (str) –

  (required) The compartment `OCID`__.

• exadata_infrastructure_id (str) – (optional) If provided, filters the results for the given Exadata Infrastructure.

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• sort_by (str) –

  (optional) The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

  Allowed values are: “TIMECREATED”, “DISPLAYNAME”

• sort_order (str) –

  (optional) The sort order to use, either ascending (ASC) or descending (DESC).

  Allowed values are: “ASC”, “DESC”

• lifecycle_state (str) –

  (optional) A filter to return only resources that match the given lifecycle state exactly.

  Allowed values are: “PROVISIONING”, “AVAILABLE”, “UPDATING”, “TERMINATING”, “TERMINATED”, “FAILED”, “MAINTENANCE_IN_PROGRESS”

• display_name (str) – (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive.

• opc_request_id (str) – (optional) Unique identifier for the request.

• vm_cluster_type (str) –

  (optional) A filter to return only vmclusters that match the given vmcluster type exactly.

  Allowed values are: “REGULAR”, “DEVELOPER”

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type list of VmClusterSummary

Return type

Response

Example

Click here to see an example of how to use list_vm_clusters API.

local_clone_pluggable_database(local_clone_pluggable_database_details, pluggable_database_id, **kwargs)

Deprecated. Use create_pluggable_database() for Pluggable Database LocalClone Operation. Clones and starts a pluggable database (PDB) in the same database (CDB) as the source PDB. The source PDB must be in the READ_WRITE openMode to perform the clone operation.

Parameters

• local_clone_pluggable_database_details (oci.database.models.LocalClonePluggableDatabaseDetails) – (required) Request to clone a pluggable database locally.

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use local_clone_pluggable_database API.

migrate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Migrate Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• autonomous_container_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use migrate_autonomous_container_database_dataguard_association API.

migrate_data_guard_association_to_multi_data_guards(database_id, data_guard_association_id, **kwargs)

Migrates the existing Data Guard association to new Data Guard model to support multiple standby databases functionality.

This operation should always be performed on primary.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• data_guard_association_id (str) –

  (required) The Data Guard association’s `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use migrate_data_guard_association_to_multi_data_guards API.

migrate_exadata_db_system_resource_model(db_system_id, **kwargs)

Migrates the Exadata DB system to the new `Exadata resource model`__. All related resources will be migrated.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataDbSystemMigration

Return type

Response

Example

Click here to see an example of how to use migrate_exadata_db_system_resource_model API.

migrate_vault_key(database_id, migrate_vault_key_details, **kwargs)

Changes encryption key management from customer-managed, using the `Vault service`__, to Oracle-managed.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• migrate_vault_key_details (oci.database.models.MigrateVaultKeyDetails) – (required) Request to change the source of the encryption key for the database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use migrate_vault_key API.

modify_database_management(database_id, modify_database_management_details, **kwargs)

Updates one or more attributes of the Database Management service for the database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• modify_database_management_details (oci.database.models.ModifyDatabaseManagementDetails) – (required) The data to update one or more attributes of the Database Management Service for the database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use modify_database_management API.

modify_pluggable_database_management(pluggable_database_id, modify_pluggable_database_management_details, **kwargs)

Updates one or more attributes of the Database Management service for the pluggable database.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• modify_pluggable_database_management_details (oci.database.models.ModifyPluggableDatabaseManagementDetails) – (required) The data to update one or more attributes of the Database Management Service for the pluggable database.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use modify_pluggable_database_management API.

mount_advanced_cluster_file_system(advanced_cluster_file_system_id, **kwargs)

Mounts the advanced cluster file system to all the virtual machines within a vmcluster.

Parameters

• advanced_cluster_file_system_id (str) –

  (required) The advanced cluster file system Id `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AdvancedClusterFileSystem

Return type

Response

Example

Click here to see an example of how to use mount_advanced_cluster_file_system API.

mount_dbnode_snapshot(mount_dbnode_snapshot_details, dbnode_snapshot_id, **kwargs)

Mounts the snapshot for the provided dbNode.

Parameters

• mount_dbnode_snapshot_details (oci.database.models.MountDbnodeSnapshotDetails) – (required) Request to mount the snapshot for the provided Exadata Database Node.

• dbnode_snapshot_id (str) –

  (required) The Exadata Database Node Snapshot `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbnodeSnapshot

Return type

Response

Example

Click here to see an example of how to use mount_dbnode_snapshot API.

move_execution_action_member(execution_action_id, move_execution_action_member_details, **kwargs)

Moves an execution action member to this execution action resource from another.

Parameters

• execution_action_id (str) –

  (required) The execution action `OCID`__.

• move_execution_action_member_details (oci.database.models.MoveExecutionActionMemberDetails) – (required) Request to move an execution action member to this execution action resource from another.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionAction

Return type

Response

Example

Click here to see an example of how to use move_execution_action_member API.

refresh_data_guard_health_status(database_id, **kwargs)

Refreshes the Data Guard health status for the specified database. This operation is supported on both primary and standby databases.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use refresh_data_guard_health_status API.

refresh_pluggable_database(pluggable_database_id, **kwargs)

Refreshes a pluggable database (PDB) Refreshable clone.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use refresh_pluggable_database API.

register_autonomous_database_data_safe(autonomous_database_id, **kwargs)

Asynchronously registers this Autonomous AI Database with Data Safe.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• register_autonomous_database_data_safe_details (oci.database.models.RegisterAutonomousDatabaseDataSafeDetails) – (optional) Request to register an Autonomous AI Database with Data Safe.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use register_autonomous_database_data_safe API.

register_cloud_autonomous_vm_cluster_pkcs(cloud_autonomous_vm_cluster_id, register_cloud_autonomous_vm_cluster_pkcs_details, **kwargs)

Install the PKCS11 driver for given keystore type

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• register_cloud_autonomous_vm_cluster_pkcs_details (oci.database.models.RegisterCloudAutonomousVmClusterPkcsDetails) – (required) Details of registering PKCS11 driver.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use register_cloud_autonomous_vm_cluster_pkcs API.

register_cloud_vm_cluster_pkcs(cloud_vm_cluster_id, register_cloud_vm_cluster_pkcs_details, **kwargs)

Install the PKCS11 driver for given keystore type

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• register_cloud_vm_cluster_pkcs_details (oci.database.models.RegisterCloudVmClusterPkcsDetails) – (required) Details of registering PKCS11 driver.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use register_cloud_vm_cluster_pkcs API.

register_exadb_vm_cluster_pkcs(exadb_vm_cluster_id, register_exadb_vm_cluster_pkcs_details, **kwargs)

Install the PKCS11 driver for given keystore type

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• register_exadb_vm_cluster_pkcs_details (oci.database.models.RegisterExadbVmClusterPkcsDetails) – (required) Details of registering PKCS11 driver.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use register_exadb_vm_cluster_pkcs API.

reinstate_autonomous_container_database_dataguard(autonomous_container_database_id, **kwargs)

Reinstates a disabled standby Autonomous Container Database (ACD), identified by the autonomousContainerDatabaseId parameter to an active standby ACD. For more information, see `Reinstate the Disabled Standby in an Autonomous Data Guard Configuration`__.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use reinstate_autonomous_container_database_dataguard API.

reinstate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Deprecated. Use the reinstate_autonomous_container_database_dataguard() operation to reinstate a disabled standby Autonomous Container Database (ACD), identified by the autonomousContainerDatabaseId parameter, to an active standby ACD.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• autonomous_container_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use reinstate_autonomous_container_database_dataguard_association API.

reinstate_data_guard(database_id, reinstate_data_guard_details, **kwargs)

Reinstates the database identified by the databaseId parameter into the standby role in a Data Guard association.

This operation should be performed on disabled standby database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• reinstate_data_guard_details (oci.database.models.ReinstateDataGuardDetails) – (required) A request to update an existing Data Guard member.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use reinstate_data_guard API.

reinstate_data_guard_association(database_id, data_guard_association_id, reinstate_data_guard_association_details, **kwargs)

Reinstates the database identified by the databaseId parameter into the standby role in a Data Guard association.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• data_guard_association_id (str) –

  (required) The Data Guard association’s `OCID`__.

• reinstate_data_guard_association_details (oci.database.models.ReinstateDataGuardAssociationDetails) – (required) A request to reinstate a database in a standby role.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DataGuardAssociation

Return type

Response

Example

Click here to see an example of how to use reinstate_data_guard_association API.

remote_clone_pluggable_database(remote_clone_pluggable_database_details, pluggable_database_id, **kwargs)

Deprecated. Use create_pluggable_database() for Pluggable Database RemoteClone Operation. Clones a pluggable database (PDB) to a different database from the source PDB. The cloned PDB will be started upon completion of the clone operation. The source PDB must be in the READ_WRITE openMode when performing the clone. For Exadata Cloud@Customer instances, the source pluggable database (PDB) must be on the same Exadata Infrastructure as the target container database (CDB) to create a remote clone.

Parameters

• remote_clone_pluggable_database_details (oci.database.models.RemoteClonePluggableDatabaseDetails) – (required) Request to clone a pluggable database (PDB) to a different database (CDB) from the source PDB.

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use remote_clone_pluggable_database API.

remove_virtual_machine_from_cloud_vm_cluster(remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, **kwargs)

Remove Virtual Machines from the Cloud VM cluster. Applies to Exadata Cloud instances only.

Parameters

• remove_virtual_machine_from_cloud_vm_cluster_details (oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails) – (required) Request to remove Virtual Machines from the Cloud VM cluster.

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudVmCluster

Return type

Response

Example

Click here to see an example of how to use remove_virtual_machine_from_cloud_vm_cluster API.

remove_virtual_machine_from_exadb_vm_cluster(remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, **kwargs)

Remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Cloud instances only.

Parameters

• remove_virtual_machine_from_exadb_vm_cluster_details (oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails) – (required) Request to remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure.

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadbVmCluster

Return type

Response

Example

Click here to see an example of how to use remove_virtual_machine_from_exadb_vm_cluster API.

remove_virtual_machine_from_vm_cluster(remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, **kwargs)

Remove Virtual Machines from the VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• remove_virtual_machine_from_vm_cluster_details (oci.database.models.RemoveVirtualMachineFromVmClusterDetails) – (required) Request to remove Virtual Machines from the VM cluster.

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmCluster

Return type

Response

Example

Click here to see an example of how to use remove_virtual_machine_from_vm_cluster API.

reorder_execution_actions(execution_window_id, reorder_execution_action_details, **kwargs)

Reorders the execution actions under this execution window resource.

Parameters

• execution_window_id (str) –

  (required) The execution window `OCID`__.

• reorder_execution_action_details (oci.database.models.ReorderExecutionActionDetails) – (required) Request to reorder the execution actions under this execution window resource.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionWindow

Return type

Response

Example

Click here to see an example of how to use reorder_execution_actions API.

reorder_scheduled_actions(reorder_scheduled_actions_details, scheduling_plan_id, **kwargs)

Re-order the scheduled actions under this scheduling plan resource.

Parameters

• reorder_scheduled_actions_details (oci.database.models.ReorderScheduledActionsDetails) – (required) Request to re-order Scheduled Action resources.

• scheduling_plan_id (str) –

  (required) The Schedule Plan `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPlan

Return type

Response

Example

Click here to see an example of how to use reorder_scheduled_actions API.

reschedule_managed_db_software_update(database_id, **kwargs)

Reschedule the Managed Database Software Update

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use reschedule_managed_db_software_update API.

resize_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, resize_vm_cluster_network_details, **kwargs)

Adds or removes Db server network nodes to extend or shrink the existing VM cluster network. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• resize_vm_cluster_network_details (oci.database.models.ResizeVmClusterNetworkDetails) – (required) Request to add or remove Db server network nodes in the VM cluster network.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterNetwork

Return type

Response

Example

Click here to see an example of how to use resize_vm_cluster_network API.

resource_pool_shapes(**kwargs)

Lists available resource pools shapes.

Parameters

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• limit (int) – (optional) The maximum number of items to return per page.

• page (str) – (optional) The pagination token to continue listing from.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ResourcePoolShapeCollection

Return type

Response

Example

Click here to see an example of how to use resource_pool_shapes API.

restart_autonomous_container_database(autonomous_container_database_id, **kwargs)

Rolling restarts the specified Autonomous Container Database.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• restart_autonomous_container_database_details (oci.database.models.RestartAutonomousContainerDatabaseDetails) – (optional) Request details to restart the Autonomous Container Database with force option.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use restart_autonomous_container_database API.

restart_autonomous_database(autonomous_database_id, **kwargs)

Restarts the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• is_online_restart (bool) – (optional) If provided, an online restart will be triggered.

• restart_autonomous_database_details (oci.database.models.RestartAutonomousDatabaseDetails) – (optional) Request details to restart the Autonomous Database with force option.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use restart_autonomous_database API.

restart_autonomous_vm_cluster_ords(autonomous_vm_cluster_id, **kwargs)

Restarts Oracle REST Data Services (ORDS) for Autonomous Exadata VM cluster.

Parameters

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use restart_autonomous_vm_cluster_ords API.

restart_cloud_autonomous_vm_cluster_ords(cloud_autonomous_vm_cluster_id, **kwargs)

Restarts Oracle REST Data Services (ORDS) for a cloud Autonomous Exadata VM cluster.

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use restart_cloud_autonomous_vm_cluster_ords API.

restore_autonomous_database(autonomous_database_id, restore_autonomous_database_details, **kwargs)

Restores an Autonomous AI Database based on the provided request parameters.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• restore_autonomous_database_details (oci.database.models.RestoreAutonomousDatabaseDetails) – (required) Request to perform an Autonomous AI Database restore.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use restore_autonomous_database API.

restore_database(database_id, restore_database_details, **kwargs)

Restore a Database based on the request parameters you provide.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• restore_database_details (oci.database.models.RestoreDatabaseDetails) – (required) Request to perform database restore.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use restore_database API.

rotate_autonomous_container_database_encryption_key(autonomous_container_database_id, **kwargs)

Creates a new version of an existing `Vault service`__ key.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• rotate_autonomous_container_database_encryption_key_details (oci.database.models.RotateAutonomousContainerDatabaseEncryptionKeyDetails) – (optional) Key details provided by the user for rotate key operation for Autonomous AI Database.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use rotate_autonomous_container_database_encryption_key API.

rotate_autonomous_database_encryption_key(autonomous_database_id, **kwargs)

Rotate existing AutonomousDatabase `Vault service`__ key.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• rotate_autonomous_database_encryption_key_details (oci.database.models.RotateAutonomousDatabaseEncryptionKeyDetails) – (optional) Key details provided by the user for rotate key operation for Autonomous AI Database.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use rotate_autonomous_database_encryption_key API.

rotate_autonomous_vm_cluster_ords_certs(rotate_autonomous_vm_cluster_ords_certs_details, autonomous_vm_cluster_id, **kwargs)

Rotates the Oracle REST Data Services (ORDS) certificates for Autonomous Exadata VM cluster.

Parameters

• rotate_autonomous_vm_cluster_ords_certs_details (oci.database.models.RotateAutonomousVmClusterOrdsCertsDetails) – (required) Request to rotate the Oracle REST Data Services (ORDS) certificates on Autonomous Exadata VM cluster.

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_autonomous_vm_cluster_ords_certs API.

rotate_autonomous_vm_cluster_ssl_certs(rotate_autonomous_vm_cluster_ssl_certs_details, autonomous_vm_cluster_id, **kwargs)

Rotates the SSL certificates for Autonomous Exadata VM cluster.

Parameters

• rotate_autonomous_vm_cluster_ssl_certs_details (oci.database.models.RotateAutonomousVmClusterSslCertsDetails) – (required) Request to rotate the SSL certificates on Autonomous Exadata VM cluster.

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_autonomous_vm_cluster_ssl_certs API.

rotate_cloud_autonomous_vm_cluster_ords_certs(cloud_autonomous_vm_cluster_id, **kwargs)

Rotates the Oracle REST Data Services (ORDS) certificates for a cloud Autonomous Exadata VM cluster.

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• rotate_cloud_autonomous_vm_cluster_ords_certs_details (oci.database.models.RotateCloudAutonomousVmClusterOrdsCertsDetails) – (optional) Request to rotate the Oracle REST Data Services (ORDS) certificates on Cloud Autonomous Exadata VM cluster.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_cloud_autonomous_vm_cluster_ords_certs API.

rotate_cloud_autonomous_vm_cluster_ssl_certs(cloud_autonomous_vm_cluster_id, **kwargs)

Rotates the SSL certficates for a cloud Autonomous Exadata VM cluster.

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• rotate_cloud_autonomous_vm_cluster_ssl_certs_details (oci.database.models.RotateCloudAutonomousVmClusterSslCertsDetails) – (optional) Request to rotate the SSL certificates on Cloud Autonomous Exadata VM cluster.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_cloud_autonomous_vm_cluster_ssl_certs API.

rotate_ords_certs(autonomous_exadata_infrastructure_id, **kwargs)

Deprecated. Use the rotate_cloud_autonomous_vm_cluster_ords_certs() to rotate Oracle REST Data Services (ORDS) certs for an Autonomous Exadata VM cluster instead.

Parameters

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_ords_certs API.

rotate_pluggable_database_encryption_key(pluggable_database_id, **kwargs)

Create a new version of the existing encryption key.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_pluggable_database_encryption_key API.

rotate_ssl_certs(autonomous_exadata_infrastructure_id, **kwargs)

Deprecated. Use the rotate_cloud_autonomous_vm_cluster_ssl_certs() to rotate SSL certs for an Autonomous Exadata VM cluster instead.

Parameters

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use rotate_ssl_certs API.

rotate_vault_key(database_id, **kwargs)

Creates a new version of an existing `Vault service`__ key.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use rotate_vault_key API.

run_data_patch(database_id, **kwargs)

Run datapatch on the specified Oracle Database and optionally on the specified Pluggable databases.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• run_data_patch_details (oci.database.models.RunDataPatchDetails) – (optional) Request to run a database datapatch.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use run_data_patch API.

saas_admin_user_status(autonomous_database_id, **kwargs)

This operation gets SaaS administrative user status of the Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SaasAdminUserStatus

Return type

Response

Example

Click here to see an example of how to use saas_admin_user_status API.

scan_external_container_database_pluggable_databases(external_container_database_id, external_database_connector_id, **kwargs)

Scans for pluggable databases in the specified external container database. This operation will return un-registered pluggable databases in the get_work_request() operation.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• external_database_connector_id (str) –

  (required) The `OCID`__ of the external database connector resource (ExternalDatabaseConnectorId).

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use scan_external_container_database_pluggable_databases API.

set_db_key_version(database_id, set_key_version_details, **kwargs)

Sets a new version of an existing `Vault service`__ key.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• set_key_version_details (oci.database.models.SetKeyVersionDetails) – (required) Requests Key Version Update.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use set_db_key_version API.

set_pdb_key_version(pluggable_database_id, set_key_version_details, **kwargs)

Sets a new version of an existing `Vault service`__ key.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• set_key_version_details (oci.database.models.SetKeyVersionDetails) – (required) Requests Key Version Update.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use set_pdb_key_version API.

shrink_autonomous_database(autonomous_database_id, **kwargs)

This operation shrinks the current allocated storage down to the current actual used data storage (actualUsedDataStorageSizeInTBs). The if the base storage value for the database (dataStorageSizeInTBs) is larger than the actualUsedDataStorageSizeInTBs value, you are billed for the base storage value.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use shrink_autonomous_database API.

start_autonomous_database(autonomous_database_id, **kwargs)

Starts the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use start_autonomous_database API.

start_pluggable_database(pluggable_database_id, **kwargs)

Starts a stopped pluggable database. The openMode value of the pluggable database will be READ_WRITE upon completion.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use start_pluggable_database API.

stop_autonomous_database(autonomous_database_id, **kwargs)

Stops the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• stop_autonomous_database_details (oci.database.models.StopAutonomousDatabaseDetails) – (optional) Request details to stop the Autonomous Database with force option.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use stop_autonomous_database API.

stop_pluggable_database(pluggable_database_id, **kwargs)

Stops a pluggable database. The openMode value of the pluggable database will be MOUNTED upon completion.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use stop_pluggable_database API.

switch_over_data_guard(database_id, switch_over_data_guard_details, **kwargs)

Performs a switchover to transition primary database of this Data Guard association into a standby role. The standby database associated with the dataGuardAssociationId assumes the primary database role.

A switchover guarantees no data loss.

This operation should be performed on respective standby database.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• switch_over_data_guard_details (oci.database.models.SwitchOverDataGuardDetails) – (required) A request to update an existing Data Guard member.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use switch_over_data_guard API.

switchover_autonomous_container_database_dataguard(autonomous_container_database_id, **kwargs)

Switchover an Autonomous Container Database (ACD), identified by the autonomousContainerDatabaseId parameter, to an active standby ACD. This standby ACD will become the new primary ACD when the switchover completes successfully. For more information, see `Switch Roles in an Autonomous Data Guard Configuration`__.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use switchover_autonomous_container_database_dataguard API.

switchover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Deprecated. Use the switchover_autonomous_container_database_dataguard() operation to switches over the primary Autonomous Container Database (ACD) of an Autonomous Data Guard peer association to standby role. The standby ACD associated with autonomousContainerDatabaseDataguardAssociationId assumes the primary ACD role.

A switchover incurs no data loss.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• autonomous_container_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use switchover_autonomous_container_database_dataguard_association API.

switchover_autonomous_database(autonomous_database_id, **kwargs)

Initiates a switchover of the specified Autonomous AI Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. This API should be called in the remote region where the peer database resides. Below parameter is optional:

• peerDbId Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. If this parameter is not provided, the switchover will happen in the same region.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• peer_db_id (str) – (optional) The database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use switchover_autonomous_database API.

switchover_data_guard_association(database_id, data_guard_association_id, switchover_data_guard_association_details, **kwargs)

Performs a switchover to transition the primary database of a Data Guard association into a standby role. The standby database associated with the dataGuardAssociationId assumes the primary database role.

A switchover guarantees no data loss.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• data_guard_association_id (str) –

  (required) The Data Guard association’s `OCID`__.

• switchover_data_guard_association_details (oci.database.models.SwitchoverDataGuardAssociationDetails) – (required) Request to swtichover a primary to a standby.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DataGuardAssociation

Return type

Response

Example

Click here to see an example of how to use switchover_data_guard_association API.

terminate_autonomous_container_database(autonomous_container_database_id, **kwargs)

Terminates an Autonomous Container Database, which permanently deletes the container database and any databases within the container database. The database data is local to the Autonomous Exadata Infrastructure and will be lost when the container database is terminated. Oracle recommends that you back up any data in the Autonomous Container Database prior to terminating it.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use terminate_autonomous_container_database API.

terminate_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, **kwargs)

Deprecated. To terminate an Exadata Infrastructure resource in the Oracle cloud, use the delete_cloud_exadata_infrastructure() operation. To delete an Autonomous Exadata VM cluster in the Oracle cloud, use the delete_cloud_autonomous_vm_cluster() operation.

Parameters

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use terminate_autonomous_exadata_infrastructure API.

terminate_db_system(db_system_id, **kwargs)

Terminates a DB system and permanently deletes it and any databases running on it, and any storage volumes attached to it. The database data is local to the DB system and will be lost when the system is terminated. Oracle recommends that you back up any data in the DB system prior to terminating it.

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use terminate_db_system API.

unmount_advanced_cluster_file_system(advanced_cluster_file_system_id, **kwargs)

Unmounts the advanced cluster file system from all the virtual machines within a vmcluster.

Parameters

• advanced_cluster_file_system_id (str) –

  (required) The advanced cluster file system Id `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AdvancedClusterFileSystem

Return type

Response

Example

Click here to see an example of how to use unmount_advanced_cluster_file_system API.

unmount_dbnode_snapshot(unmount_dbnode_snapshot_details, dbnode_snapshot_id, **kwargs)

Unmounts the snapshot for the provided dbNode.

Parameters

• unmount_dbnode_snapshot_details (oci.database.models.UnmountDbnodeSnapshotDetails) – (required) Request to unmount the snapshot for the provided Exadata Database Node.

• dbnode_snapshot_id (str) –

  (required) The Exadata Database Node Snapshot `OCID`__.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbnodeSnapshot

Return type

Response

Example

Click here to see an example of how to use unmount_dbnode_snapshot API.

unregister_cloud_autonomous_vm_cluster_pkcs(cloud_autonomous_vm_cluster_id, unregister_cloud_autonomous_vm_cluster_pkcs_details, **kwargs)

Uninstall the PKCS11 driver for given keystore type

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• unregister_cloud_autonomous_vm_cluster_pkcs_details (oci.database.models.UnregisterCloudAutonomousVmClusterPkcsDetails) – (required) Details of unregistering PKCS11 driver.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use unregister_cloud_autonomous_vm_cluster_pkcs API.

unregister_cloud_vm_cluster_pkcs(cloud_vm_cluster_id, unregister_cloud_vm_cluster_pkcs_details, **kwargs)

Uninstall the PKCS11 driver for given keystore type

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• unregister_cloud_vm_cluster_pkcs_details (oci.database.models.UnregisterCloudVmClusterPkcsDetails) – (required) Details of registering PKCS11 driver.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use unregister_cloud_vm_cluster_pkcs API.

unregister_exadb_vm_cluster_pkcs(exadb_vm_cluster_id, unregister_exadb_vm_cluster_pkcs_details, **kwargs)

Uninstall the PKCS11 driver for given keystore type

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• unregister_exadb_vm_cluster_pkcs_details (oci.database.models.UnregisterExadbVmClusterPkcsDetails) – (required) Details of unregistering PKCS11 driver.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use unregister_exadb_vm_cluster_pkcs API.

update_advanced_cluster_file_system(advanced_cluster_file_system_id, update_advanced_cluster_file_system_details, **kwargs)

Updates the advanced cluster file system resource.

Parameters

• advanced_cluster_file_system_id (str) –

  (required) The advanced cluster file system Id `OCID`__.

• update_advanced_cluster_file_system_details (oci.database.models.UpdateAdvancedClusterFileSystemDetails) – (required) Request to update the properties of an advanced cluster file system.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AdvancedClusterFileSystem

Return type

Response

Example

Click here to see an example of how to use update_advanced_cluster_file_system API.

update_autonomous_container_database(autonomous_container_database_id, update_autonomous_container_database_details, **kwargs)

Updates the properties of an Autonomous Container Database, such as display name, maintenance preference, backup retention, and tags.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• update_autonomous_container_database_details (oci.database.models.UpdateAutonomousContainerDatabaseDetails) – (required) Request to update the properties of an Autonomous Container Database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabase

Return type

Response

Example

Click here to see an example of how to use update_autonomous_container_database API.

update_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, update_autonomous_container_database_data_guard_association_details, **kwargs)

Deprecated. Use the edit_autonomous_container_database_dataguard() operation to update an Autonomous Data Guard association.

Parameters

• autonomous_container_database_id (str) –

  (required) The Autonomous Container Database `OCID`__.

• autonomous_container_database_dataguard_association_id (str) –

  (required) The Autonomous Container Database-Autonomous Data Guard association `OCID`__.

• update_autonomous_container_database_data_guard_association_details (oci.database.models.UpdateAutonomousContainerDatabaseDataGuardAssociationDetails) – (required) A request to update Data Guard association of a database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousContainerDatabaseDataguardAssociation

Return type

Response

Example

Click here to see an example of how to use update_autonomous_container_database_dataguard_association API.

update_autonomous_database(autonomous_database_id, update_autonomous_database_details, **kwargs)

Updates one or more attributes of the specified Autonomous AI Database. See the UpdateAutonomousDatabaseDetails resource for a full list of attributes that can be updated.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• update_autonomous_database_details (oci.database.models.UpdateAutonomousDatabaseDetails) – (required) Request to update the properties of an Autonomous AI Database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabase

Return type

Response

Example

Click here to see an example of how to use update_autonomous_database API.

update_autonomous_database_backup(autonomous_database_backup_id, update_autonomous_database_backup_details, **kwargs)

Updates the Autonomous AI Database backup of the specified database based on the request parameters.

Parameters

• autonomous_database_backup_id (str) –

  (required) The `OCID`__ of the Autonomous AI Database backup.

• update_autonomous_database_backup_details (oci.database.models.UpdateAutonomousDatabaseBackupDetails) – (required) Request to update an existing Autonomous AI Database backup.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseBackup

Return type

Response

Example

Click here to see an example of how to use update_autonomous_database_backup API.

update_autonomous_database_regional_wallet(update_autonomous_database_wallet_details, **kwargs)

Updates the Autonomous AI Database regional wallet.

Parameters

• update_autonomous_database_wallet_details (oci.database.models.UpdateAutonomousDatabaseWalletDetails) – (required) Request to update the properties of Autonomous AI Database regional wallet.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use update_autonomous_database_regional_wallet API.

update_autonomous_database_software_image(autonomous_database_software_image_id, update_autonomous_database_software_image_details, **kwargs)

Updates the properties of an Autonomous AI Database Software Image, like add tags

Parameters

• autonomous_database_software_image_id (str) –

  (required) The Autonomous AI Database Software Image `OCID`__.

• update_autonomous_database_software_image_details (oci.database.models.UpdateAutonomousDatabaseSoftwareImageDetails) – (required) Request to update the properties of an Autonomous AI Database Software Image.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousDatabaseSoftwareImage

Return type

Response

Example

Click here to see an example of how to use update_autonomous_database_software_image API.

update_autonomous_database_wallet(autonomous_database_id, update_autonomous_database_wallet_details, **kwargs)

Updates the wallet for the specified Autonomous AI Database.

Parameters

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• update_autonomous_database_wallet_details (oci.database.models.UpdateAutonomousDatabaseWalletDetails) – (required) Request to update the properties of an Autonomous AI Database wallet.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type None

Return type

Response

Example

Click here to see an example of how to use update_autonomous_database_wallet API.

update_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **kwargs)

Deprecated. Use the update_cloud_exadata_infrastructure() operation to update an Exadata Infrastructure resource and update_cloud_autonomous_vm_cluster() operation to update an Autonomous Exadata VM cluster.

Parameters

• autonomous_exadata_infrastructure_id (str) –

  (required) The Autonomous Exadata Infrastructure `OCID`__.

• update_autonomous_exadata_infrastructures_details (oci.database.models.UpdateAutonomousExadataInfrastructureDetails) – (required) Request to update the properties of a Autonomous Exadata Infrastructure.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use update_autonomous_exadata_infrastructure API.

update_autonomous_vm_cluster(autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **kwargs)

Updates the specified Autonomous VM cluster for the Exadata Cloud@Customer system.To update an Autonomous VM Cluster in the Oracle cloud, see update_cloud_autonomous_vm_cluster().

Parameters

• autonomous_vm_cluster_id (str) –

  (required) The autonomous VM cluster `OCID`__.

• update_autonomous_vm_cluster_details (oci.database.models.UpdateAutonomousVmClusterDetails) – (required) Request to update the attributes of an Autonomous VM cluster.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type AutonomousVmCluster

Return type

Response

Example

Click here to see an example of how to use update_autonomous_vm_cluster API.

update_backup(backup_id, update_backup_details, **kwargs)

Updates database backup details.

Parameters

• backup_id (str) –

  (required) The backup `OCID`__.

• update_backup_details (oci.database.models.UpdateBackupDetails) – (required) Request to update the properties of a Backup.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Backup

Return type

Response

Example

Click here to see an example of how to use update_backup API.

update_backup_destination(backup_destination_id, update_backup_destination_details, **kwargs)

If no database is associated with the backup destination: - For a RECOVERY_APPLIANCE backup destination, updates the connection string and/or the list of VPC users. - For an NFS backup destination, updates the NFS location.

Parameters

• backup_destination_id (str) –

  (required) The `OCID`__ of the backup destination.

• update_backup_destination_details (oci.database.models.UpdateBackupDestinationDetails) – (required) For a RECOVERY_APPLIANCE backup destination, request to update the connection string and/or the list of VPC users. For an NFS backup destination, request to update the NFS location.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BackupDestination

Return type

Response

Example

Click here to see an example of how to use update_backup_destination API.

update_basecc_vm_cluster(basecc_vm_cluster_id, update_basecc_vm_cluster_details, **kwargs)

Updates the specified BaseDB-C@C VM cluster. Applies to Base Database Service on Cloud@Customer instances only.

Parameters

• basecc_vm_cluster_id (str) –

  (required) The BaseDB-C@C VM cluster `OCID`__.

• update_basecc_vm_cluster_details (oci.database.models.UpdateBaseccVmClusterDetails) – (required) Request to update the attributes of a BaseDB-C@C VM cluster.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type BaseccVmCluster

Return type

Response

Example

Click here to see an example of how to use update_basecc_vm_cluster API.

update_cloud_autonomous_vm_cluster(cloud_autonomous_vm_cluster_id, update_cloud_autonomous_vm_cluster_details, **kwargs)

Updates the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see update_autonomous_vm_cluster().

Parameters

• cloud_autonomous_vm_cluster_id (str) –

  (required) The Cloud VM cluster `OCID`__.

• update_cloud_autonomous_vm_cluster_details (oci.database.models.UpdateCloudAutonomousVmClusterDetails) – (required) Request to update the attributes of a cloud VM cluster.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudAutonomousVmCluster

Return type

Response

Example

Click here to see an example of how to use update_cloud_autonomous_vm_cluster API.

update_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **kwargs)

Updates the Cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous AI Database on dedicated Exadata infrastructure only.

Parameters

• cloud_exadata_infrastructure_id (str) –

  (required) The cloud Exadata infrastructure `OCID`__.

• update_cloud_exadata_infrastructure_details (oci.database.models.UpdateCloudExadataInfrastructureDetails) – (required) Request to update the properties of an cloud Exadata infrastructure resource.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use update_cloud_exadata_infrastructure API.

update_cloud_vm_cluster(cloud_vm_cluster_id, update_cloud_vm_cluster_details, **kwargs)

Updates the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• update_cloud_vm_cluster_details (oci.database.models.UpdateCloudVmClusterDetails) – (required) Request to update the attributes of a cloud VM cluster.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type CloudVmCluster

Return type

Response

Example

Click here to see an example of how to use update_cloud_vm_cluster API.

update_cloud_vm_cluster_iorm_config(cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, **kwargs)

Updates the IORM settings for the specified cloud VM cluster in an Exadata Cloud Service instance.

Parameters

• cloud_vm_cluster_id (str) –

  (required) The cloud VM cluster `OCID`__.

• cloud_vm_cluster_iorm_config_update_details (oci.database.models.ExadataIormConfigUpdateDetails) – (required) Request to perform database update.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataIormConfig

Return type

Response

Example

Click here to see an example of how to use update_cloud_vm_cluster_iorm_config API.

update_console_connection(db_node_id, console_connection_id, update_console_connection_details, **kwargs)

Updates the specified database node console connection.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_connection_id (str) – (required) The OCID of the console connection.

• update_console_connection_details (oci.database.models.UpdateConsoleConnectionDetails) – (required) Request to update the specified database node console connection.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleConnection

Return type

Response

Example

Click here to see an example of how to use update_console_connection API.

update_console_history(db_node_id, console_history_id, update_console_history_details, **kwargs)

Updates the specified database node console history.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• console_history_id (str) – (required) The OCID of the console history.

• update_console_history_details (oci.database.models.UpdateConsoleHistoryDetails) – (required) Request to update the specified database node console history.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ConsoleHistory

Return type

Response

Example

Click here to see an example of how to use update_console_history API.

update_data_guard(database_id, update_data_guard_details, **kwargs)

Update an existing Data Guard member. A Data Guard member represents the replication relationship between the specified database and a standby database. For more information, see `Using Oracle Data Guard`__.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• update_data_guard_details (oci.database.models.UpdateDataGuardDetails) – (required) A request to update an existing Data Guard member.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use update_data_guard API.

update_data_guard_association(database_id, data_guard_association_id, update_data_guard_association_details, **kwargs)

Updates the Data Guard association the specified database. This API can be used to change the protectionMode and transportType of the Data Guard association.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• data_guard_association_id (str) –

  (required) The Data Guard association’s `OCID`__.

• update_data_guard_association_details (oci.database.models.UpdateDataGuardAssociationDetails) – (required) A request to update Data Guard association of a database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DataGuardAssociation

Return type

Response

Example

Click here to see an example of how to use update_data_guard_association API.

update_database(database_id, update_database_details, **kwargs)

Update the specified database based on the request parameters provided.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• update_database_details (oci.database.models.UpdateDatabaseDetails) – (required) Request to perform database update.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use update_database API.

update_database_snapshot(database_snapshot_id, update_database_snapshot_details, **kwargs)

Updates a Database Snapshot

Parameters

• database_snapshot_id (str) –

  (required) The Exadata Database Snapshot `OCID`__.

• update_database_snapshot_details (oci.database.models.UpdateDatabaseSnapshotDetails) – (required) Request to update a database snapshot.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSnapshot

Return type

Response

Example

Click here to see an example of how to use update_database_snapshot API.

update_database_software_image(database_software_image_id, update_database_software_image_details, **kwargs)

Updates the properties of a Database Software Image, like Display Nmae

Parameters

• database_software_image_id (str) –

  (required) The DB system `OCID`__.

• update_database_software_image_details (oci.database.models.UpdateDatabaseSoftwareImageDetails) – (required) Request to update the properties of a DB system.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DatabaseSoftwareImage

Return type

Response

Example

Click here to see an example of how to use update_database_software_image API.

update_db_home(db_home_id, update_db_home_details, **kwargs)

Patches the specified Database Home.

Parameters

• db_home_id (str) –

  (required) The Database Home `OCID`__.

• update_db_home_details (oci.database.models.UpdateDbHomeDetails) – (required) Request to update the properties of a Database Home.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbHome

Return type

Response

Example

Click here to see an example of how to use update_db_home API.

update_db_node(db_node_id, update_db_node_details, **kwargs)

Updates the specified database node.

Parameters

• db_node_id (str) –

  (required) The database node `OCID`__.

• update_db_node_details (oci.database.models.UpdateDbNodeDetails) – (required) Request to update the specified database node.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbNode

Return type

Response

Example

Click here to see an example of how to use update_db_node API.

update_db_system(db_system_id, update_db_system_details, **kwargs)

Updates the properties of the specified DB system.

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• update_db_system_details (oci.database.models.UpdateDbSystemDetails) – (required) Request to update the properties of a DB system.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_dry_run (bool) – (optional) Indicates that the request is a dry run, if set to “true”. A dry run request does not actually creating or updating a resource and is used only to perform validation on the submitted data.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystem

Return type

Response

Example

Click here to see an example of how to use update_db_system API.

update_exadata_infrastructure(exadata_infrastructure_id, update_exadata_infrastructure_details, **kwargs)

Updates the Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only. To update an Exadata Cloud Service infrastructure resource, use the update_cloud_exadata_infrastructure() operation.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• update_exadata_infrastructure_details (oci.database.models.UpdateExadataInfrastructureDetails) – (required) Request to update the properties of an Exadata Cloud@Customer infrastructure.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataInfrastructure

Return type

Response

Example

Click here to see an example of how to use update_exadata_infrastructure API.

update_exadata_iorm_config(db_system_id, exadata_iorm_config_update_details, **kwargs)

Updates IORM settings for the specified Exadata DB system.

Note: Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead.

For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model.

The update_cloud_vm_cluster_iorm_config() API is used for Exadata systems using the new resource model.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• exadata_iorm_config_update_details (oci.database.models.ExadataIormConfigUpdateDetails) – (required) Request to perform database update.

• opc_request_id (str) – (optional) Unique identifier for the request.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadataIormConfig

Return type

Response

Example

Click here to see an example of how to use update_exadata_iorm_config API.

update_exadb_vm_cluster(exadb_vm_cluster_id, update_exadb_vm_cluster_details, **kwargs)

Updates the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only.

Parameters

• exadb_vm_cluster_id (str) –

  (required) The Exadata VM cluster `OCID`__ on Exascale Infrastructure.

• update_exadb_vm_cluster_details (oci.database.models.UpdateExadbVmClusterDetails) – (required) Request to update the attributes of a Exadata VM cluster on Exascale Infrastructure.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExadbVmCluster

Return type

Response

Example

Click here to see an example of how to use update_exadb_vm_cluster API.

update_exascale_db_storage_vault(exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, **kwargs)

Updates the specified Exadata Database Storage Vault.

Parameters

• exascale_db_storage_vault_id (str) –

  (required) The Exadata Database Storage Vault `OCID`__.

• update_exascale_db_storage_vault_details (oci.database.models.UpdateExascaleDbStorageVaultDetails) – (required) Request to update the attributes of a Exadata Database Storage Vault.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExascaleDbStorageVault

Return type

Response

Example

Click here to see an example of how to use update_exascale_db_storage_vault API.

update_execution_action(execution_action_id, update_execution_action_details, **kwargs)

Updates the execution action resource.

Parameters

• execution_action_id (str) –

  (required) The execution action `OCID`__.

• update_execution_action_details (oci.database.models.UpdateExecutionActionDetails) – (required) Request to update the properties of a execution action.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionAction

Return type

Response

Example

Click here to see an example of how to use update_execution_action API.

update_execution_window(execution_window_id, update_execution_window_details, **kwargs)

Updates the execution window resource.

Parameters

• execution_window_id (str) –

  (required) The execution window `OCID`__.

• update_execution_window_details (oci.database.models.UpdateExecutionWindowDetails) – (required) Request to update the properties of a execution window.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExecutionWindow

Return type

Response

Example

Click here to see an example of how to use update_execution_window API.

update_external_container_database(external_container_database_id, update_external_container_database_details, **kwargs)

Updates the properties of an create_external_container_database_details() resource, such as the display name.

Parameters

• external_container_database_id (str) –

  (required) The ExternalContainerDatabase `OCID`__.

• update_external_container_database_details (oci.database.models.UpdateExternalContainerDatabaseDetails) – (required) Request to update the properties of an create_external_container_database_details() resource.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalContainerDatabase

Return type

Response

Example

Click here to see an example of how to use update_external_container_database API.

update_external_database_connector(external_database_connector_id, update_external_database_connector_details, **kwargs)

Updates the properties of an external database connector, such as the display name.

Parameters

• external_database_connector_id (str) –

  (required) The `OCID`__ of the external database connector resource (ExternalDatabaseConnectorId).

• update_external_database_connector_details (oci.database.models.UpdateExternalDatabaseConnectorDetails) – (required) Request to update the properties of an external database connector.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalDatabaseConnector

Return type

Response

Example

Click here to see an example of how to use update_external_database_connector API.

update_external_non_container_database(external_non_container_database_id, update_external_non_container_database_details, **kwargs)

Updates the properties of an external non-container database, such as the display name.

Parameters

• external_non_container_database_id (str) –

  (required) The external non-container database `OCID`__.

• update_external_non_container_database_details (oci.database.models.UpdateExternalNonContainerDatabaseDetails) – (required) Request to update the properties of an external non-container database.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalNonContainerDatabase

Return type

Response

Example

Click here to see an example of how to use update_external_non_container_database API.

update_external_pluggable_database(external_pluggable_database_id, update_external_pluggable_database_details, **kwargs)

Updates the properties of an create_external_pluggable_database_details() resource, such as the display name.

Parameters

• external_pluggable_database_id (str) –

  (required) The ExternalPluggableDatabaseId `OCID`__.

• update_external_pluggable_database_details (oci.database.models.UpdateExternalPluggableDatabaseDetails) – (required) Request to update the properties of an external pluggable database resource.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ExternalPluggableDatabase

Return type

Response

Example

Click here to see an example of how to use update_external_pluggable_database API.

update_gi_home(gi_home_id, update_gi_home_details, **kwargs)

Updates the tags and display name of a specified Grid Infrastructure Home.

Parameters

• gi_home_id (str) –

  (required) The Grid Infrastructure Home `OCID`__.

• update_gi_home_details (oci.database.models.UpdateGiHomeDetails) – (required) Request to update the properties of a Grid Infrastructure Home.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type GiHome

Return type

Response

Example

Click here to see an example of how to use update_gi_home API.

update_key_store(key_store_id, update_key_store_details, **kwargs)

Edit the key store.

Parameters

• key_store_id (str) –

  (required) The `OCID`__ of the key store.

• update_key_store_details (oci.database.models.UpdateKeyStoreDetails) – (required) Request to update the attributes of a key store.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type KeyStore

Return type

Response

Example

Click here to see an example of how to use update_key_store API.

update_maintenance_run(maintenance_run_id, update_maintenance_run_details, **kwargs)

Updates the properties of a maintenance run, such as the state of a maintenance run.

Parameters

• maintenance_run_id (str) – (required) The maintenance run OCID.

• update_maintenance_run_details (oci.database.models.UpdateMaintenanceRunDetails) – (required) Request to update the properties of a maintenance run.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type MaintenanceRun

Return type

Response

Example

Click here to see an example of how to use update_maintenance_run API.

update_oneoff_patch(oneoff_patch_id, update_oneoff_patch_details, **kwargs)

Updates the properties of the specified one-off patch.

Parameters

• oneoff_patch_id (str) –

  (required) The one-off patch `OCID`__.

• update_oneoff_patch_details (oci.database.models.UpdateOneoffPatchDetails) – (required) Request to update the properties of a one-off patch.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type OneoffPatch

Return type

Response

Example

Click here to see an example of how to use update_oneoff_patch API.

update_pluggable_database(pluggable_database_id, update_pluggable_database_details, **kwargs)

Updates the specified pluggable database.

Parameters

• pluggable_database_id (str) –

  (required) The database `OCID`__.

• update_pluggable_database_details (oci.database.models.UpdatePluggableDatabaseDetails) – (required) Request to perform pluggable database update.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type PluggableDatabase

Return type

Response

Example

Click here to see an example of how to use update_pluggable_database API.

update_scheduled_action(scheduled_action_id, update_scheduled_action_details, **kwargs)

Updates the Scheduled Action resource.

Parameters

• scheduled_action_id (str) –

  (required) The Scheduled Action `OCID`__.

• update_scheduled_action_details (oci.database.models.UpdateScheduledActionDetails) – (required) Request to update the properties of a Scheduled Action.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type ScheduledAction

Return type

Response

Example

Click here to see an example of how to use update_scheduled_action API.

update_scheduling_policy(scheduling_policy_id, update_scheduling_policy_details, **kwargs)

Updates the Scheduling Policy resource.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• update_scheduling_policy_details (oci.database.models.UpdateSchedulingPolicyDetails) – (required) Request to update the properties of a Scheduling Policy.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingPolicy

Return type

Response

Example

Click here to see an example of how to use update_scheduling_policy API.

update_scheduling_window(scheduling_policy_id, scheduling_window_id, update_scheduling_window_details, **kwargs)

Updates the Scheduling Window resource.

Parameters

• scheduling_policy_id (str) –

  (required) The Scheduling Policy `OCID`__.

• scheduling_window_id (str) –

  (required) The Scheduling Window `OCID`__.

• update_scheduling_window_details (oci.database.models.UpdateSchedulingWindowDetails) – (required) Request to update the properties of a Scheduling Window.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type SchedulingWindow

Return type

Response

Example

Click here to see an example of how to use update_scheduling_window API.

update_vm_cluster(vm_cluster_id, update_vm_cluster_details, **kwargs)

Updates the specified VM cluster. Applies to Exadata Cloud@Customer instances only.

Parameters

• vm_cluster_id (str) –

  (required) The VM cluster `OCID`__.

• update_vm_cluster_details (oci.database.models.UpdateVmClusterDetails) – (required) Request to update the attributes of a VM cluster.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmCluster

Return type

Response

Example

Click here to see an example of how to use update_vm_cluster API.

update_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, update_vm_cluster_network_details, **kwargs)

Updates the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. To update a cloud VM cluster in an Exadata Cloud Service instance, use the update_cloud_vm_cluster() operation.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• update_vm_cluster_network_details (oci.database.models.UpdateVmClusterNetworkDetails) – (required) Request to update the properties of a VM cluster network.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterNetwork

Return type

Response

Example

Click here to see an example of how to use update_vm_cluster_network API.

upgrade_database(database_id, upgrade_database_details, **kwargs)

Upgrades the specified Oracle Database instance.

Parameters

• database_id (str) –

  (required) The database `OCID`__.

• upgrade_database_details (oci.database.models.UpgradeDatabaseDetails) – (required) Request to perform a database upgrade.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type Database

Return type

Response

Example

Click here to see an example of how to use upgrade_database API.

upgrade_db_system(db_system_id, upgrade_db_system_details, **kwargs)

Upgrades the operating system and grid infrastructure of the DB system.

Parameters

• db_system_id (str) –

  (required) The DB system `OCID`__.

• upgrade_db_system_details (oci.database.models.UpgradeDbSystemDetails) – (required) Request to perform an upgrade of the operating system and the Oracle Grid Infrastructure (GI) of the DB system.

• if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type DbSystem

Return type

Response

Example

Click here to see an example of how to use upgrade_db_system API.

validate_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, **kwargs)

Validates the specified VM cluster network. Applies to Exadata Cloud@Customer instances only.

Parameters

• exadata_infrastructure_id (str) –

  (required) The Exadata infrastructure `OCID`__.

• vm_cluster_network_id (str) –

  (required) The VM cluster network `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.

• opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected).

• retry_strategy (obj) –

  (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

  This should be one of the strategies available in the retry module. This operation will not retry by default, users can also use the convenient DEFAULT_RETRY_STRATEGY provided by the SDK to enable retries for it. The specifics of the default retry strategy are described here.

  To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

• allow_control_chars (bool) – (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings

• enable_strict_url_encoding (bool) – (optional) enable_strict_url_encoding is a boolean to indicate whether or not this request should enable strict url encoding for path params. By default, strict url encoding for path params is disabled

Returns

A Response object with data of type VmClusterNetwork

Return type

Response

Example

Click here to see an example of how to use validate_vm_cluster_network API.