com.amazonaws.services.databasemigrationservice.AWSDatabaseMigrationService Maven / Gradle / Ivy
/*
* Copyright 2012-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.databasemigrationservice;
import javax.annotation.Generated;
import com.amazonaws.*;
import com.amazonaws.regions.*;
import com.amazonaws.services.databasemigrationservice.model.*;
/**
* Interface for accessing AWS Database Migration Service.
*
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
* {@link com.amazonaws.services.databasemigrationservice.AbstractAWSDatabaseMigrationService} instead.
*
*
* AWS Database Migration Service
*
* AWS Database Migration Service (AWS DMS) can migrate your data to and from the most widely used commercial and
* open-source databases such as Oracle, PostgreSQL, Microsoft SQL Server, Amazon Redshift, MariaDB, Amazon Aurora,
* MySQL, and SAP Adaptive Server Enterprise (ASE). The service supports homogeneous migrations such as Oracle to
* Oracle, as well as heterogeneous migrations between different database platforms, such as Oracle to MySQL or SQL
* Server to PostgreSQL.
*
*
* For more information about AWS DMS, see the AWS DMS user guide at What Is AWS Database Migration Service?
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AWSDatabaseMigrationService {
/**
* The region metadata service name for computing region endpoints. You can use this value to retrieve metadata
* (such as supported regions) of the service.
*
* @see RegionUtils#getRegionsForService(String)
*/
String ENDPOINT_PREFIX = "dms";
/**
* Overrides the default endpoint for this client ("dms.us-east-1.amazonaws.com"). Callers can use this method to
* control which AWS region they want to work with.
*
* Callers can pass in just the endpoint (ex: "dms.us-east-1.amazonaws.com") or a full URL, including the protocol
* (ex: "dms.us-east-1.amazonaws.com"). If the protocol is not specified here, the default protocol from this
* client's {@link ClientConfiguration} will be used, which by default is HTTPS.
*
* For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available
* endpoints for all AWS services, see:
* http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912
*
* This method is not threadsafe. An endpoint should be configured when the client is created and before any
* service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in
* transit or retrying.
*
* @param endpoint
* The endpoint (ex: "dms.us-east-1.amazonaws.com") or a full URL, including the protocol (ex:
* "dms.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will communicate with.
* @deprecated use {@link AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)} for
* example:
* {@code builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));}
*/
@Deprecated
void setEndpoint(String endpoint);
/**
* An alternative to {@link AWSDatabaseMigrationService#setEndpoint(String)}, sets the regional endpoint for this
* client's service calls. Callers can use this method to control which AWS region they want to work with.
*
* By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
* {@link ClientConfiguration} supplied at construction.
*
* This method is not threadsafe. A region should be configured when the client is created and before any service
* requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit
* or retrying.
*
* @param region
* The region this client will communicate with. See {@link Region#getRegion(com.amazonaws.regions.Regions)}
* for accessing a given region. Must not be null and must be a region where the service is available.
*
* @see Region#getRegion(com.amazonaws.regions.Regions)
* @see Region#createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
* @see Region#isServiceSupported(String)
* @deprecated use {@link AwsClientBuilder#setRegion(String)}
*/
@Deprecated
void setRegion(Region region);
/**
*
* Adds metadata tags to a DMS resource, including replication instance, endpoint, security group, and migration
* task. These tags can also be used with cost allocation reporting to track cost associated with DMS resources, or
* used in a Condition statement in an IAM policy for DMS.
*
*
* @param addTagsToResourceRequest
* @return Result of the AddTagsToResource operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.AddTagsToResource
* @see AWS API
* Documentation
*/
AddTagsToResourceResult addTagsToResource(AddTagsToResourceRequest addTagsToResourceRequest);
/**
*
* Creates an endpoint using the provided settings.
*
*
* @param createEndpointRequest
* @return Result of the CreateEndpoint operation returned by the service.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws AccessDeniedException
* AWS DMS was denied access to the endpoint.
* @sample AWSDatabaseMigrationService.CreateEndpoint
* @see AWS API
* Documentation
*/
CreateEndpointResult createEndpoint(CreateEndpointRequest createEndpointRequest);
/**
*
* Creates an AWS DMS event notification subscription.
*
*
* You can specify the type of source (SourceType) you want to be notified of, provide a list of AWS
* DMS source IDs (SourceIds) that triggers the events, and provide a list of event categories (
* EventCategories) for events you want to be notified of. If you specify both the
* SourceType and SourceIds, such as SourceType = replication-instance and
* SourceIdentifier = my-replinstance, you will be notified of all the replication instance events for
* the specified source. If you specify a SourceType but don't specify a SourceIdentifier,
* you receive notice of the events for that source type for all your AWS DMS sources. If you don't specify either
* SourceType nor SourceIdentifier, you will be notified of events generated from all AWS
* DMS sources belonging to your customer account.
*
*
* For more information about AWS DMS events, see Working with Events and Notifications
* in the AWS Database MIgration Service User Guide.
*
*
* @param createEventSubscriptionRequest
* @return Result of the CreateEventSubscription operation returned by the service.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws SNSInvalidTopicException
* The SNS topic is invalid.
* @throws SNSNoAuthorizationException
* You are not authorized for the SNS subscription.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.CreateEventSubscription
* @see AWS
* API Documentation
*/
CreateEventSubscriptionResult createEventSubscription(CreateEventSubscriptionRequest createEventSubscriptionRequest);
/**
*
* Creates the replication instance using the specified parameters.
*
*
* @param createReplicationInstanceRequest
* @return Result of the CreateReplicationInstance operation returned by the service.
* @throws AccessDeniedException
* AWS DMS was denied access to the endpoint.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws InsufficientResourceCapacityException
* There are not enough resources allocated to the database migration.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @throws StorageQuotaExceededException
* The storage quota has been exceeded.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws ReplicationSubnetGroupDoesNotCoverEnoughAZsException
* The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
* group and add more AZs.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws InvalidSubnetException
* The subnet provided is invalid.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @sample AWSDatabaseMigrationService.CreateReplicationInstance
* @see AWS
* API Documentation
*/
CreateReplicationInstanceResult createReplicationInstance(CreateReplicationInstanceRequest createReplicationInstanceRequest);
/**
*
* Creates a replication subnet group given a list of the subnet IDs in a VPC.
*
*
* @param createReplicationSubnetGroupRequest
* @return Result of the CreateReplicationSubnetGroup operation returned by the service.
* @throws AccessDeniedException
* AWS DMS was denied access to the endpoint.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @throws ReplicationSubnetGroupDoesNotCoverEnoughAZsException
* The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
* group and add more AZs.
* @throws InvalidSubnetException
* The subnet provided is invalid.
* @sample AWSDatabaseMigrationService.CreateReplicationSubnetGroup
* @see AWS API Documentation
*/
CreateReplicationSubnetGroupResult createReplicationSubnetGroup(CreateReplicationSubnetGroupRequest createReplicationSubnetGroupRequest);
/**
*
* Creates a replication task using the specified parameters.
*
*
* @param createReplicationTaskRequest
* @return Result of the CreateReplicationTask operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @sample AWSDatabaseMigrationService.CreateReplicationTask
* @see AWS API
* Documentation
*/
CreateReplicationTaskResult createReplicationTask(CreateReplicationTaskRequest createReplicationTaskRequest);
/**
*
* Deletes the specified certificate.
*
*
* @param deleteCertificateRequest
* @return Result of the DeleteCertificate operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.DeleteCertificate
* @see AWS API
* Documentation
*/
DeleteCertificateResult deleteCertificate(DeleteCertificateRequest deleteCertificateRequest);
/**
*
* Deletes the specified endpoint.
*
*
*
* All tasks associated with the endpoint must be deleted before you can delete the endpoint.
*
*
*
*
* @param deleteEndpointRequest
* @return Result of the DeleteEndpoint operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.DeleteEndpoint
* @see AWS API
* Documentation
*/
DeleteEndpointResult deleteEndpoint(DeleteEndpointRequest deleteEndpointRequest);
/**
*
* Deletes an AWS DMS event subscription.
*
*
* @param deleteEventSubscriptionRequest
* @return Result of the DeleteEventSubscription operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.DeleteEventSubscription
* @see AWS
* API Documentation
*/
DeleteEventSubscriptionResult deleteEventSubscription(DeleteEventSubscriptionRequest deleteEventSubscriptionRequest);
/**
*
* Deletes the specified replication instance.
*
*
*
* You must delete any migration tasks that are associated with the replication instance before you can delete it.
*
*
*
*
* @param deleteReplicationInstanceRequest
* @return Result of the DeleteReplicationInstance operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DeleteReplicationInstance
* @see AWS
* API Documentation
*/
DeleteReplicationInstanceResult deleteReplicationInstance(DeleteReplicationInstanceRequest deleteReplicationInstanceRequest);
/**
*
* Deletes a subnet group.
*
*
* @param deleteReplicationSubnetGroupRequest
* @return Result of the DeleteReplicationSubnetGroup operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DeleteReplicationSubnetGroup
* @see AWS API Documentation
*/
DeleteReplicationSubnetGroupResult deleteReplicationSubnetGroup(DeleteReplicationSubnetGroupRequest deleteReplicationSubnetGroupRequest);
/**
*
* Deletes the specified replication task.
*
*
* @param deleteReplicationTaskRequest
* @return Result of the DeleteReplicationTask operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.DeleteReplicationTask
* @see AWS API
* Documentation
*/
DeleteReplicationTaskResult deleteReplicationTask(DeleteReplicationTaskRequest deleteReplicationTaskRequest);
/**
*
* Lists all of the AWS DMS attributes for a customer account. The attributes include AWS DMS quotas for the
* account, such as the number of replication instances allowed. The description for a quota includes the quota
* name, current usage toward that quota, and the quota's maximum value.
*
*
* This command does not take any parameters.
*
*
* @param describeAccountAttributesRequest
* @return Result of the DescribeAccountAttributes operation returned by the service.
* @sample AWSDatabaseMigrationService.DescribeAccountAttributes
* @see AWS
* API Documentation
*/
DescribeAccountAttributesResult describeAccountAttributes(DescribeAccountAttributesRequest describeAccountAttributesRequest);
/**
*
* Provides a description of the certificate.
*
*
* @param describeCertificatesRequest
* @return Result of the DescribeCertificates operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeCertificates
* @see AWS API
* Documentation
*/
DescribeCertificatesResult describeCertificates(DescribeCertificatesRequest describeCertificatesRequest);
/**
*
* Describes the status of the connections that have been made between the replication instance and an endpoint.
* Connections are created when you test an endpoint.
*
*
* @param describeConnectionsRequest
* @return Result of the DescribeConnections operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeConnections
* @see AWS API
* Documentation
*/
DescribeConnectionsResult describeConnections(DescribeConnectionsRequest describeConnectionsRequest);
/**
*
* Returns information about the type of endpoints available.
*
*
* @param describeEndpointTypesRequest
* @return Result of the DescribeEndpointTypes operation returned by the service.
* @sample AWSDatabaseMigrationService.DescribeEndpointTypes
* @see AWS API
* Documentation
*/
DescribeEndpointTypesResult describeEndpointTypes(DescribeEndpointTypesRequest describeEndpointTypesRequest);
/**
*
* Returns information about the endpoints for your account in the current region.
*
*
* @param describeEndpointsRequest
* @return Result of the DescribeEndpoints operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeEndpoints
* @see AWS API
* Documentation
*/
DescribeEndpointsResult describeEndpoints(DescribeEndpointsRequest describeEndpointsRequest);
/**
*
* Lists categories for all event source types, or, if specified, for a specified source type. You can see a list of
* the event categories and source types in Working with Events and Notifications
* in the AWS Database Migration Service User Guide.
*
*
* @param describeEventCategoriesRequest
* @return Result of the DescribeEventCategories operation returned by the service.
* @sample AWSDatabaseMigrationService.DescribeEventCategories
* @see AWS
* API Documentation
*/
DescribeEventCategoriesResult describeEventCategories(DescribeEventCategoriesRequest describeEventCategoriesRequest);
/**
*
* Lists all the event subscriptions for a customer account. The description of a subscription includes
* SubscriptionName, SNSTopicARN, CustomerID, SourceType,
* SourceID, CreationTime, and Status.
*
*
* If you specify SubscriptionName, this action lists the description for that subscription.
*
*
* @param describeEventSubscriptionsRequest
* @return Result of the DescribeEventSubscriptions operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeEventSubscriptions
* @see AWS
* API Documentation
*/
DescribeEventSubscriptionsResult describeEventSubscriptions(DescribeEventSubscriptionsRequest describeEventSubscriptionsRequest);
/**
*
* Lists events for a given source identifier and source type. You can also specify a start and end time. For more
* information on AWS DMS events, see
* Working with Events and Notifications .
*
*
* @param describeEventsRequest
* @return Result of the DescribeEvents operation returned by the service.
* @sample AWSDatabaseMigrationService.DescribeEvents
* @see AWS API
* Documentation
*/
DescribeEventsResult describeEvents(DescribeEventsRequest describeEventsRequest);
/**
*
* Returns information about the replication instance types that can be created in the specified region.
*
*
* @param describeOrderableReplicationInstancesRequest
* @return Result of the DescribeOrderableReplicationInstances operation returned by the service.
* @sample AWSDatabaseMigrationService.DescribeOrderableReplicationInstances
* @see AWS API Documentation
*/
DescribeOrderableReplicationInstancesResult describeOrderableReplicationInstances(
DescribeOrderableReplicationInstancesRequest describeOrderableReplicationInstancesRequest);
/**
*
* Returns the status of the RefreshSchemas operation.
*
*
* @param describeRefreshSchemasStatusRequest
* @return Result of the DescribeRefreshSchemasStatus operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeRefreshSchemasStatus
* @see AWS API Documentation
*/
DescribeRefreshSchemasStatusResult describeRefreshSchemasStatus(DescribeRefreshSchemasStatusRequest describeRefreshSchemasStatusRequest);
/**
*
* Returns information about replication instances for your account in the current region.
*
*
* @param describeReplicationInstancesRequest
* @return Result of the DescribeReplicationInstances operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeReplicationInstances
* @see AWS API Documentation
*/
DescribeReplicationInstancesResult describeReplicationInstances(DescribeReplicationInstancesRequest describeReplicationInstancesRequest);
/**
*
* Returns information about the replication subnet groups.
*
*
* @param describeReplicationSubnetGroupsRequest
* @return Result of the DescribeReplicationSubnetGroups operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeReplicationSubnetGroups
* @see AWS API Documentation
*/
DescribeReplicationSubnetGroupsResult describeReplicationSubnetGroups(DescribeReplicationSubnetGroupsRequest describeReplicationSubnetGroupsRequest);
/**
*
* Returns information about replication tasks for your account in the current region.
*
*
* @param describeReplicationTasksRequest
* @return Result of the DescribeReplicationTasks operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeReplicationTasks
* @see AWS
* API Documentation
*/
DescribeReplicationTasksResult describeReplicationTasks(DescribeReplicationTasksRequest describeReplicationTasksRequest);
/**
*
* Returns information about the schema for the specified endpoint.
*
*
*
* @param describeSchemasRequest
* @return Result of the DescribeSchemas operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.DescribeSchemas
* @see AWS API
* Documentation
*/
DescribeSchemasResult describeSchemas(DescribeSchemasRequest describeSchemasRequest);
/**
*
* Returns table statistics on the database migration task, including table name, rows inserted, rows updated, and
* rows deleted.
*
*
* @param describeTableStatisticsRequest
* @return Result of the DescribeTableStatistics operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.DescribeTableStatistics
* @see AWS
* API Documentation
*/
DescribeTableStatisticsResult describeTableStatistics(DescribeTableStatisticsRequest describeTableStatisticsRequest);
/**
*
* Uploads the specified certificate.
*
*
* @param importCertificateRequest
* @return Result of the ImportCertificate operation returned by the service.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws InvalidCertificateException
* The certificate was not valid.
* @sample AWSDatabaseMigrationService.ImportCertificate
* @see AWS API
* Documentation
*/
ImportCertificateResult importCertificate(ImportCertificateRequest importCertificateRequest);
/**
*
* Lists all tags for an AWS DMS resource.
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.ListTagsForResource
* @see AWS API
* Documentation
*/
ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest);
/**
*
* Modifies the specified endpoint.
*
*
* @param modifyEndpointRequest
* @return Result of the ModifyEndpoint operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @throws AccessDeniedException
* AWS DMS was denied access to the endpoint.
* @sample AWSDatabaseMigrationService.ModifyEndpoint
* @see AWS API
* Documentation
*/
ModifyEndpointResult modifyEndpoint(ModifyEndpointRequest modifyEndpointRequest);
/**
*
* Modifies an existing AWS DMS event notification subscription.
*
*
* @param modifyEventSubscriptionRequest
* @return Result of the ModifyEventSubscription operation returned by the service.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws SNSInvalidTopicException
* The SNS topic is invalid.
* @throws SNSNoAuthorizationException
* You are not authorized for the SNS subscription.
* @sample AWSDatabaseMigrationService.ModifyEventSubscription
* @see AWS
* API Documentation
*/
ModifyEventSubscriptionResult modifyEventSubscription(ModifyEventSubscriptionRequest modifyEventSubscriptionRequest);
/**
*
* Modifies the replication instance to apply new settings. You can change one or more parameters by specifying
* these parameters and the new values in the request.
*
*
* Some settings are applied during the maintenance window.
*
*
*
* @param modifyReplicationInstanceRequest
* @return Result of the ModifyReplicationInstance operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InsufficientResourceCapacityException
* There are not enough resources allocated to the database migration.
* @throws StorageQuotaExceededException
* The storage quota has been exceeded.
* @throws UpgradeDependencyFailureException
* An upgrade dependency is preventing the database migration.
* @sample AWSDatabaseMigrationService.ModifyReplicationInstance
* @see AWS
* API Documentation
*/
ModifyReplicationInstanceResult modifyReplicationInstance(ModifyReplicationInstanceRequest modifyReplicationInstanceRequest);
/**
*
* Modifies the settings for the specified replication subnet group.
*
*
* @param modifyReplicationSubnetGroupRequest
* @return Result of the ModifyReplicationSubnetGroup operation returned by the service.
* @throws AccessDeniedException
* AWS DMS was denied access to the endpoint.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @throws SubnetAlreadyInUseException
* The specified subnet is already in use.
* @throws ReplicationSubnetGroupDoesNotCoverEnoughAZsException
* The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
* group and add more AZs.
* @throws InvalidSubnetException
* The subnet provided is invalid.
* @sample AWSDatabaseMigrationService.ModifyReplicationSubnetGroup
* @see AWS API Documentation
*/
ModifyReplicationSubnetGroupResult modifyReplicationSubnetGroup(ModifyReplicationSubnetGroupRequest modifyReplicationSubnetGroupRequest);
/**
*
* Modifies the specified replication task.
*
*
* You can't modify the task endpoints. The task must be stopped before you can modify it.
*
*
* For more information about AWS DMS tasks, see the AWS DMS user guide at Working with Migration Tasks
*
*
* @param modifyReplicationTaskRequest
* @return Result of the ModifyReplicationTask operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws ResourceAlreadyExistsException
* The resource you are attempting to create already exists.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @sample AWSDatabaseMigrationService.ModifyReplicationTask
* @see AWS API
* Documentation
*/
ModifyReplicationTaskResult modifyReplicationTask(ModifyReplicationTaskRequest modifyReplicationTaskRequest);
/**
*
* Populates the schema for the specified endpoint. This is an asynchronous operation and can take several minutes.
* You can check the status of this operation by calling the DescribeRefreshSchemasStatus operation.
*
*
* @param refreshSchemasRequest
* @return Result of the RefreshSchemas operation returned by the service.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @sample AWSDatabaseMigrationService.RefreshSchemas
* @see AWS API
* Documentation
*/
RefreshSchemasResult refreshSchemas(RefreshSchemasRequest refreshSchemasRequest);
/**
*
* Reloads the target database table with the source data.
*
*
* @param reloadTablesRequest
* @return Result of the ReloadTables operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.ReloadTables
* @see AWS API
* Documentation
*/
ReloadTablesResult reloadTables(ReloadTablesRequest reloadTablesRequest);
/**
*
* Removes metadata tags from a DMS resource.
*
*
* @param removeTagsFromResourceRequest
* @return Result of the RemoveTagsFromResource operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @sample AWSDatabaseMigrationService.RemoveTagsFromResource
* @see AWS API
* Documentation
*/
RemoveTagsFromResourceResult removeTagsFromResource(RemoveTagsFromResourceRequest removeTagsFromResourceRequest);
/**
*
* Starts the replication task.
*
*
* For more information about AWS DMS tasks, see the AWS DMS user guide at Working with Migration Tasks
*
*
* @param startReplicationTaskRequest
* @return Result of the StartReplicationTask operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.StartReplicationTask
* @see AWS API
* Documentation
*/
StartReplicationTaskResult startReplicationTask(StartReplicationTaskRequest startReplicationTaskRequest);
/**
*
* Stops the replication task.
*
*
*
* @param stopReplicationTaskRequest
* @return Result of the StopReplicationTask operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @sample AWSDatabaseMigrationService.StopReplicationTask
* @see AWS API
* Documentation
*/
StopReplicationTaskResult stopReplicationTask(StopReplicationTaskRequest stopReplicationTaskRequest);
/**
*
* Tests the connection between the replication instance and the endpoint.
*
*
* @param testConnectionRequest
* @return Result of the TestConnection operation returned by the service.
* @throws ResourceNotFoundException
* The resource could not be found.
* @throws InvalidResourceStateException
* The resource is in a state that prevents it from being used for database migration.
* @throws KMSKeyNotAccessibleException
* AWS DMS cannot access the KMS key.
* @throws ResourceQuotaExceededException
* The quota for this resource quota has been exceeded.
* @sample AWSDatabaseMigrationService.TestConnection
* @see AWS API
* Documentation
*/
TestConnectionResult testConnection(TestConnectionRequest testConnectionRequest);
/**
* Shuts down this client object, releasing any resources that might be held open. This is an optional method, and
* callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client
* has been shutdown, it should not be used to make any more requests.
*/
void shutdown();
/**
* Returns additional metadata for a previously executed successful request, typically used for debugging issues
* where a service isn't acting as expected. This data isn't considered part of the result data returned by an
* operation, so it's available through this separate, diagnostic interface.
*
* Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic
* information for an executed request, you should use this method to retrieve it as soon as possible after
* executing a request.
*
* @param request
* The originally executed request.
*
* @return The response metadata for the specified request, or null if none is available.
*/
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request);
}