View a markdown version of this page

DeleteConnection - AWS Interconnect

DeleteConnection

Deletes an existing Connection with the supplied identifier.

This operation will also inform the remote partner of your intention to delete your connection. Note, the partner may still require you to delete to fully clean up resources, but the network connectivity provided by the Connection will cease to exist.

Request Parameters

clientToken

Idempotency token used for the request.

Type: String

Required: No

identifier

The identifier of the Connection to be deleted.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 32.

Pattern: (mcc|lmcc)-[a-z0-9]{8}

Required: Yes

Response Elements

The following element is returned by the service.

connection

The Connection object that has been marked for deletion.

Type: Connection object

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

The calling principal is not allowed to access the specified resource, or the resource does not exist.

HTTP Status Code: 403

InterconnectClientException

The request was denied due to incorrect client supplied parameters.

HTTP Status Code: 400

InterconnectServerException

The request resulted in an exception internal to the service.

HTTP Status Code: 500

InterconnectValidationException

The input fails to satisfy the constraints specified.

HTTP Status Code: 400

ResourceNotFoundException

The request specifies a resource that does not exist on the server.

HTTP Status Code: 404

ServiceQuotaExceededException

The requested operation would result in the calling principal exceeding their allotted quota.

HTTP Status Code: 402

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: