Lag - Amazon Direct Connect
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).

Lag

Information about a link aggregation group (LAG).

Contents

allowsHostedConnections

Indicates whether the LAG can host other connections.

Type: Boolean

Required: No

awsDevice

This member has been deprecated.

The Amazon Direct Connect endpoint that hosts the LAG.

Type: String

Required: No

awsDeviceV2

The Amazon Direct Connect endpoint that hosts the LAG.

Type: String

Required: No

awsLogicalDeviceId

The Direct Connect endpoint that terminates the logical connection. This device might be different than the device that terminates the physical connection.

Type: String

Required: No

connections

The connections bundled by the LAG.

Type: Array of Connection objects

Required: No

connectionsBandwidth

The individual bandwidth of the physical connections bundled by the LAG. The possible values are 1Gbps and 10Gbps.

Type: String

Required: No

encryptionMode

The LAG MAC Security (MACsec) encryption mode.

The valid values are no_encrypt, should_encrypt, and must_encrypt.

Type: String

Required: No

hasLogicalRedundancy

Indicates whether the LAG supports a secondary BGP peer in the same address family (IPv4/IPv6).

Type: String

Valid Values: unknown | yes | no

Required: No

jumboFrameCapable

Indicates whether jumbo frames are supported.

Type: Boolean

Required: No

lagId

The ID of the LAG.

Type: String

Required: No

lagName

The name of the LAG.

Type: String

Required: No

lagState

The state of the LAG. The following are the possible values:

  • requested: The initial state of a LAG. The LAG stays in the requested state until the Letter of Authorization (LOA) is available.

  • pending: The LAG has been approved and is being initialized.

  • available: The network link is established and the LAG is ready for use.

  • down: The network link is down.

  • deleting: The LAG is being deleted.

  • deleted: The LAG is deleted.

  • unknown: The state of the LAG is not available.

Type: String

Valid Values: requested | pending | available | down | deleting | deleted | unknown

Required: No

location

The location of the LAG.

Type: String

Required: No

macSecCapable

Indicates whether the LAG supports MAC Security (MACsec).

Type: Boolean

Required: No

macSecKeys

The MAC Security (MACsec) security keys associated with the LAG.

Type: Array of MacSecKey objects

Required: No

The minimum number of physical dedicated connections that must be operational for the LAG itself to be operational.

Type: Integer

Required: No

numberOfConnections

The number of physical dedicated connections bundled by the LAG, up to a maximum of 10.

Type: Integer

Required: No

ownerAccount

The ID of the Amazon Web Services account that owns the LAG.

Type: String

Required: No

providerName

The name of the service provider associated with the LAG.

Type: String

Required: No

region

The Amazon Web Services Region where the connection is located.

Type: String

Required: No

tags

The tags associated with the LAG.

Type: Array of Tag objects

Array Members: Minimum number of 1 item.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: