Interface Cookies.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<Cookies.Builder,
,Cookies> SdkBuilder<Cookies.Builder,
,Cookies> SdkPojo
- Enclosing class:
Cookies
-
Method Summary
Modifier and TypeMethodDescriptiondefault Cookies.Builder
matchPattern
(Consumer<CookieMatchPattern.Builder> matchPattern) The filter to use to identify the subset of cookies to inspect in a web request.matchPattern
(CookieMatchPattern matchPattern) The filter to use to identify the subset of cookies to inspect in a web request.matchScope
(String matchScope) The parts of the cookies to inspect with the rule inspection criteria.matchScope
(MapMatchScope matchScope) The parts of the cookies to inspect with the rule inspection criteria.oversizeHandling
(String oversizeHandling) What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect.oversizeHandling
(OversizeHandling oversizeHandling) What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect.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
-
matchPattern
The filter to use to identify the subset of cookies to inspect in a web request.
You must specify exactly one setting: either
All
,IncludedCookies
, orExcludedCookies
.Example JSON:
"MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
- Parameters:
matchPattern
- The filter to use to identify the subset of cookies to inspect in a web request.You must specify exactly one setting: either
All
,IncludedCookies
, orExcludedCookies
.Example JSON:
"MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
matchPattern
The filter to use to identify the subset of cookies to inspect in a web request.
You must specify exactly one setting: either
All
,IncludedCookies
, orExcludedCookies
.Example JSON:
This is a convenience method that creates an instance of the"MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
CookieMatchPattern.Builder
avoiding the need to create one manually viaCookieMatchPattern.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tomatchPattern(CookieMatchPattern)
.- Parameters:
matchPattern
- a consumer that will call methods onCookieMatchPattern.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
matchScope
The parts of the cookies to inspect with the rule inspection criteria. If you specify
ALL
, WAF inspects both keys and values.All
does not require a match to be found in the keys and a match to be found in the values. It requires a match to be found in the keys or the values or both. To require a match in the keys and in the values, use a logicalAND
statement to combine two match rules, one that inspects the keys and another that inspects the values.- Parameters:
matchScope
- The parts of the cookies to inspect with the rule inspection criteria. If you specifyALL
, WAF inspects both keys and values.All
does not require a match to be found in the keys and a match to be found in the values. It requires a match to be found in the keys or the values or both. To require a match in the keys and in the values, use a logicalAND
statement to combine two match rules, one that inspects the keys and another that inspects the values.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
matchScope
The parts of the cookies to inspect with the rule inspection criteria. If you specify
ALL
, WAF inspects both keys and values.All
does not require a match to be found in the keys and a match to be found in the values. It requires a match to be found in the keys or the values or both. To require a match in the keys and in the values, use a logicalAND
statement to combine two match rules, one that inspects the keys and another that inspects the values.- Parameters:
matchScope
- The parts of the cookies to inspect with the rule inspection criteria. If you specifyALL
, WAF inspects both keys and values.All
does not require a match to be found in the keys and a match to be found in the values. It requires a match to be found in the keys or the values or both. To require a match in the keys and in the values, use a logicalAND
statement to combine two match rules, one that inspects the keys and another that inspects the values.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
oversizeHandling
What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to WAF.
The options for oversize handling are the following:
-
CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria. -
MATCH
- Treat the web request as matching the rule statement. WAF applies the rule action to the request. -
NO_MATCH
- Treat the web request as not matching the rule statement.
- Parameters:
oversizeHandling
- What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to WAF.The options for oversize handling are the following:
-
CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria. -
MATCH
- Treat the web request as matching the rule statement. WAF applies the rule action to the request. -
NO_MATCH
- Treat the web request as not matching the rule statement.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
oversizeHandling
What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to WAF.
The options for oversize handling are the following:
-
CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria. -
MATCH
- Treat the web request as matching the rule statement. WAF applies the rule action to the request. -
NO_MATCH
- Treat the web request as not matching the rule statement.
- Parameters:
oversizeHandling
- What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to WAF.The options for oversize handling are the following:
-
CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria. -
MATCH
- Treat the web request as matching the rule statement. WAF applies the rule action to the request. -
NO_MATCH
- Treat the web request as not matching the rule statement.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-