"ResourceArn": "string", "Value": "string"
} ],
"Username": "string"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters (p. 364).
The request accepts the following data in JSON format.
CertificateArn (p. 11)
The Amazon Resource Name (ARN) for the certificate.
Type: String Required: No DatabaseName (p. 11)
The name of the endpoint database. For a MySQL source or target endpoint, do not specify DatabaseName. To migrate to a specific database, use this setting and targetDbType.
Type: String Required: No
DmsTransferSettings (p. 11)
The settings in JSON format for the DMS transfer type of source endpoint.
Possible settings include the following:
• ServiceAccessRoleArn - The Amazon Resource Name (ARN) used by the service access IAM role. The role must allow the iam:PassRole action.
• BucketName - The name of the S3 bucket to use.
Shorthand syntax for these settings is as follows:
ServiceAccessRoleArn=string,BucketName=string
JSON syntax for these settings is as follows: { "ServiceAccessRoleArn": "string",
"BucketName": "string", }
Type: DmsTransferSettings (p. 254) object Required: No
DocDbSettings (p. 11)
Provides information that defines a DocumentDB endpoint.
Type: DocDbSettings (p. 255) object Required: No
DynamoDbSettings (p. 11)
Settings in JSON format for the target Amazon DynamoDB endpoint. For information about other available settings, see Using Object Mapping to Migrate Data to DynamoDB in the AWS Database Migration Service User Guide.
Request Parameters
Type: DynamoDbSettings (p. 258) object Required: No
ElasticsearchSettings (p. 11)
Settings in JSON format for the target OpenSearch endpoint. For more information about the available settings, see Extra Connection Attributes When Using OpenSearch as a Target for AWS DMS in the AWS Database Migration Service User Guide.
Type: ElasticsearchSettings (p. 259) object Required: No
EndpointIdentifier (p. 11)
The database endpoint identifier. Identifiers must begin with a letter and must contain only ASCII letters, digits, and hyphens. They can't end with a hyphen, or contain two consecutive hyphens.
Type: String Required: Yes EndpointType (p. 11)
The type of endpoint. Valid values are source and target.
Type: String
Valid Values: source | target Required: Yes
EngineName (p. 11)
The type of engine for the endpoint. Valid values, depending on the EndpointType value, include "mysql", "oracle", "postgres", "mariadb", "aurora", "aurora-postgresql",
"opensearch", "redshift", "s3", "db2", "azuredb", "sybase", "dynamodb", "mongodb",
"kinesis", "kafka", "elasticsearch", "docdb", "sqlserver", and "neptune".
Type: String Required: Yes
ExternalTableDefinition (p. 11) The external table definition.
Type: String Required: No
ExtraConnectionAttributes (p. 11)
Additional attributes associated with the connection. Each attribute is specified as a name-value pair associated by an equal sign (=). Multiple attributes are separated by a semicolon (;) with no additional white space. For information on the attributes available for connecting your source or target endpoint, see Working with AWS DMS Endpoints in the AWS Database Migration Service User Guide.
Type: String Required: No
GcpMySQLSettings (p. 11)
Settings in JSON format for the source GCP MySQL endpoint.
Request Parameters
Type: GcpMySQLSettings (p. 274) object Required: No
IBMDb2Settings (p. 11)
Settings in JSON format for the source IBM Db2 LUW endpoint. For information about other available settings, see Extra connection attributes when using Db2 LUW as a source for AWS DMS in the AWS Database Migration Service User Guide.
Type: IBMDb2Settings (p. 277) object Required: No
KafkaSettings (p. 11)
Settings in JSON format for the target Apache Kafka endpoint. For more information about the available settings, see Using object mapping to migrate data to a Kafka topic in the AWS Database Migration Service User Guide.
Type: KafkaSettings (p. 279) object Required: No
KinesisSettings (p. 11)
Settings in JSON format for the target endpoint for Amazon Kinesis Data Streams. For more
information about the available settings, see Using object mapping to migrate data to a Kinesis data stream in the AWS Database Migration Service User Guide.
Type: KinesisSettings (p. 282) object Required: No
KmsKeyId (p. 11)
An AWS KMS key identifier that is used to encrypt the connection parameters for the endpoint.
If you don't specify a value for the KmsKeyId parameter, then AWS DMS uses your default encryption key.
AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.
Type: String Required: No
MicrosoftSQLServerSettings (p. 11)
Settings in JSON format for the source and target Microsoft SQL Server endpoint. For information about other available settings, see Extra connection attributes when using SQL Server as a source for AWS DMS and Extra connection attributes when using SQL Server as a target for AWS DMS in the AWS Database Migration Service User Guide.
Type: MicrosoftSQLServerSettings (p. 284) object Required: No
MongoDbSettings (p. 11)
Settings in JSON format for the source MongoDB endpoint. For more information about the available settings, see Endpoint configuration settings when using MongoDB as a source for AWS Database Migration Service in the AWS Database Migration Service User Guide.
Type: MongoDbSettings (p. 287) object
Request Parameters
Required: No MySQLSettings (p. 11)
Settings in JSON format for the source and target MySQL endpoint. For information about other available settings, see Extra connection attributes when using MySQL as a source for AWS DMS and Extra connection attributes when using a MySQL-compatible database as a target for AWS DMS in the AWS Database Migration Service User Guide.
Type: MySQLSettings (p. 290) object Required: No
NeptuneSettings (p. 11)
Settings in JSON format for the target Amazon Neptune endpoint. For more information about the available settings, see Specifying graph-mapping rules using Gremlin and R2RML for Amazon Neptune as a target in the AWS Database Migration Service User Guide.
Type: NeptuneSettings (p. 293) object Required: No
OracleSettings (p. 11)
Settings in JSON format for the source and target Oracle endpoint. For information about other available settings, see Extra connection attributes when using Oracle as a source for AWS DMS and Extra connection attributes when using Oracle as a target for AWS DMS in the AWS Database Migration Service User Guide.
Type: OracleSettings (p. 295) object Required: No
Password (p. 11)
The password to be used to log in to the endpoint database.
Type: String Required: No Port (p. 11)
The port used by the endpoint database.
Type: Integer Required: No
PostgreSQLSettings (p. 11)
Settings in JSON format for the source and target PostgreSQL endpoint. For information about other available settings, see Extra connection attributes when using PostgreSQL as a source for AWS DMS and Extra connection attributes when using PostgreSQL as a target for AWS DMS in the AWS Database Migration Service User Guide.
Type: PostgreSQLSettings (p. 307) object Required: No
RedisSettings (p. 11)
Settings in JSON format for the target Redis endpoint.
Type: RedisSettings (p. 311) object
Request Parameters
Required: No RedshiftSettings (p. 11)
Provides information that defines an Amazon Redshift endpoint.
Type: RedshiftSettings (p. 313) object Required: No
ResourceIdentifier (p. 11)
A friendly name for the resource identifier at the end of the EndpointArn response parameter that is returned in the created Endpoint object. The value for this parameter can have up to 31 characters. It can contain only ASCII letters, digits, and hyphen ('-'). Also, it can't end with a hyphen or contain two consecutive hyphens, and can only begin with a letter, such as Example-App-ARN1. For example, this value might result in the EndpointArn value arn:aws:dms:eu-west-1:012345678901:rep:Example-App-ARN1. If you don't specify a ResourceIdentifier value, AWS DMS generates a default identifier value for the end of EndpointArn.
Type: String Required: No S3Settings (p. 11)
Settings in JSON format for the target Amazon S3 endpoint. For more information about the available settings, see Extra Connection Attributes When Using Amazon S3 as a Target for AWS DMS in the AWS Database Migration Service User Guide.
Type: S3Settings (p. 343) object Required: No
ServerName (p. 11)
The name of the server where the endpoint database resides.
Type: String Required: No
ServiceAccessRoleArn (p. 11)
The Amazon Resource Name (ARN) for the service access role that you want to use to create the endpoint. The role must allow the iam:PassRole action.
Type: String Required: No SslMode (p. 11)
The Secure Sockets Layer (SSL) mode to use for the SSL connection. The default is none Type: String
Valid Values: none | require | verify-ca | verify-full Required: No
SybaseSettings (p. 11)
Settings in JSON format for the source and target SAP ASE endpoint. For information about other available settings, see Extra connection attributes when using SAP ASE as a source for AWS DMS and Extra connection attributes when using SAP ASE as a target for AWS DMS in the AWS Database Migration Service User Guide.