@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, 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. 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 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 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 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.
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 is invalid.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.
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 is invalid.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 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 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 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 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 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 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 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 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 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 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 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, security 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 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 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 is invalid.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 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, security 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 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 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 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