Jump to Content

This API Documentation is now deprecated

We are excited to announce our new API Documentation.

Class DisassociateConnectionFromLagCommandProtected

Disassociates a connection from a link aggregation group (LAG). The connection is interrupted and re-established as a standalone connection (the connection is not deleted; to delete the connection, use the DeleteConnection request). If the LAG has associated virtual interfaces or hosted connections, they remain associated with the LAG. A disassociated connection owned by an Direct Connect Partner is automatically converted to an interconnect.

If disassociating the connection would cause the LAG to fall below its setting for minimum number of operational connections, the request fails, except when it's the last member of the LAG. If all connections are disassociated, the LAG continues to exist as an empty LAG with no physical connections.

Example

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

import { DirectConnectClient, DisassociateConnectionFromLagCommand } from "@aws-sdk/client-direct-connect"; // ES Modules import
// const { DirectConnectClient, DisassociateConnectionFromLagCommand } = require("@aws-sdk/client-direct-connect"); // CommonJS import
const client = new DirectConnectClient(config);
const input = { // DisassociateConnectionFromLagRequest
connectionId: "STRING_VALUE", // required
lagId: "STRING_VALUE", // required
};
const command = new DisassociateConnectionFromLagCommand(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

DisassociateConnectionFromLagCommandInput

Returns

DisassociateConnectionFromLagCommandOutput

See

Throws

DirectConnectClientException (client fault)

One or more parameters are not valid.

Throws

DirectConnectServerException (server fault)

A server-side error occurred.

Throws

DirectConnectServiceException

Base exception class for all service exceptions from DirectConnect service.

Hierarchy

Constructors

Properties

Methods

Constructors

Properties

Methods