Interface RateBasedRule.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<RateBasedRule.Builder,
,RateBasedRule> SdkBuilder<RateBasedRule.Builder,
,RateBasedRule> SdkPojo
- Enclosing class:
RateBasedRule
-
Method Summary
Modifier and TypeMethodDescriptionmatchPredicates
(Collection<Predicate> matchPredicates) ThePredicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.matchPredicates
(Consumer<Predicate.Builder>... matchPredicates) ThePredicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.matchPredicates
(Predicate... matchPredicates) ThePredicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.metricName
(String metricName) A friendly name or description for the metrics for aRateBasedRule
.A friendly name or description for aRateBasedRule
.The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring.The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring.The maximum number of requests, which have an identical value in the field specified by theRateKey
, allowed in a five-minute period.A unique identifier for aRateBasedRule
.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
ruleId
A unique identifier for a
RateBasedRule
. You useRuleId
to get more information about aRateBasedRule
(see GetRateBasedRule), update aRateBasedRule
(see UpdateRateBasedRule), insert aRateBasedRule
into aWebACL
or delete one from aWebACL
(see UpdateWebACL), or delete aRateBasedRule
from AWS WAF (see DeleteRateBasedRule).- Parameters:
ruleId
- A unique identifier for aRateBasedRule
. You useRuleId
to get more information about aRateBasedRule
(see GetRateBasedRule), update aRateBasedRule
(see UpdateRateBasedRule), insert aRateBasedRule
into aWebACL
or delete one from aWebACL
(see UpdateWebACL), or delete aRateBasedRule
from AWS WAF (see DeleteRateBasedRule).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
name
A friendly name or description for a
RateBasedRule
. You can't change the name of aRateBasedRule
after you create it.- Parameters:
name
- A friendly name or description for aRateBasedRule
. You can't change the name of aRateBasedRule
after you create it.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
metricName
A friendly name or description for the metrics for a
RateBasedRule
. The name can contain only alphanumeric characters (A-Z, a-z, 0-9), with maximum length 128 and minimum length one. It can't contain whitespace or metric names reserved for AWS WAF, including "All" and "Default_Action." You can't change the name of the metric after you create theRateBasedRule
.- Parameters:
metricName
- A friendly name or description for the metrics for aRateBasedRule
. The name can contain only alphanumeric characters (A-Z, a-z, 0-9), with maximum length 128 and minimum length one. It can't contain whitespace or metric names reserved for AWS WAF, including "All" and "Default_Action." You can't change the name of the metric after you create theRateBasedRule
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
matchPredicates
The
Predicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.- Parameters:
matchPredicates
- ThePredicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
matchPredicates
The
Predicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.- Parameters:
matchPredicates
- ThePredicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
matchPredicates
The
This is a convenience method that creates an instance of thePredicates
object contains onePredicate
element for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule
.Predicate.Builder
avoiding the need to create one manually viaPredicate.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tomatchPredicates(List<Predicate>)
.- Parameters:
matchPredicates
- a consumer that will call methods onPredicate.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
rateKey
The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring. The only valid value for
RateKey
isIP
.IP
indicates that requests arriving from the same IP address are subject to theRateLimit
that is specified in theRateBasedRule
.- Parameters:
rateKey
- The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring. The only valid value forRateKey
isIP
.IP
indicates that requests arriving from the same IP address are subject to theRateLimit
that is specified in theRateBasedRule
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
rateKey
The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring. The only valid value for
RateKey
isIP
.IP
indicates that requests arriving from the same IP address are subject to theRateLimit
that is specified in theRateBasedRule
.- Parameters:
rateKey
- The field that AWS WAF uses to determine if requests are likely arriving from single source and thus subject to rate monitoring. The only valid value forRateKey
isIP
.IP
indicates that requests arriving from the same IP address are subject to theRateLimit
that is specified in theRateBasedRule
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
rateLimit
The maximum number of requests, which have an identical value in the field specified by the
RateKey
, allowed in a five-minute period. If the number of requests exceeds theRateLimit
and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.- Parameters:
rateLimit
- The maximum number of requests, which have an identical value in the field specified by theRateKey
, allowed in a five-minute period. If the number of requests exceeds theRateLimit
and the other predicates specified in the rule are also met, AWS WAF triggers the action that is specified for this rule.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-