software.amazon.awssdk.services.wafv2.model

Class FieldToMatch

java.lang.Object

software.amazon.awssdk.services.wafv2.model.FieldToMatch

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<FieldToMatch.Builder,FieldToMatch>

@Generated(value="software.amazon.awssdk:codegen")
public final class FieldToMatch
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<FieldToMatch.Builder,FieldToMatch>

The part of the web request that you want WAF to inspect. Include the single FieldToMatch type that you want to inspect, with additional specifications as needed, according to the type. You specify a single request component in FieldToMatch for each rule statement that requires it. To inspect more than one component of the web request, create a separate rule statement for each component.

Example JSON for a QueryString field to match:

"FieldToMatch": { "QueryString": {} }

Example JSON for a Method field to match specification:

"FieldToMatch": { "Method": { "Name": "DELETE" } }

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	FieldToMatch.Builder

Method Summary

Modifier and Type	Method and Description
AllQueryArguments	allQueryArguments() Inspect all query arguments.
Body	body() Inspect the request body as plain text.
static FieldToMatch.Builder	builder()
Cookies	cookies() Inspect the request cookies.
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
int	hashCode()
Headers	headers() Inspect the request headers.
JsonBody	jsonBody() Inspect the request body as JSON.
Method	method() Inspect the HTTP method.
QueryString	queryString() Inspect the query string.
List<SdkField<?>>	sdkFields()
static Class<? extends FieldToMatch.Builder>	serializableBuilderClass()
SingleHeader	singleHeader() Inspect a single header.
SingleQueryArgument	singleQueryArgument() Inspect a single query argument.
FieldToMatch.Builder	toBuilder()
String	toString() Returns a string representation of this object.
UriPath	uriPath() Inspect the request URI path.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

copy

Method Detail

singleHeader

public final SingleHeader singleHeader()

Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.

Example JSON: "SingleHeader": { "Name": "haystack" }

Alternately, you can filter and inspect all headers with the Headers FieldToMatch setting.

Returns:

Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.

Example JSON: "SingleHeader": { "Name": "haystack" }

Alternately, you can filter and inspect all headers with the Headers FieldToMatch setting.

singleQueryArgument

public final SingleQueryArgument singleQueryArgument()

Inspect a single query argument. Provide the name of the query argument to inspect, such as UserName or SalesRegion. The name can be up to 30 characters long and isn't case sensitive.

Example JSON: "SingleQueryArgument": { "Name": "myArgument" }

Returns:

Inspect a single query argument. Provide the name of the query argument to inspect, such as UserName or SalesRegion. The name can be up to 30 characters long and isn't case sensitive.

Example JSON: "SingleQueryArgument": { "Name": "myArgument" }

allQueryArguments

public final AllQueryArguments allQueryArguments()

Inspect all query arguments.

Returns:

Inspect all query arguments.

uriPath

public final UriPath uriPath()

Inspect the request URI path. This is the part of the web request that identifies a resource, for example, /images/daily-ad.jpg.

Returns:

Inspect the request URI path. This is the part of the web request that identifies a resource, for example, /images/daily-ad.jpg.

queryString

public final QueryString queryString()

Inspect the query string. This is the part of a URL that appears after a ? character, if any.

Returns:

Inspect the query string. This is the part of a URL that appears after a ? character, if any.

body

public final Body body()

Inspect the request body as plain text. The request body immediately follows the request headers. This is the part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form.

Only the first 8 KB (8192 bytes) of the request body are forwarded to WAF for inspection by the underlying host service. For information about how to handle oversized request bodies, see the Body object configuration.

Returns:

Inspect the request body as plain text. The request body immediately follows the request headers. This is the part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form.

Only the first 8 KB (8192 bytes) of the request body are forwarded to WAF for inspection by the underlying host service. For information about how to handle oversized request bodies, see the Body object configuration.

method

public final Method method()

Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.

Returns:

Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.

jsonBody

public final JsonBody jsonBody()

Inspect the request body as JSON. The request body immediately follows the request headers. This is the part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form.

Only the first 8 KB (8192 bytes) of the request body are forwarded to WAF for inspection by the underlying host service. For information about how to handle oversized request bodies, see the JsonBody object configuration.

Returns:

Inspect the request body as JSON. The request body immediately follows the request headers. This is the part of a request that contains any additional data that you want to send to your web server as the HTTP request body, such as data from a form.

Only the first 8 KB (8192 bytes) of the request body are forwarded to WAF for inspection by the underlying host service. For information about how to handle oversized request bodies, see the JsonBody object configuration.

headers

public final Headers headers()

Inspect the request headers. You must configure scope and pattern matching filters in the Headers object, to define the set of headers to and the parts of the headers that WAF inspects.

Only the first 8 KB (8192 bytes) of a request's headers and only the first 200 headers are forwarded to WAF for inspection by the underlying host service. You must configure how to handle any oversize header content in the Headers object. WAF applies the pattern matching filters to the headers that it receives from the underlying host service.

Returns:

Inspect the request headers. You must configure scope and pattern matching filters in the Headers object, to define the set of headers to and the parts of the headers that WAF inspects.

Only the first 8 KB (8192 bytes) of a request's headers and only the first 200 headers are forwarded to WAF for inspection by the underlying host service. You must configure how to handle any oversize header content in the Headers object. WAF applies the pattern matching filters to the headers that it receives from the underlying host service.

cookies

public final Cookies cookies()

Inspect the request cookies. You must configure scope and pattern matching filters in the Cookies object, to define the set of cookies and the parts of the cookies that WAF inspects.

Only the first 8 KB (8192 bytes) of a request's cookies and only the first 200 cookies are forwarded to WAF for inspection by the underlying host service. You must configure how to handle any oversize cookie content in the Cookies object. WAF applies the pattern matching filters to the cookies that it receives from the underlying host service.

Returns:

Inspect the request cookies. You must configure scope and pattern matching filters in the Cookies object, to define the set of cookies and the parts of the cookies that WAF inspects.

Only the first 8 KB (8192 bytes) of a request's cookies and only the first 200 cookies are forwarded to WAF for inspection by the underlying host service. You must configure how to handle any oversize cookie content in the Cookies object. WAF applies the pattern matching filters to the cookies that it receives from the underlying host service.

toBuilder

public FieldToMatch.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<FieldToMatch.Builder,FieldToMatch>

builder

public static FieldToMatch.Builder builder()

serializableBuilderClass

public static Class<? extends FieldToMatch.Builder> serializableBuilderClass()

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public final boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

toString

public final String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

getValueForField

public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)

sdkFields

public final List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo