public static interface Headers.Builder extends CopyableBuilder<Headers.Builder,Headers>
Modifier and Type | Method and Description |
---|---|
Headers.Builder |
items(Collection<String> items)
A list that contains one
Name element for each header that you want CloudFront to use for
caching in this cache behavior. |
Headers.Builder |
items(String... items)
A list that contains one
Name element for each header that you want CloudFront to use for
caching in this cache behavior. |
Headers.Builder |
quantity(Integer quantity)
The number of different headers that you want CloudFront to base caching on for this cache behavior.
|
copy
apply, build
Headers.Builder quantity(Integer quantity)
The number of different headers that you want CloudFront to base caching on for this cache behavior. You can configure each cache behavior in a web distribution to do one of the following:
Forward all headers to your origin: Specify 1
for Quantity
and
*
for Name
.
CloudFront doesn't cache the objects that are associated with this cache behavior. Instead, CloudFront sends every request to the origin.
Forward a whitelist of headers you specify: Specify the number of headers that you want CloudFront to
base caching on. Then specify the header names in Name
elements. CloudFront caches your objects
based on the values in the specified headers.
Forward only the default headers: Specify 0
for Quantity
and omit
Items
. In this configuration, CloudFront doesn't cache based on the values in the request
headers.
Regardless of which option you choose, CloudFront forwards headers to your origin based on whether the origin is an S3 bucket or a custom origin. See the following documentation:
S3 bucket: See HTTP Request Headers That CloudFront Removes or Updates
Custom origin: See HTTP Request Headers and CloudFront Behavior
quantity
- The number of different headers that you want CloudFront to base caching on for this cache behavior.
You can configure each cache behavior in a web distribution to do one of the following:
Forward all headers to your origin: Specify 1
for Quantity
and
*
for Name
.
CloudFront doesn't cache the objects that are associated with this cache behavior. Instead, CloudFront sends every request to the origin.
Forward a whitelist of headers you specify: Specify the number of headers that you want
CloudFront to base caching on. Then specify the header names in Name
elements. CloudFront
caches your objects based on the values in the specified headers.
Forward only the default headers: Specify 0
for Quantity
and omit
Items
. In this configuration, CloudFront doesn't cache based on the values in the request
headers.
Regardless of which option you choose, CloudFront forwards headers to your origin based on whether the origin is an S3 bucket or a custom origin. See the following documentation:
S3 bucket: See HTTP Request Headers That CloudFront Removes or Updates
Custom origin: See HTTP Request Headers and CloudFront Behavior
Headers.Builder items(Collection<String> items)
A list that contains one Name
element for each header that you want CloudFront to use for
caching in this cache behavior. If Quantity
is 0
, omit Items
.
items
- A list that contains one Name
element for each header that you want CloudFront to use for
caching in this cache behavior. If Quantity
is 0
, omit Items
.Headers.Builder items(String... items)
A list that contains one Name
element for each header that you want CloudFront to use for
caching in this cache behavior. If Quantity
is 0
, omit Items
.
items
- A list that contains one Name
element for each header that you want CloudFront to use for
caching in this cache behavior. If Quantity
is 0
, omit Items
.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.