

# Devices in AWS Global Networks for Transit Gateways
Devices

Devices represent a physical or virtual appliance in AWS Global Networks for Transit Gateways. When you add a device to your core network using AWS Network Manager, you can include optional information such as vendor, model and serial number to help you more easily identify the device.

In addition, you'll indicate whether the device is on-premises or in the AWS Cloud. If the device is on-premises you can specify optional information such as physical address. If the device is in the AWS Cloud, you can specify the zone, subnet ID, latitude and longitude, and physical address. Tags are also used to more help you identify this Network Manager resource.

Once added to your global network, a device can then be associated with a site. Before you can associate the device with a site using a link, you must first create the site. For more information on creating sites and linking the site to a device, see [Sites and links in AWS Global Networks for Transit Gateways](nm-sites.md).

**Note**  
A single device can't be associated with multiple sites. 

**Topics**
+ [Add a device](nm-devices-add.md)
+ [Delete a device](nm-devices-delete.md)
+ [Edit a device](nm-devices-update.md)
+ [View device details](nm-devices-working-with.md)

# Add a device using AWS Network Manager
Add a device

Create a device to represent a physical or virtual appliance.

**To add a device**

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**. Choose **Create device**.

1. For **Name** and **Description**, enter a name and description for the device.

1. For **Model**, enter the device model number.

1. For **Serial number**, enter the serial number for the device.

1. For **Type**, enter the device type.

1. For **Vendor**, enter the name of the vendor, for example, `Cisco`.

1. For **Location type**, specify whether the device is located in a remote location (on-premises network, data center, or other cloud provider) or in AWS.

   If you choose **AWS Cloud**, specify the location of the device within AWS. For **Zone**, specify the name of an Availability Zone, Local Zone, Wavelength Zone, or an Outpost. For **Subnet**, specify the Amazon Resource Name (ARN) of a subnet (for example, arn:aws:ec2:us-east-1:111111111111:subnet/subnet-abcd1234).

1. For **Address**, enter the physical address of the site, for example, `New York, NY 10004`.

1. For **Latitude**, enter the latitude coordinates for the site, for example, `40.7128`.

1. For **Longitude**, enter the longitude coordinates for the site, for example, `-74.0060`.

1. Choose **Create device**.

