Network.AWS.DirectConnect.CreateInterconnect

Creates a new interconnect between a AWS Direct Connect partner's network and a specific AWS Direct Connect location.

An interconnect is a connection which is capable of hosting other connections. The AWS Direct Connect partner can use an interconnect to provide sub-1Gbps AWS Direct Connect service to tier 2 customers who do not have their own connections. Like a standard connection, an interconnect links the AWS Direct Connect partner's network to an AWS Direct Connect location over a standard 1 Gbps or 10 Gbps Ethernet fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect router.

You can automatically add the new interconnect to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new interconnect 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 interconnect will be created.

For each end customer, the AWS Direct Connect partner provisions a connection on their interconnect by calling AllocateConnectionOnInterconnect. The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the AWS Direct Connect partner.

Creating a Request

createInterconnect

Arguments

:: Text

ciInterconnectName

-> Text

ciBandwidth

-> Text

ciLocation

-> CreateInterconnect

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

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

• ciLagId - Undocumented member.
• ciInterconnectName - The name of the interconnect. Example: "1G Interconnect to AWS " Default: None
• ciBandwidth - The port bandwidth Example: 1Gbps Default: None Available values: 1Gbps,10Gbps
• ciLocation - Where the interconnect is located Example: EqSV5 Default: None

data CreateInterconnect

Container for the parameters to the CreateInterconnect operation.

See: createInterconnect smart constructor.

Instances

Eq CreateInterconnect

Methods

(==) :: CreateInterconnect -> CreateInterconnect -> Bool

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

Data CreateInterconnect

Methods

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

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

toConstr :: CreateInterconnect -> Constr

dataTypeOf :: CreateInterconnect -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateInterconnect

Methods

readsPrec :: Int -> ReadS CreateInterconnect

readList :: ReadS [CreateInterconnect]

readPrec :: ReadPrec CreateInterconnect

readListPrec :: ReadPrec [CreateInterconnect]

Show CreateInterconnect

Methods

showsPrec :: Int -> CreateInterconnect -> ShowS

show :: CreateInterconnect -> String

showList :: [CreateInterconnect] -> ShowS

Generic CreateInterconnect

Associated Types

type Rep CreateInterconnect :: * -> *

Methods

from :: CreateInterconnect -> Rep CreateInterconnect x

to :: Rep CreateInterconnect x -> CreateInterconnect

Hashable CreateInterconnect

Methods

hashWithSalt :: Int -> CreateInterconnect -> Int

hash :: CreateInterconnect -> Int

ToJSON CreateInterconnect

Methods

toJSON :: CreateInterconnect -> Value

toEncoding :: CreateInterconnect -> Encoding

toJSONList :: [CreateInterconnect] -> Value

toEncodingList :: [CreateInterconnect] -> Encoding

NFData CreateInterconnect

Methods

rnf :: CreateInterconnect -> ()

AWSRequest CreateInterconnect

Associated Types

type Rs CreateInterconnect :: *

Methods

request :: CreateInterconnect -> Request CreateInterconnect

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

ToHeaders CreateInterconnect

Methods

toHeaders :: CreateInterconnect -> [Header]

ToPath CreateInterconnect

Methods

toPath :: CreateInterconnect -> ByteString

ToQuery CreateInterconnect

Methods

toQuery :: CreateInterconnect -> QueryString

type Rep CreateInterconnect

