AWS CloudFormation
User Guide (Version )

AWS::DMS::Endpoint

The AWS::DMS::Endpoint resource creates an AWS DMS endpoint.

Syntax

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

JSON

{ "Type" : "AWS::DMS::Endpoint", "Properties" : { "CertificateArn" : String, "DatabaseName" : String, "DynamoDbSettings" : DynamoDbSettings, "ElasticsearchSettings" : ElasticsearchSettings, "EndpointIdentifier" : String, "EndpointType" : String, "EngineName" : String, "ExtraConnectionAttributes" : String, "KinesisSettings" : KinesisSettings, "KmsKeyId" : String, "MongoDbSettings" : MongoDbSettings, "Password" : String, "Port" : Integer, "S3Settings" : S3Settings, "ServerName" : String, "SslMode" : String, "Tags" : [ Tag, ... ], "Username" : String } }

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.

Required: No

Type: String

Update requires: No interruption

DynamoDbSettings

Settings in JSON format for the target Amazon DynamoDB endpoint. For more information about the available settings, see Using Object Mapping to Migrate Data to DynamoDB in the AWS Database Migration Service User Guide.

Required: No

Type: DynamoDbSettings

Update requires: No interruption

ElasticsearchSettings

Settings in JSON format for the target Elasticsearch endpoint. For more information about the available settings, see Extra Connection Attributes When Using Elasticsearch as a Target for AWS DMS in the AWS Database Migration User Guide.

Required: No

Type: ElasticsearchSettings

Update requires: No interruption

EndpointIdentifier

The database endpoint identifier. Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must not 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. Valid values, depending on the EndpointType value, include mysql, oracle, postgres, mariadb, aurora, aurora-postgresql, redshift, s3, db2, azuredb, sybase, dynamodb, mongodb, and sqlserver.

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

Required: No

Type: String

Update requires: No interruption

KinesisSettings

Settings in JSON format for the target Amazon Kinesis Data Streams endpoint. For more information about the available settings, see Using Object Mapping to Migrate Data to a Kinesis Data Stream in the AWS Database Migration User Guide.

Required: No

Type: KinesisSettings

Update requires: No interruption

KmsKeyId

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.

Required: No

Type: String

Update requires: Replacement

MongoDbSettings

Settings in JSON format for the source MongoDB endpoint. For more information about the available settings, see the configuration properties section in Using MongoDB as a Target for AWS Database Migration Service in the AWS Database Migration Service User Guide.

Required: No

Type: MongoDbSettings

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

S3Settings

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.

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

Required: No

Type: String

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

Update requires: No interruption

Tags

One or more tags to be assigned to the endpoint.

Required: No

Type: List of Tag

Update requires: Replacement

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