amazonka-directconnect-1.4.0: gen/Network/AWS/DirectConnect/DescribeVirtualInterfaces.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.DescribeVirtualInterfaces
-- 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)
--
-- Displays all virtual interfaces for an AWS account. Virtual interfaces
-- deleted fewer than 15 minutes before DescribeVirtualInterfaces is called
-- are also returned. If a connection ID is included then only virtual
-- interfaces associated with this connection will be returned. If a
-- virtual interface ID is included then only a single virtual interface
-- will be returned.
--
-- A virtual interface (VLAN) transmits the traffic between the AWS Direct
-- Connect location and the customer.
--
-- If a connection ID is provided, only virtual interfaces provisioned on
-- the specified connection will be returned. If a virtual interface ID is
-- provided, only this particular virtual interface will be returned.
module Network.AWS.DirectConnect.DescribeVirtualInterfaces
(
-- * Creating a Request
describeVirtualInterfaces
, DescribeVirtualInterfaces
-- * Request Lenses
, dviConnectionId
, dviVirtualInterfaceId
-- * Destructuring the Response
, describeVirtualInterfacesResponse
, DescribeVirtualInterfacesResponse
-- * Response Lenses
, dvisrsVirtualInterfaces
, dvisrsResponseStatus
) 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 DescribeVirtualInterfaces operation.
--
-- /See:/ 'describeVirtualInterfaces' smart constructor.
data DescribeVirtualInterfaces = DescribeVirtualInterfaces'
{ _dviConnectionId :: !(Maybe Text)
, _dviVirtualInterfaceId :: !(Maybe Text)
} deriving (Eq,Read,Show,Data,Typeable,Generic)
-- | Creates a value of 'DescribeVirtualInterfaces' with the minimum fields required to make a request.
--
-- Use one of the following lenses to modify other fields as desired:
--
-- * 'dviConnectionId'
--
-- * 'dviVirtualInterfaceId'
describeVirtualInterfaces
:: DescribeVirtualInterfaces
describeVirtualInterfaces =
DescribeVirtualInterfaces'
{ _dviConnectionId = Nothing
, _dviVirtualInterfaceId = Nothing
}
-- | Undocumented member.
dviConnectionId :: Lens' DescribeVirtualInterfaces (Maybe Text)
dviConnectionId = lens _dviConnectionId (\ s a -> s{_dviConnectionId = a});
-- | Undocumented member.
dviVirtualInterfaceId :: Lens' DescribeVirtualInterfaces (Maybe Text)
dviVirtualInterfaceId = lens _dviVirtualInterfaceId (\ s a -> s{_dviVirtualInterfaceId = a});
instance AWSRequest DescribeVirtualInterfaces where
type Rs DescribeVirtualInterfaces =
DescribeVirtualInterfacesResponse
request = postJSON directConnect
response
= receiveJSON
(\ s h x ->
DescribeVirtualInterfacesResponse' <$>
(x .?> "virtualInterfaces" .!@ mempty) <*>
(pure (fromEnum s)))
instance Hashable DescribeVirtualInterfaces
instance ToHeaders DescribeVirtualInterfaces where
toHeaders
= const
(mconcat
["X-Amz-Target" =#
("OvertureService.DescribeVirtualInterfaces" ::
ByteString),
"Content-Type" =#
("application/x-amz-json-1.1" :: ByteString)])
instance ToJSON DescribeVirtualInterfaces where
toJSON DescribeVirtualInterfaces'{..}
= object
(catMaybes
[("connectionId" .=) <$> _dviConnectionId,
("virtualInterfaceId" .=) <$>
_dviVirtualInterfaceId])
instance ToPath DescribeVirtualInterfaces where
toPath = const "/"
instance ToQuery DescribeVirtualInterfaces where
toQuery = const mempty
-- | A structure containing a list of virtual interfaces.
--
-- /See:/ 'describeVirtualInterfacesResponse' smart constructor.
data DescribeVirtualInterfacesResponse = DescribeVirtualInterfacesResponse'
{ _dvisrsVirtualInterfaces :: !(Maybe [VirtualInterface])
, _dvisrsResponseStatus :: !Int
} deriving (Eq,Read,Show,Data,Typeable,Generic)
-- | Creates a value of 'DescribeVirtualInterfacesResponse' with the minimum fields required to make a request.
--
-- Use one of the following lenses to modify other fields as desired:
--
-- * 'dvisrsVirtualInterfaces'
--
-- * 'dvisrsResponseStatus'
describeVirtualInterfacesResponse
:: Int -- ^ 'dvisrsResponseStatus'
-> DescribeVirtualInterfacesResponse
describeVirtualInterfacesResponse pResponseStatus_ =
DescribeVirtualInterfacesResponse'
{ _dvisrsVirtualInterfaces = Nothing
, _dvisrsResponseStatus = pResponseStatus_
}
-- | A list of virtual interfaces.
dvisrsVirtualInterfaces :: Lens' DescribeVirtualInterfacesResponse [VirtualInterface]
dvisrsVirtualInterfaces = lens _dvisrsVirtualInterfaces (\ s a -> s{_dvisrsVirtualInterfaces = a}) . _Default . _Coerce;
-- | The response status code.
dvisrsResponseStatus :: Lens' DescribeVirtualInterfacesResponse Int
dvisrsResponseStatus = lens _dvisrsResponseStatus (\ s a -> s{_dvisrsResponseStatus = a});