Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . directconnect ]

allocate-connection-on-interconnect

Description

Deprecated. Use AllocateHostedConnection instead.

Creates a hosted connection on an interconnect.

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the specified interconnect.

Note

Intended for use by AWS Direct Connect Partners only.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  allocate-connection-on-interconnect
--bandwidth <value>
--connection-name <value>
--owner-account <value>
--interconnect-id <value>
--vlan <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--bandwidth (string)

The bandwidth of the connection. The possible values are 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps, and 10Gbps. Note that only those AWS Direct Connect Partners who have met specific requirements are allowed to create a 1Gbps, 2Gbps, 5Gbps or 10Gbps hosted connection.

--connection-name (string)

The name of the provisioned connection.

--owner-account (string)

The ID of the AWS account of the customer for whom the connection will be provisioned.

--interconnect-id (string)

The ID of the interconnect on which the connection will be provisioned.

--vlan (integer)

The dedicated VLAN provisioned to the connection.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Examples

To create a hosted connection on an interconnect

The following allocate-connection-on-interconnect command creates a hosted connection on an interconnect:

aws directconnect allocate-connection-on-interconnect --bandwidth 500Mbps --connection-name mydcinterconnect --owner-account 123456789012 --interconnect-id dxcon-fgktov66 --vlan 101

Output:

{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}

Output

ownerAccount -> (string)

The ID of the AWS account that owns the connection.

connectionId -> (string)

The ID of the connection.

connectionName -> (string)

The name of the connection.

connectionState -> (string)

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

  • 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 being deleted.
  • deleted : The connection has been deleted.
  • rejected : A hosted connection in the ordering state enters the rejected state if it is deleted by the customer.
  • unknown : The state of the connection is not available.

region -> (string)

The AWS Region where the connection is located.

location -> (string)

The location of the connection.

bandwidth -> (string)

The bandwidth of the connection.

vlan -> (integer)

The ID of the VLAN.

partnerName -> (string)

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

loaIssueTime -> (timestamp)

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

lagId -> (string)

The ID of the LAG.

awsDevice -> (string)

The Direct Connect endpoint on which the physical connection terminates.

jumboFrameCapable -> (boolean)

Indicates whether jumbo frames (9001 MTU) are supported.

awsDeviceV2 -> (string)

The Direct Connect endpoint on which the physical connection terminates.

hasLogicalRedundancy -> (string)

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

tags -> (list)

Any tags assigned to the connection.

(structure)

Information about a tag.

key -> (string)

The key.

value -> (string)

The value.