amazonka-directconnect-1.6.0: Amazon Direct Connect SDK.

Copyright(c) 2013-2018 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.DirectConnect.AssociateConnectionWithLag

Contents

Description

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.

Synopsis

Creating a Request

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 # 
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 # 
Show AssociateConnectionWithLag # 
Generic AssociateConnectionWithLag # 
Hashable AssociateConnectionWithLag # 
ToJSON AssociateConnectionWithLag # 
NFData AssociateConnectionWithLag # 
AWSRequest AssociateConnectionWithLag # 
ToHeaders AssociateConnectionWithLag # 
ToPath AssociateConnectionWithLag # 
ToQuery AssociateConnectionWithLag # 
type Rep AssociateConnectionWithLag # 
type Rep AssociateConnectionWithLag = D1 * (MetaData "AssociateConnectionWithLag" "Network.AWS.DirectConnect.AssociateConnectionWithLag" "amazonka-directconnect-1.6.0-1iHBIYuuv8NGkO6PD7WukU" 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 # 

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 # 
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 # 
Show Connection # 
Generic Connection # 

Associated Types

type Rep Connection :: * -> * #

Hashable Connection # 
FromJSON 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-1iHBIYuuv8NGkO6PD7WukU" 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.