amazonka-directconnect-1.4.5: gen/Network/AWS/DirectConnect/CreateInterconnect.hs
{-# LANGUAGE DeriveDataTypeable #-}
{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE TypeFamilies #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-binds #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}
-- Derived from AWS service descriptions, licensed under Apache 2.0.
-- |
-- Module : Network.AWS.DirectConnect.CreateInterconnect
-- Copyright : (c) 2013-2016 Brendan Hay
-- License : Mozilla Public License, v. 2.0.
-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
-- Stability : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- 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.
--
-- 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.
--
module Network.AWS.DirectConnect.CreateInterconnect
(
-- * Creating a Request
createInterconnect
, CreateInterconnect
-- * Request Lenses
, ciInterconnectName
, ciBandwidth
, ciLocation
-- * Destructuring the Response
, interconnect
, Interconnect
-- * Response Lenses
, iInterconnectId
, iLocation
, iInterconnectName
, iLoaIssueTime
, iBandwidth
, iInterconnectState
, iRegion
) where
import Network.AWS.DirectConnect.Types
import Network.AWS.DirectConnect.Types.Product
import Network.AWS.Lens
import Network.AWS.Prelude
import Network.AWS.Request
import Network.AWS.Response
-- | Container for the parameters to the CreateInterconnect operation.
--
--
--
-- /See:/ 'createInterconnect' smart constructor.
data CreateInterconnect = CreateInterconnect'
{ _ciInterconnectName :: !Text
, _ciBandwidth :: !Text
, _ciLocation :: !Text
} deriving (Eq,Read,Show,Data,Typeable,Generic)
-- | 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:
--
-- * '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
createInterconnect
:: Text -- ^ 'ciInterconnectName'
-> Text -- ^ 'ciBandwidth'
-> Text -- ^ 'ciLocation'
-> CreateInterconnect
createInterconnect pInterconnectName_ pBandwidth_ pLocation_ =
CreateInterconnect'
{ _ciInterconnectName = pInterconnectName_
, _ciBandwidth = pBandwidth_
, _ciLocation = pLocation_
}
-- | The name of the interconnect. Example: "/1G Interconnect to AWS/ " Default: None
ciInterconnectName :: Lens' CreateInterconnect Text
ciInterconnectName = lens _ciInterconnectName (\ s a -> s{_ciInterconnectName = a});
-- | The port bandwidth Example: 1Gbps Default: None Available values: 1Gbps,10Gbps
ciBandwidth :: Lens' CreateInterconnect Text
ciBandwidth = lens _ciBandwidth (\ s a -> s{_ciBandwidth = a});
-- | Where the interconnect is located Example: EqSV5 Default: None
ciLocation :: Lens' CreateInterconnect Text
ciLocation = lens _ciLocation (\ s a -> s{_ciLocation = a});
instance AWSRequest CreateInterconnect where
type Rs CreateInterconnect = Interconnect
request = postJSON directConnect
response = receiveJSON (\ s h x -> eitherParseJSON x)
instance Hashable CreateInterconnect
instance NFData CreateInterconnect
instance ToHeaders CreateInterconnect where
toHeaders
= const
(mconcat
["X-Amz-Target" =#
("OvertureService.CreateInterconnect" :: ByteString),
"Content-Type" =#
("application/x-amz-json-1.1" :: ByteString)])
instance ToJSON CreateInterconnect where
toJSON CreateInterconnect'{..}
= object
(catMaybes
[Just ("interconnectName" .= _ciInterconnectName),
Just ("bandwidth" .= _ciBandwidth),
Just ("location" .= _ciLocation)])
instance ToPath CreateInterconnect where
toPath = const "/"
instance ToQuery CreateInterconnect where
toQuery = const mempty