test_connection

DatabaseMigrationService.Client.test_connection(**kwargs)

Tests the connection between the replication instance and the endpoint.

See also: AWS API Documentation

Request Syntax

response = client.test_connection(
    ReplicationInstanceArn='string',
    EndpointArn='string'
)
Parameters
  • ReplicationInstanceArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the replication instance.

  • EndpointArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) string that uniquely identifies the endpoint.

Return type

dict

Returns

Response Syntax

{
    'Connection': {
        'ReplicationInstanceArn': 'string',
        'EndpointArn': 'string',
        'Status': 'string',
        'LastFailureMessage': 'string',
        'EndpointIdentifier': 'string',
        'ReplicationInstanceIdentifier': 'string'
    }
}

Response Structure

  • (dict) --

    • Connection (dict) --

      The connection tested.

      • ReplicationInstanceArn (string) --

        The ARN of the replication instance.

      • EndpointArn (string) --

        The ARN string that uniquely identifies the endpoint.

      • Status (string) --

        The connection status. This parameter can return one of the following values:

        • "successful"
        • "testing"
        • "failed"
        • "deleting"
      • LastFailureMessage (string) --

        The error message when the connection last failed.

      • EndpointIdentifier (string) --

        The 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.

      • ReplicationInstanceIdentifier (string) --

        The replication instance identifier. This parameter is stored as a lowercase string.

Exceptions

  • DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault
  • DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault
  • DatabaseMigrationService.Client.exceptions.KMSKeyNotAccessibleFault
  • DatabaseMigrationService.Client.exceptions.ResourceQuotaExceededFault
  • DatabaseMigrationService.Client.exceptions.AccessDeniedFault

Examples

Tests the connection between the replication instance and the endpoint.

response = client.test_connection(
    EndpointArn='arn:aws:dms:us-east-1:123456789012:endpoint:RAAR3R22XSH46S3PWLC3NJAWKM',
    ReplicationInstanceArn='arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ',
)

print(response)

Expected Output:

{
    'Connection': {
    },
    'ResponseMetadata': {
        '...': '...',
    },
}