Network.AWS.WAF.CreateIPSet

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 AWS WAF Developer Guide.

Creating a Request

createIPSet

Arguments

:: Text

cisName

-> Text

cisChangeToken

-> CreateIPSet

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

data CreateIPSet

See: createIPSet smart constructor.

Instances

Eq CreateIPSet

Methods

(==) :: CreateIPSet -> CreateIPSet -> Bool

(/=) :: CreateIPSet -> CreateIPSet -> Bool

Data CreateIPSet

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateIPSet -> c CreateIPSet

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateIPSet

toConstr :: CreateIPSet -> Constr

dataTypeOf :: CreateIPSet -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateIPSet)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateIPSet)

gmapT :: (forall b. Data b => b -> b) -> CreateIPSet -> CreateIPSet

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateIPSet -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateIPSet -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateIPSet -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateIPSet -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateIPSet -> m CreateIPSet

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateIPSet -> m CreateIPSet

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateIPSet -> m CreateIPSet

Read CreateIPSet

Methods

readsPrec :: Int -> ReadS CreateIPSet

readList :: ReadS [CreateIPSet]

readPrec :: ReadPrec CreateIPSet

readListPrec :: ReadPrec [CreateIPSet]

Show CreateIPSet

Methods

showsPrec :: Int -> CreateIPSet -> ShowS

show :: CreateIPSet -> String

showList :: [CreateIPSet] -> ShowS

Generic CreateIPSet

Associated Types

type Rep CreateIPSet :: * -> *

Methods

from :: CreateIPSet -> Rep CreateIPSet x

to :: Rep CreateIPSet x -> CreateIPSet

ToJSON CreateIPSet

Methods

toJSON :: CreateIPSet -> Value

toEncoding :: CreateIPSet -> Encoding

Hashable CreateIPSet

Methods

hashWithSalt :: Int -> CreateIPSet -> Int

hash :: CreateIPSet -> Int

NFData CreateIPSet

Methods

rnf :: CreateIPSet -> ()

AWSRequest CreateIPSet

Associated Types

type Rs CreateIPSet :: *

Methods

request :: CreateIPSet -> Request CreateIPSet

response :: MonadResource m => Logger -> Service -> Proxy * CreateIPSet -> ClientResponse -> m (Response CreateIPSet)

ToPath CreateIPSet

Methods

toPath :: CreateIPSet -> ByteString

ToHeaders CreateIPSet

Methods

toHeaders :: CreateIPSet -> [Header]

ToQuery CreateIPSet

Methods

toQuery :: CreateIPSet -> QueryString

type Rep CreateIPSet

type Rep CreateIPSet = D1 (MetaData "CreateIPSet" "Network.AWS.WAF.CreateIPSet" "amazonka-waf-1.4.3-HJkEVBX92ZdHK435qw2Wf" False) (C1 (MetaCons "CreateIPSet'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_cisName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_cisChangeToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs CreateIPSet

type Rs CreateIPSet = CreateIPSetResponse

Request Lenses

cisName :: Lens' CreateIPSet Text

A friendly name or description of the IPSet. You can't change Name after you create the IPSet.

cisChangeToken :: Lens' CreateIPSet Text

The value returned by the most recent call to GetChangeToken.

Destructuring the Response

createIPSetResponse

Arguments

:: Int

cisrsResponseStatus

-> CreateIPSetResponse

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

data CreateIPSetResponse

See: createIPSetResponse smart constructor.

Instances

Eq CreateIPSetResponse

Methods

(==) :: CreateIPSetResponse -> CreateIPSetResponse -> Bool

(/=) :: CreateIPSetResponse -> CreateIPSetResponse -> Bool

Data CreateIPSetResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateIPSetResponse -> c CreateIPSetResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateIPSetResponse

toConstr :: CreateIPSetResponse -> Constr

dataTypeOf :: CreateIPSetResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateIPSetResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateIPSetResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateIPSetResponse -> CreateIPSetResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateIPSetResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateIPSetResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateIPSetResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateIPSetResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateIPSetResponse -> m CreateIPSetResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateIPSetResponse -> m CreateIPSetResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateIPSetResponse -> m CreateIPSetResponse

Read CreateIPSetResponse

Methods

readsPrec :: Int -> ReadS CreateIPSetResponse

readList :: ReadS [CreateIPSetResponse]

readPrec :: ReadPrec CreateIPSetResponse

readListPrec :: ReadPrec [CreateIPSetResponse]

Show CreateIPSetResponse

Methods

showsPrec :: Int -> CreateIPSetResponse -> ShowS

show :: CreateIPSetResponse -> String

showList :: [CreateIPSetResponse] -> ShowS

Generic CreateIPSetResponse

Associated Types

type Rep CreateIPSetResponse :: * -> *

Methods

from :: CreateIPSetResponse -> Rep CreateIPSetResponse x

to :: Rep CreateIPSetResponse x -> CreateIPSetResponse

NFData CreateIPSetResponse

Methods

rnf :: CreateIPSetResponse -> ()

type Rep CreateIPSetResponse

type Rep CreateIPSetResponse = D1 (MetaData "CreateIPSetResponse" "Network.AWS.WAF.CreateIPSet" "amazonka-waf-1.4.3-HJkEVBX92ZdHK435qw2Wf" False) (C1 (MetaCons "CreateIPSetResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_cisrsChangeToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_cisrsIPSet") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe IPSet))) (S1 (MetaSel (Just Symbol "_cisrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))

Response Lenses

cisrsChangeToken :: Lens' CreateIPSetResponse (Maybe Text)

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.

cisrsIPSet :: Lens' CreateIPSetResponse (Maybe IPSet)

The IPSet returned in the CreateIPSet response.

cisrsResponseStatus :: Lens' CreateIPSetResponse Int

The response status code.