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_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 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 Database and its dependent resources to the specified compartment.
change_autonomous_database_software_image_compartment(…)	Move the Autonomous Database Software Image and its dependent resources to the specified compartment.
change_autonomous_database_subscription(…)	Associate an Autonomous 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_cloud_autonomous_vm_cluster_compartment(…)	Moves an Autonomous Exadata VM cluster in the Oracle cloud and its dependent resources to another compartment.
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(…)	Switch the Autonomous Container Database 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 Database Serverless database, and must be run on the standby side.
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_exascale_db_storage_vault_compartment(…)	Moves a Exadata Database Storage Vault to another compartment.
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 Database Vault service `key`__.
configure_exascale_exadata_infrastructure(…)	Configures Exascale on Exadata infrastructure resource.
configure_saas_admin_user(…)	This operation updates SaaS administrative user configuration of the Autonomous 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_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).
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(…)	Create a new Autonomous Data Guard association.
create_autonomous_database(…)	Creates a new Autonomous Database.
create_autonomous_database_backup(…)	Creates a new Autonomous Database backup for the specified database based on the provided request parameters.
create_autonomous_database_software_image(…)	create Autonomous 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_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_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_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_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:
delete_application_vip(application_vip_id, …)	Deletes and deregisters the specified application virtual IP (VIP) address.
delete_autonomous_database(…)	Deletes the specified Autonomous Database.
delete_autonomous_database_backup(…)	Deletes a long-term backup.
delete_autonomous_database_software_image(…)	Delete an Autonomous 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_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_software_image(…)	Delete a database software image
delete_db_home(db_home_id, **kwargs)	Deletes a Database Home.
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_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_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 Database with Data Safe.
disable_autonomous_database_management(…)	Disables Database Management for the Autonomous Database resource.
disable_autonomous_database_operations_insights(…)	Disables Operations Insights for the Autonomous 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_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.
enable_autonomous_database_management(…)	Enables Database Management for Autonomous Database.
enable_autonomous_database_operations_insights(…)	Enables the specified Autonomous 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.
fail_over_autonomous_database(…)	Initiates a failover of the specified Autonomous Database to the associated peer database.
failover_autonomous_container_database_dataguard_association(…)	Fails over the standby Autonomous Container Database identified by the autonomousContainerDatabaseId parameter to the primary Autonomous Container Database after the existing primary Autonomous Container 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 Database.
generate_recommended_vm_cluster_network(…)	Generates a recommended Cloud@Customer VM cluster network configuration.
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_dataguard_association(…)	Gets an Autonomous Container Database enabled with Autonomous Data Guard associated with the specified Autonomous Container Database.
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 Database.
get_autonomous_database_backup(…)	Gets information about the specified Autonomous Database backup.
get_autonomous_database_dataguard_association(…)	Gets an Autonomous Data Guard-enabled database associated with the specified Autonomous Database.
get_autonomous_database_regional_wallet(**kwargs)	Gets the Autonomous Database regional wallet details.
get_autonomous_database_software_image(…)	Gets information about the specified Autonomous Database Software Image.
get_autonomous_database_wallet(…)	Gets the wallet details for the specified Autonomous 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_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_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_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_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_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_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_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.
launch_autonomous_exadata_infrastructure(…)	Deprecated To create a new Autonomous 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.
launch_db_system(launch_db_system_details, …)	Creates a new DB system in the specified compartment and availability domain.
list_application_vips(compartment_id, …)	Gets a list of application virtual IP (VIP) addresses on a cloud VM cluster.
list_autonomous_container_database_dataguard_associations(…)	Gets a list of the Autonomous Container Databases with Autonomous Data Guard-enabled associated with the specified Autonomous Container Database.
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 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 Database clones for the specified Autonomous Database.
list_autonomous_database_dataguard_associations(…)	Gets a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous Database.
list_autonomous_database_peers(…)	Lists the Autonomous Database peers for the specified Autonomous Database.
list_autonomous_database_refreshable_clones(…)	Lists the OCIDs of the Autonomous 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 Database Software Images in the specified compartment.
list_autonomous_databases(compartment_id, …)	Gets a list of Autonomous Databases based on the query parameters specified.
list_autonomous_db_preview_versions(…)	Gets a list of supported Autonomous Database versions.
list_autonomous_db_versions(compartment_id, …)	Gets a list of supported Autonomous 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_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_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_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_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_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_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_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_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_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_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_versions(compartment_id, shape, …)	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_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.
move_execution_action_member(…)	Moves an execution action member to this execution action resource from another.
refresh_pluggable_database(…)	Refreshes a pluggable database (PDB) Refreshable clone.
register_autonomous_database_data_safe(…)	Asynchronously registers this Autonomous Database with Data Safe.
reinstate_autonomous_container_database_dataguard_association(…)	Reinstates a disabled standby Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter, to an active standby Autonomous Container Database.
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.
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 Database.
restore_autonomous_database(…)	Restores an Autonomous 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.
saas_admin_user_status(…)	This operation gets SaaS administrative user status of the Autonomous 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 Database.
start_pluggable_database(…)	Starts a stopped pluggable database.
stop_autonomous_database(…)	Stops the specified Autonomous Database.
stop_pluggable_database(…)	Stops a pluggable database.
switchover_autonomous_container_database_dataguard_association(…)	Switches over the primary Autonomous Container Database of an Autonomous Data Guard peer association to standby role.
switchover_autonomous_database(…)	Initiates a switchover of the specified Autonomous Database to the associated peer database.
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. To delete an Autonomous Exadata VM cluster in the Oracle cloud, use the delete_cloud_autonomous_vm_cluster() 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.
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(…)	Update Autonomous Data Guard association.
update_autonomous_database(…)	Updates one or more attributes of the specified Autonomous Database.
update_autonomous_database_backup(…)	Updates the Autonomous Database backup of the specified database based on the request parameters.
update_autonomous_database_regional_wallet(…)	Updates the Autonomous Database regional wallet.
update_autonomous_database_software_image(…)	Updates the properties of an Autonomous Database Software Image, like add tags
update_autonomous_database_wallet(…)	Updates the wallet for the specified Autonomous 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_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_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_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_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_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.

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

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_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 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

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

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

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

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 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 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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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

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 Database and its dependent resources to the specified compartment. For more information about moving Autonomous Databases, see `Moving Database Resources to a Different Compartment`__.

