---
title: "POST /global-networks/{globalNetworkId}/link-associations"
method: POST
path: "/global-networks/{globalNetworkId}/link-associations"
---

# POST /global-networks/{globalNetworkId}/link-associations

`POST /global-networks/{globalNetworkId}/link-associations`

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.

## Path parameters

- `globalNetworkId` string, required

## Request body

- object
  - `DeviceId` string, required — The ID of the device.
  - `LinkId` string, required — The ID of the link.

## Response `200`

Success

- AssociateLinkResponse
  - `LinkAssociation` object — The link association.
    - `GlobalNetworkId` string — The ID of the global network.
    - `DeviceId` string — The device ID for the link association.
    - `LinkId` string — The ID of the link.
    - `LinkAssociationState` 'PENDING' | 'AVAILABLE' | 'DELETING' | 'DELETED' — The state of the association.

## Other responses

- `480` — ValidationException
- `481` — ServiceQuotaExceededException
- `482` — AccessDeniedException
- `483` — ResourceNotFoundException
- `484` — ConflictException
- `485` — ThrottlingException
- `486` — InternalServerException

---

[API](https://skmtc.net/aws/apis/networkmanager.md) · [All operations](https://skmtc.net/aws/apis/networkmanager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/networkmanager/versions/4ea0acef56bf/schema)