Interface CfnDistribution.HeaderObjectProperty

All Superinterfaces:
All Known Implementing Classes:
Enclosing class:

@Stability(Stable) public static interface CfnDistribution.HeaderObjectProperty extends
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.


 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 HeaderObjectProperty headerObjectProperty = HeaderObjectProperty.builder()
  • Method Details

    • getHeadersAllowList

      @Stability(Stable) @Nullable default List<String> getHeadersAllowList()
      The specific headers to forward to your distribution's origin.
    • getOption

      @Stability(Stable) @Nullable default String getOption()
      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.
    • builder

      @Stability(Stable) static CfnDistribution.HeaderObjectProperty.Builder builder()
      a CfnDistribution.HeaderObjectProperty.Builder of CfnDistribution.HeaderObjectProperty