Parameters:

• change_compartment_details (oci.database.models.ChangeCompartmentDetails) – (required) Request to move Autonomous 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.
• retry_strategy (obj) –

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

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

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

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

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 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 Database Software Image to a different compartment
• autonomous_database_software_image_id (str) –

  (required) The Autonomous 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

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 Database with a different subscription.

Parameters:

• change_autonomous_database_subscription_details (oci.database.models.ChangeAutonomousDatabaseSubscriptionDetails) – (required) Associate an Autonomous 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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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_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

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_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 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

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

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

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

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

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)

Switch the Autonomous Container Database role between Standby and Snapshot Standby. For more information about changing Autonomous Container Databases Dataguard 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

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

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 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 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.
• retry_strategy (obj) –

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

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

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

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

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_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

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

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_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

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_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

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

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

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

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

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

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

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

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

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

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

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 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 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).
• retry_strategy (obj) –

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

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

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

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

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_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

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 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 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

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

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_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

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

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.

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

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.CreateAutonomousContainerDatabaseDetails) – (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

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)

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`__.

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:

• 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

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 Database.

Parameters:

• create_autonomous_database_details (oci.database.models.CreateAutonomousDatabaseBase) – (required) Request to create a new Autonomous 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

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 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 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.
• retry_strategy (obj) –

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

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

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

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

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 Database Software Image in the specified compartment.

Parameters:

• create_autonomous_database_software_image_details (oci.database.models.CreateAutonomousDatabaseSoftwareImageDetails) – (required) Request to create Autonomous 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

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

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

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

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_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.
• retry_strategy (obj) –

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

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

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

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

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 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.
• retry_strategy (obj) –

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

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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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_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

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

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

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

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

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

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

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

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

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

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

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

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_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

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

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

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

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_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

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

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

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

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

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

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 - 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”, “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

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_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

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 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.
• retry_strategy (obj) –

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

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

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

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

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 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.
• retry_strategy (obj) –

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

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

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

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

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 Database Software Image

Parameters:

• autonomous_database_software_image_id (str) –

  (required) The Autonomous 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

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

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

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

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_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

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 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

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

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

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

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

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_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

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

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_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

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

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

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

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

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

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

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

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

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_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

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

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

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_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

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

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

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

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

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

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 Database with Data Safe.

Parameters:

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.
• deregister_autonomous_database_data_safe_details (oci.database.models.DeregisterAutonomousDatabaseDataSafeDetails) – (optional) Details for deregistering an Autonomous 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

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 Database resource.

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

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 Database resource.

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

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

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

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

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

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

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

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

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

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

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

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_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

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

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

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

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.

enable_autonomous_database_management(autonomous_database_id, **kwargs)

Enables Database Management for Autonomous 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

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 Database with Operations Insights.

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

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

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

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

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

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

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

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

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

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

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

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.

fail_over_autonomous_database(autonomous_database_id, **kwargs)

Initiates a failover of the specified Autonomous 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.
• retry_strategy (obj) –

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

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

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

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

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_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Fails over the standby Autonomous Container Database identified by the autonomousContainerDatabaseId parameter to the primary Autonomous Container Database after the existing primary Autonomous Container Database 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

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_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

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 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 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).
• retry_strategy (obj) –

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

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

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

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

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

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_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

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

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_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Gets an Autonomous Container Database enabled with Autonomous Data Guard associated with the specified Autonomous Container Database.

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

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

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 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

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 Database backup.

Parameters:

• autonomous_database_backup_id (str) –

  (required) The `OCID`__ of the Autonomous 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

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)

Gets an Autonomous Data Guard-enabled database associated with the specified Autonomous 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

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 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

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 Database Software Image.

Parameters:

• autonomous_database_software_image_id (str) –

  (required) The Autonomous 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

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 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

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

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

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

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

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

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

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

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_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

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

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 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

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

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

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

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

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

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

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

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

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

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

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_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

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

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_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

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

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

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

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

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

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_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

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

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

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_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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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_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

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

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

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

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

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

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

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_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

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

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

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

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

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

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

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

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

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

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.

launch_autonomous_exadata_infrastructure(launch_autonomous_exadata_infrastructure_details, **kwargs)

Deprecated To create a new Autonomous 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

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).
• retry_strategy (obj) –

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

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

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

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

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_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

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_dataguard_associations(autonomous_container_database_id, **kwargs)

Gets a list of the Autonomous Container Databases with Autonomous Data Guard-enabled associated with the specified Autonomous Container Database.

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

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

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

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 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.
• 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

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 Database Serverless instance. By default, this request will be for Autonomous Database on Dedicated Exadata Infrastructure.
• is_dedicated (bool) – (optional) Specifies if the request is for an Autonomous Database Dedicated instance. The default request is for an Autonomous 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

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 Database clones for the specified Autonomous 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”

• 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

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)

Gets a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous 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

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 Database peers for the specified Autonomous 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

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 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

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 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 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

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 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”

• 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”

• db_workload (str) –

  (optional) A filter to return only autonomous database resources that match the specified workload type.

  Allowed values are: “OLTP”, “DW”, “AJD”, “APEX”

• db_version (str) – (optional) A filter to return only autonomous 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 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

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_db_preview_versions(compartment_id, **kwargs)

Gets a list of supported Autonomous Database versions. Note that preview version software is only available for Autonomous 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

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 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 database resources that match the specified workload type.

  Allowed values are: “OLTP”, “DW”, “AJD”, “APEX”

• 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

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

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

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

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

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

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_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

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”

• retry_strategy (obj) –

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

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

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

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

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_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

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

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 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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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

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_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”

• patch_set_greater_than_or_equal_to (str) – (optional) A filter to return only resources with patchSet greater than or equal to given value.
• 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

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

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.
• retry_strategy (obj) –

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

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

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

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

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_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

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

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

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. A database node is a server running database software.

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

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

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.

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.
• retry_strategy (obj) –

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

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

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

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

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_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

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

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.
• retry_strategy (obj) –

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

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

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

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

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.
• 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

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

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_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

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”

• 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

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_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

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

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

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.
• 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

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”

• 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

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

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

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

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

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

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

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.
• 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

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_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.
• 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

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.
• retry_strategy (obj) –

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

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

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

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

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

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”

• 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

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.
• 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”

• 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

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

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”

• 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

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

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_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

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”

• 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

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_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

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.
• retry_strategy (obj) –

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

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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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

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_versions(compartment_id, shape, 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`__.

