---
title: "DELETE /global-networks/{globalNetworkId}/links/{linkId}"
method: DELETE
path: "/global-networks/{globalNetworkId}/links/{linkId}"
---

# DELETE /global-networks/{globalNetworkId}/links/{linkId}

`DELETE /global-networks/{globalNetworkId}/links/{linkId}`

Deletes an existing link. You must first disassociate the link from any devices and customer gateways.

## Path parameters

- `globalNetworkId` string, required
- `linkId` string, required

## Response `200`

Success

- DeleteLinkResponse
  - `Link` object — Information about the link.
    - `LinkId` string — The ID of the link.
    - `LinkArn` string — The Amazon Resource Name (ARN) of the link.
    - `GlobalNetworkId` string — The ID of the global network.
    - `SiteId` string — The ID of the site.
    - `Description` string — The description of the link.
    - `Type` string — The type of the link.
    - `Bandwidth` object — The bandwidth for the link.
      - `UploadSpeed` integer — Upload speed in Mbps.
      - `DownloadSpeed` integer — Download speed in Mbps.
    - `Provider` string — The provider of the link.
    - `CreatedAt` string, date-time — The date and time that the link was created.
    - `State` 'PENDING' | 'AVAILABLE' | 'DELETING' | 'UPDATING' — The state of the link.
    - `Tags` Tag[] — The tags for the link.
      - `Key` string — <p>The tag key.</p> <p>Constraints: Maximum length of 128 characters.</p>
      - `Value` string — <p>The tag value.</p> <p>Constraints: Maximum length of 256 characters.</p>

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ConflictException
- `484` — ThrottlingException
- `485` — 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)