AWS::CloudFront::OriginRequestPolicy HeadersConfig - Amazon CloudFormation
SyntaxProperties
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::CloudFront::OriginRequestPolicy HeadersConfig

An object that determines whether any HTTP headers (and if so, which headers) are included in requests that CloudFront sends to the origin.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "HeaderBehavior" : String,
  "Headers" : [ String, ... ]
}

YAML

  HeaderBehavior: String
  Headers: 
    - String

Properties

HeaderBehavior

Determines whether any HTTP headers are included in requests that CloudFront sends to the origin. Valid values are:

  • none – No HTTP headers in viewer requests are included in requests that CloudFront sends to the origin. Even when this field is set to none, any headers that are listed in a CachePolicy are included in origin requests.

  • whitelist – Only the HTTP headers that are listed in the Headers type are included in requests that CloudFront sends to the origin.

  • allViewer – All HTTP headers in viewer requests are included in requests that CloudFront sends to the origin.

  • allViewerAndWhitelistCloudFront – All HTTP headers in viewer requests and the additional CloudFront headers that are listed in the Headers type are included in requests that CloudFront sends to the origin. The additional headers are added by CloudFront.

  • allExcept – All HTTP headers in viewer requests are included in requests that CloudFront sends to the origin, except for those listed in the Headers type, which are not included.

Required: Yes

Type: String

Pattern: ^(none|whitelist|allViewer|allViewerAndWhitelistCloudFront|allExcept)$

Update requires: No interruption

Headers

Contains a list of HTTP header names.

Required: No

Type: Array of String

Update requires: No interruption