• shape (str) – (required) Specifies shape query parameter.
• 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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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

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_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

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

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

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

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.

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

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_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

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 Database with Data Safe.

Parameters:

• autonomous_database_id (str) –

  (required) The database `OCID`__.

• opc_request_id (str) – (optional) Unique identifier for the request.
• register_autonomous_database_data_safe_details (oci.database.models.RegisterAutonomousDatabaseDataSafeDetails) – (optional) Request to register an Autonomous 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

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.

reinstate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Reinstates a disabled standby Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter, to an active standby Autonomous Container Database.

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

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_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

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

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

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

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

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

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

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.

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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 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.
• retry_strategy (obj) –

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

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

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

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

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.

restore_autonomous_database(autonomous_database_id, restore_autonomous_database_details, **kwargs)

Restores an Autonomous 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 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

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

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.
• retry_strategy (obj) –

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

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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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

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

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

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

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

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.

saas_admin_user_status(autonomous_database_id, **kwargs)

This operation gets SaaS administrative user status of the Autonomous 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

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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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 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.
• retry_strategy (obj) –

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

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

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

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

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

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 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.
• retry_strategy (obj) –

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

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

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

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

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

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.

switchover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs)

Switches over the primary Autonomous Container Database of an Autonomous Data Guard peer association to standby role. The standby Autonomous Container Database associated with autonomousContainerDatabaseDataguardAssociationId assumes the primary Autonomous Container Database 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

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 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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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

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.

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

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)

Update 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

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 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 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

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 Database backup of the specified database based on the request parameters.

Parameters:

• autonomous_database_backup_id (str) –

  (required) The `OCID`__ of the Autonomous Database backup.

• update_autonomous_database_backup_details (oci.database.models.UpdateAutonomousDatabaseBackupDetails) – (required) Request to update an existing Autonomous 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.
• retry_strategy (obj) –

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

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

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

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

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 Database regional wallet.

Parameters:

• update_autonomous_database_wallet_details (oci.database.models.UpdateAutonomousDatabaseWalletDetails) – (required) Request to update the properties of Autonomous Database regional wallet.
• 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

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 Database Software Image, like add tags

Parameters:

• autonomous_database_software_image_id (str) –

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

• update_autonomous_database_software_image_details (oci.database.models.UpdateAutonomousDatabaseSoftwareImageDetails) – (required) Request to update the properties of an Autonomous 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

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 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 Database wallet.
• 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

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

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

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_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

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_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.
• retry_strategy (obj) –

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

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

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

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

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 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

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

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

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

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

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_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

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

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_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

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

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

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.
• retry_strategy (obj) –

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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_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

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

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

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

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

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

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

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

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

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

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

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

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.