DeleteLink

Deletes a link between gateways.

Permanently removes the connection between gateways. This action cannot be undone.

Request Syntax


DELETE /gateway/gatewayId/link/linkId HTTP/1.1

The request uses the following URI parameters.

The unique identifier of the gateway.

Pattern: rtb-gw-[a-z0-9-]{1,25}

Required: Yes

The unique identifier of the link.

Pattern: link-[a-z0-9-]{1,25}

Required: Yes

The request does not have a request body.


HTTP/1.1 200
Content-type: application/json

{
   "linkId": "string",
   "status": "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.

The unique identifier of the link.

Type: String

Pattern: link-[a-z0-9-]{1,25}

The status of the link.

Type: String

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

AccessDeniedException

The request could not be completed because you do not have sufficient access to perform this action.

HTTP Status Code: 403

ConflictException

The request could not be completed because of a conflict in the current state of the resource.

HTTP Status Code: 409

InternalServerException

The request could not be completed because of an internal server error. Try your call again.

HTTP Status Code: 500

ResourceNotFoundException

The request could not be completed because the resource does not exist.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The request could not be completed because it fails satisfy the constraints specified by the service.

HTTP Status Code: 400