Copyright | (c) 2013-2018 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Creates a WebACL
, which contains the Rules
that identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluates Rules
in order based on the value of Priority
for each Rule
.
You also specify a default action, either ALLOW
or BLOCK
. If a web request doesn't match any of the Rules
in a WebACL
, AWS WAF responds to the request with the default action.
To create and configure a WebACL
, perform the following steps:
- Create and update the
ByteMatchSet
objects and other predicates that you want to include inRules
. For more information, seeCreateByteMatchSet
,UpdateByteMatchSet
,CreateIPSet
,UpdateIPSet
,CreateSqlInjectionMatchSet
, andUpdateSqlInjectionMatchSet
. - Create and update the
Rules
that you want to include in theWebACL
. For more information, seeCreateRule
andUpdateRule
. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of aCreateWebACL
request. - Submit a
CreateWebACL
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of anUpdateWebACL
request. - Submit an
UpdateWebACL
request to specify theRules
that you want to include in theWebACL
, to specify the default action, and to associate theWebACL
with a CloudFront distribution.
For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide .
- createWebACL :: Text -> Text -> WafAction -> Text -> CreateWebACL
- data CreateWebACL
- cwaName :: Lens' CreateWebACL Text
- cwaMetricName :: Lens' CreateWebACL Text
- cwaDefaultAction :: Lens' CreateWebACL WafAction
- cwaChangeToken :: Lens' CreateWebACL Text
- createWebACLResponse :: Int -> CreateWebACLResponse
- data CreateWebACLResponse
- cwarsWebACL :: Lens' CreateWebACLResponse (Maybe WebACL)
- cwarsChangeToken :: Lens' CreateWebACLResponse (Maybe Text)
- cwarsResponseStatus :: Lens' CreateWebACLResponse Int
Creating a Request
Creates a value of CreateWebACL
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
cwaName
- A friendly name or description of theWebACL
. You can't changeName
after you create theWebACL
.cwaMetricName
- A friendly name or description for the metrics for thisWebACL
. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't changeMetricName
after you create theWebACL
.cwaDefaultAction
- The action that you want AWS WAF to take when a request doesn't match the criteria specified in any of theRule
objects that are associated with theWebACL
.cwaChangeToken
- The value returned by the most recent call toGetChangeToken
.
data CreateWebACL Source #
See: createWebACL
smart constructor.
Request Lenses
cwaName :: Lens' CreateWebACL Text Source #
A friendly name or description of the WebACL
. You can't change Name
after you create the WebACL
.
cwaMetricName :: Lens' CreateWebACL Text Source #
A friendly name or description for the metrics for this WebACL
. The name can contain only alphanumeric characters (A-Z, a-z, 0-9); the name can't contain whitespace. You can't change MetricName
after you create the WebACL
.
cwaDefaultAction :: Lens' CreateWebACL WafAction Source #
The action that you want AWS WAF to take when a request doesn't match the criteria specified in any of the Rule
objects that are associated with the WebACL
.
cwaChangeToken :: Lens' CreateWebACL Text Source #
The value returned by the most recent call to GetChangeToken
.
Destructuring the Response
Creates a value of CreateWebACLResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
cwarsWebACL
- TheWebACL
returned in theCreateWebACL
response.cwarsChangeToken
- TheChangeToken
that you used to submit theCreateWebACL
request. You can also use this value to query the status of the request. For more information, seeGetChangeTokenStatus
.cwarsResponseStatus
- -- | The response status code.
data CreateWebACLResponse Source #
See: createWebACLResponse
smart constructor.
Response Lenses
cwarsWebACL :: Lens' CreateWebACLResponse (Maybe WebACL) Source #
The WebACL
returned in the CreateWebACL
response.
cwarsChangeToken :: Lens' CreateWebACLResponse (Maybe Text) Source #
The ChangeToken
that you used to submit the CreateWebACL
request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus
.
cwarsResponseStatus :: Lens' CreateWebACLResponse Int Source #
- - | The response status code.