AWS::DMS::Endpoint - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::DMS::Endpoint

The AWS::DMS::Endpoint resource specifies an Amazon DMS endpoint.

Currently, Amazon CloudFormation supports all Amazon DMS endpoint types.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

Properties

CertificateArn

The Amazon Resource Name (ARN) for the certificate.

Required: No

Type: String

Update requires: No interruption

DatabaseName

The name of the endpoint database. For a MySQL source or target endpoint, don't specify DatabaseName. To migrate to a specific database, use this setting and targetDbType.

Required: No

Type: String

Update requires: No interruption

DocDbSettings

Settings in JSON format for the source and target DocumentDB endpoint. For more information about other available settings, see Using extra connections attributes with Amazon DocumentDB as a source and Using Amazon DocumentDB as a target for Amazon Database Migration Service in the Amazon Database Migration Service User Guide.

Required: No

Type: DocDbSettings

Update requires: No interruption

DynamoDbSettings

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 Amazon Database Migration Service User Guide.

Required: No

Type: DynamoDbSettings

Update requires: No interruption

ElasticsearchSettings

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 Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: ElasticsearchSettings

Update requires: No interruption

EndpointIdentifier

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.

Required: No

Type: String

Update requires: No interruption

EndpointType

The type of endpoint. Valid values are source and target.

Required: Yes

Type: String

Allowed values: source | target

Update requires: No interruption

EngineName

The type of engine for the endpoint, depending on the EndpointType value.

Valid values: mysql | oracle | postgres | mariadb | aurora | aurora-postgresql | opensearch | redshift | redshift-serverless |s3 | db2 | azuredb | sybase | dynamodb | mongodb | kinesis | kafka | elasticsearch | docdb | sqlserver | neptune

Required: Yes

Type: String

Update requires: No interruption

ExtraConnectionAttributes

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 Amazon DMS Endpoints in the Amazon Database Migration Service User Guide.

Required: No

Type: String

Update requires: No interruption

GcpMySQLSettings

Settings in JSON format for the source GCP MySQL endpoint. These settings are much the same as the settings for any MySQL-compatible endpoint. For more information, see Extra connection attributes when using MySQL as a source for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: GcpMySQLSettings

Update requires: No interruption

IbmDb2Settings

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 Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: IbmDb2Settings

Update requires: No interruption

KafkaSettings

Settings in JSON format for the target Apache Kafka endpoint. For more information about other available settings, see Using object mapping to migrate data to a Kafka topic in the Amazon Database Migration Service User Guide.

Required: No

Type: KafkaSettings

Update requires: No interruption

KinesisSettings

Settings in JSON format for the target endpoint for Amazon Kinesis Data Streams. For more information about other available settings, see Using object mapping to migrate data to a Kinesis data stream in the Amazon Database Migration Service User Guide.

Required: No

Type: KinesisSettings

Update requires: No interruption

KmsKeyId

An Amazon 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, Amazon DMS uses your default encryption key.

Amazon KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

Required: No

Type: String

Update requires: Replacement

MicrosoftSqlServerSettings

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 Amazon DMS and Extra connection attributes when using SQL Server as a target for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: MicrosoftSqlServerSettings

Update requires: No interruption

MongoDbSettings

Settings in JSON format for the source MongoDB endpoint. For more information about the available settings, see Using MongoDB as a target for Amazon Database Migration Service in the Amazon Database Migration Service User Guide.

Required: No

Type: MongoDbSettings

Update requires: No interruption

MySqlSettings

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 Amazon DMS and Extra connection attributes when using a MySQL-compatible database as a target for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: MySqlSettings

Update requires: No interruption

NeptuneSettings

Settings in JSON format for the target Amazon Neptune endpoint. For more information about the available settings, see Specifying endpoint settings for Amazon Neptune as a target in the Amazon Database Migration Service User Guide.

Required: No

Type: NeptuneSettings

Update requires: No interruption

OracleSettings

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 Amazon DMS and Extra connection attributes when using Oracle as a target for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: OracleSettings

Update requires: No interruption

Password

The password to be used to log in to the endpoint database.

Required: No

Type: String

Update requires: No interruption

Port

The port used by the endpoint database.

Required: No

Type: Integer

Update requires: No interruption

PostgreSqlSettings

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 Amazon DMS and Extra connection attributes when using PostgreSQL as a target for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: PostgreSqlSettings

Update requires: No interruption

RedisSettings

Settings in JSON format for the target Redis endpoint. For information about other available settings, see Specifying endpoint settings for Redis as a target in the Amazon Database Migration Service User Guide.

Required: No

Type: RedisSettings

Update requires: No interruption

RedshiftSettings

Settings in JSON format for the Amazon Redshift endpoint.

For more information about other available settings, see Extra connection attributes when using Amazon Redshift as a target for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: RedshiftSettings

Update requires: No interruption

ResourceIdentifier

A display 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, Amazon DMS generates a default identifier value for the end of EndpointArn.

Required: No

Type: String

Update requires: Replacement

S3Settings

Settings in JSON format for the source and target Amazon S3 endpoint. For more information about other available settings, see Extra connection attributes when using Amazon S3 as a source for Amazon DMS and Extra connection attributes when using Amazon S3 as a target for Amazon DMS in theAmazon Database Migration Service User Guide.

Required: No

Type: S3Settings

Update requires: No interruption

ServerName

The name of the server where the endpoint database resides.

Required: No

Type: String

Update requires: No interruption

SslMode

The Secure Sockets Layer (SSL) mode to use for the SSL connection. The default is none.

Note

When engine_name is set to S3, the only allowed value is none.

Required: No

Type: String

Allowed values: none | require | verify-ca | verify-full

Update requires: No interruption

SybaseSettings

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 Amazon DMS and Extra connection attributes when using SAP ASE as a target for Amazon DMS in the Amazon Database Migration Service User Guide.

Required: No

Type: SybaseSettings

Update requires: No interruption

Tags

One or more tags to be assigned to the endpoint.

Required: No

Type: Array of Tag

Update requires: No interruption

Username

The user name to be used to log in to the endpoint database.

Required: No

Type: String

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the ARN of the endpoint.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

ExternalId

A value that can be used for cross-account validation.

Examples

JSON

{ "AWSTemplateFormatVersion": "2010-09-09", "Resources": { "myBasicEndpoint": { "Type": "AWS::DMS::Endpoint", "Properties": { "EngineName": "mysql", "EndpointType": "source", "Username": "username", "Password": { "Ref": "PasswordParameter" }, "ServerName": "source.db.amazon.com", "Port": 1234, "DatabaseName": "source-db" } } } }

YAML

AWSTemplateFormatVersion: 2010-09-09 Description: "Endpoint test" Resources: BasicEndpoint: Properties: DatabaseName: my-db EndpointType: target EngineName: mysql Password: PasswordParameter Port: 1234 ServerName: server.db.amazon.com Tags: - Key: type Value: new Username: username Type: "AWS::DMS::Endpoint"

See also