@Generated(value="OracleSDKGenerator", comments="API Version: 20160918") public class DatabaseAsyncClient extends Object implements DatabaseAsync
Async client implementation for Database service.
There are two ways to use async client: 1. Use AsyncHandler: using AsyncHandler, if the response to the call is an InputStream
, like getObject Api in object storage service, developers need to process the stream in AsyncHandler, and not anywhere else, because the stream will be closed right after the AsyncHandler is invoked.
2. Use Java Future: using Java Future, developers need to close the stream after they are done with the Java Future.
Accessing the result should be done in a mutually exclusive manner, either through the Future or the AsyncHandler, but not both. If the Future is used, the caller should pass in null as the AsyncHandler. If the AsyncHandler is used, it is still safe to use the Future to determine whether or not the request was completed via Future.isDone/isCancelled.
Please refer to https://github.com/oracle/oci-java-sdk/blob/master/bmc-examples/src/main/java/ResteasyClientWithObjectStorageExample.java
Modifier and Type | Class and Description |
---|---|
static class |
DatabaseAsyncClient.Builder
Builder class for this client.
|
Modifier and Type | Field and Description |
---|---|
static Service |
SERVICE
Service instance for Database.
|
Constructor and Description |
---|
DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Creates a new service instance using the given authentication provider and client configuration.
|
DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Creates a new service instance using the given authentication provider and client configuration.
|
DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Creates a new service instance using the given authentication provider and client configuration.
|
DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Creates a new service instance using the given authentication provider and client configuration.
|
DatabaseAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Creates a new service instance using the given authentication provider.
|
DatabaseAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Creates a new service instance using the given authentication provider and client configuration.
|
DatabaseAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Creates a new service instance using the given authentication provider and client configuration.
|
public static final Service SERVICE
Service instance for Database.
public DatabaseAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Creates a new service instance using the given authentication provider.
authenticationDetailsProvider
- The authentication details provider, required.public DatabaseAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
Creates a new service instance using the given authentication provider and client configuration.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.public DatabaseAsyncClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.public DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.public DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.additionalClientConfigurators
- Additional client configurators to be run after the primary configurator.public DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.additionalClientConfigurators
- Additional client configurators to be run after the primary configurator.endpoint
- Endpoint, or null to leave unset (note, may be overridden by authenticationDetailsProvider
)public DatabaseAsyncClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
Creates a new service instance using the given authentication provider and client configuration. Additionally, a Consumer can be provided that will be invoked whenever a REST Client is created to allow for additional configuration/customization.
This is an advanced constructor for clients that want to take control over how requests are signed.
authenticationDetailsProvider
- The authentication details provider, required.configuration
- The client configuration, optional.clientConfigurator
- ClientConfigurator that will be invoked for additional configuration of a REST client, optional.defaultRequestSignerFactory
- The request signer factory used to create the request signer for this service.signingStrategyRequestSignerFactories
- The request signer factories for each signing strategy used to create the request signeradditionalClientConfigurators
- Additional client configurators to be run after the primary configurator.endpoint
- Endpoint, or null to leave unset (note, may be overridden by authenticationDetailsProvider
)public static DatabaseAsyncClient.Builder builder()
Create a builder for this client.
public void setEndpoint(String endpoint)
DatabaseAsync
Sets the endpoint to call (ex, https://www.example.com).
setEndpoint
in interface DatabaseAsync
endpoint
- The endpoint of the serice.public void setRegion(Region region)
DatabaseAsync
Sets the region to call (ex, Region.US_PHOENIX_1).
Note, this will call setEndpoint
after resolving the endpoint. If the service is not available in this region, however, an IllegalArgumentException will be raised.
setRegion
in interface DatabaseAsync
region
- The region of the service.public void setRegion(String regionId)
DatabaseAsync
Sets the region to call (ex, ‘us-phoenix-1’).
Note, this will first try to map the region ID to a known Region and call setRegion
.
If no known Region could be determined, it will create an endpoint based on the default endpoint format (Region.formatDefaultRegionEndpoint(Service, String)
and then call setEndpoint
.
setRegion
in interface DatabaseAsync
regionId
- The public region ID.public void close()
close
in interface AutoCloseable
public Future<CompleteExternalBackupJobResponse> completeExternalBackupJob(CompleteExternalBackupJobRequest request, AsyncHandler<CompleteExternalBackupJobRequest,CompleteExternalBackupJobResponse> handler)
DatabaseAsync
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.
completeExternalBackupJob
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateAutonomousContainerDatabaseResponse> createAutonomousContainerDatabase(CreateAutonomousContainerDatabaseRequest request, AsyncHandler<CreateAutonomousContainerDatabaseRequest,CreateAutonomousContainerDatabaseResponse> handler)
DatabaseAsync
Create a new Autonomous Container Database in the specified Autonomous Exadata Infrastructure.
createAutonomousContainerDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateAutonomousDataWarehouseResponse> createAutonomousDataWarehouse(CreateAutonomousDataWarehouseRequest request, AsyncHandler<CreateAutonomousDataWarehouseRequest,CreateAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To create a new Autonomous Data Warehouse, use the createAutonomousDatabase
operation and specify DW
as the workload type.
createAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateAutonomousDataWarehouseBackupResponse> createAutonomousDataWarehouseBackup(CreateAutonomousDataWarehouseBackupRequest request, AsyncHandler<CreateAutonomousDataWarehouseBackupRequest,CreateAutonomousDataWarehouseBackupResponse> handler)
DatabaseAsync
Deprecated. To create a new Autonomous Data Warehouse backup for a specified database, use the createAutonomousDatabaseBackup
operation.
createAutonomousDataWarehouseBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateAutonomousDatabaseResponse> createAutonomousDatabase(CreateAutonomousDatabaseRequest request, AsyncHandler<CreateAutonomousDatabaseRequest,CreateAutonomousDatabaseResponse> handler)
DatabaseAsync
Creates a new Autonomous Database.
createAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateAutonomousDatabaseBackupResponse> createAutonomousDatabaseBackup(CreateAutonomousDatabaseBackupRequest request, AsyncHandler<CreateAutonomousDatabaseBackupRequest,CreateAutonomousDatabaseBackupResponse> handler)
DatabaseAsync
Creates a new Autonomous Database backup for the specified database based on the provided request parameters.
createAutonomousDatabaseBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateBackupResponse> createBackup(CreateBackupRequest request, AsyncHandler<CreateBackupRequest,CreateBackupResponse> handler)
DatabaseAsync
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.
createBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateDataGuardAssociationResponse> createDataGuardAssociation(CreateDataGuardAssociationRequest request, AsyncHandler<CreateDataGuardAssociationRequest,CreateDataGuardAssociationResponse> handler)
DatabaseAsync
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.
createDataGuardAssociation
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateDbHomeResponse> createDbHome(CreateDbHomeRequest request, AsyncHandler<CreateDbHomeRequest,CreateDbHomeResponse> handler)
DatabaseAsync
Creates a new database home in the specified DB system based on the request parameters you provide.
createDbHome
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<CreateExternalBackupJobResponse> createExternalBackupJob(CreateExternalBackupJobRequest request, AsyncHandler<CreateExternalBackupJobRequest,CreateExternalBackupJobResponse> handler)
DatabaseAsync
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.
createExternalBackupJob
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DbNodeActionResponse> dbNodeAction(DbNodeActionRequest request, AsyncHandler<DbNodeActionRequest,DbNodeActionResponse> handler)
DatabaseAsync
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 DB 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 (terminateDbSystem
) 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.
dbNodeAction
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteAutonomousDataWarehouseResponse> deleteAutonomousDataWarehouse(DeleteAutonomousDataWarehouseRequest request, AsyncHandler<DeleteAutonomousDataWarehouseRequest,DeleteAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To delete an Autonomous Data Warehouse, use the deleteAutonomousDatabase
operation.
deleteAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteAutonomousDatabaseResponse> deleteAutonomousDatabase(DeleteAutonomousDatabaseRequest request, AsyncHandler<DeleteAutonomousDatabaseRequest,DeleteAutonomousDatabaseResponse> handler)
DatabaseAsync
Deletes the specified Autonomous Database.
deleteAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteBackupResponse> deleteBackup(DeleteBackupRequest request, AsyncHandler<DeleteBackupRequest,DeleteBackupResponse> handler)
DatabaseAsync
Deletes a full backup. You cannot delete automatic backups using this API.
deleteBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<DeleteDbHomeResponse> deleteDbHome(DeleteDbHomeRequest request, AsyncHandler<DeleteDbHomeRequest,DeleteDbHomeResponse> handler)
DatabaseAsync
Deletes a DB Home. The DB Home and its database data are local to the DB system and will be lost when it is deleted. Oracle recommends that you back up any data in the DB system prior to deleting it.
deleteDbHome
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<FailoverDataGuardAssociationResponse> failoverDataGuardAssociation(FailoverDataGuardAssociationRequest request, AsyncHandler<FailoverDataGuardAssociationRequest,FailoverDataGuardAssociationResponse> handler)
DatabaseAsync
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.
failoverDataGuardAssociation
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GenerateAutonomousDataWarehouseWalletResponse> generateAutonomousDataWarehouseWallet(GenerateAutonomousDataWarehouseWalletRequest request, AsyncHandler<GenerateAutonomousDataWarehouseWalletRequest,GenerateAutonomousDataWarehouseWalletResponse> handler)
DatabaseAsync
Deprecated. To create and download a wallet for an Autonomous Data Warehouse, use the generateAutonomousDatabaseWallet
operation.
generateAutonomousDataWarehouseWallet
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GenerateAutonomousDatabaseWalletResponse> generateAutonomousDatabaseWallet(GenerateAutonomousDatabaseWalletRequest request, AsyncHandler<GenerateAutonomousDatabaseWalletRequest,GenerateAutonomousDatabaseWalletResponse> handler)
DatabaseAsync
Creates and downloads a wallet for the specified Autonomous Database.
generateAutonomousDatabaseWallet
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAutonomousContainerDatabaseResponse> getAutonomousContainerDatabase(GetAutonomousContainerDatabaseRequest request, AsyncHandler<GetAutonomousContainerDatabaseRequest,GetAutonomousContainerDatabaseResponse> handler)
DatabaseAsync
Gets information about the specified Autonomous Container Database.
getAutonomousContainerDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAutonomousDataWarehouseResponse> getAutonomousDataWarehouse(GetAutonomousDataWarehouseRequest request, AsyncHandler<GetAutonomousDataWarehouseRequest,GetAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To get the details of an Autonomous Data Warehouse, use the getAutonomousDatabase
operation.
getAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAutonomousDataWarehouseBackupResponse> getAutonomousDataWarehouseBackup(GetAutonomousDataWarehouseBackupRequest request, AsyncHandler<GetAutonomousDataWarehouseBackupRequest,GetAutonomousDataWarehouseBackupResponse> handler)
DatabaseAsync
Deprecated. To get information about a specified Autonomous Data Warehouse backup, use the getAutonomousDatabaseBackup
operation.
getAutonomousDataWarehouseBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAutonomousDatabaseResponse> getAutonomousDatabase(GetAutonomousDatabaseRequest request, AsyncHandler<GetAutonomousDatabaseRequest,GetAutonomousDatabaseResponse> handler)
DatabaseAsync
Gets the details of the specified Autonomous Database.
getAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAutonomousDatabaseBackupResponse> getAutonomousDatabaseBackup(GetAutonomousDatabaseBackupRequest request, AsyncHandler<GetAutonomousDatabaseBackupRequest,GetAutonomousDatabaseBackupResponse> handler)
DatabaseAsync
Gets information about the specified Autonomous Database backup.
getAutonomousDatabaseBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetAutonomousExadataInfrastructureResponse> getAutonomousExadataInfrastructure(GetAutonomousExadataInfrastructureRequest request, AsyncHandler<GetAutonomousExadataInfrastructureRequest,GetAutonomousExadataInfrastructureResponse> handler)
DatabaseAsync
Gets information about the specified Autonomous Exadata Infrastructure.
getAutonomousExadataInfrastructure
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetBackupResponse> getBackup(GetBackupRequest request, AsyncHandler<GetBackupRequest,GetBackupResponse> handler)
DatabaseAsync
Gets information about the specified backup.
getBackup
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDataGuardAssociationResponse> getDataGuardAssociation(GetDataGuardAssociationRequest request, AsyncHandler<GetDataGuardAssociationRequest,GetDataGuardAssociationResponse> handler)
DatabaseAsync
Gets the specified Data Guard association’s configuration information.
getDataGuardAssociation
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDatabaseResponse> getDatabase(GetDatabaseRequest request, AsyncHandler<GetDatabaseRequest,GetDatabaseResponse> handler)
DatabaseAsync
Gets information about a specific database.
getDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbHomeResponse> getDbHome(GetDbHomeRequest request, AsyncHandler<GetDbHomeRequest,GetDbHomeResponse> handler)
DatabaseAsync
Gets information about the specified database home.
getDbHome
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbHomePatchResponse> getDbHomePatch(GetDbHomePatchRequest request, AsyncHandler<GetDbHomePatchRequest,GetDbHomePatchResponse> handler)
DatabaseAsync
Gets information about a specified patch package.
getDbHomePatch
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbHomePatchHistoryEntryResponse> getDbHomePatchHistoryEntry(GetDbHomePatchHistoryEntryRequest request, AsyncHandler<GetDbHomePatchHistoryEntryRequest,GetDbHomePatchHistoryEntryResponse> handler)
DatabaseAsync
Gets the patch history details for the specified patchHistoryEntryId
getDbHomePatchHistoryEntry
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbNodeResponse> getDbNode(GetDbNodeRequest request, AsyncHandler<GetDbNodeRequest,GetDbNodeResponse> handler)
DatabaseAsync
Gets information about the specified database node.
getDbNode
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbSystemResponse> getDbSystem(GetDbSystemRequest request, AsyncHandler<GetDbSystemRequest,GetDbSystemResponse> handler)
DatabaseAsync
Gets information about the specified DB system.
getDbSystem
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbSystemPatchResponse> getDbSystemPatch(GetDbSystemPatchRequest request, AsyncHandler<GetDbSystemPatchRequest,GetDbSystemPatchResponse> handler)
DatabaseAsync
Gets information about a specified patch package.
getDbSystemPatch
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetDbSystemPatchHistoryEntryResponse> getDbSystemPatchHistoryEntry(GetDbSystemPatchHistoryEntryRequest request, AsyncHandler<GetDbSystemPatchHistoryEntryRequest,GetDbSystemPatchHistoryEntryResponse> handler)
DatabaseAsync
Gets the patch history details for the specified patchHistoryEntryId.
getDbSystemPatchHistoryEntry
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetExadataIormConfigResponse> getExadataIormConfig(GetExadataIormConfigRequest request, AsyncHandler<GetExadataIormConfigRequest,GetExadataIormConfigResponse> handler)
DatabaseAsync
Gets IORM
Setting for the requested Exadata DB System. The default IORM Settings is pre-created in all the Exadata DB System.
getExadataIormConfig
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetExternalBackupJobResponse> getExternalBackupJob(GetExternalBackupJobRequest request, AsyncHandler<GetExternalBackupJobRequest,GetExternalBackupJobResponse> handler)
DatabaseAsync
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.
getExternalBackupJob
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<GetMaintenanceRunResponse> getMaintenanceRun(GetMaintenanceRunRequest request, AsyncHandler<GetMaintenanceRunRequest,GetMaintenanceRunResponse> handler)
DatabaseAsync
Gets information about the specified Maintenance Run.
getMaintenanceRun
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<LaunchAutonomousExadataInfrastructureResponse> launchAutonomousExadataInfrastructure(LaunchAutonomousExadataInfrastructureRequest request, AsyncHandler<LaunchAutonomousExadataInfrastructureRequest,LaunchAutonomousExadataInfrastructureResponse> handler)
DatabaseAsync
Launches a new Autonomous Exadata Infrastructure in the specified compartment and availability domain.
launchAutonomousExadataInfrastructure
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<LaunchDbSystemResponse> launchDbSystem(LaunchDbSystemRequest request, AsyncHandler<LaunchDbSystemRequest,LaunchDbSystemResponse> handler)
DatabaseAsync
Launches 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 more information, see Default Options for the Initial Database.
launchDbSystem
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousContainerDatabasesResponse> listAutonomousContainerDatabases(ListAutonomousContainerDatabasesRequest request, AsyncHandler<ListAutonomousContainerDatabasesRequest,ListAutonomousContainerDatabasesResponse> handler)
DatabaseAsync
Gets a list of the Autonomous Container Databases in the specified compartment.
listAutonomousContainerDatabases
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousDataWarehouseBackupsResponse> listAutonomousDataWarehouseBackups(ListAutonomousDataWarehouseBackupsRequest request, AsyncHandler<ListAutonomousDataWarehouseBackupsRequest,ListAutonomousDataWarehouseBackupsResponse> handler)
DatabaseAsync
Deprecated. To get a list of Autonomous Data Warehouse backups, use the listAutonomousDatabaseBackups
operation.
listAutonomousDataWarehouseBackups
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousDataWarehousesResponse> listAutonomousDataWarehouses(ListAutonomousDataWarehousesRequest request, AsyncHandler<ListAutonomousDataWarehousesRequest,ListAutonomousDataWarehousesResponse> handler)
DatabaseAsync
Deprecated. To get a list of Autonomous Data Warehouses, use the listAutonomousDatabases
operation and specify DW
as the workload type.
listAutonomousDataWarehouses
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousDatabaseBackupsResponse> listAutonomousDatabaseBackups(ListAutonomousDatabaseBackupsRequest request, AsyncHandler<ListAutonomousDatabaseBackupsRequest,ListAutonomousDatabaseBackupsResponse> handler)
DatabaseAsync
Gets a list of Autonomous Database backups based on either the autonomousDatabaseId
or compartmentId
specified as a query parameter.
listAutonomousDatabaseBackups
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousDatabasesResponse> listAutonomousDatabases(ListAutonomousDatabasesRequest request, AsyncHandler<ListAutonomousDatabasesRequest,ListAutonomousDatabasesResponse> handler)
DatabaseAsync
Gets a list of Autonomous Databases.
listAutonomousDatabases
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousExadataInfrastructureShapesResponse> listAutonomousExadataInfrastructureShapes(ListAutonomousExadataInfrastructureShapesRequest request, AsyncHandler<ListAutonomousExadataInfrastructureShapesRequest,ListAutonomousExadataInfrastructureShapesResponse> handler)
DatabaseAsync
Gets a list of the shapes that can be used to launch a new Autonomous Exadata Infrastructure DB system. The shape determines resources to allocate to the DB system (CPU cores, memory and storage).
listAutonomousExadataInfrastructureShapes
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListAutonomousExadataInfrastructuresResponse> listAutonomousExadataInfrastructures(ListAutonomousExadataInfrastructuresRequest request, AsyncHandler<ListAutonomousExadataInfrastructuresRequest,ListAutonomousExadataInfrastructuresResponse> handler)
DatabaseAsync
Gets a list of the Autonomous Exadata Infrastructures in the specified compartment.
listAutonomousExadataInfrastructures
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListBackupsResponse> listBackups(ListBackupsRequest request, AsyncHandler<ListBackupsRequest,ListBackupsResponse> handler)
DatabaseAsync
Gets a list of backups based on the databaseId or compartmentId specified. Either one of the query parameters must be provided.
listBackups
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDataGuardAssociationsResponse> listDataGuardAssociations(ListDataGuardAssociationsRequest request, AsyncHandler<ListDataGuardAssociationsRequest,ListDataGuardAssociationsResponse> handler)
DatabaseAsync
Lists all Data Guard associations for the specified database.
listDataGuardAssociations
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDatabasesResponse> listDatabases(ListDatabasesRequest request, AsyncHandler<ListDatabasesRequest,ListDatabasesResponse> handler)
DatabaseAsync
Gets a list of the databases in the specified database home.
listDatabases
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbHomePatchHistoryEntriesResponse> listDbHomePatchHistoryEntries(ListDbHomePatchHistoryEntriesRequest request, AsyncHandler<ListDbHomePatchHistoryEntriesRequest,ListDbHomePatchHistoryEntriesResponse> handler)
DatabaseAsync
Gets history of the actions taken for patches for the specified database home.
listDbHomePatchHistoryEntries
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbHomePatchesResponse> listDbHomePatches(ListDbHomePatchesRequest request, AsyncHandler<ListDbHomePatchesRequest,ListDbHomePatchesResponse> handler)
DatabaseAsync
Lists patches applicable to the requested database home.
listDbHomePatches
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbHomesResponse> listDbHomes(ListDbHomesRequest request, AsyncHandler<ListDbHomesRequest,ListDbHomesResponse> handler)
DatabaseAsync
Gets a list of database homes in the specified DB system and compartment. A database home is a directory where Oracle Database software is installed.
listDbHomes
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbNodesResponse> listDbNodes(ListDbNodesRequest request, AsyncHandler<ListDbNodesRequest,ListDbNodesResponse> handler)
DatabaseAsync
Gets a list of database nodes in the specified DB system and compartment. A database node is a server running database software.
listDbNodes
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbSystemPatchHistoryEntriesResponse> listDbSystemPatchHistoryEntries(ListDbSystemPatchHistoryEntriesRequest request, AsyncHandler<ListDbSystemPatchHistoryEntriesRequest,ListDbSystemPatchHistoryEntriesResponse> handler)
DatabaseAsync
Gets the history of the patch actions performed on the specified DB system.
listDbSystemPatchHistoryEntries
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbSystemPatchesResponse> listDbSystemPatches(ListDbSystemPatchesRequest request, AsyncHandler<ListDbSystemPatchesRequest,ListDbSystemPatchesResponse> handler)
DatabaseAsync
Lists the patches applicable to the requested DB system.
listDbSystemPatches
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbSystemShapesResponse> listDbSystemShapes(ListDbSystemShapesRequest request, AsyncHandler<ListDbSystemShapesRequest,ListDbSystemShapesResponse> handler)
DatabaseAsync
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.
listDbSystemShapes
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbSystemsResponse> listDbSystems(ListDbSystemsRequest request, AsyncHandler<ListDbSystemsRequest,ListDbSystemsResponse> handler)
DatabaseAsync
Gets a list of 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.
listDbSystems
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListDbVersionsResponse> listDbVersions(ListDbVersionsRequest request, AsyncHandler<ListDbVersionsRequest,ListDbVersionsResponse> handler)
DatabaseAsync
Gets a list of supported Oracle Database versions.
listDbVersions
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ListMaintenanceRunsResponse> listMaintenanceRuns(ListMaintenanceRunsRequest request, AsyncHandler<ListMaintenanceRunsRequest,ListMaintenanceRunsResponse> handler)
DatabaseAsync
Gets a list of the Maintenance Runs in the specified compartment.
listMaintenanceRuns
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<ReinstateDataGuardAssociationResponse> reinstateDataGuardAssociation(ReinstateDataGuardAssociationRequest request, AsyncHandler<ReinstateDataGuardAssociationRequest,ReinstateDataGuardAssociationResponse> handler)
DatabaseAsync
Reinstates the database identified by the databaseId
parameter into the standby role in a Data Guard association.
reinstateDataGuardAssociation
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<RestartAutonomousContainerDatabaseResponse> restartAutonomousContainerDatabase(RestartAutonomousContainerDatabaseRequest request, AsyncHandler<RestartAutonomousContainerDatabaseRequest,RestartAutonomousContainerDatabaseResponse> handler)
DatabaseAsync
Rolling restarts the specified Autonomous Container Database.
restartAutonomousContainerDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<RestoreAutonomousDataWarehouseResponse> restoreAutonomousDataWarehouse(RestoreAutonomousDataWarehouseRequest request, AsyncHandler<RestoreAutonomousDataWarehouseRequest,RestoreAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To restore an Autonomous Data Warehouse, use the restoreAutonomousDatabase
operation.
restoreAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<RestoreAutonomousDatabaseResponse> restoreAutonomousDatabase(RestoreAutonomousDatabaseRequest request, AsyncHandler<RestoreAutonomousDatabaseRequest,RestoreAutonomousDatabaseResponse> handler)
DatabaseAsync
Restores an Autonomous Database based on the provided request parameters.
restoreAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<RestoreDatabaseResponse> restoreDatabase(RestoreDatabaseRequest request, AsyncHandler<RestoreDatabaseRequest,RestoreDatabaseResponse> handler)
DatabaseAsync
Restore a Database based on the request parameters you provide.
restoreDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<StartAutonomousDataWarehouseResponse> startAutonomousDataWarehouse(StartAutonomousDataWarehouseRequest request, AsyncHandler<StartAutonomousDataWarehouseRequest,StartAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To start an Autonomous Data Warehouse, use the startAutonomousDatabase
operation.
startAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<StartAutonomousDatabaseResponse> startAutonomousDatabase(StartAutonomousDatabaseRequest request, AsyncHandler<StartAutonomousDatabaseRequest,StartAutonomousDatabaseResponse> handler)
DatabaseAsync
Starts the specified Autonomous Database.
startAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<StopAutonomousDataWarehouseResponse> stopAutonomousDataWarehouse(StopAutonomousDataWarehouseRequest request, AsyncHandler<StopAutonomousDataWarehouseRequest,StopAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To stop an Autonomous Data Warehouse, use the stopAutonomousDatabase
operation.
stopAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<StopAutonomousDatabaseResponse> stopAutonomousDatabase(StopAutonomousDatabaseRequest request, AsyncHandler<StopAutonomousDatabaseRequest,StopAutonomousDatabaseResponse> handler)
DatabaseAsync
Stops the specified Autonomous Database.
stopAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<SwitchoverDataGuardAssociationResponse> switchoverDataGuardAssociation(SwitchoverDataGuardAssociationRequest request, AsyncHandler<SwitchoverDataGuardAssociationRequest,SwitchoverDataGuardAssociationResponse> handler)
DatabaseAsync
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.
switchoverDataGuardAssociation
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<TerminateAutonomousContainerDatabaseResponse> terminateAutonomousContainerDatabase(TerminateAutonomousContainerDatabaseRequest request, AsyncHandler<TerminateAutonomousContainerDatabaseRequest,TerminateAutonomousContainerDatabaseResponse> handler)
DatabaseAsync
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.
terminateAutonomousContainerDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<TerminateAutonomousExadataInfrastructureResponse> terminateAutonomousExadataInfrastructure(TerminateAutonomousExadataInfrastructureRequest request, AsyncHandler<TerminateAutonomousExadataInfrastructureRequest,TerminateAutonomousExadataInfrastructureResponse> handler)
DatabaseAsync
Terminates an Autonomous Exadata Infrastructure, which permanently deletes the Exadata Infrastructure and any container databases and databases contained in the Exadata Infrastructure. The database data is local to the Autonomous Exadata Infrastructure and will be lost when the system is terminated. Oracle recommends that you back up any data in the Autonomous Exadata Infrastructure prior to terminating it.
terminateAutonomousExadataInfrastructure
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<TerminateDbSystemResponse> terminateDbSystem(TerminateDbSystemRequest request, AsyncHandler<TerminateDbSystemRequest,TerminateDbSystemResponse> handler)
DatabaseAsync
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.
terminateDbSystem
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateAutonomousContainerDatabaseResponse> updateAutonomousContainerDatabase(UpdateAutonomousContainerDatabaseRequest request, AsyncHandler<UpdateAutonomousContainerDatabaseRequest,UpdateAutonomousContainerDatabaseResponse> handler)
DatabaseAsync
Updates the properties of an Autonomous Container Database, such as the CPU core count and storage size.
updateAutonomousContainerDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateAutonomousDataWarehouseResponse> updateAutonomousDataWarehouse(UpdateAutonomousDataWarehouseRequest request, AsyncHandler<UpdateAutonomousDataWarehouseRequest,UpdateAutonomousDataWarehouseResponse> handler)
DatabaseAsync
Deprecated. To update the CPU core count and storage size of an Autonomous Data Warehouse, use the updateAutonomousDatabase
operation.
updateAutonomousDataWarehouse
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateAutonomousDatabaseResponse> updateAutonomousDatabase(UpdateAutonomousDatabaseRequest request, AsyncHandler<UpdateAutonomousDatabaseRequest,UpdateAutonomousDatabaseResponse> handler)
DatabaseAsync
Updates the specified Autonomous Database with a new CPU core count and size.
updateAutonomousDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateAutonomousExadataInfrastructureResponse> updateAutonomousExadataInfrastructure(UpdateAutonomousExadataInfrastructureRequest request, AsyncHandler<UpdateAutonomousExadataInfrastructureRequest,UpdateAutonomousExadataInfrastructureResponse> handler)
DatabaseAsync
Updates the properties of an Autonomous Exadata Infrastructure, such as the CPU core count.
updateAutonomousExadataInfrastructure
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateDatabaseResponse> updateDatabase(UpdateDatabaseRequest request, AsyncHandler<UpdateDatabaseRequest,UpdateDatabaseResponse> handler)
DatabaseAsync
Update a Database based on the request parameters you provide.
updateDatabase
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateDbHomeResponse> updateDbHome(UpdateDbHomeRequest request, AsyncHandler<UpdateDbHomeRequest,UpdateDbHomeResponse> handler)
DatabaseAsync
Patches the specified dbHome.
updateDbHome
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateDbSystemResponse> updateDbSystem(UpdateDbSystemRequest request, AsyncHandler<UpdateDbSystemRequest,UpdateDbSystemResponse> handler)
DatabaseAsync
Updates the properties of a DB system, such as the CPU core count.
updateDbSystem
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateExadataIormConfigResponse> updateExadataIormConfig(UpdateExadataIormConfigRequest request, AsyncHandler<UpdateExadataIormConfigRequest,UpdateExadataIormConfigResponse> handler)
DatabaseAsync
Update IORM
Settings for the requested Exadata DB System.
updateExadataIormConfig
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.public Future<UpdateMaintenanceRunResponse> updateMaintenanceRun(UpdateMaintenanceRunRequest request, AsyncHandler<UpdateMaintenanceRunRequest,UpdateMaintenanceRunResponse> handler)
DatabaseAsync
Updates the properties of a Maintenance Run, such as the state of a Maintenance Run.
updateMaintenanceRun
in interface DatabaseAsync
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Copyright © 2016–2019. All rights reserved.