**Creating and viewing a device using the AWS CLI**  
Use the following commands:
+ To create a device: [create-device](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/create-device.html)
+ To view your devices: [get-devices](https://docs.aws.amazon.com/cli/latest/reference/networkmanager/get-devices.html)

# Delete a device using AWS Network Manager
Delete a device

Delete any device from your global network that's no longer needed or is no longer available.

**To delete a site**

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**.

1. Choose the device that you want to want to delete, and then choose **Delete**.

1. Confirm that you want to delete the site by choosing **Delete** again.

   Deletion occurs immediately.

# Edit a device using AWS Network Manager
Edit a device

Edit the details of a device, including whether the location type is either on-premises or AWS Cloud. 

**To update a device**

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**.

1. Choose the check box of the device that you want to update, and then choose **Edit**.

1. Choose **Edit device**.

1. Add or update any of the following device information:
   + **Description**
   + **Model**
   + **Serial number**
   + **Type**
   + **Vendor**
   + **Location type**
   + **Latitude**
   + **Longitude**
   + **Tags**

1. Choose **Edit device**.

# View device details using AWS Network Manager
View device details

View details about a device. On the device details page you can access tabs:
+  **Overview**

  This tab provides general information about the device, such as the device State, Vendor, and Model. You can also edit, delete, and associate or disassociate the device with a site, 
+ **Links**

  Associate or disassociate a link with a device.
+ **On-premises associations**

  Associate or disassociate a device with a customer gateway. You must have at least one gateway set up and one link to create the association.
+ **Connect peer associations**

  Associate a Connect peer with a device, allowing you to connect with a transit gateway. You must have at least one Connect peer and one link.
+ **Connections**

  Create a connection between two devices using a link. You can create a connection between two devices in your global network. The connection can be between a physical or virtual appliance and a third-party appliance in a VPC, or between physical appliances in an on-premises network. A connection is created for a specific global network and cannot be shared with other global networks.
+ **VPNs**

  View the VPNs associated with the device. On this tab you can only view the associations of a transit gateway with a device.
+ **Monitoring**

  Monitor the device's data in, data out, and Tunnel down count average with CloudWatch metrics. You can modify the CloudWatch time frame as well as add these metrics to your global network dashboard.

**Topics**
+ [Associate or disassociate a device link](nm-device-link-associate.md)
+ [Associate or disassociae an on-premises link](nm-devices-onprem.md)
+ [Associate or disassociate a Connect peer](nm-devices-connect-peer.md)
+ [View VPNs](nm-devices-vpns.md)
+ [Monitor devices](nm-devices-monitoring.md)

# Associate or disassociate a device link using AWS Network Manager
Associate or disassociate a device link

Associate a link with a device in your AWS global network. In order to associate a link with a device, you must first create the link. For more information on creating links, see [Add a link using AWS Network Manager](nm-site-link-add.md).

You can only associate one link with one device. If a link is already associated with a device, and you want to use that link with another device, you must first disassociate the link the device it's associated with.

**To associate a link with a device**

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**.

1. Choose the link for the device **ID** that you want to add a link to, and then choose the **Links** tab.
**Note**  
Choose the link. Do not select the check box.

1. Choose the **Links** tab, and then choose **Associate link**.

1. Choose the link that you want to associate with the device.

1. Choose **Associate link**.

   The link is available to use immediately.

If you to use a link with another device, you must first disassociate the link from its original device.

**To disassociate a link from a device**

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**.

1. Choose the link for the device **ID** that you want to add a link to, and then choose the **Links** tab.
**Note**  
Choose the link. Do not select the check box.

1. Choose the **Links** tab, and then choose **Associate link**.

1. Choose the check box for the link that you want to disassociate from a device.

1. Choose **Disassociate link**.

   Disassociation occurs immediately.

# Associate or disassociate an on-premises link using AWS Network Manager
Associate or disassociae an on-premises link

Associate or disassociate an on-premises device link association in your AWS global network.

You can only associate one link with a customer gateway. If a link is already associated with a customer gateway, and you want to use that link with another gateway, you must first disassociate the link the gateway it's currently associated with.

**To create an on-premises association**

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**.

1. Choose the link for the device **ID** that you want to create an on-premises association for. 

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

1. Choose **Associate**.

1. Choose the on-premises **Customer gateway**.

1. (Optional) Choose the **Link** used for the connection. 

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

   The link is available to use immediately.

**To disassociate an on-premises association**

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**.

1. Choose the device **ID** link.

1. Choose the **On-premises association** tab.

1. Choose the check box for the on-premises association that you want to disassociate. 

1. Choose **Disassociate**.

   Disassociation occurs immediately.

# Associate or disassociate a Connect peer using AWS Network Manager
Associate or disassociate a Connect peer

Associate or disassociate a Connect peer device link association in your AWS global network.

You can only associate one link with a Connect peer. If a link is already associated with a Connect peer, and you want to use that link with another Connect peer, you must first disassociate the link the Connect peer it's associated with.

**To create a Connect peer association**

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**.

1. Choose the link for the device **ID** that you want to create an on-premises association for. 

1. Choose the **Connect peer** tab.

1. Choose **Associate**.

1. Choose the on-premises **Connect peer**.

1. (Optional) Choose the **Link** used for the connection. 

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

   The link is available to use immediately.

**To disassociate a Connect peer association**

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**.

1. Choose the device **ID** link.

1. Choose the **Connect peer** tab.

1. Choose the check box for the Connect peer that you want to disassociate. 

1. Choose **Disassociate**.

   Disassociation occurs immediately.

# View VPNs using AWS Network Manager
View VPNs

The VPNs page displays a list of your VPN connections for a device. 

**To view device VPN connections**

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**.

1. Choose the device that you want to view the VPN connections for.

1. Choose **VPNs**.

# Monitor devices using AWS Network Manager
Monitor devices

Monitor device Amazon CloudWatch events on the Network Manager Monitoring page. 

**To monitor devices**

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**.

1. Choose the **Monitoring** tab.

1. The **Monitoring** page displays data for the following:
   + **Data In**
   + **Data Out**
   + **Tunnel down count Average**

   (Optional) Metrics and events use the default time set up in the CloudWatch Events event. To set a custom time frame, choose **Custom** and then choose a **Relative** or **Absolute** time, and then choose if you want to see that date range in **UTC** or the edge location's **Local time zone**.

   Choose **Add to dashboard** to add this metric to your CloudWatch dashboard. For more information about using CloudWatch dashboards, see [Using Amazon CloudWatch Dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) in the *Amazon CloudWatch User Guide*.
**Note**  
The **Add to dashboard** option only works if your registered transit gateway is in the US West (Oregon) Region. 