Class CreateConnectionCommandProtected

Creates a connection between a customer network and a specific Direct Connect location.

A connection links your internal network to an Direct Connect location over a standard Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an Direct Connect router.

To find the locations for your Region, use DescribeLocations.

You can automatically add the new connection to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new connection is allocated on the same Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection is created.

Example

Use a bare-bones client and the command you need to make an API call.

import { DirectConnectClient, CreateConnectionCommand } from "@aws-sdk/client-direct-connect"; // ES Modules import
// const { DirectConnectClient, CreateConnectionCommand } = require("@aws-sdk/client-direct-connect"); // CommonJS import
const client = new DirectConnectClient(config);
const input = { // CreateConnectionRequest
  location: "STRING_VALUE", // required
  bandwidth: "STRING_VALUE", // required
  connectionName: "STRING_VALUE", // required
  lagId: "STRING_VALUE",
  tags: [ // TagList
    { // Tag
      key: "STRING_VALUE", // required
      value: "STRING_VALUE",
    },
  ],
  providerName: "STRING_VALUE",
  requestMACSec: true || false,
};
const command = new CreateConnectionCommand(input);
const response = await client.send(command);
// { // Connection
//   ownerAccount: "STRING_VALUE",
//   connectionId: "STRING_VALUE",
//   connectionName: "STRING_VALUE",
//   connectionState: "ordering" || "requested" || "pending" || "available" || "down" || "deleting" || "deleted" || "rejected" || "unknown",
//   region: "STRING_VALUE",
//   location: "STRING_VALUE",
//   bandwidth: "STRING_VALUE",
//   vlan: Number("int"),
//   partnerName: "STRING_VALUE",
//   loaIssueTime: new Date("TIMESTAMP"),
//   lagId: "STRING_VALUE",
//   awsDevice: "STRING_VALUE",
//   jumboFrameCapable: true || false,
//   awsDeviceV2: "STRING_VALUE",
//   awsLogicalDeviceId: "STRING_VALUE",
//   hasLogicalRedundancy: "unknown" || "yes" || "no",
//   tags: [ // TagList
//     { // Tag
//       key: "STRING_VALUE", // required
//       value: "STRING_VALUE",
//     },
//   ],
//   providerName: "STRING_VALUE",
//   macSecCapable: true || false,
//   portEncryptionStatus: "STRING_VALUE",
//   encryptionMode: "STRING_VALUE",
//   macSecKeys: [ // MacSecKeyList
//     { // MacSecKey
//       secretARN: "STRING_VALUE",
//       ckn: "STRING_VALUE",
//       state: "STRING_VALUE",
//       startOn: "STRING_VALUE",
//     },
//   ],
// };

Param

CreateConnectionCommandInput

Returns

CreateConnectionCommandOutput

See

• CreateConnectionCommandInput for command's input shape.
• CreateConnectionCommandOutput for command's response shape.
• config for DirectConnectClient's config shape.

Throws

DirectConnectClientException (client fault)

One or more parameters are not valid.

Throws

DirectConnectServerException (server fault)

A server-side error occurred.

Throws

DuplicateTagKeysException (client fault)

A tag key was specified more than once.

Throws

TooManyTagsException (client fault)

You have reached the limit on the number of tags that can be assigned.

Throws

DirectConnectServiceException

Base exception class for all service exceptions from DirectConnect service.