Devices
You can represent your on-premises network in your global network through sites, devices, and links. For more information, see Define and associate your on-premises network. You can then associate a device with a site and one or more links.
You can also create a device to represent a virtual appliance in your AWS network. For more information, see Connection between devices.
A device is created for a specific global network and cannot be shared with other global networks.
Create a device
Create a device to represent a physical or virtual appliance.
To create a device
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices. Choose Create device.
-
For Name and Description, enter a name and description for the device.
-
For Model, enter the device model number.
-
For Serial number, enter the serial number for the device.
-
For Type, enter the device type.
-
For Vendor, enter the name of the vendor, for example,
Cisco
. -
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).
-
For Address, enter the physical address of the site, for example,
New York, NY 10004
. -
For Latitude, enter the latitude coordinates for the site, for example,
40.7128
. -
For Longitude, enter the longitude coordinates for the site, for example,
-74.0060
. -
Choose Create device.
Creating and viewing a device using the AWS CLI
Use the following commands:
-
To create a device: create-device
-
To view your devices: get-devices
Update a device
You can update the details of your device, including the description, model, serial number, type, vendor, and location information.
To update a device
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices and select the device.
-
Choose Edit.
-
Update the device details as needed, then choose Edit device.
Updating a device using the AWS CLI
Use the update-device command.
Delete a device
If you no longer need a device, you can delete it. You must first disassociate the device from any sites, links, and customer gateways.
To delete a device
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices.
-
Select the site and choose Delete.
-
In the confirmation dialog box, choose Delete.
Deleting a device using the AWS CLI
Use the delete-device command.
Associate a device
You can associate a device with a site, and a device with one or more links.
Device and site associations
A site can have multiple devices associated with it, but a device can only be associated with a single site.
To associate a device and site
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices, and choose the ID of your device.
-
Choose Associate site.
-
For Site, choose the name of your site from the list.
-
Choose Edit site association.
You can remove the association between a device and a site.
To disassociate a device and site
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices, and choose the ID of your device.
-
Choose Disassociate site.
Working with device and site associations using the AWS CLI
When you create a new device using the create-device AWS CLI command, you can specify the site to associate with the device. For an existing device, you can use the update-device AWS CLI command to associate or disassociate a site.
Device and link associations
A link can be associated with more than one device. The device must be associated with a site.
To associate a link and a device
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices, and choose the ID of your device.
-
Choose Links.
-
Choose Associate link.
-
Choose the link to associate, then choose Associate link.
You can remove the association between a link and a device.
To disassociate a link and a device
Access the Network Manager console at https://console.aws.amazon.com/networkmanager/home/
. -
Under Connectivity, choose Global Networks.
-
On the Global networks page, choose the global network ID.
-
In the navigation pane, choose Devices, and choose the ID of your device.
-
Choose Links.
-
Select the link and choose Disassociate.
Working with device and link associations using the AWS CLI
You can work with device associations using the following commands.
-
To associate a link with a device: associate-link
-
To view your link associations: get-link-associations
-
To disassociate a link from a device: disassociate-link