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

# POST /global-networks/{globalNetworkId}/connections

`POST /global-networks/{globalNetworkId}/connections`

Creates a connection between two devices. The devices can be a physical or virtual appliance that connects to a third-party appliance in a VPC, or a physical appliance that connects to another physical appliance in an on-premises network.

## Path parameters

- `globalNetworkId` string, required

## Request body

- object
  - `DeviceId` string, required — The ID of the first device in the connection.
  - `ConnectedDeviceId` string, required — The ID of the second device in the connection.
  - `LinkId` string — The ID of the link for the first device.
  - `ConnectedLinkId` string — The ID of the link for the second device.
  - `Description` string — <p>A description of the connection.</p> <p>Length Constraints: Maximum length of 256 characters.</p>
  - `Tags` Tag[] — The tags to apply to the resource during creation.
    - `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>

## Response `200`

Success

- CreateConnectionResponse
  - `Connection` object — Information about the connection.
    - `ConnectionId` string — The ID of the connection.
    - `ConnectionArn` string — The Amazon Resource Name (ARN) of the connection.
    - `GlobalNetworkId` string — The ID of the global network.
    - `DeviceId` string — The ID of the first device in the connection.
    - `ConnectedDeviceId` string — The ID of the second device in the connection.
    - `LinkId` string — The ID of the link for the first device in the connection.
    - `ConnectedLinkId` string — The ID of the link for the second device in the connection.
    - `Description` string — The description of the connection.
    - `CreatedAt` string, date-time — The date and time that the connection was created.
    - `State` 'PENDING' | 'AVAILABLE' | 'DELETING' | 'UPDATING' — The state of the connection.
    - `Tags` Tag[] — The tags for the connection.
      - `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` — ServiceQuotaExceededException
- `482` — AccessDeniedException
- `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)