AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Container for the parameters to the CreateRateBasedRule operation.
This is AWS WAF Classic documentation. For more information, see AWS
WAF Classic in the developer guide.
For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS
WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints
for regional and global use.
Creates a RateBasedRule. The RateBasedRule
contains a RateLimit
,
which specifies the maximum number of requests that AWS WAF allows from a specified
IP address in a five-minute period. The RateBasedRule
also contains the IPSet
objects, ByteMatchSet
objects, and other predicates that identify the requests
that you want to count or block if these requests exceed the RateLimit
.
If you add more than one predicate to a RateBasedRule
, a request not only must
exceed the RateLimit
, but it also must match all the conditions to be counted
or blocked. For example, suppose you add the following to a RateBasedRule
:
An IPSet
that matches the IP address 192.0.2.44/32
A ByteMatchSet
that matches BadBot
in the User-Agent
header
Further, you specify a RateLimit
of 1,000.
You then add the RateBasedRule
to a WebACL
and specify that you want
to block requests that meet the conditions in the rule. For a request to be blocked,
it must come from the IP address 192.0.2.44 and the User-Agent
header
in the request must contain the value BadBot
. Further, requests that match
these two conditions must be received at a rate of more than 1,000 requests every
five minutes. If both conditions are met and the rate is exceeded, AWS WAF blocks
the requests. If the rate drops below 1,000 for a five-minute period, AWS WAF no longer
blocks the requests.
As a second example, suppose you want to limit requests to a particular page on your
site. To do this, you could add the following to a RateBasedRule
:
A ByteMatchSet
with FieldToMatch
of URI
A PositionalConstraint
of STARTS_WITH
A TargetString
of login
Further, you specify a RateLimit
of 1,000.
By adding this RateBasedRule
to a WebACL
, you could limit requests to
your login page without affecting the rest of your site.
To create and configure a RateBasedRule
, perform the following steps:
Create and update the predicates that you want to include in the rule. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.
Use GetChangeToken to get the change token that you provide in the ChangeToken
parameter of a CreateRule
request.
Submit a CreateRateBasedRule
request.
Use GetChangeToken
to get the change token that you provide in the ChangeToken
parameter of an UpdateRule request.
Submit an UpdateRateBasedRule
request to specify the predicates that you want
to include in the rule.
Create and update a WebACL
that contains the RateBasedRule
. For more
information, see CreateWebACL.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
Namespace: Amazon.WAF.Model
Assembly: AWSSDK.WAF.dll
Version: 3.x.y.z
public class CreateRateBasedRuleRequest : AmazonWAFRequest IAmazonWebServiceRequest
The CreateRateBasedRuleRequest type exposes the following members
Name | Description | |
---|---|---|
CreateRateBasedRuleRequest() |
Name | Type | Description | |
---|---|---|---|
ChangeToken | System.String |
Gets and sets the property ChangeToken.
The |
|
MetricName | System.String |
Gets and sets the property MetricName.
A friendly name or description for the metrics for this |
|
Name | System.String |
Gets and sets the property Name.
A friendly name or description of the RateBasedRule. You can't change the name
of a |
|
RateKey | Amazon.WAF.RateKey |
Gets and sets the property RateKey.
The field that AWS WAF uses to determine if requests are likely arriving from a single
source and thus subject to rate monitoring. The only valid value for |
|
RateLimit | System.Int64 |
Gets and sets the property RateLimit.
The maximum number of requests, which have an identical value in the field that is
specified by |
|
Tags | System.Collections.Generic.List<Amazon.WAF.Model.Tag> |
Gets and sets the property Tags. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5