Package software.amazon.awssdk.services.cloudfront.model

Interface Headers.Builder

All Superinterfaces:

CopyableBuilder<Headers.Builder,Headers>, SdkBuilder<Headers.Builder,Headers>

Enclosing class:

Headers

public static interface Headers.Builder
extends CopyableBuilder<Headers.Builder,Headers>

Method Summary

Modifier and Type	Method	Description
Headers.Builder	items(String... items)	A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior.
Headers.Builder	items(Collection<String> items)	A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior.
Headers.Builder	quantity(Integer quantity)	The number of different headers that you want CloudFront to forward to the origin for this cache behavior.

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

copy

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

apply, build

Method Detail

quantity

Headers.Builder quantity(Integer quantity)

The number of different headers that you want CloudFront to forward to the origin 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.

  If you configure CloudFront to forward all headers to your origin, CloudFront doesn't cache the objects associated with this cache behavior. Instead, it sends every request to the origin.

• Forward a whitelist of headers you specify: Specify the number of headers that you want to forward, and specify the header names in Name elements. CloudFront caches your objects based on the values in all of the specified headers. CloudFront also forwards the headers that it forwards by default, but it caches your objects based only on the headers that you specify.

• 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.

Parameters:

quantity - The number of different headers that you want CloudFront to forward to the origin 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.

  If you configure CloudFront to forward all headers to your origin, CloudFront doesn't cache the objects associated with this cache behavior. Instead, it sends every request to the origin.

• Forward a whitelist of headers you specify: Specify the number of headers that you want to forward, and specify the header names in Name elements. CloudFront caches your objects based on the values in all of the specified headers. CloudFront also forwards the headers that it forwards by default, but it caches your objects based only on the headers that you specify.

• 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

items

Headers.Builder items(Collection<String> items)

A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items.

Parameters:

items - A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items.

Returns:

Returns a reference to this object so that method calls can be chained together.

items

Headers.Builder items(String... items)

A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items.

NOTE: This method appends the values to the existing list (if any). Use #setItems(java.util.Collection) or #withItems(java.util.Collection) if you want to override the existing values.

Parameters:

items - A complex type that contains one Name element for each header that you want CloudFront to forward to the origin and to vary on for this cache behavior. If Quantity is 0, omit Items.

Returns:

Returns a reference to this object so that method calls can be chained together.