@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSDatabaseMigrationServiceClient extends AmazonWebServiceClient implements AWSDatabaseMigrationService
Database Migration Service (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 DMS, see What Is Database Migration Service? in the Database Migration Service User Guide.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Constructor and Description |
---|
AWSDatabaseMigrationServiceClient()
Deprecated.
|
AWSDatabaseMigrationServiceClient(AWSCredentials awsCredentials)
Deprecated.
use
AwsClientBuilder.withCredentials(AWSCredentialsProvider) for
example:
AWSDatabaseMigrationServiceClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build(); |
AWSDatabaseMigrationServiceClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
|
AWSDatabaseMigrationServiceClient(AWSCredentialsProvider awsCredentialsProvider)
Deprecated.
|
AWSDatabaseMigrationServiceClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
|
AWSDatabaseMigrationServiceClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
|
AWSDatabaseMigrationServiceClient(ClientConfiguration clientConfiguration)
Deprecated.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
setEndpoint, setRegion
@Deprecated public AWSDatabaseMigrationServiceClient()
AWSDatabaseMigrationServiceClientBuilder.defaultClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
@Deprecated public AWSDatabaseMigrationServiceClient(ClientConfiguration clientConfiguration)
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this client connects to AWS Database Migration Service
(ex: proxy settings, retry counts, etc.).DefaultAWSCredentialsProviderChain
@Deprecated public AWSDatabaseMigrationServiceClient(AWSCredentials awsCredentials)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
for
example:
AWSDatabaseMigrationServiceClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.@Deprecated public AWSDatabaseMigrationServiceClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to AWS Database Migration Service
(ex: proxy settings, retry counts, etc.).@Deprecated public AWSDatabaseMigrationServiceClient(AWSCredentialsProvider awsCredentialsProvider)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.@Deprecated public AWSDatabaseMigrationServiceClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to AWS Database Migration Service
(ex: proxy settings, retry counts, etc.).@Deprecated public AWSDatabaseMigrationServiceClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
AwsClientBuilder.withCredentials(AWSCredentialsProvider)
and
AwsClientBuilder.withClientConfiguration(ClientConfiguration)
and
AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to AWS Database Migration Service
(ex: proxy settings, retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic static AWSDatabaseMigrationServiceClientBuilder builder()
public AddTagsToResourceResult addTagsToResource(AddTagsToResourceRequest request)
Adds metadata tags to an DMS resource, including replication instance, endpoint, subnet 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. For more information, see Tag
data type
description.
addTagsToResource
in interface AWSDatabaseMigrationService
addTagsToResourceRequest
- Associates a set of tags with an DMS resource.ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); AddTagsToResourceRequest request = new AddTagsToResourceRequest() //Required. Use the ARN of the resource you want to tag. .withResourceArn("arn:aws:dms:us-east-1:123456789012:endpoint:ASXWXJZLNWNT5HTWCGV2BUJQ7E")//Required. Use the Key/Value pair format. .withTags(new Tag().withKey("Acount").withValue("1633456")); AddTagsToResourceResult response = client.addTagsToResource(request);
public ApplyPendingMaintenanceActionResult applyPendingMaintenanceAction(ApplyPendingMaintenanceActionRequest request)
Applies a pending maintenance action to a resource (for example, to a replication instance).
applyPendingMaintenanceAction
in interface AWSDatabaseMigrationService
applyPendingMaintenanceActionRequest
- ResourceNotFoundException
- The resource could not be found.public BatchStartRecommendationsResult batchStartRecommendations(BatchStartRecommendationsRequest request)
Starts the analysis of up to 20 source databases to recommend target engines for each source database. This is a batch version of StartRecommendations .
The result of analysis of each source database is reported individually in the response. Because the batch
request can result in a combination of successful and unsuccessful actions, you should check for batch errors
even when the call returns an HTTP status code of 200
.
batchStartRecommendations
in interface AWSDatabaseMigrationService
batchStartRecommendationsRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.public CancelReplicationTaskAssessmentRunResult cancelReplicationTaskAssessmentRun(CancelReplicationTaskAssessmentRunRequest request)
Cancels a single premigration assessment run.
This operation prevents any individual assessments from running if they haven't started running. It also attempts to cancel any individual assessments that are currently running.
cancelReplicationTaskAssessmentRun
in interface AWSDatabaseMigrationService
cancelReplicationTaskAssessmentRunRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public CreateDataProviderResult createDataProvider(CreateDataProviderRequest request)
Creates a data provider using the provided settings. A data provider stores a data store type and location information about your database.
createDataProvider
in interface AWSDatabaseMigrationService
createDataProviderRequest
- ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.public CreateEndpointResult createEndpoint(CreateEndpointRequest request)
Creates an endpoint using the provided settings.
For a MySQL source or target endpoint, don't explicitly specify the database using the DatabaseName
request parameter on the CreateEndpoint
API call. Specifying DatabaseName
when you
create a MySQL endpoint replicates all the task tables to this single database. For MySQL endpoints, you specify
the database only when you specify the schema in the table-mapping rules of the DMS task.
createEndpoint
in interface AWSDatabaseMigrationService
createEndpointRequest
- KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); CreateEndpointRequest request = new CreateEndpointRequest().withEndpointIdentifier("test-endpoint-1").withEndpointType("source") .withEngineName("mysql").withUsername("username").withPassword("pasword").withServerName("mydb.cx1llnox7iyx.us-west-2.rds.amazonaws.com") .withPort(3306).withDatabaseName("testdb").withExtraConnectionAttributes("") .withKmsKeyId("arn:aws:kms:us-east-1:123456789012:key/4c1731d6-5435-ed4d-be13-d53411a7cfbd") .withTags(new Tag().withKey("Acount").withValue("143327655")).withCertificateArn("").withSslMode("require"); CreateEndpointResult response = client.createEndpoint(request);
public CreateEventSubscriptionResult createEventSubscription(CreateEventSubscriptionRequest request)
Creates an DMS event notification subscription.
You can specify the type of source (SourceType
) you want to be notified of, provide a list of 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 DMS sources. If you don't specify either
SourceType
nor SourceIdentifier
, you will be notified of events generated from all DMS
sources belonging to your customer account.
For more information about DMS events, see Working with Events and Notifications in the Database Migration Service User Guide.
createEventSubscription
in interface AWSDatabaseMigrationService
createEventSubscriptionRequest
- ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.ResourceNotFoundException
- The resource could not be found.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.SNSInvalidTopicException
- The SNS topic is invalid.SNSNoAuthorizationException
- You are not authorized for the SNS subscription.KMSAccessDeniedException
- The ciphertext references a key that doesn't exist or that the DMS account doesn't have access to.KMSDisabledException
- The specified KMS key isn't enabled.KMSInvalidStateException
- The state of the specified KMS resource isn't valid for this request.KMSNotFoundException
- The specified KMS entity or resource can't be found.KMSThrottlingException
- This request triggered KMS request throttling.public CreateFleetAdvisorCollectorResult createFleetAdvisorCollector(CreateFleetAdvisorCollectorRequest request)
Creates a Fleet Advisor collector using the specified parameters.
createFleetAdvisorCollector
in interface AWSDatabaseMigrationService
createFleetAdvisorCollectorRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.public CreateInstanceProfileResult createInstanceProfile(CreateInstanceProfileRequest request)
Creates the instance profile using the specified parameters.
createInstanceProfile
in interface AWSDatabaseMigrationService
createInstanceProfileRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public CreateMigrationProjectResult createMigrationProject(CreateMigrationProjectRequest request)
Creates the migration project using the specified parameters.
You can run this action only after you create an instance profile and data providers using CreateInstanceProfile and CreateDataProvider.
createMigrationProject
in interface AWSDatabaseMigrationService
createMigrationProjectRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.ResourceNotFoundException
- The resource could not be found.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public CreateReplicationConfigResult createReplicationConfig(CreateReplicationConfigRequest request)
Creates a configuration that you can later provide to configure and start an DMS Serverless replication. You can also provide options to validate the configuration inputs before you start the replication.
createReplicationConfig
in interface AWSDatabaseMigrationService
createReplicationConfigRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ReplicationSubnetGroupDoesNotCoverEnoughAZsException
- The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
group and add more AZs.InvalidSubnetException
- The subnet provided isn't valid.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.public CreateReplicationInstanceResult createReplicationInstance(CreateReplicationInstanceRequest request)
Creates the replication instance using the specified parameters.
DMS requires that your account have certain roles with appropriate permissions before you can create a replication instance. For information on the required roles, see Creating the IAM Roles to Use With the CLI and DMS API. For information on the required permissions, see IAM Permissions Needed to Use DMS.
If you don't specify a version when creating a replication instance, DMS will create the instance using the default engine version. For information about the default engine version, see Release Notes.
createReplicationInstance
in interface AWSDatabaseMigrationService
createReplicationInstanceRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.InsufficientResourceCapacityException
- There are not enough resources allocated to the database migration.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.StorageQuotaExceededException
- The storage quota has been exceeded.ResourceNotFoundException
- The resource could not be found.ReplicationSubnetGroupDoesNotCoverEnoughAZsException
- The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
group and add more AZs.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.InvalidSubnetException
- The subnet provided isn't valid.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); CreateReplicationInstanceRequest request = new CreateReplicationInstanceRequest().withReplicationInstanceIdentifier("").withAllocatedStorage(123) .withReplicationInstanceClass("").withVpcSecurityGroupIds(new ArrayList()).withAvailabilityZone("").withReplicationSubnetGroupIdentifier("") .withPreferredMaintenanceWindow("").withMultiAZ(true).withEngineVersion("").withAutoMinorVersionUpgrade(true) .withTags(new Tag().withKey("string").withValue("string")).withKmsKeyId("").withPubliclyAccessible(true); CreateReplicationInstanceResult response = client.createReplicationInstance(request);
public CreateReplicationSubnetGroupResult createReplicationSubnetGroup(CreateReplicationSubnetGroupRequest request)
Creates a replication subnet group given a list of the subnet IDs in a VPC.
The VPC needs to have at least one subnet in at least two availability zones in the Amazon Web Services Region,
otherwise the service will throw a ReplicationSubnetGroupDoesNotCoverEnoughAZs
exception.
If a replication subnet group exists in your Amazon Web Services account, the CreateReplicationSubnetGroup action returns the following error message: The Replication Subnet Group already exists. In this case, delete the existing replication subnet group. To do so, use the DeleteReplicationSubnetGroup action. Optionally, choose Subnet groups in the DMS console, then choose your subnet group. Next, choose Delete from Actions.
createReplicationSubnetGroup
in interface AWSDatabaseMigrationService
createReplicationSubnetGroupRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.ReplicationSubnetGroupDoesNotCoverEnoughAZsException
- The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
group and add more AZs.InvalidSubnetException
- The subnet provided isn't valid.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); CreateReplicationSubnetGroupRequest request = new CreateReplicationSubnetGroupRequest() .withReplicationSubnetGroupIdentifier("us-west-2ab-vpc-215ds366").withReplicationSubnetGroupDescription("US West subnet group") .withSubnetIds("subnet-e145356n", "subnet-58f79200").withTags(new Tag().withKey("Acount").withValue("145235")); CreateReplicationSubnetGroupResult response = client.createReplicationSubnetGroup(request);
public CreateReplicationTaskResult createReplicationTask(CreateReplicationTaskRequest request)
Creates a replication task using the specified parameters.
createReplicationTask
in interface AWSDatabaseMigrationService
createReplicationTaskRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); CreateReplicationTaskRequest request = new CreateReplicationTaskRequest().withReplicationTaskIdentifier("task1") .withSourceEndpointArn("arn:aws:dms:us-east-1:123456789012:endpoint:ZW5UAN6P4E77EC7YWHK4RZZ3BE") .withTargetEndpointArn("arn:aws:dms:us-east-1:123456789012:endpoint:ASXWXJZLNWNT5HTWCGV2BUJQ7E") .withReplicationInstanceArn("arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ").withMigrationType("full-load") .withTableMappings("file://mappingfile.json").withReplicationTaskSettings("").withCdcStartTime(new Date("2016-12-14T18:25:43Z")) .withTags(new Tag().withKey("Acount").withValue("24352226")); CreateReplicationTaskResult response = client.createReplicationTask(request);
public DeleteCertificateResult deleteCertificate(DeleteCertificateRequest request)
Deletes the specified certificate.
deleteCertificate
in interface AWSDatabaseMigrationService
deleteCertificateRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DeleteCertificateRequest request = new DeleteCertificateRequest().withCertificateArn("arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUSM457DE6XFJCJQ"); DeleteCertificateResult response = client.deleteCertificate(request);
public DeleteConnectionResult deleteConnection(DeleteConnectionRequest request)
Deletes the connection between a replication instance and an endpoint.
deleteConnection
in interface AWSDatabaseMigrationService
deleteConnectionRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DeleteDataProviderResult deleteDataProvider(DeleteDataProviderRequest request)
Deletes the specified data provider.
All migration projects associated with the data provider must be deleted or modified before you can delete the data provider.
deleteDataProvider
in interface AWSDatabaseMigrationService
deleteDataProviderRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DeleteEndpointResult deleteEndpoint(DeleteEndpointRequest request)
Deletes the specified endpoint.
All tasks associated with the endpoint must be deleted before you can delete the endpoint.
deleteEndpoint
in interface AWSDatabaseMigrationService
deleteEndpointRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DeleteEndpointRequest request = new DeleteEndpointRequest().withEndpointArn("arn:aws:dms:us-east-1:123456789012:endpoint:RAAR3R22XSH46S3PWLC3NJAWKM"); DeleteEndpointResult response = client.deleteEndpoint(request);
public DeleteEventSubscriptionResult deleteEventSubscription(DeleteEventSubscriptionRequest request)
Deletes an DMS event subscription.
deleteEventSubscription
in interface AWSDatabaseMigrationService
deleteEventSubscriptionRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DeleteFleetAdvisorCollectorResult deleteFleetAdvisorCollector(DeleteFleetAdvisorCollectorRequest request)
Deletes the specified Fleet Advisor collector.
deleteFleetAdvisorCollector
in interface AWSDatabaseMigrationService
deleteFleetAdvisorCollectorRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.CollectorNotFoundException
- The specified collector doesn't exist.public DeleteFleetAdvisorDatabasesResult deleteFleetAdvisorDatabases(DeleteFleetAdvisorDatabasesRequest request)
Deletes the specified Fleet Advisor collector databases.
deleteFleetAdvisorDatabases
in interface AWSDatabaseMigrationService
deleteFleetAdvisorDatabasesRequest
- ResourceNotFoundException
- The resource could not be found.InvalidOperationException
- The action or operation requested isn't valid.public DeleteInstanceProfileResult deleteInstanceProfile(DeleteInstanceProfileRequest request)
Deletes the specified instance profile.
All migration projects associated with the instance profile must be deleted or modified before you can delete the instance profile.
deleteInstanceProfile
in interface AWSDatabaseMigrationService
deleteInstanceProfileRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DeleteMigrationProjectResult deleteMigrationProject(DeleteMigrationProjectRequest request)
Deletes the specified migration project.
The migration project must be closed before you can delete it.
deleteMigrationProject
in interface AWSDatabaseMigrationService
deleteMigrationProjectRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DeleteReplicationConfigResult deleteReplicationConfig(DeleteReplicationConfigRequest request)
Deletes an DMS Serverless replication configuration. This effectively deprovisions any and all replications that use this configuration. You can't delete the configuration for an DMS Serverless replication that is ongoing. You can delete the configuration when the replication is in a non-RUNNING and non-STARTING state.
deleteReplicationConfig
in interface AWSDatabaseMigrationService
deleteReplicationConfigRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DeleteReplicationInstanceResult deleteReplicationInstance(DeleteReplicationInstanceRequest request)
Deletes the specified replication instance.
You must delete any migration tasks that are associated with the replication instance before you can delete it.
deleteReplicationInstance
in interface AWSDatabaseMigrationService
deleteReplicationInstanceRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DeleteReplicationInstanceRequest request = new DeleteReplicationInstanceRequest() .withReplicationInstanceArn("arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ"); DeleteReplicationInstanceResult response = client.deleteReplicationInstance(request);
public DeleteReplicationSubnetGroupResult deleteReplicationSubnetGroup(DeleteReplicationSubnetGroupRequest request)
Deletes a subnet group.
deleteReplicationSubnetGroup
in interface AWSDatabaseMigrationService
deleteReplicationSubnetGroupRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DeleteReplicationSubnetGroupRequest request = new DeleteReplicationSubnetGroupRequest() .withReplicationSubnetGroupIdentifier("us-west-2ab-vpc-215ds366"); DeleteReplicationSubnetGroupResult response = client.deleteReplicationSubnetGroup(request);
public DeleteReplicationTaskResult deleteReplicationTask(DeleteReplicationTaskRequest request)
Deletes the specified replication task.
deleteReplicationTask
in interface AWSDatabaseMigrationService
deleteReplicationTaskRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DeleteReplicationTaskRequest request = new DeleteReplicationTaskRequest() .withReplicationTaskArn("arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ"); DeleteReplicationTaskResult response = client.deleteReplicationTask(request);
public DeleteReplicationTaskAssessmentRunResult deleteReplicationTaskAssessmentRun(DeleteReplicationTaskAssessmentRunRequest request)
Deletes the record of a single premigration assessment run.
This operation removes all metadata that DMS maintains about this assessment run. However, the operation leaves untouched all information about this assessment run that is stored in your Amazon S3 bucket.
deleteReplicationTaskAssessmentRun
in interface AWSDatabaseMigrationService
deleteReplicationTaskAssessmentRunRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeAccountAttributesResult describeAccountAttributes(DescribeAccountAttributesRequest request)
Lists all of the DMS attributes for a customer account. These attributes include DMS quotas for the account and a unique account identifier in a particular DMS region. DMS quotas include a list of resource quotas supported by the account, such as the number of replication instances allowed. The description for each resource quota, includes the quota name, current usage toward that quota, and the quota's maximum value. DMS uses the unique account identifier to name each artifact used by DMS in the given region.
This command does not take any parameters.
describeAccountAttributes
in interface AWSDatabaseMigrationService
describeAccountAttributesRequest
- AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeAccountAttributesRequest request = new DescribeAccountAttributesRequest(); DescribeAccountAttributesResult response = client.describeAccountAttributes(request);
public DescribeApplicableIndividualAssessmentsResult describeApplicableIndividualAssessments(DescribeApplicableIndividualAssessmentsRequest request)
Provides a list of individual assessments that you can specify for a new premigration assessment run, given one or more parameters.
If you specify an existing migration task, this operation provides the default individual assessments you can specify for that task. Otherwise, the specified parameters model elements of a possible migration task on which to base a premigration assessment run.
To use these migration task modeling parameters, you must specify an existing replication instance, a source database engine, a target database engine, and a migration type. This combination of parameters potentially limits the default individual assessments available for an assessment run created for a corresponding migration task.
If you specify no parameters, this operation provides a list of all possible individual assessments that you can specify for an assessment run. If you specify any one of the task modeling parameters, you must specify all of them or the operation cannot provide a list of individual assessments. The only parameter that you can specify alone is for an existing migration task. The specified task definition then determines the default list of individual assessments that you can specify in an assessment run for the task.
describeApplicableIndividualAssessments
in interface AWSDatabaseMigrationService
describeApplicableIndividualAssessmentsRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeCertificatesResult describeCertificates(DescribeCertificatesRequest request)
Provides a description of the certificate.
describeCertificates
in interface AWSDatabaseMigrationService
describeCertificatesRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeCertificatesRequest request = new DescribeCertificatesRequest().withFilters(new Filter().withName("string").withValues("string", "string")) .withMaxRecords(123).withMarker(""); DescribeCertificatesResult response = client.describeCertificates(request);
public DescribeConnectionsResult describeConnections(DescribeConnectionsRequest request)
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.
describeConnections
in interface AWSDatabaseMigrationService
describeConnectionsRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeConnectionsRequest request = new DescribeConnectionsRequest().withFilters(new Filter().withName("string").withValues("string", "string")) .withMaxRecords(123).withMarker(""); DescribeConnectionsResult response = client.describeConnections(request);
public DescribeConversionConfigurationResult describeConversionConfiguration(DescribeConversionConfigurationRequest request)
Returns configuration parameters for a schema conversion project.
describeConversionConfiguration
in interface AWSDatabaseMigrationService
describeConversionConfigurationRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeDataProvidersResult describeDataProviders(DescribeDataProvidersRequest request)
Returns a paginated list of data providers for your account in the current region.
describeDataProviders
in interface AWSDatabaseMigrationService
describeDataProvidersRequest
- ResourceNotFoundException
- The resource could not be found.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public DescribeEndpointSettingsResult describeEndpointSettings(DescribeEndpointSettingsRequest request)
Returns information about the possible endpoint settings available when you create an endpoint for a specific database engine.
describeEndpointSettings
in interface AWSDatabaseMigrationService
describeEndpointSettingsRequest
- public DescribeEndpointTypesResult describeEndpointTypes(DescribeEndpointTypesRequest request)
Returns information about the type of endpoints available.
describeEndpointTypes
in interface AWSDatabaseMigrationService
describeEndpointTypesRequest
- AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeEndpointTypesRequest request = new DescribeEndpointTypesRequest().withFilters(new Filter().withName("string").withValues("string", "string")) .withMaxRecords(123).withMarker(""); DescribeEndpointTypesResult response = client.describeEndpointTypes(request);
public DescribeEndpointsResult describeEndpoints(DescribeEndpointsRequest request)
Returns information about the endpoints for your account in the current region.
describeEndpoints
in interface AWSDatabaseMigrationService
describeEndpointsRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeEndpointsRequest request = new DescribeEndpointsRequest().withFilters(new Filter().withName("string").withValues("string", "string")) .withMaxRecords(123).withMarker(""); DescribeEndpointsResult response = client.describeEndpoints(request);
public DescribeEngineVersionsResult describeEngineVersions(DescribeEngineVersionsRequest request)
Returns information about the replication instance versions used in the project.
describeEngineVersions
in interface AWSDatabaseMigrationService
describeEngineVersionsRequest
- public DescribeEventCategoriesResult describeEventCategories(DescribeEventCategoriesRequest request)
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 Database Migration Service User Guide.
describeEventCategories
in interface AWSDatabaseMigrationService
describeEventCategoriesRequest
- public DescribeEventSubscriptionsResult describeEventSubscriptions(DescribeEventSubscriptionsRequest request)
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.
describeEventSubscriptions
in interface AWSDatabaseMigrationService
describeEventSubscriptionsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeEventsResult describeEvents(DescribeEventsRequest request)
Lists events for a given source identifier and source type. You can also specify a start and end time. For more information on DMS events, see Working with Events and Notifications in the Database Migration Service User Guide.
describeEvents
in interface AWSDatabaseMigrationService
describeEventsRequest
- public DescribeExtensionPackAssociationsResult describeExtensionPackAssociations(DescribeExtensionPackAssociationsRequest request)
Returns a paginated list of extension pack associations for the specified migration project. An extension pack is an add-on module that emulates functions present in a source database that are required when converting objects to the target database.
describeExtensionPackAssociations
in interface AWSDatabaseMigrationService
describeExtensionPackAssociationsRequest
- public DescribeFleetAdvisorCollectorsResult describeFleetAdvisorCollectors(DescribeFleetAdvisorCollectorsRequest request)
Returns a list of the Fleet Advisor collectors in your account.
describeFleetAdvisorCollectors
in interface AWSDatabaseMigrationService
describeFleetAdvisorCollectorsRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeFleetAdvisorDatabasesResult describeFleetAdvisorDatabases(DescribeFleetAdvisorDatabasesRequest request)
Returns a list of Fleet Advisor databases in your account.
describeFleetAdvisorDatabases
in interface AWSDatabaseMigrationService
describeFleetAdvisorDatabasesRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeFleetAdvisorLsaAnalysisResult describeFleetAdvisorLsaAnalysis(DescribeFleetAdvisorLsaAnalysisRequest request)
Provides descriptions of large-scale assessment (LSA) analyses produced by your Fleet Advisor collectors.
describeFleetAdvisorLsaAnalysis
in interface AWSDatabaseMigrationService
describeFleetAdvisorLsaAnalysisRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeFleetAdvisorSchemaObjectSummaryResult describeFleetAdvisorSchemaObjectSummary(DescribeFleetAdvisorSchemaObjectSummaryRequest request)
Provides descriptions of the schemas discovered by your Fleet Advisor collectors.
describeFleetAdvisorSchemaObjectSummary
in interface AWSDatabaseMigrationService
describeFleetAdvisorSchemaObjectSummaryRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeFleetAdvisorSchemasResult describeFleetAdvisorSchemas(DescribeFleetAdvisorSchemasRequest request)
Returns a list of schemas detected by Fleet Advisor Collectors in your account.
describeFleetAdvisorSchemas
in interface AWSDatabaseMigrationService
describeFleetAdvisorSchemasRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeInstanceProfilesResult describeInstanceProfiles(DescribeInstanceProfilesRequest request)
Returns a paginated list of instance profiles for your account in the current region.
describeInstanceProfiles
in interface AWSDatabaseMigrationService
describeInstanceProfilesRequest
- ResourceNotFoundException
- The resource could not be found.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public DescribeMetadataModelAssessmentsResult describeMetadataModelAssessments(DescribeMetadataModelAssessmentsRequest request)
Returns a paginated list of metadata model assessments for your account in the current region.
describeMetadataModelAssessments
in interface AWSDatabaseMigrationService
describeMetadataModelAssessmentsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeMetadataModelConversionsResult describeMetadataModelConversions(DescribeMetadataModelConversionsRequest request)
Returns a paginated list of metadata model conversions for a migration project.
describeMetadataModelConversions
in interface AWSDatabaseMigrationService
describeMetadataModelConversionsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeMetadataModelExportsAsScriptResult describeMetadataModelExportsAsScript(DescribeMetadataModelExportsAsScriptRequest request)
Returns a paginated list of metadata model exports.
describeMetadataModelExportsAsScript
in interface AWSDatabaseMigrationService
describeMetadataModelExportsAsScriptRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeMetadataModelExportsToTargetResult describeMetadataModelExportsToTarget(DescribeMetadataModelExportsToTargetRequest request)
Returns a paginated list of metadata model exports.
describeMetadataModelExportsToTarget
in interface AWSDatabaseMigrationService
describeMetadataModelExportsToTargetRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeMetadataModelImportsResult describeMetadataModelImports(DescribeMetadataModelImportsRequest request)
Returns a paginated list of metadata model imports.
describeMetadataModelImports
in interface AWSDatabaseMigrationService
describeMetadataModelImportsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeMigrationProjectsResult describeMigrationProjects(DescribeMigrationProjectsRequest request)
Returns a paginated list of migration projects for your account in the current region.
describeMigrationProjects
in interface AWSDatabaseMigrationService
describeMigrationProjectsRequest
- ResourceNotFoundException
- The resource could not be found.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public DescribeOrderableReplicationInstancesResult describeOrderableReplicationInstances(DescribeOrderableReplicationInstancesRequest request)
Returns information about the replication instance types that can be created in the specified region.
describeOrderableReplicationInstances
in interface AWSDatabaseMigrationService
describeOrderableReplicationInstancesRequest
- AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeOrderableReplicationInstancesRequest request = new DescribeOrderableReplicationInstancesRequest().withMaxRecords(123).withMarker(""); DescribeOrderableReplicationInstancesResult response = client.describeOrderableReplicationInstances(request);
public DescribePendingMaintenanceActionsResult describePendingMaintenanceActions(DescribePendingMaintenanceActionsRequest request)
For internal use only
describePendingMaintenanceActions
in interface AWSDatabaseMigrationService
describePendingMaintenanceActionsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeRecommendationLimitationsResult describeRecommendationLimitations(DescribeRecommendationLimitationsRequest request)
Returns a paginated list of limitations for recommendations of target Amazon Web Services engines.
describeRecommendationLimitations
in interface AWSDatabaseMigrationService
describeRecommendationLimitationsRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public DescribeRecommendationsResult describeRecommendations(DescribeRecommendationsRequest request)
Returns a paginated list of target engine recommendations for your source databases.
describeRecommendations
in interface AWSDatabaseMigrationService
describeRecommendationsRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public DescribeRefreshSchemasStatusResult describeRefreshSchemasStatus(DescribeRefreshSchemasStatusRequest request)
Returns the status of the RefreshSchemas operation.
describeRefreshSchemasStatus
in interface AWSDatabaseMigrationService
describeRefreshSchemasStatusRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeRefreshSchemasStatusRequest request = new DescribeRefreshSchemasStatusRequest().withEndpointArn(""); DescribeRefreshSchemasStatusResult response = client.describeRefreshSchemasStatus(request);
public DescribeReplicationConfigsResult describeReplicationConfigs(DescribeReplicationConfigsRequest request)
Returns one or more existing DMS Serverless replication configurations as a list of structures.
describeReplicationConfigs
in interface AWSDatabaseMigrationService
describeReplicationConfigsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeReplicationInstanceTaskLogsResult describeReplicationInstanceTaskLogs(DescribeReplicationInstanceTaskLogsRequest request)
Returns information about the task logs for the specified task.
describeReplicationInstanceTaskLogs
in interface AWSDatabaseMigrationService
describeReplicationInstanceTaskLogsRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeReplicationInstancesResult describeReplicationInstances(DescribeReplicationInstancesRequest request)
Returns information about replication instances for your account in the current region.
describeReplicationInstances
in interface AWSDatabaseMigrationService
describeReplicationInstancesRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeReplicationInstancesRequest request = new DescribeReplicationInstancesRequest() .withFilters(new Filter().withName("string").withValues("string", "string")).withMaxRecords(123).withMarker(""); DescribeReplicationInstancesResult response = client.describeReplicationInstances(request);
public DescribeReplicationSubnetGroupsResult describeReplicationSubnetGroups(DescribeReplicationSubnetGroupsRequest request)
Returns information about the replication subnet groups.
describeReplicationSubnetGroups
in interface AWSDatabaseMigrationService
describeReplicationSubnetGroupsRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeReplicationSubnetGroupsRequest request = new DescribeReplicationSubnetGroupsRequest() .withFilters(new Filter().withName("string").withValues("string", "string")).withMaxRecords(123).withMarker(""); DescribeReplicationSubnetGroupsResult response = client.describeReplicationSubnetGroups(request);
public DescribeReplicationTableStatisticsResult describeReplicationTableStatistics(DescribeReplicationTableStatisticsRequest request)
Returns table and schema statistics for one or more provisioned replications that use a given DMS Serverless replication configuration.
describeReplicationTableStatistics
in interface AWSDatabaseMigrationService
describeReplicationTableStatisticsRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public DescribeReplicationTaskAssessmentResultsResult describeReplicationTaskAssessmentResults(DescribeReplicationTaskAssessmentResultsRequest request)
Returns the task assessment results from the Amazon S3 bucket that DMS creates in your Amazon Web Services account. This action always returns the latest results.
For more information about DMS task assessments, see Creating a task assessment report in the Database Migration Service User Guide.
describeReplicationTaskAssessmentResults
in interface AWSDatabaseMigrationService
describeReplicationTaskAssessmentResultsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeReplicationTaskAssessmentRunsResult describeReplicationTaskAssessmentRuns(DescribeReplicationTaskAssessmentRunsRequest request)
Returns a paginated list of premigration assessment runs based on filter settings.
These filter settings can specify a combination of premigration assessment runs, migration tasks, replication instances, and assessment run status values.
This operation doesn't return information about individual assessments. For this information, see the
DescribeReplicationTaskIndividualAssessments
operation.
describeReplicationTaskAssessmentRuns
in interface AWSDatabaseMigrationService
describeReplicationTaskAssessmentRunsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeReplicationTaskIndividualAssessmentsResult describeReplicationTaskIndividualAssessments(DescribeReplicationTaskIndividualAssessmentsRequest request)
Returns a paginated list of individual assessments based on filter settings.
These filter settings can specify a combination of premigration assessment runs, migration tasks, and assessment status values.
describeReplicationTaskIndividualAssessments
in interface AWSDatabaseMigrationService
describeReplicationTaskIndividualAssessmentsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeReplicationTasksResult describeReplicationTasks(DescribeReplicationTasksRequest request)
Returns information about replication tasks for your account in the current region.
describeReplicationTasks
in interface AWSDatabaseMigrationService
describeReplicationTasksRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeReplicationTasksRequest request = new DescribeReplicationTasksRequest() .withFilters(new Filter().withName("string").withValues("string", "string")).withMaxRecords(123).withMarker(""); DescribeReplicationTasksResult response = client.describeReplicationTasks(request);
public DescribeReplicationsResult describeReplications(DescribeReplicationsRequest request)
Provides details on replication progress by returning status information for one or more provisioned DMS Serverless replications.
describeReplications
in interface AWSDatabaseMigrationService
describeReplicationsRequest
- ResourceNotFoundException
- The resource could not be found.public DescribeSchemasResult describeSchemas(DescribeSchemasRequest request)
Returns information about the schema for the specified endpoint.
describeSchemas
in interface AWSDatabaseMigrationService
describeSchemasRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeSchemasRequest request = new DescribeSchemasRequest().withEndpointArn("").withMaxRecords(123).withMarker(""); DescribeSchemasResult response = client.describeSchemas(request);
public DescribeTableStatisticsResult describeTableStatistics(DescribeTableStatisticsRequest request)
Returns table statistics on the database migration task, including table name, rows inserted, rows updated, and rows deleted.
Note that the "last updated" column the DMS console only indicates the time that DMS last updated the table statistics record for a table. It does not indicate the time of the last update to the table.
describeTableStatistics
in interface AWSDatabaseMigrationService
describeTableStatisticsRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); DescribeTableStatisticsRequest request = new DescribeTableStatisticsRequest().withReplicationTaskArn("").withMaxRecords(123).withMarker(""); DescribeTableStatisticsResult response = client.describeTableStatistics(request);
public ExportMetadataModelAssessmentResult exportMetadataModelAssessment(ExportMetadataModelAssessmentRequest request)
Saves a copy of a database migration assessment report to your Amazon S3 bucket. DMS can save your assessment report as a comma-separated value (CSV) or a PDF file.
exportMetadataModelAssessment
in interface AWSDatabaseMigrationService
exportMetadataModelAssessmentRequest
- ResourceNotFoundException
- The resource could not be found.public ImportCertificateResult importCertificate(ImportCertificateRequest request)
Uploads the specified certificate.
importCertificate
in interface AWSDatabaseMigrationService
importCertificateRequest
- ResourceAlreadyExistsException
- The resource you are attempting to create already exists.InvalidCertificateException
- The certificate was not valid.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); ImportCertificateRequest request = new ImportCertificateRequest().withCertificateIdentifier("").withCertificatePem(""); ImportCertificateResult response = client.importCertificate(request);
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists all metadata tags attached to an DMS resource, including replication instance, endpoint, subnet group, and
migration task. For more information, see Tag
data type
description.
listTagsForResource
in interface AWSDatabaseMigrationService
listTagsForResourceRequest
- ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); ListTagsForResourceRequest request = new ListTagsForResourceRequest().withResourceArn(""); ListTagsForResourceResult response = client.listTagsForResource(request);
public ModifyConversionConfigurationResult modifyConversionConfiguration(ModifyConversionConfigurationRequest request)
Modifies the specified schema conversion configuration using the provided parameters.
modifyConversionConfiguration
in interface AWSDatabaseMigrationService
modifyConversionConfigurationRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public ModifyDataProviderResult modifyDataProvider(ModifyDataProviderRequest request)
Modifies the specified data provider using the provided settings.
You must remove the data provider from all migration projects before you can modify it.
modifyDataProvider
in interface AWSDatabaseMigrationService
modifyDataProviderRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public ModifyEndpointResult modifyEndpoint(ModifyEndpointRequest request)
Modifies the specified endpoint.
For a MySQL source or target endpoint, don't explicitly specify the database using the DatabaseName
request parameter on the ModifyEndpoint
API call. Specifying DatabaseName
when you
modify a MySQL endpoint replicates all the task tables to this single database. For MySQL endpoints, you specify
the database only when you specify the schema in the table-mapping rules of the DMS task.
modifyEndpoint
in interface AWSDatabaseMigrationService
modifyEndpointRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); ModifyEndpointRequest request = new ModifyEndpointRequest().withEndpointArn("").withEndpointIdentifier("").withEndpointType("source") .withEngineName("").withUsername("").withPassword("").withServerName("").withPort(123).withDatabaseName("").withExtraConnectionAttributes("") .withCertificateArn("").withSslMode("require"); ModifyEndpointResult response = client.modifyEndpoint(request);
public ModifyEventSubscriptionResult modifyEventSubscription(ModifyEventSubscriptionRequest request)
Modifies an existing DMS event notification subscription.
modifyEventSubscription
in interface AWSDatabaseMigrationService
modifyEventSubscriptionRequest
- ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.ResourceNotFoundException
- The resource could not be found.SNSInvalidTopicException
- The SNS topic is invalid.SNSNoAuthorizationException
- You are not authorized for the SNS subscription.KMSAccessDeniedException
- The ciphertext references a key that doesn't exist or that the DMS account doesn't have access to.KMSDisabledException
- The specified KMS key isn't enabled.KMSInvalidStateException
- The state of the specified KMS resource isn't valid for this request.KMSNotFoundException
- The specified KMS entity or resource can't be found.KMSThrottlingException
- This request triggered KMS request throttling.public ModifyInstanceProfileResult modifyInstanceProfile(ModifyInstanceProfileRequest request)
Modifies the specified instance profile using the provided parameters.
All migration projects associated with the instance profile must be deleted or modified before you can modify the instance profile.
modifyInstanceProfile
in interface AWSDatabaseMigrationService
modifyInstanceProfileRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public ModifyMigrationProjectResult modifyMigrationProject(ModifyMigrationProjectRequest request)
Modifies the specified migration project using the provided parameters.
The migration project must be closed before you can modify it.
modifyMigrationProject
in interface AWSDatabaseMigrationService
modifyMigrationProjectRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public ModifyReplicationConfigResult modifyReplicationConfig(ModifyReplicationConfigRequest request)
Modifies an existing DMS Serverless replication configuration that you can use to start a replication. This command includes input validation and logic to check the state of any replication that uses this configuration. You can only modify a replication configuration before any replication that uses it has started. As soon as you have initially started a replication with a given configuiration, you can't modify that configuration, even if you stop it.
Other run statuses that allow you to run this command include FAILED and CREATED. A provisioning state that allows you to run this command is FAILED_PROVISION.
modifyReplicationConfig
in interface AWSDatabaseMigrationService
modifyReplicationConfigRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.ReplicationSubnetGroupDoesNotCoverEnoughAZsException
- The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
group and add more AZs.InvalidSubnetException
- The subnet provided isn't valid.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public ModifyReplicationInstanceResult modifyReplicationInstance(ModifyReplicationInstanceRequest request)
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.
modifyReplicationInstance
in interface AWSDatabaseMigrationService
modifyReplicationInstanceRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.InsufficientResourceCapacityException
- There are not enough resources allocated to the database migration.StorageQuotaExceededException
- The storage quota has been exceeded.UpgradeDependencyFailureException
- An upgrade dependency is preventing the database migration.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); ModifyReplicationInstanceRequest request = new ModifyReplicationInstanceRequest() .withReplicationInstanceArn("arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ").withAllocatedStorage(123) .withApplyImmediately(true).withReplicationInstanceClass("dms.t2.micro").withVpcSecurityGroupIds(new ArrayList()) .withPreferredMaintenanceWindow("sun:06:00-sun:14:00").withMultiAZ(true).withEngineVersion("1.5.0").withAllowMajorVersionUpgrade(true) .withAutoMinorVersionUpgrade(true).withReplicationInstanceIdentifier("test-rep-1"); ModifyReplicationInstanceResult response = client.modifyReplicationInstance(request);
public ModifyReplicationSubnetGroupResult modifyReplicationSubnetGroup(ModifyReplicationSubnetGroupRequest request)
Modifies the settings for the specified replication subnet group.
modifyReplicationSubnetGroup
in interface AWSDatabaseMigrationService
modifyReplicationSubnetGroupRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.SubnetAlreadyInUseException
- The specified subnet is already in use.ReplicationSubnetGroupDoesNotCoverEnoughAZsException
- The replication subnet group does not cover enough Availability Zones (AZs). Edit the replication subnet
group and add more AZs.InvalidSubnetException
- The subnet provided isn't valid.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); ModifyReplicationSubnetGroupRequest request = new ModifyReplicationSubnetGroupRequest().withReplicationSubnetGroupIdentifier("") .withReplicationSubnetGroupDescription("").withSubnetIds(new ArrayList()); ModifyReplicationSubnetGroupResult response = client.modifyReplicationSubnetGroup(request);
public ModifyReplicationTaskResult modifyReplicationTask(ModifyReplicationTaskRequest request)
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 DMS tasks, see Working with Migration Tasks in the Database Migration Service User Guide.
modifyReplicationTask
in interface AWSDatabaseMigrationService
modifyReplicationTaskRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.public MoveReplicationTaskResult moveReplicationTask(MoveReplicationTaskRequest request)
Moves a replication task from its current replication instance to a different target replication instance using the specified parameters. The target replication instance must be created with the same or later DMS version as the current replication instance.
moveReplicationTask
in interface AWSDatabaseMigrationService
moveReplicationTaskRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.public RebootReplicationInstanceResult rebootReplicationInstance(RebootReplicationInstanceRequest request)
Reboots a replication instance. Rebooting results in a momentary outage, until the replication instance becomes available again.
rebootReplicationInstance
in interface AWSDatabaseMigrationService
rebootReplicationInstanceRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public RefreshSchemasResult refreshSchemas(RefreshSchemasRequest request)
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.
refreshSchemas
in interface AWSDatabaseMigrationService
refreshSchemasRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); RefreshSchemasRequest request = new RefreshSchemasRequest().withEndpointArn("").withReplicationInstanceArn(""); RefreshSchemasResult response = client.refreshSchemas(request);
public ReloadReplicationTablesResult reloadReplicationTables(ReloadReplicationTablesRequest request)
Reloads the target database table with the source data for a given DMS Serverless replication configuration.
You can only use this operation with a task in the RUNNING state, otherwise the service will throw an
InvalidResourceStateFault
exception.
reloadReplicationTables
in interface AWSDatabaseMigrationService
reloadReplicationTablesRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public ReloadTablesResult reloadTables(ReloadTablesRequest request)
Reloads the target database table with the source data.
You can only use this operation with a task in the RUNNING
state, otherwise the service will throw
an InvalidResourceStateFault
exception.
reloadTables
in interface AWSDatabaseMigrationService
reloadTablesRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public RemoveTagsFromResourceResult removeTagsFromResource(RemoveTagsFromResourceRequest request)
Removes metadata tags from an DMS resource, including replication instance, endpoint, subnet group, and migration
task. For more information, see
Tag
data type description.
removeTagsFromResource
in interface AWSDatabaseMigrationService
removeTagsFromResourceRequest
- Removes one or more tags from an DMS resource.ResourceNotFoundException
- The resource could not be found.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); RemoveTagsFromResourceRequest request = new RemoveTagsFromResourceRequest().withResourceArn( "arn:aws:dms:us-east-1:123456789012:endpoint:ASXWXJZLNWNT5HTWCGV2BUJQ7E").withTagKeys(new ArrayList()); RemoveTagsFromResourceResult response = client.removeTagsFromResource(request);
public RunFleetAdvisorLsaAnalysisResult runFleetAdvisorLsaAnalysis(RunFleetAdvisorLsaAnalysisRequest request)
Runs large-scale assessment (LSA) analysis on every Fleet Advisor collector in your account.
runFleetAdvisorLsaAnalysis
in interface AWSDatabaseMigrationService
runFleetAdvisorLsaAnalysisRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.public StartExtensionPackAssociationResult startExtensionPackAssociation(StartExtensionPackAssociationRequest request)
Applies the extension pack to your target database. An extension pack is an add-on module that emulates functions present in a source database that are required when converting objects to the target database.
startExtensionPackAssociation
in interface AWSDatabaseMigrationService
startExtensionPackAssociationRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public StartMetadataModelAssessmentResult startMetadataModelAssessment(StartMetadataModelAssessmentRequest request)
Creates a database migration assessment report by assessing the migration complexity for your source database. A database migration assessment report summarizes all of the schema conversion tasks. It also details the action items for database objects that can't be converted to the database engine of your target database instance.
startMetadataModelAssessment
in interface AWSDatabaseMigrationService
startMetadataModelAssessmentRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public StartMetadataModelConversionResult startMetadataModelConversion(StartMetadataModelConversionRequest request)
Converts your source database objects to a format compatible with the target database.
startMetadataModelConversion
in interface AWSDatabaseMigrationService
startMetadataModelConversionRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public StartMetadataModelExportAsScriptResult startMetadataModelExportAsScript(StartMetadataModelExportAsScriptRequest request)
Saves your converted code to a file as a SQL script, and stores this file on your Amazon S3 bucket.
startMetadataModelExportAsScript
in interface AWSDatabaseMigrationService
startMetadataModelExportAsScriptRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public StartMetadataModelExportToTargetResult startMetadataModelExportToTarget(StartMetadataModelExportToTargetRequest request)
Applies converted database objects to your target database.
startMetadataModelExportToTarget
in interface AWSDatabaseMigrationService
startMetadataModelExportToTargetRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public StartMetadataModelImportResult startMetadataModelImport(StartMetadataModelImportRequest request)
Loads the metadata for all the dependent database objects of the parent object.
This operation uses your project's Amazon S3 bucket as a metadata cache to improve performance.
startMetadataModelImport
in interface AWSDatabaseMigrationService
startMetadataModelImportRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.ResourceNotFoundException
- The resource could not be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.public StartRecommendationsResult startRecommendations(StartRecommendationsRequest request)
Starts the analysis of your source database to provide recommendations of target engines.
You can create recommendations for multiple source databases using BatchStartRecommendations.
startRecommendations
in interface AWSDatabaseMigrationService
startRecommendationsRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.public StartReplicationResult startReplication(StartReplicationRequest request)
For a given DMS Serverless replication configuration, DMS connects to the source endpoint and collects the metadata to analyze the replication workload. Using this metadata, DMS then computes and provisions the required capacity and starts replicating to the target endpoint using the server resources that DMS has provisioned for the DMS Serverless replication.
startReplication
in interface AWSDatabaseMigrationService
startReplicationRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public StartReplicationTaskResult startReplicationTask(StartReplicationTaskRequest request)
Starts the replication task.
For more information about DMS tasks, see Working with Migration Tasks in the Database Migration Service User Guide.
startReplicationTask
in interface AWSDatabaseMigrationService
startReplicationTaskRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); StartReplicationTaskRequest request = new StartReplicationTaskRequest() .withReplicationTaskArn("arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ").withStartReplicationTaskType("start-replication") .withCdcStartTime(new Date("2016-12-14T13:33:20Z")); StartReplicationTaskResult response = client.startReplicationTask(request);
public StartReplicationTaskAssessmentResult startReplicationTaskAssessment(StartReplicationTaskAssessmentRequest request)
Starts the replication task assessment for unsupported data types in the source database.
You can only use this operation for a task if the following conditions are true:
The task must be in the stopped
state.
The task must have successful connections to the source and target.
If either of these conditions are not met, an InvalidResourceStateFault
error will result.
For information about DMS task assessments, see Creating a task assessment report in the Database Migration Service User Guide.
startReplicationTaskAssessment
in interface AWSDatabaseMigrationService
startReplicationTaskAssessmentRequest
- InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.ResourceNotFoundException
- The resource could not be found.public StartReplicationTaskAssessmentRunResult startReplicationTaskAssessmentRun(StartReplicationTaskAssessmentRunRequest request)
Starts a new premigration assessment run for one or more individual assessments of a migration task.
The assessments that you can specify depend on the source and target database engine and the migration type defined for the given task. To run this operation, your migration task must already be created. After you run this operation, you can review the status of each individual assessment. You can also run the migration task manually after the assessment run and its individual assessments complete.
startReplicationTaskAssessmentRun
in interface AWSDatabaseMigrationService
startReplicationTaskAssessmentRunRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.KMSAccessDeniedException
- The ciphertext references a key that doesn't exist or that the DMS account doesn't have access to.KMSDisabledException
- The specified KMS key isn't enabled.KMSException
- An Key Management Service (KMS) error is preventing access to KMS.KMSInvalidStateException
- The state of the specified KMS resource isn't valid for this request.KMSNotFoundException
- The specified KMS entity or resource can't be found.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.S3AccessDeniedException
- Insufficient privileges are preventing access to an Amazon S3 object.S3ResourceNotFoundException
- A specified Amazon S3 bucket, bucket folder, or other object can't be found.ResourceAlreadyExistsException
- The resource you are attempting to create already exists.public StopReplicationResult stopReplication(StopReplicationRequest request)
For a given DMS Serverless replication configuration, DMS stops any and all ongoing DMS Serverless replications. This command doesn't deprovision the stopped replications.
stopReplication
in interface AWSDatabaseMigrationService
stopReplicationRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.public StopReplicationTaskResult stopReplicationTask(StopReplicationTaskRequest request)
Stops the replication task.
stopReplicationTask
in interface AWSDatabaseMigrationService
stopReplicationTaskRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); StopReplicationTaskRequest request = new StopReplicationTaskRequest() .withReplicationTaskArn("arn:aws:dms:us-east-1:123456789012:endpoint:ASXWXJZLNWNT5HTWCGV2BUJQ7E"); StopReplicationTaskResult response = client.stopReplicationTask(request);
public TestConnectionResult testConnection(TestConnectionRequest request)
Tests the connection between the replication instance and the endpoint.
testConnection
in interface AWSDatabaseMigrationService
testConnectionRequest
- ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.KMSKeyNotAccessibleException
- DMS cannot access the KMS key.ResourceQuotaExceededException
- The quota for this resource quota has been exceeded.AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.AWSDatabaseMigrationService client = AWSDatabaseMigrationServiceClientBuilder.standard().build(); TestConnectionRequest request = new TestConnectionRequest().withReplicationInstanceArn( "arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ").withEndpointArn( "arn:aws:dms:us-east-1:123456789012:endpoint:RAAR3R22XSH46S3PWLC3NJAWKM"); TestConnectionResult response = client.testConnection(request);
public UpdateSubscriptionsToEventBridgeResult updateSubscriptionsToEventBridge(UpdateSubscriptionsToEventBridgeRequest request)
Migrates 10 active and enabled Amazon SNS subscriptions at a time and converts them to corresponding Amazon
EventBridge rules. By default, this operation migrates subscriptions only when all your replication instance
versions are 3.4.5 or higher. If any replication instances are from versions earlier than 3.4.5, the operation
raises an error and tells you to upgrade these instances to version 3.4.5 or higher. To enable migration
regardless of version, set the Force
option to true. However, if you don't upgrade instances earlier
than version 3.4.5, some types of events might not be available when you use Amazon EventBridge.
To call this operation, make sure that you have certain permissions added to your user account. For more information, see Migrating event subscriptions to Amazon EventBridge in the Amazon Web Services Database Migration Service User Guide.
updateSubscriptionsToEventBridge
in interface AWSDatabaseMigrationService
updateSubscriptionsToEventBridgeRequest
- AccessDeniedException
- DMS was denied access to the endpoint. Check that the role is correctly configured.InvalidResourceStateException
- The resource is in a state that prevents it from being used for database migration.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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 the request.
getCachedResponseMetadata
in interface AWSDatabaseMigrationService
request
- The originally executed requestpublic AWSDatabaseMigrationServiceWaiters waiters()
waiters
in interface AWSDatabaseMigrationService
public void shutdown()
AmazonWebServiceClient
shutdown
in interface AWSDatabaseMigrationService
shutdown
in class AmazonWebServiceClient