AWS::NetworkManager::Device - Amazon CloudFormation
SyntaxPropertiesReturn valuesExamples
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::NetworkManager::Device

Specifies a device.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::NetworkManager::Device",
  "Properties" : {
      "AWSLocation" : AWSLocation,
      "Description" : String,
      "GlobalNetworkId" : String,
      "Location" : Location,
      "Model" : String,
      "SerialNumber" : String,
      "SiteId" : String,
      "Tags" : [ Tag, ... ],
      "Type" : String,
      "Vendor" : String
    }
}

YAML

Type: AWS::NetworkManager::Device
Properties: 
  AWSLocation: 
    AWSLocation
  Description: String
  GlobalNetworkId: String
  Location: 
    Location
  Model: String
  SerialNumber: String
  SiteId: String
  Tags: 
    - Tag
  Type: String
  Vendor: String

Properties

AWSLocation

Property description not available.

Required: No

Type: AWSLocation

Update requires: No interruption

Description

A description of the device.

Constraints: Maximum length of 256 characters.

Required: No

Type: String

Minimum: 0

Maximum: 256

Pattern: [\s\S]*

Update requires: No interruption

GlobalNetworkId

The ID of the global network.

Required: Yes

Type: String

Minimum: 0

Maximum: 50

Pattern: [\s\S]*

Update requires: Replacement

Location

The site location.

Required: No

Type: Location

Update requires: No interruption

Model

The model of the device.

Constraints: Maximum length of 128 characters.

Required: No

Type: String

Minimum: 0

Maximum: 256

Pattern: [\s\S]*

Update requires: No interruption

SerialNumber

The serial number of the device.

Constraints: Maximum length of 128 characters.

Required: No

Type: String

Minimum: 0

Maximum: 256

Pattern: [\s\S]*

Update requires: No interruption

SiteId

The site ID.

Required: No

Type: String

Minimum: 0

Maximum: 50

Pattern: [\s\S]*

Update requires: No interruption

Tags

The tags for the device.

Required: No

Type: List of Tag

Update requires: No interruption

Type

The device type.

Required: No

Type: String

Minimum: 0

Maximum: 256

Pattern: [\s\S]*

Update requires: No interruption

Vendor

The vendor of the device.

Constraints: Maximum length of 128 characters.

Required: No

Type: String

Minimum: 0

Maximum: 256

Pattern: [\s\S]*

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns the IDs of the global network and device. For example: global-network-01231231231231231|device-07f6fd08867abc123.

For more information about using the Reffunction, see Ref.

Fn::GetAtt

The Fn::GetAttintrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAttintrinsic function, see Fn::GetAtt.

CreatedAt

Property description not available.

DeviceArn

The ARN of the device. For example, arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123.

DeviceId

The ID of the device. For example, device-07f6fd08867abc123.

Examples

Device

The following example creates a device in a global network.

JSON

{
    "Type": "AWS::NetworkManager::Device",
    "Properties": {
        "Description": "Chicago office device",
        "GlobalNetworkId": {
            "Ref": "GlobalNetwork"
        },
        "SiteId": {
            "Fn::GetAtt": [
                "Site",
                "SiteId"
            ]
        },
        "Location": {
            "Address": "227 W Monroe St, Chicago, IL 60606",
            "Latitude": "41.8",
            "Longitude": "-87.6"
        },
        "Tags": [
            {
                "Key": "Network",
                "Value": "north-america"
            }
        ]
    }
}

YAML

Type: AWS::NetworkManager::Device
Properties:
  Description: "Chicago office device"
  GlobalNetworkId: !Ref GlobalNetwork
  SiteId: !GetAtt Site.SiteId
  Location:
    Address: "227 W Monroe St, Chicago, IL 60606"
    Latitude: "41.8"
    Longitude: "-87.6"
  Tags:
    - Key: Network
      Value: north-america