Interface ParametersInCacheKeyAndForwardedToOrigin.Builder
- All Superinterfaces:
Buildable,CopyableBuilder<ParametersInCacheKeyAndForwardedToOrigin.Builder,,ParametersInCacheKeyAndForwardedToOrigin> SdkBuilder<ParametersInCacheKeyAndForwardedToOrigin.Builder,,ParametersInCacheKeyAndForwardedToOrigin> SdkPojo
- Enclosing class:
ParametersInCacheKeyAndForwardedToOrigin
-
Method Summary
Modifier and TypeMethodDescriptioncookiesConfig(Consumer<CachePolicyCookiesConfig.Builder> cookiesConfig) An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.cookiesConfig(CachePolicyCookiesConfig cookiesConfig) An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.enableAcceptEncodingBrotli(Boolean enableAcceptEncodingBrotli) A flag that can affect whether theAccept-EncodingHTTP header is included in the cache key and included in requests that CloudFront sends to the origin.enableAcceptEncodingGzip(Boolean enableAcceptEncodingGzip) A flag that can affect whether theAccept-EncodingHTTP header is included in the cache key and included in requests that CloudFront sends to the origin.headersConfig(Consumer<CachePolicyHeadersConfig.Builder> headersConfig) An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.headersConfig(CachePolicyHeadersConfig headersConfig) An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.queryStringsConfig(Consumer<CachePolicyQueryStringsConfig.Builder> queryStringsConfig) 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.queryStringsConfig(CachePolicyQueryStringsConfig queryStringsConfig) 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.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, sdkFields
-
Method Details
-
enableAcceptEncodingGzip
ParametersInCacheKeyAndForwardedToOrigin.Builder enableAcceptEncodingGzip(Boolean enableAcceptEncodingGzip) A flag that can affect whether the
Accept-EncodingHTTP header is included in the cache key and included in requests that CloudFront sends to the origin.This field is related to the
EnableAcceptEncodingBrotlifield. If one or both of these fields istrueand the viewer request includes theAccept-Encodingheader, then CloudFront does the following:-
Normalizes the value of the viewer's
Accept-Encodingheader -
Includes the normalized header in the cache key
-
Includes the normalized header in the request to the origin, if a request is necessary
For more information, see Compression support in the Amazon CloudFront Developer Guide.
If you set this value to
true, and this cache behavior also has an origin request policy attached, do not include theAccept-Encodingheader in the origin request policy. CloudFront always includes theAccept-Encodingheader in origin requests when the value of this field istrue, so including this header in an origin request policy has no effect.If both of these fields are
false, then CloudFront treats theAccept-Encodingheader the same as any other HTTP header in the viewer request. By default, it's not included in the cache key and it's not included in origin requests. In this case, you can manually addAccept-Encodingto the headers whitelist like any other HTTP header.- Parameters:
enableAcceptEncodingGzip- A flag that can affect whether theAccept-EncodingHTTP header is included in the cache key and included in requests that CloudFront sends to the origin.This field is related to the
EnableAcceptEncodingBrotlifield. If one or both of these fields istrueand the viewer request includes theAccept-Encodingheader, then CloudFront does the following:-
Normalizes the value of the viewer's
Accept-Encodingheader -
Includes the normalized header in the cache key
-
Includes the normalized header in the request to the origin, if a request is necessary
For more information, see Compression support in the Amazon CloudFront Developer Guide.
If you set this value to
true, and this cache behavior also has an origin request policy attached, do not include theAccept-Encodingheader in the origin request policy. CloudFront always includes theAccept-Encodingheader in origin requests when the value of this field istrue, so including this header in an origin request policy has no effect.If both of these fields are
false, then CloudFront treats theAccept-Encodingheader the same as any other HTTP header in the viewer request. By default, it's not included in the cache key and it's not included in origin requests. In this case, you can manually addAccept-Encodingto the headers whitelist like any other HTTP header.-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
enableAcceptEncodingBrotli
ParametersInCacheKeyAndForwardedToOrigin.Builder enableAcceptEncodingBrotli(Boolean enableAcceptEncodingBrotli) A flag that can affect whether the
Accept-EncodingHTTP header is included in the cache key and included in requests that CloudFront sends to the origin.This field is related to the
EnableAcceptEncodingGzipfield. If one or both of these fields istrueand the viewer request includes theAccept-Encodingheader, then CloudFront does the following:-
Normalizes the value of the viewer's
Accept-Encodingheader -
Includes the normalized header in the cache key
-
Includes the normalized header in the request to the origin, if a request is necessary
For more information, see Compression support in the Amazon CloudFront Developer Guide.
If you set this value to
true, and this cache behavior also has an origin request policy attached, do not include theAccept-Encodingheader in the origin request policy. CloudFront always includes theAccept-Encodingheader in origin requests when the value of this field istrue, so including this header in an origin request policy has no effect.If both of these fields are
false, then CloudFront treats theAccept-Encodingheader the same as any other HTTP header in the viewer request. By default, it's not included in the cache key and it's not included in origin requests. In this case, you can manually addAccept-Encodingto the headers whitelist like any other HTTP header.- Parameters:
enableAcceptEncodingBrotli- A flag that can affect whether theAccept-EncodingHTTP header is included in the cache key and included in requests that CloudFront sends to the origin.This field is related to the
EnableAcceptEncodingGzipfield. If one or both of these fields istrueand the viewer request includes theAccept-Encodingheader, then CloudFront does the following:-
Normalizes the value of the viewer's
Accept-Encodingheader -
Includes the normalized header in the cache key
-
Includes the normalized header in the request to the origin, if a request is necessary
For more information, see Compression support in the Amazon CloudFront Developer Guide.
If you set this value to
true, and this cache behavior also has an origin request policy attached, do not include theAccept-Encodingheader in the origin request policy. CloudFront always includes theAccept-Encodingheader in origin requests when the value of this field istrue, so including this header in an origin request policy has no effect.If both of these fields are
false, then CloudFront treats theAccept-Encodingheader the same as any other HTTP header in the viewer request. By default, it's not included in the cache key and it's not included in origin requests. In this case, you can manually addAccept-Encodingto the headers whitelist like any other HTTP header.-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
headersConfig
ParametersInCacheKeyAndForwardedToOrigin.Builder headersConfig(CachePolicyHeadersConfig headersConfig) An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.
- Parameters:
headersConfig- An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
headersConfig
default ParametersInCacheKeyAndForwardedToOrigin.Builder headersConfig(Consumer<CachePolicyHeadersConfig.Builder> headersConfig) An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.
This is a convenience method that creates an instance of theCachePolicyHeadersConfig.Builderavoiding the need to create one manually viaCachePolicyHeadersConfig.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toheadersConfig(CachePolicyHeadersConfig).- Parameters:
headersConfig- a consumer that will call methods onCachePolicyHeadersConfig.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
cookiesConfig
ParametersInCacheKeyAndForwardedToOrigin.Builder cookiesConfig(CachePolicyCookiesConfig cookiesConfig) An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.
- Parameters:
cookiesConfig- An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
cookiesConfig
default ParametersInCacheKeyAndForwardedToOrigin.Builder cookiesConfig(Consumer<CachePolicyCookiesConfig.Builder> cookiesConfig) An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.
This is a convenience method that creates an instance of theCachePolicyCookiesConfig.Builderavoiding the need to create one manually viaCachePolicyCookiesConfig.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed tocookiesConfig(CachePolicyCookiesConfig).- Parameters:
cookiesConfig- a consumer that will call methods onCachePolicyCookiesConfig.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
queryStringsConfig
ParametersInCacheKeyAndForwardedToOrigin.Builder queryStringsConfig(CachePolicyQueryStringsConfig queryStringsConfig) 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.
- Parameters:
queryStringsConfig- 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.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
queryStringsConfig
default ParametersInCacheKeyAndForwardedToOrigin.Builder queryStringsConfig(Consumer<CachePolicyQueryStringsConfig.Builder> queryStringsConfig) 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.
This is a convenience method that creates an instance of theCachePolicyQueryStringsConfig.Builderavoiding the need to create one manually viaCachePolicyQueryStringsConfig.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toqueryStringsConfig(CachePolicyQueryStringsConfig).- Parameters:
queryStringsConfig- a consumer that will call methods onCachePolicyQueryStringsConfig.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-