Network.AWS.DirectConnect.CreateConnection

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

A connection links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. An AWS Direct Connect location provides access to Amazon Web Services in the region it is associated with. You can establish connections with AWS Direct Connect locations in multiple regions, but a connection in one region does not provide connectivity to other regions.

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 AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection will be created.

Creating a Request

createConnection

Arguments

:: Text

ccLocation

-> Text

ccBandwidth

-> Text

ccConnectionName

-> CreateConnection

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

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

• ccLagId - Undocumented member.
• ccLocation - Undocumented member.
• ccBandwidth - Undocumented member.
• ccConnectionName - Undocumented member.

data CreateConnection

Container for the parameters to the CreateConnection operation.

See: createConnection smart constructor.

Instances

Eq CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

(==) :: CreateConnection -> CreateConnection -> Bool

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

Data CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

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

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

toConstr :: CreateConnection -> Constr

dataTypeOf :: CreateConnection -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

readsPrec :: Int -> ReadS CreateConnection

readList :: ReadS [CreateConnection]

readPrec :: ReadPrec CreateConnection

readListPrec :: ReadPrec [CreateConnection]

Show CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

showsPrec :: Int -> CreateConnection -> ShowS

show :: CreateConnection -> String

showList :: [CreateConnection] -> ShowS

Generic CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Associated Types

type Rep CreateConnection :: Type -> Type

Methods

from :: CreateConnection -> Rep CreateConnection x

to :: Rep CreateConnection x -> CreateConnection

Hashable CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

hashWithSalt :: Int -> CreateConnection -> Int

hash :: CreateConnection -> Int

ToJSON CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

toJSON :: CreateConnection -> Value

toEncoding :: CreateConnection -> Encoding

toJSONList :: [CreateConnection] -> Value

toEncodingList :: [CreateConnection] -> Encoding

AWSRequest CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Associated Types

type Rs CreateConnection :: Type

Methods

request :: CreateConnection -> Request CreateConnection

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

ToHeaders CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

toHeaders :: CreateConnection -> [Header]

ToPath CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

toPath :: CreateConnection -> ByteString

ToQuery CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

toQuery :: CreateConnection -> QueryString

NFData CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

Methods

rnf :: CreateConnection -> ()

type Rep CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

type Rep CreateConnection = D1 (MetaData "CreateConnection" "Network.AWS.DirectConnect.CreateConnection" "amazonka-directconnect-1.6.1-Jjw4CKEcom3TDRFDWXGnu" False) (C1 (MetaCons "CreateConnection'" PrefixI True) ((S1 (MetaSel (Just "_ccLagId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_ccLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) :*: (S1 (MetaSel (Just "_ccBandwidth") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_ccConnectionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs CreateConnection

Defined in Network.AWS.DirectConnect.CreateConnection

type Rs CreateConnection = Connection

Request Lenses

ccLagId :: Lens' CreateConnection (Maybe Text)

Undocumented member.

ccLocation :: Lens' CreateConnection Text

Undocumented member.

ccBandwidth :: Lens' CreateConnection Text

Undocumented member.

ccConnectionName :: Lens' CreateConnection Text

Undocumented member.

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

Defined in Network.AWS.DirectConnect.Types.Product

Methods

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

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

Data Connection

Defined in Network.AWS.DirectConnect.Types.Product

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

Defined in Network.AWS.DirectConnect.Types.Product

Methods

readsPrec :: Int -> ReadS Connection

readList :: ReadS [Connection]

readPrec :: ReadPrec Connection

readListPrec :: ReadPrec [Connection]

Show Connection

Defined in Network.AWS.DirectConnect.Types.Product

Methods

showsPrec :: Int -> Connection -> ShowS

show :: Connection -> String

showList :: [Connection] -> ShowS

Generic Connection

Defined in Network.AWS.DirectConnect.Types.Product

Associated Types

type Rep Connection :: Type -> Type

Methods

from :: Connection -> Rep Connection x

to :: Rep Connection x -> Connection

Hashable Connection

Defined in Network.AWS.DirectConnect.Types.Product

Methods

hashWithSalt :: Int -> Connection -> Int

hash :: Connection -> Int

FromJSON Connection

Defined in Network.AWS.DirectConnect.Types.Product

Methods

parseJSON :: Value -> Parser Connection

parseJSONList :: Value -> Parser [Connection]

NFData Connection

Defined in Network.AWS.DirectConnect.Types.Product

Methods

rnf :: Connection -> ()

type Rep Connection

Defined in Network.AWS.DirectConnect.Types.Product

type Rep Connection = D1 (MetaData "Connection" "Network.AWS.DirectConnect.Types.Product" "amazonka-directconnect-1.6.1-Jjw4CKEcom3TDRFDWXGnu" False) (C1 (MetaCons "Connection'" PrefixI True) (((S1 (MetaSel (Just "_cLagId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_cVlan") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Int)) :*: S1 (MetaSel (Just "_cLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) :*: (S1 (MetaSel (Just "_cAwsDevice") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_cConnectionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_cLoaIssueTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe POSIX))))) :*: ((S1 (MetaSel (Just "_cPartnerName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_cConnectionName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_cBandwidth") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))) :*: (S1 (MetaSel (Just "_cOwnerAccount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_cRegion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_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.