Network.AWS.DirectConnect.AssociateConnectionWithLag

Associates an existing connection with a link aggregation group (LAG). The connection is interrupted and re-established as a member of the LAG (connectivity to AWS will be interrupted). The connection must be hosted on the same AWS Direct Connect endpoint as the LAG, and its bandwidth must match the bandwidth for the LAG. You can reassociate a connection that's currently associated with a different LAG; however, if removing the connection will cause the original LAG to fall below its setting for minimum number of operational connections, the request fails.

Any virtual interfaces that are directly associated with the connection are automatically re-associated with the LAG. If the connection was originally associated with a different LAG, the virtual interfaces remain associated with the original LAG.

For interconnects, any hosted connections are automatically re-associated with the LAG. If the interconnect was originally associated with a different LAG, the hosted connections remain associated with the original LAG.

Creating a Request

associateConnectionWithLag

Arguments

:: Text

acwlConnectionId

-> Text

acwlLagId

-> AssociateConnectionWithLag

Creates a value of AssociateConnectionWithLag with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• acwlConnectionId - The ID of the connection. Example: dxcon-abc123 Default: None
• acwlLagId - The ID of the LAG with which to associate the connection. Example: dxlag-abc123 Default: None

data AssociateConnectionWithLag

Container for the parameters to the AssociateConnectionWithLag operation.

See: associateConnectionWithLag smart constructor.

Instances

Eq AssociateConnectionWithLag

Methods

(==) :: AssociateConnectionWithLag -> AssociateConnectionWithLag -> Bool

(/=) :: AssociateConnectionWithLag -> AssociateConnectionWithLag -> Bool

Data AssociateConnectionWithLag

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> AssociateConnectionWithLag -> c AssociateConnectionWithLag

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c AssociateConnectionWithLag

toConstr :: AssociateConnectionWithLag -> Constr

dataTypeOf :: AssociateConnectionWithLag -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c AssociateConnectionWithLag)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c AssociateConnectionWithLag)

gmapT :: (forall b. Data b => b -> b) -> AssociateConnectionWithLag -> AssociateConnectionWithLag

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> AssociateConnectionWithLag -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> AssociateConnectionWithLag -> r

gmapQ :: (forall d. Data d => d -> u) -> AssociateConnectionWithLag -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> AssociateConnectionWithLag -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> AssociateConnectionWithLag -> m AssociateConnectionWithLag

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> AssociateConnectionWithLag -> m AssociateConnectionWithLag

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> AssociateConnectionWithLag -> m AssociateConnectionWithLag

Read AssociateConnectionWithLag

Methods

readsPrec :: Int -> ReadS AssociateConnectionWithLag

readList :: ReadS [AssociateConnectionWithLag]

readPrec :: ReadPrec AssociateConnectionWithLag

readListPrec :: ReadPrec [AssociateConnectionWithLag]

Show AssociateConnectionWithLag

Methods

showsPrec :: Int -> AssociateConnectionWithLag -> ShowS

show :: AssociateConnectionWithLag -> String

showList :: [AssociateConnectionWithLag] -> ShowS

Generic AssociateConnectionWithLag

Associated Types

type Rep AssociateConnectionWithLag :: * -> *

Methods

from :: AssociateConnectionWithLag -> Rep AssociateConnectionWithLag x

to :: Rep AssociateConnectionWithLag x -> AssociateConnectionWithLag

Hashable AssociateConnectionWithLag

Methods

hashWithSalt :: Int -> AssociateConnectionWithLag -> Int

hash :: AssociateConnectionWithLag -> Int

ToJSON AssociateConnectionWithLag

Methods

toJSON :: AssociateConnectionWithLag -> Value

toEncoding :: AssociateConnectionWithLag -> Encoding

toJSONList :: [AssociateConnectionWithLag] -> Value

toEncodingList :: [AssociateConnectionWithLag] -> Encoding

NFData AssociateConnectionWithLag

Methods

rnf :: AssociateConnectionWithLag -> ()

AWSRequest AssociateConnectionWithLag

Associated Types

type Rs AssociateConnectionWithLag :: *

Methods

request :: AssociateConnectionWithLag -> Request AssociateConnectionWithLag

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * AssociateConnectionWithLag -> ClientResponse -> m (Response AssociateConnectionWithLag)

ToHeaders AssociateConnectionWithLag

Methods

toHeaders :: AssociateConnectionWithLag -> [Header]

ToPath AssociateConnectionWithLag

Methods

toPath :: AssociateConnectionWithLag -> ByteString

ToQuery AssociateConnectionWithLag

Methods

toQuery :: AssociateConnectionWithLag -> QueryString

