DisassociateLink - AWS Global Networks for Transit Gateways

DisassociateLink

Disassociates an existing device from a link. You must first disassociate any customer gateways that are associated with the link.

DELETE /global-networks/globalNetworkId/link-associations?deviceId=DeviceId&linkId=LinkId HTTP/1.1

The request uses the following URI parameters.

The ID of the device.

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

Pattern: [\s\S]*

Required: Yes

The ID of the global network.

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

Pattern: [\s\S]*

Required: Yes

The ID of the link.

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

Pattern: [\s\S]*

Required: Yes

The request does not have a request body.

HTTP/1.1 200 Content-type: application/json { "LinkAssociation": { "DeviceId": "string", "GlobalNetworkId": "string", "LinkAssociationState": "string", "LinkId": "string" } }

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 the link association.

Type: LinkAssociation object

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

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

ConflictException

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

HTTP Status Code: 409

InternalServerException

The request has failed due to an internal error.

HTTP Status Code: 500

ResourceNotFoundException

The specified resource could not be found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the constraints.

HTTP Status Code: 400

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