{-# 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.WAF.CreateIPSet -- Copyright : (c) 2013-2016 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Creates an < IPSet>, which you use to specify which web requests you -- want to allow or block based on the IP addresses that the requests -- originate from. For example, if you\'re receiving a lot of requests from -- one or more individual IP addresses or one or more ranges of IP -- addresses and you want to block the requests, you can create an 'IPSet' -- that contains those IP addresses and then configure AWS WAF to block the -- requests. -- -- To create and configure an 'IPSet', perform the following steps: -- -- 1. Use < GetChangeToken> to get the change token that you provide in -- the 'ChangeToken' parameter of a 'CreateIPSet' request. -- 2. Submit a 'CreateIPSet' request. -- 3. Use 'GetChangeToken' to get the change token that you provide in the -- 'ChangeToken' parameter of an < UpdateIPSet> request. -- 4. Submit an 'UpdateIPSet' request to specify the IP addresses that you -- want AWS WAF to watch for. -- -- For more information about how to use the AWS WAF API to allow or block -- HTTP requests, see the -- . module Network.AWS.WAF.CreateIPSet ( -- * Creating a Request createIPSet , CreateIPSet -- * Request Lenses , cisName , cisChangeToken -- * Destructuring the Response , createIPSetResponse , CreateIPSetResponse -- * Response Lenses , cisrsChangeToken , cisrsIPSet , cisrsResponseStatus ) where import Network.AWS.Lens import Network.AWS.Prelude import Network.AWS.Request import Network.AWS.Response import Network.AWS.WAF.Types import Network.AWS.WAF.Types.Product -- | /See:/ 'createIPSet' smart constructor. data CreateIPSet = CreateIPSet' { _cisName :: !Text , _cisChangeToken :: !Text } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'CreateIPSet' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'cisName' -- -- * 'cisChangeToken' createIPSet :: Text -- ^ 'cisName' -> Text -- ^ 'cisChangeToken' -> CreateIPSet createIPSet pName_ pChangeToken_ = CreateIPSet' { _cisName = pName_ , _cisChangeToken = pChangeToken_ } -- | A friendly name or description of the < IPSet>. You can\'t change 'Name' -- after you create the 'IPSet'. cisName :: Lens' CreateIPSet Text cisName = lens _cisName (\ s a -> s{_cisName = a}); -- | The value returned by the most recent call to < GetChangeToken>. cisChangeToken :: Lens' CreateIPSet Text cisChangeToken = lens _cisChangeToken (\ s a -> s{_cisChangeToken = a}); instance AWSRequest CreateIPSet where type Rs CreateIPSet = CreateIPSetResponse request = postJSON waf response = receiveJSON (\ s h x -> CreateIPSetResponse' <$> (x .?> "ChangeToken") <*> (x .?> "IPSet") <*> (pure (fromEnum s))) instance Hashable CreateIPSet instance NFData CreateIPSet instance ToHeaders CreateIPSet where toHeaders = const (mconcat ["X-Amz-Target" =# ("AWSWAF_20150824.CreateIPSet" :: ByteString), "Content-Type" =# ("application/x-amz-json-1.1" :: ByteString)]) instance ToJSON CreateIPSet where toJSON CreateIPSet'{..} = object (catMaybes [Just ("Name" .= _cisName), Just ("ChangeToken" .= _cisChangeToken)]) instance ToPath CreateIPSet where toPath = const "/" instance ToQuery CreateIPSet where toQuery = const mempty -- | /See:/ 'createIPSetResponse' smart constructor. data CreateIPSetResponse = CreateIPSetResponse' { _cisrsChangeToken :: !(Maybe Text) , _cisrsIPSet :: !(Maybe IPSet) , _cisrsResponseStatus :: !Int } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'CreateIPSetResponse' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'cisrsChangeToken' -- -- * 'cisrsIPSet' -- -- * 'cisrsResponseStatus' createIPSetResponse :: Int -- ^ 'cisrsResponseStatus' -> CreateIPSetResponse createIPSetResponse pResponseStatus_ = CreateIPSetResponse' { _cisrsChangeToken = Nothing , _cisrsIPSet = Nothing , _cisrsResponseStatus = pResponseStatus_ } -- | The 'ChangeToken' that you used to submit the 'CreateIPSet' request. You -- can also use this value to query the status of the request. For more -- information, see < GetChangeTokenStatus>. cisrsChangeToken :: Lens' CreateIPSetResponse (Maybe Text) cisrsChangeToken = lens _cisrsChangeToken (\ s a -> s{_cisrsChangeToken = a}); -- | The < IPSet> returned in the 'CreateIPSet' response. cisrsIPSet :: Lens' CreateIPSetResponse (Maybe IPSet) cisrsIPSet = lens _cisrsIPSet (\ s a -> s{_cisrsIPSet = a}); -- | The response status code. cisrsResponseStatus :: Lens' CreateIPSetResponse Int cisrsResponseStatus = lens _cisrsResponseStatus (\ s a -> s{_cisrsResponseStatus = a}); instance NFData CreateIPSetResponse