Skip to content

/AWS1/CL_FNTCACHEPLYQUERYSTR00

An object that determines whether any URL query strings in viewer requests (and if so, which query strings) are included in the cache key and in requests that CloudFront sends to the origin.

CONSTRUCTOR

IMPORTING

Required arguments:

IV_QUERYSTRINGBEHAVIOR TYPE /AWS1/FNTCACHEPLYQUERYSTRBEHAV /AWS1/FNTCACHEPLYQUERYSTRBEHAV

Determines whether any URL query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin. Valid values are:

  • none – No query strings in viewer requests are included in the cache key or in requests that CloudFront sends to the origin. Even when this field is set to none, any query strings that are listed in an OriginRequestPolicy are included in origin requests.

  • whitelist – Only the query strings in viewer requests that are listed in the QueryStringNames type are included in the cache key and in requests that CloudFront sends to the origin.

  • allExcept – All query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin, except those that are listed in the QueryStringNames type, which are not included.

  • all – All query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin.

Optional arguments:

IO_QUERYSTRINGS TYPE REF TO /AWS1/CL_FNTQUERYSTRINGNAMES /AWS1/CL_FNTQUERYSTRINGNAMES

Contains the specific query strings in viewer requests that either are or are not included in the cache key and in requests that CloudFront sends to the origin. The behavior depends on whether the QueryStringBehavior field in the CachePolicyQueryStringsConfig type is set to whitelist (the listed query strings are included) or allExcept (the listed query strings are not included, but all other query strings are).


Queryable Attributes

QueryStringBehavior

Determines whether any URL query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin. Valid values are:

  • none – No query strings in viewer requests are included in the cache key or in requests that CloudFront sends to the origin. Even when this field is set to none, any query strings that are listed in an OriginRequestPolicy are included in origin requests.

  • whitelist – Only the query strings in viewer requests that are listed in the QueryStringNames type are included in the cache key and in requests that CloudFront sends to the origin.

  • allExcept – All query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin, except those that are listed in the QueryStringNames type, which are not included.

  • all – All query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin.

Accessible with the following methods

Method Description
GET_QUERYSTRINGBEHAVIOR() Getter for QUERYSTRINGBEHAVIOR, with configurable default
ASK_QUERYSTRINGBEHAVIOR() Getter for QUERYSTRINGBEHAVIOR w/ exceptions if field has no
HAS_QUERYSTRINGBEHAVIOR() Determine if QUERYSTRINGBEHAVIOR has a value

QueryStrings

Contains the specific query strings in viewer requests that either are or are not included in the cache key and in requests that CloudFront sends to the origin. The behavior depends on whether the QueryStringBehavior field in the CachePolicyQueryStringsConfig type is set to whitelist (the listed query strings are included) or allExcept (the listed query strings are not included, but all other query strings are).

Accessible with the following methods

Method Description
GET_QUERYSTRINGS() Getter for QUERYSTRINGS