amazonka-directconnect-1.2.0: 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-2015 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.
--
-- /See:/ <http://docs.aws.amazon.com/directconnect/latest/APIReference/API_CreateInterconnect.html AWS API Reference> for CreateInterconnect.
module Network.AWS.DirectConnect.CreateInterconnect
(
-- * Creating a Request
createInterconnect
, CreateInterconnect
-- * Request Lenses
, ciInterconnectName
, ciBandwidth
, ciLocation
-- * Destructuring the Response
, interconnect
, Interconnect
-- * Response Lenses
, iInterconnectId
, iInterconnectName
, iLocation
, iBandwidth
, iInterconnectState
, iRegion
) where
import Network.AWS.DirectConnect.Types
import Network.AWS.DirectConnect.Types.Product
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'
--
-- * 'ciBandwidth'
--
-- * 'ciLocation'
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 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