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

Connection

A connection represents the physical network connection between the AWS Direct Connect location and the customer.

Contents

awsDevice

The Direct Connection endpoint which the physical connection terminates on.

Type: String

Required: No

bandwidth

Bandwidth of the connection.

Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections)

Default: None

Type: String

Required: No

connectionId

The ID of the connection. This field is also used as the ID type for operations that use multiple connection types (LAG, interconnect, and/or connection).

Example: dxcon-fg5678gh

Default: None

Type: String

Required: No

connectionName

The name of the connection.

Example: "My Connection to AWS"

Default: None

Type: String

Required: No

connectionState

State of the connection.

  • Ordering: The initial state of a hosted connection provisioned on an interconnect. The connection stays in the ordering state until the owner of the hosted connection confirms or declines the connection order.

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

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

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

  • Down: The network link is down.

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

  • Deleted: The connection has been deleted.

  • Rejected: A hosted connection in the 'Ordering' state will enter the 'Rejected' state if it is deleted by the end customer.

Type: String

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

Required: No

lagId

The ID of the LAG.

Example: dxlag-fg5678gh

Type: String

Required: No

loaIssueTime

The time of the most recent call to DescribeLoa for this connection.

Type: Timestamp

Required: No

location

Where the connection is located.

Example: EqSV5

Default: None

Type: String

Required: No

ownerAccount

The AWS account that will own the new connection.

Type: String

Required: No

partnerName

The name of the AWS Direct Connect service provider associated with the connection.

Type: String

Required: No

region

The AWS region where the connection is located.

Example: us-east-1

Default: None

Type: String

Required: No

vlan

The VLAN ID.

Example: 101

Type: Integer

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: