AWS::Lightsail::Distribution HeaderObject - AWS CloudFormation

AWS::Lightsail::Distribution HeaderObject

HeaderObject is a property of the CacheSettings property. It describes the request headers used by your distribution, which caches your content based on the request headers.

For the headers that you specify, your distribution caches separate versions of the specified content based on the header values in viewer requests. For example, suppose that viewer requests for logo.jpg contain a custom product header that has a value of either acme or apex. Also, suppose that you configure your distribution to cache your content based on values in the product header. Your distribution forwards the product header to the origin and caches the response from the origin once for each header value.


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


{ "HeadersAllowList" : [ String, ... ], "Option" : String }


HeadersAllowList: - String Option: String



The specific headers to forward to your distribution's origin.

Required: No

Type: Array of String

Update requires: No interruption


The headers that you want your distribution to forward to your origin. Your distribution caches your content based on these headers.

Use one of the following configurations for your distribution:

  • all - Forwards all headers to your origin..

  • none - Forwards only the default headers.

  • allow-list - Forwards only the headers that you specify using the HeadersAllowList parameter.

Required: No

Type: String

Allowed values: none | allow-list | all

Update requires: No interruption