AssociateLink - AWS Network Manager

AssociateLink

Associates a link to a device. A device can be associated to multiple links and a link can be associated to multiple devices. The device and link must be in the same global network and the same site.

POST /global-networks/globalNetworkId/link-associations HTTP/1.1 Content-type: application/json { "DeviceId": "string", "LinkId": "string" }

The request uses the following URI parameters.

globalNetworkId

The ID of the global network.

Required: Yes

The request accepts the following data in JSON format.

DeviceId

The ID of the device.

Type: String

Required: Yes

LinkId

The ID of the link.

Type: String

Required: Yes

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.

LinkAssociation

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

ServiceQuotaExceededException

A service limit was exceeded.

HTTP Status Code: 402

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: