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) ThePredicatesobject contains onePredicateelement for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule.matchPredicates(Consumer<Predicate.Builder>... matchPredicates) ThePredicatesobject contains onePredicateelement for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule.matchPredicates(Predicate... matchPredicates) ThePredicatesobject contains onePredicateelement 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
copyMethods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, buildMethods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Method Details
-
ruleId
A unique identifier for a
RateBasedRule. You useRuleIdto get more information about aRateBasedRule(see GetRateBasedRule), update aRateBasedRule(see UpdateRateBasedRule), insert aRateBasedRuleinto aWebACLor delete one from aWebACL(see UpdateWebACL), or delete aRateBasedRulefrom AWS WAF (see DeleteRateBasedRule).- Parameters:
ruleId- A unique identifier for aRateBasedRule. You useRuleIdto get more information about aRateBasedRule(see GetRateBasedRule), update aRateBasedRule(see UpdateRateBasedRule), insert aRateBasedRuleinto aWebACLor delete one from aWebACL(see UpdateWebACL), or delete aRateBasedRulefrom 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 aRateBasedRuleafter you create it.- Parameters:
name- A friendly name or description for aRateBasedRule. You can't change the name of aRateBasedRuleafter 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
Predicatesobject contains onePredicateelement for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule.- Parameters:
matchPredicates- ThePredicatesobject contains onePredicateelement 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
Predicatesobject contains onePredicateelement for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule.- Parameters:
matchPredicates- ThePredicatesobject contains onePredicateelement 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 thePredicatesobject contains onePredicateelement for each ByteMatchSet, IPSet, or SqlInjectionMatchSet object that you want to include in aRateBasedRule.Predicate.Builderavoiding the need to create one manually viaPredicate.builder().When the
Consumercompletes,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
RateKeyisIP.IPindicates that requests arriving from the same IP address are subject to theRateLimitthat 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 forRateKeyisIP.IPindicates that requests arriving from the same IP address are subject to theRateLimitthat 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
RateKeyisIP.IPindicates that requests arriving from the same IP address are subject to theRateLimitthat 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 forRateKeyisIP.IPindicates that requests arriving from the same IP address are subject to theRateLimitthat 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 theRateLimitand 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 theRateLimitand 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.
-