type Rep CreateInterconnect = D1 * (MetaData "CreateInterconnect" "Network.AWS.DirectConnect.CreateInterconnect" "amazonka-directconnect-1.6.0-3Ds8OcMuONt5kWQC5zsRrM" False) (C1 * (MetaCons "CreateInterconnect'" PrefixI True) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_ciLagId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_ciInterconnectName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_ciBandwidth") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_ciLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))))

type Rs CreateInterconnect

type Rs CreateInterconnect = Interconnect

Request Lenses

ciLagId :: Lens' CreateInterconnect (Maybe Text)

Undocumented member.

ciInterconnectName :: Lens' CreateInterconnect Text

The name of the interconnect. Example: "1G Interconnect to AWS " Default: None

ciBandwidth :: Lens' CreateInterconnect Text

The port bandwidth Example: 1Gbps Default: None Available values: 1Gbps,10Gbps

ciLocation :: Lens' CreateInterconnect Text

Where the interconnect is located Example: EqSV5 Default: None

Destructuring the Response

interconnect :: Interconnect

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

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

• iLagId - Undocumented member.
• iInterconnectId - Undocumented member.
• iLocation - Undocumented member.
• iInterconnectName - Undocumented member.
• iAwsDevice - The Direct Connection endpoint which the physical connection terminates on.
• iLoaIssueTime - The time of the most recent call to DescribeInterconnectLoa for this Interconnect.
• iBandwidth - Undocumented member.
• iInterconnectState - Undocumented member.
• iRegion - Undocumented member.

data Interconnect

An interconnect is a connection that can host other connections.

Like a standard AWS Direct Connect connection, an interconnect represents the physical connection between an AWS Direct Connect partner's network and a specific Direct Connect location. An AWS Direct Connect partner who owns an interconnect can provision hosted connections on the interconnect for their end customers, thereby providing the end customers with connectivity to AWS services.

The resources of the interconnect, including bandwidth and VLAN numbers, are shared by all of the hosted connections on the interconnect, and the owner of the interconnect determines how these resources are assigned.

See: interconnect smart constructor.

Instances

Eq Interconnect

Methods

(==) :: Interconnect -> Interconnect -> Bool

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

Data Interconnect

Methods

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

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

toConstr :: Interconnect -> Constr

dataTypeOf :: Interconnect -> DataType

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

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

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

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

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

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

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

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

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

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

Read Interconnect

Methods

readsPrec :: Int -> ReadS Interconnect

readList :: ReadS [Interconnect]

readPrec :: ReadPrec Interconnect

readListPrec :: ReadPrec [Interconnect]

Show Interconnect

Methods

showsPrec :: Int -> Interconnect -> ShowS

show :: Interconnect -> String

showList :: [Interconnect] -> ShowS

Generic Interconnect

Associated Types

type Rep Interconnect :: * -> *

Methods

from :: Interconnect -> Rep Interconnect x

to :: Rep Interconnect x -> Interconnect

Hashable Interconnect

Methods

hashWithSalt :: Int -> Interconnect -> Int

hash :: Interconnect -> Int

FromJSON Interconnect

Methods

parseJSON :: Value -> Parser Interconnect

parseJSONList :: Value -> Parser [Interconnect]

NFData Interconnect

Methods

rnf :: Interconnect -> ()

type Rep Interconnect

type Rep Interconnect = D1 * (MetaData "Interconnect" "Network.AWS.DirectConnect.Types.Product" "amazonka-directconnect-1.6.0-3Ds8OcMuONt5kWQC5zsRrM" False) (C1 * (MetaCons "Interconnect'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_iLagId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_iInterconnectId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_iLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_iInterconnectName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_iAwsDevice") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_iLoaIssueTime") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe POSIX)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_iBandwidth") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) ((:*:) * (S1 * (MetaSel (Just Symbol "_iInterconnectState") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe InterconnectState))) (S1 * (MetaSel (Just Symbol "_iRegion") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))))))

Response Lenses

iLagId :: Lens' Interconnect (Maybe Text)

Undocumented member.

iInterconnectId :: Lens' Interconnect (Maybe Text)

Undocumented member.

iLocation :: Lens' Interconnect (Maybe Text)

Undocumented member.

iInterconnectName :: Lens' Interconnect (Maybe Text)

Undocumented member.

iAwsDevice :: Lens' Interconnect (Maybe Text)

The Direct Connection endpoint which the physical connection terminates on.

iLoaIssueTime :: Lens' Interconnect (Maybe UTCTime)

The time of the most recent call to DescribeInterconnectLoa for this Interconnect.

iBandwidth :: Lens' Interconnect (Maybe Text)

Undocumented member.

iInterconnectState :: Lens' Interconnect (Maybe InterconnectState)

Undocumented member.

iRegion :: Lens' Interconnect (Maybe Text)

Undocumented member.