AWS Direct Connect
API Reference (API Version 2012-10-25)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


Deletes the specified link aggregation group (LAG). You cannot delete a LAG if it has active virtual interfaces or hosted connections.

Request Syntax

{ "lagId": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


The ID of the LAG.

Type: String

Required: Yes

Response Syntax

{ "allowsHostedConnections": boolean, "awsDevice": "string", "awsDeviceV2": "string", "connections": [ { "awsDevice": "string", "awsDeviceV2": "string", "bandwidth": "string", "connectionId": "string", "connectionName": "string", "connectionState": "string", "hasLogicalRedundancy": "string", "jumboFrameCapable": boolean, "lagId": "string", "loaIssueTime": number, "location": "string", "ownerAccount": "string", "partnerName": "string", "region": "string", "tags": [ { "key": "string", "value": "string" } ], "vlan": number } ], "connectionsBandwidth": "string", "hasLogicalRedundancy": "string", "jumboFrameCapable": boolean, "lagId": "string", "lagName": "string", "lagState": "string", "location": "string", "minimumLinks": number, "numberOfConnections": number, "ownerAccount": "string", "region": "string", "tags": [ { "key": "string", "value": "string" } ] }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


Indicates whether the LAG can host other connections.

Type: Boolean


This parameter has been deprecated.

The AWS Direct Connect endpoint that hosts the LAG.

Type: String


The AWS Direct Connect endpoint that hosts the LAG.

Type: String


The connections bundled by the LAG.

Type: Array of Connection objects


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

Type: String


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

Type: String

Valid Values: unknown | yes | no


Indicates whether jumbo frames (9001 MTU) are supported.

Type: Boolean


The ID of the LAG.

Type: String


The name of the LAG.

Type: String


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


The location of the LAG.

Type: String


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

Type: Integer


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

Type: Integer


The ID of the AWS account that owns the LAG.

Type: String


The AWS Region where the connection is located.

Type: String


Any tags assigned to link aggregation group (LAG).

Type: Array of Tag objects

Array Members: Minimum number of 1 item.


For information about the errors that are common to all actions, see Common Errors.


One or more parameters are not valid.

HTTP Status Code: 400


A server-side error occurred.

HTTP Status Code: 400

See Also

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