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

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS CreateConnection

readList :: ReadS [CreateConnection]

readPrec :: ReadPrec CreateConnection

readListPrec :: ReadPrec [CreateConnection]

Show CreateConnection

Methods

showsPrec :: Int -> CreateConnection -> ShowS

show :: CreateConnection -> String

showList :: [CreateConnection] -> ShowS

Generic CreateConnection

Associated Types

type Rep CreateConnection :: * -> *

Methods

from :: CreateConnection -> Rep CreateConnection x

to :: Rep CreateConnection x -> CreateConnection

Hashable CreateConnection

Methods

hashWithSalt :: Int -> CreateConnection -> Int

hash :: CreateConnection -> Int

ToJSON CreateConnection

Methods

toJSON :: CreateConnection -> Value

toEncoding :: CreateConnection -> Encoding

toJSONList :: [CreateConnection] -> Value

toEncodingList :: [CreateConnection] -> Encoding

NFData CreateConnection

Methods

rnf :: CreateConnection -> ()

AWSRequest CreateConnection

Associated Types

type Rs CreateConnection :: *

Methods

request :: CreateConnection -> Request CreateConnection

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

ToQuery CreateConnection

Methods

toQuery :: CreateConnection -> QueryString

ToPath CreateConnection

Methods

toPath :: CreateConnection -> ByteString

ToHeaders CreateConnection

Methods

toHeaders :: CreateConnection -> [Header]

type Rep CreateConnection

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

type Rs 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

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.5.0-FuyMg4sTg24L6HyEmXEioA" 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.