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

Interconnect

An interconnect is a connection that can host other connections.

Like a standard AWS Direct Connect connection, an interconnect represents the physical connection between an AWS Direct Connect partner's network and a specific Direct Connect location. An AWS Direct Connect partner who owns an interconnect can provision hosted connections on the interconnect for their end customers, thereby providing the end customers with connectivity to AWS services.

The resources of the interconnect, including bandwidth and VLAN numbers, are shared by all of the hosted connections on the interconnect, and the owner of the interconnect determines how these resources are assigned.

Contents

awsDevice

The Direct Connection endpoint which the physical connection terminates on.

Type: String

Required: No

bandwidth

Bandwidth of the connection.

Example: 1Gbps

Default: None

Type: String

Required: No

interconnectId

The ID of the interconnect.

Example: dxcon-abc123

Type: String

Required: No

interconnectName

The name of the interconnect.

Example: "1G Interconnect to AWS"

Type: String

Required: No

interconnectState

State of the interconnect.

  • Requested: The initial state of an interconnect. The interconnect stays in the requested state until the Letter of Authorization (LOA) is sent to the customer.

  • Pending: The interconnect has been approved, and is being initialized.

  • Available: The network link is up, and the interconnect is ready for use.

  • Down: The network link is down.

  • Deleting: The interconnect is in the process of being deleted.

  • Deleted: The interconnect has been deleted.

Type: String

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

Required: No

lagId

The ID of the LAG.

Example: dxlag-fg5678gh

Type: String

Required: No

loaIssueTime

The time of the most recent call to DescribeInterconnectLoa for this Interconnect.

Type: Timestamp

Required: No

location

Where the connection is located.

Example: EqSV5

Default: None

Type: String

Required: No

region

The AWS region where the connection is located.

Example: us-east-1

Default: None

Type: String

Required: No

See Also

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

On this page: