Skip to main content

connections

Creates, updates, deletes, gets or lists a connections resource.

Overview

Nameconnections
TypeResource
Idaws.dms.connections

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
endpoint_arnstringThe ARN string that uniquely identifies the endpoint.
endpoint_identifierstringThe identifier of the endpoint. 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.
last_failure_messagestringThe error message when the connection last failed.
replication_instance_arnstringThe ARN of the replication instance.
replication_instance_identifierstringThe replication instance identifier. This parameter is stored as a lowercase string.
statusstringThe connection status. This parameter can return one of the following values: "successful" "testing" "failed" "deleting"

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_connectionsselectregionDescribes the status of the connections that have been made between the replication instance and an endpoint. Connections are created when you test an endpoint.
delete_connectiondeleteregionDeletes the connection between a replication instance and an endpoint.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)

SELECT examples

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.

SELECT
endpoint_arn,
endpoint_identifier,
last_failure_message,
replication_instance_arn,
replication_instance_identifier,
status
FROM aws.dms.connections
WHERE region = '{{ region }}' -- required
;

DELETE examples

Deletes the connection between a replication instance and an endpoint.

DELETE FROM aws.dms.connections
WHERE region = '{{ region }}' --required
;