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

• DisassociateConnectionFromLagCommandInput for command's input shape.
• DisassociateConnectionFromLagCommandOutput 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

DirectConnectServiceException

Base exception class for all service exceptions from DirectConnect service.