

# Gateway associations in AWS Global Networks for Transit Gateways
Gateway associations

Create a customer gateway association with either a device or with a transit gateway Connect peer.

## Customer gateway associations


To add your on-premises network to your global network, you associate a customer gateway with your device, and optionally, a link. The customer gateway must already be in your global network as part of a VPN attachment in your transit gateway. If you specify a link, it must already be associated with the specified device.

For more information about creating a customer gateway, see [Create a Customer Gateway](https://docs.aws.amazon.com/vpn/latest/s2svpn/SetUpVPNConnections.html#vpn-create-cgw) in the *AWS Site-to-Site VPN User Guide*. For more information about creating a VPN attachment to a transit gateway, see [Transit Gateway VPN Attachments](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpn-attachments.html) in *Amazon VPC Transit Gateways*.

For more information about viewing the topology of your on-premises network in Network Manager, see [Access transit gateway network dashboards using AWS Network Manager](nm-monitoring-console.md) />.

## Transit Gateway Connect peer associations


You can associate a [Connect peer](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-connect.html#tgw-connect-peer) (in a transit gateway Connect attachment) with a device, and optionally, with a link.

 If you specify a link, it must be associated with the specified device.

**Topics**
+ [

## Customer gateway associations
](#cgw-associations)
+ [

## Transit Gateway Connect peer associations
](#tgw-associations)
+ [Associate a customer gateway with a device](nm-cgw-associate.md)
+ [Disassociate a customer gateway association from a device](nm-cgw-diasssociate.md)
+ [Add a Connect peer association](connect-peer-association.md)
+ [Disassociate a Connect peer from a device](nm-cgw-connect-disassociate.md)

# Associate a customer gateway using AWS Network Manager
Associate a customer gateway with a device

You can associate a customer gateway with a device and link using the Network Manager console on either of the following pages:
+ On the **Transit gateways** page
+ On the **Devices** page

------
#### [ Transit gateways page ]

**To associate a customer gateway using the Transit gateways page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Transit gateways**, and then choose the ID of your transit gateway.

1. Choose **On-premises associations**.

1. Select your customer gateway and choose **Associate**.

1. For **Device**, select the ID of the device to associate. For **Link**, select the ID of the link to associate.

1. Choose **Edit on-premises association**.

------
#### [ Devices page ]

**To associate a customer gateway using the Devices page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Devices**, and then choose the ID of your device.

1. Choose **On-premises associations**.

1. Choose **Associate**.

1. For **Customer gateway**, select the ID of the customer gateway to associate. For **Link**, select the ID of the link to associate.

1. Choose **Create on-premises association**.

------

**Create a customer gateway association using the AWS CLI**  
You can view and create a customer gateway association using the following commands.
+ To associate a customer gateway with a device and link: [associate-customer-gateway](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/associate-customer-gateway.html)
+ To view your customer gateway associations: [get-customer-gateway-associations](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/get-customer-gateway-associations.html)

# Disassociate a customer gateway using AWS Network Manager
Disassociate a customer gateway association from a device

You can disassociate a customer gateway from a device or link using the Network Manager console on either of the following pages:
+ On the **Transit gateways** page
+ On the **Devices** page

------
#### [ Transit gateways page ]

**To disassociate a customer gateway using the Transit gateways page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Transit gateways**, and then choose **On-premises associations**.

1. Select your customer gateway and choose **Disassociate**.

------
#### [ Devices page ]

**To disassociate a customer gateway using the Devices page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Devices**, and then choose the ID of your device.

1. Choose **On-premises associations**.

1. Select your customer gateway and choose **Disassociate**.

------

**Disassociate a customer gateway association using the AWS CLI**  
You can view and disassociate a customer gateway association using the following command.
+ To view your customer gateway associations: [get-customer-gateway-associations](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/get-customer-gateway-associations.html)
+ To disassociate a customer gateway from a device and link: [disassociate-customer-gateway](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/disassociate-customer-gateway.html)

# Add a Connect peer association using AWS Network Manager
Add a Connect peer association

Create a transit gateway Connect peer association using the Network Manager console on either of the following pages:
+ On the **Transit gateways** page
+ On the **Devices** page

------
#### [ Transit gateways page ]

**To associate a Connect peer using the Transit gateways page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Transit gateways**, and then choose the ID of your transit gateway.

1. Choose **Connect peer associations**.

1. Select the Connect peer and choose **Edit**.

1. For **Device**, select the ID of the device to associate. For **Link**, select the ID of the link to associate.

1. Choose **Edit Connect peer association**.

------
#### [ Devices page ]

**To associate a Connect peer using the Devices page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Devices**, and choose the ID of the device.

1. Choose **Connect peer associations**.

1. Choose **Associate**.

1. For **Connect peer**, choose the Connect peer.

1. (Optional) For **Link**, choose the link for the Connect peer association.

1. Choose **Create Connect peer association**.

------

**Working with Connect peer associations using the AWS CLI**  
You can view and create Connect peer associations using the following commands.
+ To associate a Connect peer with a device: [associate-transit-gateway-connect-peer](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/associate-transit-gateway-connect-peer.html)
+ To view your Connect peer associations: [get-transit-gateway-connect-peer-associations](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/get-transit-gateway-connect-peer-associations.html)

# Disassociate a Connect peer using AWS Network Manager
Disassociate a Connect peer from a device

You can disassociate a Connect peer from a device in one of the following ways:
+ On the **Transit gateways** page
+ On the **Devices** page

------
#### [ Transit gateways page ]

**To disassociate a Connect peer using the Transit gateways page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Transit gateways**, and then choose **Connect peer associations**.

1. Select the Connect peer and choose **Disassociate**.

------
#### [ Devices page ]

**To disassociate a Connect peer using the Devices page**

1. Access the Network Manager console at [https://console.aws.amazon.com/networkmanager/home/](https://console.aws.amazon.com/networkmanager/home).

1. Under **Connectivity**, choose **Global Networks**.

1. On the **Global networks** page, choose the global network ID.

1. In the navigation pane, choose **Devices**, and then choose the ID of your device.

1. Choose **Connect peer associations**.

1. Select the Connect peer and choose **Disassociate**.

------

**Working with Connect peer associations using the AWS CLI**  
You can view and disassociate Connect peer associations using the following commands.
+ To view your Connect peer associations: [get-transit-gateway-connect-peer-associations](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/get-transit-gateway-connect-peer-associations.html)
+ To disassociate a Connect peer from a device: [disassociate-transit-gateway-connect-peer](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/disassociate-transit-gateway-connect-peer.html)