DatabaseMigrationService / Client / delete_connection

delete_connection

DatabaseMigrationService.Client.delete_connection(**kwargs)

Deletes the connection between a replication instance and an endpoint.

See also: AWS API Documentation

Request Syntax

response = client.delete_connection(
    EndpointArn='string',
    ReplicationInstanceArn='string'
)

Parameters:

• EndpointArn (string) –

  [REQUIRED]

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

• ReplicationInstanceArn (string) –

  [REQUIRED]

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

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 that is being deleted.

    • 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.AccessDeniedFault

• DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault

• DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault

Examples

Deletes the connection between the replication instance and the endpoint.

response = client.delete_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': {
        '...': '...',
    },
}