AWS::NetworkManager::Link - AWS CloudFormation

AWS::NetworkManager::Link

Specifies a link for a site.

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

{ "Type" : "AWS::NetworkManager::Link", "Properties" : { "Bandwidth" : Bandwidth, "Description" : String, "GlobalNetworkId" : String, "Provider" : String, "SiteId" : String, "Tags" : [ Tag, ... ], "Type" : String } }
Type: AWS::NetworkManager::Link Properties: Bandwidth: Bandwidth Description: String GlobalNetworkId: String Provider: String SiteId: String Tags: - Tag Type: String

The bandwidth for the link.

Required: Yes

Type: Bandwidth

Update requires: No interruption

A description of the link.

Constraints: Maximum length of 256 characters.

Required: No

Type: String

Pattern: [\s\S]*

Minimum: 0

Maximum: 256

Update requires: No interruption

The ID of the global network.

Required: Yes

Type: String

Pattern: [\s\S]*

Minimum: 0

Maximum: 50

Update requires: Replacement

The provider of the link.

Constraints: Maximum length of 128 characters. Cannot include the following characters: | \ ^

Required: No

Type: String

Pattern: [\s\S]*

Minimum: 0

Maximum: 256

Update requires: No interruption

The ID of the site.

Required: Yes

Type: String

Pattern: [\s\S]*

Minimum: 0

Maximum: 50

Update requires: Replacement

The tags for the link.

Required: No

Type: Array of Tag

Update requires: No interruption

The type of the link.

Constraints: Maximum length of 128 characters. Cannot include the following characters: | \ ^

Required: No

Type: String

Pattern: [\s\S]*

Minimum: 0

Maximum: 256

Update requires: No interruption

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the IDs of the global network and link. For example: global-network-01231231231231231|link-11112222aaaabbbb1.

For more information about using the Ref function, see Ref.

The Fn::GetAtt intrinsic 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::GetAtt intrinsic function, see Fn::GetAtt.

CreatedAt

The date and time that the link was created.

LinkArn

The ARN of the link. For example, arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1.

LinkId

The ID of the link. For example, link-11112222aaaabbbb1.

State

The state of the link.

The following example creates a link in a global network.

{ "Type": "AWS::NetworkManager::Link", "Properties": { "Description": "Broadband link", "GlobalNetworkId": { "Ref": "GlobalNetwork" }, "SiteId": { "Fn::GetAtt": [ "Site", "SiteId" ] }, "Bandwidth": { "DownloadSpeed": 20, "UploadSpeed": 20 }, "Provider": "AnyCompany", "Type": "Broadband", "Tags": [ { "Key": "Name", "Value": "broadband-link-1" } ] } }
Type: AWS::NetworkManager::Link Properties: Description: "Broadband link" GlobalNetworkId: !Ref GlobalNetwork SiteId: !GetAtt Site.SiteId Bandwidth: DownloadSpeed: 20 UploadSpeed: 20 Provider: "AnyCompany" Type: "Broadband" Tags: - Key: Name Value: broadband-link-1