type Rep AssociateConnectionWithLag

type Rep AssociateConnectionWithLag = D1 * (MetaData "AssociateConnectionWithLag" "Network.AWS.DirectConnect.AssociateConnectionWithLag" "amazonka-directconnect-1.6.0-3Ds8OcMuONt5kWQC5zsRrM" False) (C1 * (MetaCons "AssociateConnectionWithLag'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_acwlConnectionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_acwlLagId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))

type Rs AssociateConnectionWithLag

type Rs AssociateConnectionWithLag = Connection

Request Lenses

acwlConnectionId :: Lens' AssociateConnectionWithLag Text

The ID of the connection. Example: dxcon-abc123 Default: None

acwlLagId :: Lens' AssociateConnectionWithLag Text

The ID of the LAG with which to associate the connection. Example: dxlag-abc123 Default: None

Destructuring the Response

connection :: Connection

Creates a value of Connection with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cLagId - Undocumented member.
• cVlan - Undocumented member.
• cLocation - Undocumented member.
• cAwsDevice - The Direct Connection endpoint which the physical connection terminates on.
• cConnectionId - Undocumented member.
• cLoaIssueTime - The time of the most recent call to DescribeLoa for this connection.
• cPartnerName - The name of the AWS Direct Connect service provider associated with the connection.
• cConnectionName - Undocumented member.
• cBandwidth - Bandwidth of the connection. Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections) Default: None
• cOwnerAccount - The AWS account that will own the new connection.
• cRegion - Undocumented member.
• cConnectionState - Undocumented member.

data Connection

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

See: connection smart constructor.

Instances

Eq Connection

Methods

(==) :: Connection -> Connection -> Bool

(/=) :: Connection -> Connection -> Bool

Data Connection

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> Connection -> c Connection

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c Connection

toConstr :: Connection -> Constr

dataTypeOf :: Connection -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c Connection)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c Connection)

gmapT :: (forall b. Data b => b -> b) -> Connection -> Connection

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> Connection -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> Connection -> r

gmapQ :: (forall d. Data d => d -> u) -> Connection -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> Connection -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> Connection -> m Connection

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> Connection -> m Connection

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> Connection -> m Connection

Read Connection

Methods

readsPrec :: Int -> ReadS Connection

readList :: ReadS [Connection]

readPrec :: ReadPrec Connection

readListPrec :: ReadPrec [Connection]

Show Connection

Methods

showsPrec :: Int -> Connection -> ShowS

show :: Connection -> String

showList :: [Connection] -> ShowS

Generic Connection

Associated Types

type Rep Connection :: * -> *

Methods

from :: Connection -> Rep Connection x

to :: Rep Connection x -> Connection

Hashable Connection

Methods

hashWithSalt :: Int -> Connection -> Int

hash :: Connection -> Int

FromJSON Connection

Methods

parseJSON :: Value -> Parser Connection

parseJSONList :: Value -> Parser [Connection]

NFData Connection

Methods

rnf :: Connection -> ()

type Rep Connection

type Rep Connection = D1 * (MetaData "Connection" "Network.AWS.DirectConnect.Types.Product" "amazonka-directconnect-1.6.0-3Ds8OcMuONt5kWQC5zsRrM" False) (C1 * (MetaCons "Connection'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_cLagId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cVlan") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Int))) (S1 * (MetaSel (Just Symbol "_cLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cAwsDevice") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cConnectionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_cLoaIssueTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe POSIX)))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_cPartnerName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cConnectionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_cBandwidth") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cOwnerAccount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cRegion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_cConnectionState") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe ConnectionState))))))))

Response Lenses

cLagId :: Lens' Connection (Maybe Text)

Undocumented member.

cVlan :: Lens' Connection (Maybe Int)

Undocumented member.

cLocation :: Lens' Connection (Maybe Text)

Undocumented member.

cAwsDevice :: Lens' Connection (Maybe Text)

The Direct Connection endpoint which the physical connection terminates on.

cConnectionId :: Lens' Connection (Maybe Text)

Undocumented member.

cLoaIssueTime :: Lens' Connection (Maybe UTCTime)

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

cPartnerName :: Lens' Connection (Maybe Text)

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

cConnectionName :: Lens' Connection (Maybe Text)

Undocumented member.

cBandwidth :: Lens' Connection (Maybe Text)

Bandwidth of the connection. Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections) Default: None

cOwnerAccount :: Lens' Connection (Maybe Text)

The AWS account that will own the new connection.

cRegion :: Lens' Connection (Maybe Text)

Undocumented member.

cConnectionState :: Lens' Connection (Maybe ConnectionState)

Undocumented member.