{-# 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-2018 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- 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. -- -- 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. -- module Network.AWS.DirectConnect.CreateInterconnect ( -- * Creating a Request createInterconnect , CreateInterconnect -- * Request Lenses , ciLagId , ciInterconnectName , ciBandwidth , ciLocation -- * Destructuring the Response , interconnect , Interconnect -- * Response Lenses , iLagId , iInterconnectId , iLocation , iInterconnectName , iAwsDevice , 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' { _ciLagId :: !(Maybe Text) , _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: -- -- * '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 createInterconnect :: Text -- ^ 'ciInterconnectName' -> Text -- ^ 'ciBandwidth' -> Text -- ^ 'ciLocation' -> CreateInterconnect createInterconnect pInterconnectName_ pBandwidth_ pLocation_ = CreateInterconnect' { _ciLagId = Nothing , _ciInterconnectName = pInterconnectName_ , _ciBandwidth = pBandwidth_ , _ciLocation = pLocation_ } -- | Undocumented member. ciLagId :: Lens' CreateInterconnect (Maybe Text) ciLagId = lens _ciLagId (\ s a -> s{_ciLagId = a}) -- | 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 where instance NFData CreateInterconnect where 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 [("lagId" .=) <$> _ciLagId, Just ("interconnectName" .= _ciInterconnectName), Just ("bandwidth" .= _ciBandwidth), Just ("location" .= _ciLocation)]) instance ToPath CreateInterconnect where toPath = const "/" instance ToQuery CreateInterconnect where toQuery = const mempty