DeletePeering - AWS Global Networks for Transit Gateways


Deletes an existing peering connection.

Request Syntax

DELETE /peerings/peeringId HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The ID of the peering connection to delete.

Length Constraints: Minimum length of 0. Maximum length of 50.

Pattern: ^peering-([0-9a-f]{8,17})$

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "Peering": { "CoreNetworkArn": "string", "CoreNetworkId": "string", "CreatedAt": number, "EdgeLocation": "string", "LastModificationErrors": [ { "Code": "string", "Message": "string", "MissingPermissionsContext": { "MissingPermission": "string" }, "RequestId": "string", "ResourceArn": "string" } ], "OwnerAccountId": "string", "PeeringId": "string", "PeeringType": "string", "ResourceArn": "string", "State": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


Information about a deleted peering connection.

Type: Peering object


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


You do not have sufficient access to perform this action.

HTTP Status Code: 403


There was a conflict processing the request. Updating or deleting the resource can cause an inconsistent state.

HTTP Status Code: 409


The request has failed due to an internal error.

HTTP Status Code: 500


The specified resource could not be found.

HTTP Status Code: 404


The request was denied due to request throttling.

HTTP Status Code: 429


The input fails to satisfy the constraints.

HTTP Status Code: 400

See Also

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