@awboost/cfn-resource-types 0.1.197 → 0.1.199

package/lib/AWS-CloudFront-CachePolicy.d.ts

@@ -1,10 +1,19 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 import type { ResourceOptions as $ResourceOptions } from "@awboost/cfn-template-builder/template";
 /**
- * Resource Type definition for AWS::CloudFront::CachePolicy
+ * Resource type definition for `AWS::CloudFront::CachePolicy`.
+ * A cache policy.
+ When it's attached to a cache behavior, the cache policy determines the following:
+  +  The values that CloudFront includes in the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
+  +  The default, minimum, and maximum time to live (TTL) values that you want objects to stay in the CloudFront cache.
+  
+ The headers, cookies, and query strings that are included in the cache key are also included in requests that CloudFront sends to the origin. CloudFront sends a request when it can't find a valid object in its cache that matches the request's cache key. If you want to send values to the origin but *not* include them in the cache key, use ``OriginRequestPolicy``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-cachepolicy.html}
  */
 export type CloudFrontCachePolicyProperties = {
+    /**
+     * The cache policy configuration.
+     */
     CachePolicyConfig: CachePolicyConfig;
 };
 /**
@@ -17,71 +26,155 @@ export type CloudFrontCachePolicyAttributes = {
 };
 /**
  * Type definition for `AWS::CloudFront::CachePolicy.CachePolicyConfig`.
+ * A cache policy configuration.
+ This configuration determines the following:
+  +  The values that CloudFront includes in the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
+  +  The default, minimum, and maximum time to live (TTL) values that you want objects to stay in the CloudFront cache.
+  
+ The headers, cookies, and query strings that are included in the cache key are also included in requests that CloudFront sends to the origin. CloudFront sends a request when it can't find a valid object in its cache that matches the request's cache key. If you want to send values to the origin but *not* include them in the cache key, use ``OriginRequestPolicy``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-cachepolicy-cachepolicyconfig.html}
  */
 export type CachePolicyConfig = {
-    Comment?: string;
     /**
-     * @min `0`
+     * A comment to describe the cache policy. The comment cannot be longer than 128 characters.
      */
+    Comment?: string;
+    /**
+       * The default amount of time, in seconds, that you want objects to stay in the CloudFront cache before CloudFront sends another request to the origin to see if the object has been updated. CloudFront uses this value as the object's time to live (TTL) only when the origin does *not* send ``Cache-Control`` or ``Expires`` headers with the object. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide*.
+       The default value for this field is 86400 seconds (one day). If the value of ``MinTTL`` is more than 86400 seconds, then the default value for this field is the same as the value of ``MinTTL``.
+       * @min `0`
+       */
     DefaultTTL: number;
     /**
-     * @min `0`
-     */
+       * The maximum amount of time, in seconds, that objects stay in the CloudFront cache before CloudFront sends another request to the origin to see if the object has been updated. CloudFront uses this value only when the origin sends ``Cache-Control`` or ``Expires`` headers with the object. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide*.
+       The default value for this field is 31536000 seconds (one year). If the value of ``MinTTL`` or ``DefaultTTL`` is more than 31536000 seconds, then the default value for this field is the same as the value of ``DefaultTTL``.
+       * @min `0`
+       */
     MaxTTL: number;
     /**
+     * The minimum amount of time, in seconds, that you want objects to stay in the CloudFront cache before CloudFront sends another request to the origin to see if the object has been updated. For more information, see [Managing How Long Content Stays in an Edge Cache (Expiration)](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html) in the *Amazon CloudFront Developer Guide*.
      * @min `0`
      */
     MinTTL: number;
+    /**
+     * A unique name to identify the cache policy.
+     */
     Name: string;
+    /**
+     * The HTTP headers, cookies, and URL query strings to include in the cache key. The values included in the cache key are also included in requests that CloudFront sends to the origin.
+     */
     ParametersInCacheKeyAndForwardedToOrigin: ParametersInCacheKeyAndForwardedToOrigin;
 };
 /**
  * Type definition for `AWS::CloudFront::CachePolicy.CookiesConfig`.
+ * An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-cachepolicy-cookiesconfig.html}
  */
 export type CookiesConfig = {
     /**
-     * @pattern `^(none|whitelist|allExcept|all)$`
-     */
+       * Determines whether any cookies in viewer requests are included in the cache key and in requests that CloudFront sends to the origin. Valid values are:
+        +   ``none`` – No cookies in viewer requests are included in the cache key or in requests that CloudFront sends to the origin. Even when this field is set to ``none``, any cookies that are listed in an ``OriginRequestPolicy`` *are* included in origin requests.
+        +   ``whitelist`` – Only the cookies in viewer requests that are listed in the ``CookieNames`` type are included in the cache key and in requests that CloudFront sends to the origin.
+        +   ``allExcept`` – All cookies in viewer requests are included in the cache key and in requests that CloudFront sends to the origin, *except* for those that are listed in the ``CookieNames`` type, which are not included.
+        +   ``all`` – All cookies in viewer requests are included in the cache key and in requests that CloudFront sends to the origin.
+       * @pattern `^(none|whitelist|allExcept|all)$`
+       */
     CookieBehavior: string;
+    /**
+     * Contains a list of cookie names.
+     */
     Cookies?: string[];
 };
 /**
  * Type definition for `AWS::CloudFront::CachePolicy.HeadersConfig`.
+ * An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-cachepolicy-headersconfig.html}
  */
 export type HeadersConfig = {
     /**
-     * @pattern `^(none|whitelist)$`
-     */
+       * Determines whether any HTTP headers are included in the cache key and in requests that CloudFront sends to the origin. Valid values are:
+        +   ``none`` – No HTTP headers are included in the cache key or in requests that CloudFront sends to the origin. Even when this field is set to ``none``, any headers that are listed in an ``OriginRequestPolicy`` *are* included in origin requests.
+        +   ``whitelist`` – Only the HTTP headers that are listed in the ``Headers`` type are included in the cache key and in requests that CloudFront sends to the origin.
+       * @pattern `^(none|whitelist)$`
+       */
     HeaderBehavior: string;
+    /**
+     * Contains a list of HTTP header names.
+     */
     Headers?: string[];
 };
 /**
  * Type definition for `AWS::CloudFront::CachePolicy.ParametersInCacheKeyAndForwardedToOrigin`.
+ * This object determines the values that CloudFront includes in the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
+ The headers, cookies, and query strings that are included in the cache key are also included in requests that CloudFront sends to the origin. CloudFront sends a request when it can't find an object in its cache that matches the request's cache key. If you want to send values to the origin but *not* include them in the cache key, use ``OriginRequestPolicy``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-cachepolicy-parametersincachekeyandforwardedtoorigin.html}
  */
 export type ParametersInCacheKeyAndForwardedToOrigin = {
+    /**
+     * An object that determines whether any cookies in viewer requests (and if so, which cookies) are included in the cache key and in requests that CloudFront sends to the origin.
+     */
     CookiesConfig: CookiesConfig;
+    /**
+       * A flag that can affect whether the ``Accept-Encoding`` HTTP header is included in the cache key and included in requests that CloudFront sends to the origin.
+       This field is related to the ``EnableAcceptEncodingGzip`` field. If one or both of these fields is ``true`` *and* the viewer request includes the ``Accept-Encoding`` header, then CloudFront does the following:
+        +  Normalizes the value of the viewer's ``Accept-Encoding`` header
+        +  Includes the normalized header in the cache key
+        +  Includes the normalized header in the request to the origin, if a request is necessary
+        
+       For more information, see [Compression support](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-policy-compressed-objects) in the *Amazon CloudFront Developer Guide*.
+       If you set this value to ``true``, and this cache behavior also has an origin request policy attached, do not include the ``Accept-Encoding`` header in the origin request policy. CloudFront always includes the ``Accept-Encoding`` header in origin requests when the value of this field is ``true``, so including this header in an origin request policy has no effect.
+       If both of these fields are ``false``, then CloudFront treats the ``Accept-Encoding`` header the same as any other HTTP header in the viewer request. By default, it's not included in the cache key and it's not included in origin requests. In this case, you can manually add ``Accept-Encoding`` to the headers whitelist like any other HTTP header.
+       */
     EnableAcceptEncodingBrotli?: boolean;
+    /**
+       * A flag that can affect whether the ``Accept-Encoding`` HTTP header is included in the cache key and included in requests that CloudFront sends to the origin.
+       This field is related to the ``EnableAcceptEncodingBrotli`` field. If one or both of these fields is ``true`` *and* the viewer request includes the ``Accept-Encoding`` header, then CloudFront does the following:
+        +  Normalizes the value of the viewer's ``Accept-Encoding`` header
+        +  Includes the normalized header in the cache key
+        +  Includes the normalized header in the request to the origin, if a request is necessary
+        
+       For more information, see [Compression support](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/controlling-the-cache-key.html#cache-policy-compressed-objects) in the *Amazon CloudFront Developer Guide*.
+       If you set this value to ``true``, and this cache behavior also has an origin request policy attached, do not include the ``Accept-Encoding`` header in the origin request policy. CloudFront always includes the ``Accept-Encoding`` header in origin requests when the value of this field is ``true``, so including this header in an origin request policy has no effect.
+       If both of these fields are ``false``, then CloudFront treats the ``Accept-Encoding`` header the same as any other HTTP header in the viewer request. By default, it's not included in the cache key and it's not included in origin requests. In this case, you can manually add ``Accept-Encoding`` to the headers whitelist like any other HTTP header.
+       */
     EnableAcceptEncodingGzip: boolean;
+    /**
+     * An object that determines whether any HTTP headers (and if so, which headers) are included in the cache key and in requests that CloudFront sends to the origin.
+     */
     HeadersConfig: HeadersConfig;
+    /**
+     * An object that determines whether any URL query strings in viewer requests (and if so, which query strings) are included in the cache key and in requests that CloudFront sends to the origin.
+     */
     QueryStringsConfig: QueryStringsConfig;
 };
 /**
  * Type definition for `AWS::CloudFront::CachePolicy.QueryStringsConfig`.
+ * An object that determines whether any URL query strings in viewer requests (and if so, which query strings) are included in the cache key and in requests that CloudFront sends to the origin.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-cachepolicy-querystringsconfig.html}
  */
 export type QueryStringsConfig = {
     /**
-     * @pattern `^(none|whitelist|allExcept|all)$`
-     */
+       * Determines whether any URL query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin. Valid values are:
+        +   ``none`` – No query strings in viewer requests are included in the cache key or in requests that CloudFront sends to the origin. Even when this field is set to ``none``, any query strings that are listed in an ``OriginRequestPolicy`` *are* included in origin requests.
+        +   ``whitelist`` – Only the query strings in viewer requests that are listed in the ``QueryStringNames`` type are included in the cache key and in requests that CloudFront sends to the origin.
+        +   ``allExcept`` – All query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin, *except* those that are listed in the ``QueryStringNames`` type, which are not included.
+        +   ``all`` – All query strings in viewer requests are included in the cache key and in requests that CloudFront sends to the origin.
+       * @pattern `^(none|whitelist|allExcept|all)$`
+       */
     QueryStringBehavior: string;
+    /**
+     * Contains a list of query string names.
+     */
     QueryStrings?: string[];
 };
 /**
- * Resource Type definition for AWS::CloudFront::CachePolicy
+ * Resource type definition for `AWS::CloudFront::CachePolicy`.
+ * A cache policy.
+ When it's attached to a cache behavior, the cache policy determines the following:
+  +  The values that CloudFront includes in the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
+  +  The default, minimum, and maximum time to live (TTL) values that you want objects to stay in the CloudFront cache.
+  
+ The headers, cookies, and query strings that are included in the cache key are also included in requests that CloudFront sends to the origin. CloudFront sends a request when it can't find a valid object in its cache that matches the request's cache key. If you want to send values to the origin but *not* include them in the cache key, use ``OriginRequestPolicy``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-cachepolicy.html}
  */
 export declare class CloudFrontCachePolicy extends $Resource<"AWS::CloudFront::CachePolicy", CloudFrontCachePolicyProperties, CloudFrontCachePolicyAttributes> {

package/lib/AWS-CloudFront-CachePolicy.js

@@ -1,6 +1,12 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::CachePolicy
+ * Resource type definition for `AWS::CloudFront::CachePolicy`.
+ * A cache policy.
+ When it's attached to a cache behavior, the cache policy determines the following:
+  +  The values that CloudFront includes in the cache key. These values can include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to find an object in its cache that it can return to the viewer.
+  +  The default, minimum, and maximum time to live (TTL) values that you want objects to stay in the CloudFront cache.
+  
+ The headers, cookies, and query strings that are included in the cache key are also included in requests that CloudFront sends to the origin. CloudFront sends a request when it can't find a valid object in its cache that matches the request's cache key. If you want to send values to the origin but *not* include them in the cache key, use ``OriginRequestPolicy``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-cachepolicy.html}
  */
 export class CloudFrontCachePolicy extends $Resource {

package/lib/AWS-CloudFront-CloudFrontOriginAccessIdentity.d.ts

@@ -1,10 +1,14 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 import type { ResourceOptions as $ResourceOptions } from "@awboost/cfn-template-builder/template";
 /**
- * Resource Type definition for AWS::CloudFront::CloudFrontOriginAccessIdentity
+ * Resource type definition for `AWS::CloudFront::CloudFrontOriginAccessIdentity`.
+ * The request to create a new origin access identity (OAI). An origin access identity is a special CloudFront user that you can associate with Amazon S3 origins, so that you can secure all or just some of your Amazon S3 content. For more information, see [Restricting Access to Amazon S3 Content by Using an Origin Access Identity](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html) in the *Amazon CloudFront Developer Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-cloudfrontoriginaccessidentity.html}
  */
 export type CloudFrontCloudFrontOriginAccessIdentityProperties = {
+    /**
+     * The current configuration information for the identity.
+     */
     CloudFrontOriginAccessIdentityConfig: CloudFrontOriginAccessIdentityConfig;
 };
 /**
@@ -17,13 +21,18 @@ export type CloudFrontCloudFrontOriginAccessIdentityAttributes = {
 };
 /**
  * Type definition for `AWS::CloudFront::CloudFrontOriginAccessIdentity.CloudFrontOriginAccessIdentityConfig`.
+ * Origin access identity configuration. Send a ``GET`` request to the ``/CloudFront API version/CloudFront/identity ID/config`` resource.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-cloudfrontoriginaccessidentity-cloudfrontoriginaccessidentityconfig.html}
  */
 export type CloudFrontOriginAccessIdentityConfig = {
+    /**
+     * A comment to describe the origin access identity. The comment cannot be longer than 128 characters.
+     */
     Comment: string;
 };
 /**
- * Resource Type definition for AWS::CloudFront::CloudFrontOriginAccessIdentity
+ * Resource type definition for `AWS::CloudFront::CloudFrontOriginAccessIdentity`.
+ * The request to create a new origin access identity (OAI). An origin access identity is a special CloudFront user that you can associate with Amazon S3 origins, so that you can secure all or just some of your Amazon S3 content. For more information, see [Restricting Access to Amazon S3 Content by Using an Origin Access Identity](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html) in the *Amazon CloudFront Developer Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-cloudfrontoriginaccessidentity.html}
  */
 export declare class CloudFrontCloudFrontOriginAccessIdentity extends $Resource<"AWS::CloudFront::CloudFrontOriginAccessIdentity", CloudFrontCloudFrontOriginAccessIdentityProperties, CloudFrontCloudFrontOriginAccessIdentityAttributes> {

package/lib/AWS-CloudFront-CloudFrontOriginAccessIdentity.js

@@ -1,6 +1,7 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::CloudFrontOriginAccessIdentity
+ * Resource type definition for `AWS::CloudFront::CloudFrontOriginAccessIdentity`.
+ * The request to create a new origin access identity (OAI). An origin access identity is a special CloudFront user that you can associate with Amazon S3 origins, so that you can secure all or just some of your Amazon S3 content. For more information, see [Restricting Access to Amazon S3 Content by Using an Origin Access Identity](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html) in the *Amazon CloudFront Developer Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-cloudfrontoriginaccessidentity.html}
  */
 export class CloudFrontCloudFrontOriginAccessIdentity extends $Resource {

package/lib/AWS-CloudFront-ContinuousDeploymentPolicy.d.ts

@@ -1,10 +1,16 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 import type { ResourceOptions as $ResourceOptions } from "@awboost/cfn-template-builder/template";
 /**
- * Resource Type definition for AWS::CloudFront::ContinuousDeploymentPolicy
+ * Resource type definition for `AWS::CloudFront::ContinuousDeploymentPolicy`.
+ * Creates a continuous deployment policy that routes a subset of production traffic from a primary distribution to a staging distribution.
+ After you create and update a staging distribution, you can use a continuous deployment policy to incrementally move traffic to the staging distribution. This enables you to test changes to a distribution's configuration before moving all of your production traffic to the new configuration.
+ For more information, see [Using CloudFront continuous deployment to safely test CDN configuration changes](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/continuous-deployment.html) in the *Amazon CloudFront Developer Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-continuousdeploymentpolicy.html}
  */
 export type CloudFrontContinuousDeploymentPolicyProperties = {
+    /**
+     * Contains the configuration for a continuous deployment policy.
+     */
     ContinuousDeploymentPolicyConfig: ContinuousDeploymentPolicyConfig;
 };
 /**
@@ -17,10 +23,17 @@ export type CloudFrontContinuousDeploymentPolicyAttributes = {
 };
 /**
  * Type definition for `AWS::CloudFront::ContinuousDeploymentPolicy.ContinuousDeploymentPolicyConfig`.
+ * Contains the configuration for a continuous deployment policy.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-continuousdeploymentpolicy-continuousdeploymentpolicyconfig.html}
  */
 export type ContinuousDeploymentPolicyConfig = {
+    /**
+     * A Boolean that indicates whether this continuous deployment policy is enabled (in effect). When this value is ``true``, this policy is enabled and in effect. When this value is ``false``, this policy is not enabled and has no effect.
+     */
     Enabled: boolean;
+    /**
+     * This configuration determines which HTTP requests are sent to the staging distribution. If the HTTP request contains a header and value that matches what you specify here, the request is sent to the staging distribution. Otherwise the request is sent to the primary distribution.
+     */
     SingleHeaderPolicyConfig?: {
         /**
          * @minLength `1`
@@ -33,7 +46,13 @@ export type ContinuousDeploymentPolicyConfig = {
          */
         Value: string;
     };
+    /**
+     * This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
+     */
     SingleWeightPolicyConfig?: {
+        /**
+         * Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
+         */
         SessionStickinessConfig?: SessionStickinessConfig;
         /**
          * @min `0`
@@ -42,23 +61,33 @@ export type ContinuousDeploymentPolicyConfig = {
         Weight: number;
     };
     /**
+     * The CloudFront domain name of the staging distribution. For example: ``d111111abcdef8.cloudfront.net``.
      * @minLength `1`
      */
     StagingDistributionDnsNames: string[];
+    /**
+     * Contains the parameters for routing production traffic from your primary to staging distributions.
+     */
     TrafficConfig?: TrafficConfig;
+    /**
+     * The type of traffic configuration.
+     */
     Type?: "SingleWeight" | "SingleHeader";
 };
 /**
  * Type definition for `AWS::CloudFront::ContinuousDeploymentPolicy.SessionStickinessConfig`.
+ * Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-continuousdeploymentpolicy-sessionstickinessconfig.html}
  */
 export type SessionStickinessConfig = {
     /**
+     * The amount of time after which you want sessions to cease if no requests are received. Allowed values are 300–3600 seconds (5–60 minutes).
      * @min `300`
      * @max `3600`
      */
     IdleTTL: number;
     /**
+     * The maximum amount of time to consider requests from the viewer as being part of the same session. Allowed values are 300–3600 seconds (5–60 minutes).
      * @min `300`
      * @max `3600`
      */
@@ -66,15 +95,18 @@ export type SessionStickinessConfig = {
 };
 /**
  * Type definition for `AWS::CloudFront::ContinuousDeploymentPolicy.SingleHeaderConfig`.
+ * Determines which HTTP requests are sent to the staging distribution.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-continuousdeploymentpolicy-singleheaderconfig.html}
  */
 export type SingleHeaderConfig = {
     /**
+     * The request header name that you want CloudFront to send to your staging distribution. The header must contain the prefix ``aws-cf-cd-``.
      * @minLength `1`
      * @maxLength `256`
      */
     Header: string;
     /**
+     * The request header value.
      * @minLength `1`
      * @maxLength `1783`
      */
@@ -82,11 +114,16 @@ export type SingleHeaderConfig = {
 };
 /**
  * Type definition for `AWS::CloudFront::ContinuousDeploymentPolicy.SingleWeightConfig`.
+ * This configuration determines the percentage of HTTP requests that are sent to the staging distribution.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-continuousdeploymentpolicy-singleweightconfig.html}
  */
 export type SingleWeightConfig = {
+    /**
+     * Session stickiness provides the ability to define multiple requests from a single viewer as a single session. This prevents the potentially inconsistent experience of sending some of a given user's requests to your staging distribution, while others are sent to your primary distribution. Define the session duration using TTL values.
+     */
     SessionStickinessConfig?: SessionStickinessConfig;
     /**
+     * The percentage of traffic to send to a staging distribution, expressed as a decimal number between 0 and 0.15. For example, a value of 0.10 means 10% of traffic is sent to the staging distribution.
      * @min `0`
      * @max `1`
      */
@@ -94,15 +131,28 @@ export type SingleWeightConfig = {
 };
 /**
  * Type definition for `AWS::CloudFront::ContinuousDeploymentPolicy.TrafficConfig`.
+ * The traffic configuration of your continuous deployment.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-continuousdeploymentpolicy-trafficconfig.html}
  */
 export type TrafficConfig = {
+    /**
+     * Determines which HTTP requests are sent to the staging distribution.
+     */
     SingleHeaderConfig?: SingleHeaderConfig;
+    /**
+     * Contains the percentage of traffic to send to the staging distribution.
+     */
     SingleWeightConfig?: SingleWeightConfig;
+    /**
+     * The type of traffic configuration.
+     */
     Type: "SingleWeight" | "SingleHeader";
 };
 /**
- * Resource Type definition for AWS::CloudFront::ContinuousDeploymentPolicy
+ * Resource type definition for `AWS::CloudFront::ContinuousDeploymentPolicy`.
+ * Creates a continuous deployment policy that routes a subset of production traffic from a primary distribution to a staging distribution.
+ After you create and update a staging distribution, you can use a continuous deployment policy to incrementally move traffic to the staging distribution. This enables you to test changes to a distribution's configuration before moving all of your production traffic to the new configuration.
+ For more information, see [Using CloudFront continuous deployment to safely test CDN configuration changes](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/continuous-deployment.html) in the *Amazon CloudFront Developer Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-continuousdeploymentpolicy.html}
  */
 export declare class CloudFrontContinuousDeploymentPolicy extends $Resource<"AWS::CloudFront::ContinuousDeploymentPolicy", CloudFrontContinuousDeploymentPolicyProperties, CloudFrontContinuousDeploymentPolicyAttributes> {

package/lib/AWS-CloudFront-ContinuousDeploymentPolicy.js

@@ -1,6 +1,9 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::ContinuousDeploymentPolicy
+ * Resource type definition for `AWS::CloudFront::ContinuousDeploymentPolicy`.
+ * Creates a continuous deployment policy that routes a subset of production traffic from a primary distribution to a staging distribution.
+ After you create and update a staging distribution, you can use a continuous deployment policy to incrementally move traffic to the staging distribution. This enables you to test changes to a distribution's configuration before moving all of your production traffic to the new configuration.
+ For more information, see [Using CloudFront continuous deployment to safely test CDN configuration changes](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/continuous-deployment.html) in the *Amazon CloudFront Developer Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-continuousdeploymentpolicy.html}
  */
 export class CloudFrontContinuousDeploymentPolicy extends $Resource {

package/lib/AWS-CloudFront-Distribution.d.ts

@@ -28,7 +28,7 @@ export type CloudFrontDistributionAttributes = {
  * A complex type that describes how CloudFront processes requests.
  You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to serve objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used.
  For the current quota (formerly known as limit) on the number of cache behaviors that you can add to a distribution, see [Quotas](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html) in the *Amazon CloudFront Developer Guide*.
- If you don't want to specify any cache behaviors, include only an empty ``CacheBehaviors`` element. Don't include an empty ``CacheBehavior`` element because this is invalid.
+ If you don't want to specify any cache behaviors, include only an empty ``CacheBehaviors`` element. Don't specify an empty individual ``CacheBehavior`` element, because this is invalid. For more information, see [CacheBehaviors](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CacheBehaviors.html).
  To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty ``CacheBehaviors`` element.
  To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution.
  For more information about cache behaviors, see [Cache Behavior Settings](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior) in the *Amazon CloudFront Developer Guide*.
@@ -298,7 +298,7 @@ export type DefaultCacheBehavior = {
        */
     ForwardedValues?: ForwardedValues;
     /**
-     * A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the ``LIVE`` stage to associate them with a cache behavior.
+     * A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the ``LIVE`` stage to associate them with a cache behavior.
      */
     FunctionAssociations?: FunctionAssociation[];
     /**
@@ -368,6 +368,10 @@ export type DistributionConfig = {
      * A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
      */
     Aliases?: string[];
+    /**
+       * An alias for the CF distribution's domain name.
+        This property is legacy. We recommend that you use [Aliases](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-aliases) instead.
+       */
     CNAMEs?: string[];
     /**
      * A complex type that contains zero or more ``CacheBehavior`` elements.
@@ -389,6 +393,10 @@ export type DistributionConfig = {
        For more information about custom error pages, see [Customizing Error Responses](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/custom-error-pages.html) in the *Amazon CloudFront Developer Guide*.
        */
     CustomErrorResponses?: CustomErrorResponse[];
+    /**
+       * The user-defined HTTP server that serves as the origin for content that CF distributes.
+        This property is legacy. We recommend that you use [Origin](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-origin.html) instead.
+       */
     CustomOrigin?: LegacyCustomOrigin;
     /**
      * A complex type that describes the default cache behavior if you don't specify a ``CacheBehavior`` element or if files don't match any of the values of ``PathPattern`` in ``CacheBehavior`` elements. You must create exactly one default cache behavior.
@@ -408,7 +416,7 @@ export type DistributionConfig = {
      */
     Enabled: boolean;
     /**
-       * (Optional) Specify the maximum HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is ``http1.1``.
+       * (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is ``http1.1``.
        For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI).
        For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see [Connection Migration](https://docs.aws.amazon.com/https://www.rfc-editor.org/rfc/rfc9000.html#name-connection-migration) at RFC 9000. For more information about supported TLSv1.3 ciphers, see [Supported protocols and ciphers between viewers and CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/secure-connections-supported-viewer-protocols-ciphers.html).
        */
@@ -430,12 +438,14 @@ export type DistributionConfig = {
        */
     Logging?: Logging;
     /**
-     * A complex type that contains information about origin groups for this distribution.
-     */
+       * A complex type that contains information about origin groups for this distribution.
+       Specify a value for either the ``Origins`` or ``OriginGroups`` property.
+       */
     OriginGroups?: OriginGroups;
     /**
-     * A complex type that contains information about origins for this distribution.
-     */
+       * A complex type that contains information about origins for this distribution.
+       Specify a value for either the ``Origins`` or ``OriginGroups`` property.
+       */
     Origins?: Origin[];
     /**
        * The price class that corresponds with the maximum price that you want to pay for CloudFront service. If you specify ``PriceClass_All``, CloudFront responds to requests for your objects from all CloudFront edge locations.
@@ -447,6 +457,10 @@ export type DistributionConfig = {
      * A complex type that identifies ways in which you want to restrict distribution of your content.
      */
     Restrictions?: Restrictions;
+    /**
+       * The origin as an S3 bucket.
+        This property is legacy. We recommend that you use [Origin](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-origin.html) instead.
+       */
     S3Origin?: LegacyS3Origin;
     /**
      * A Boolean that indicates whether this is a staging distribution. When this value is ``true``, this is a staging distribution. When this value is ``false``, this is not a staging distribution.
@@ -457,7 +471,7 @@ export type DistributionConfig = {
      */
     ViewerCertificate?: ViewerCertificate;
     /**
-       * A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example ``arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/473e64fd-f30b-4765-81a0-62ad96dd167a``. To specify a web ACL created using WAF Classic, use the ACL ID, for example ``473e64fd-f30b-4765-81a0-62ad96dd167a``.
+       * A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example ``arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111``. To specify a web ACL created using WAF Classic, use the ACL ID, for example ``a1b2c3d4-5678-90ab-cdef-EXAMPLE11111``.
         WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the [Developer Guide](https://docs.aws.amazon.com/waf/latest/developerguide/what-is-aws-waf.html).
        */
     WebACLId?: string;
@@ -566,21 +580,48 @@ export type LambdaFunctionAssociation = {
 };
 /**
  * Type definition for `AWS::CloudFront::Distribution.LegacyCustomOrigin`.
+ * A custom origin. A custom origin is any origin that is *not* an S3 bucket, with one exception. An S3 bucket that is [configured with static website hosting](https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html) *is* a custom origin.
+  This property is legacy. We recommend that you use [Origin](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-origin.html) instead.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-legacycustomorigin.html}
  */
 export type LegacyCustomOrigin = {
+    /**
+     * The domain name assigned to your CF distribution.
+     */
     DNSName: string;
+    /**
+     * The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
+     */
     HTTPPort?: number;
+    /**
+     * The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
+     */
     HTTPSPort?: number;
+    /**
+     * Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
+     */
     OriginProtocolPolicy: string;
+    /**
+       * The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs.
+       For more information, see [Minimum Origin SSL Protocol](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginSSLProtocols) in the *Developer Guide*.
+       */
     OriginSSLProtocols: string[];
 };
 /**
  * Type definition for `AWS::CloudFront::Distribution.LegacyS3Origin`.
+ * The origin as an S3 bucket.
+  This property is legacy. We recommend that you use [Origin](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-origin.html) instead.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-legacys3origin.html}
  */
 export type LegacyS3Origin = {
+    /**
+     * The domain name assigned to your CF distribution.
+     */
     DNSName: string;
+    /**
+       * The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF.
+        This property is legacy. We recommend that you use [OriginAccessControl](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-originaccesscontrol.html) instead.
+       */
     OriginAccessIdentity?: string;
 };
 /**
@@ -792,9 +833,10 @@ export type Restrictions = {
  */
 export type S3OriginConfig = {
     /**
-       * The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can *only* access objects in an Amazon S3 bucket through CloudFront. The format of the value is:
-       origin-access-identity/cloudfront/*ID-of-origin-access-identity*
-       where ``ID-of-origin-access-identity`` is the value that CloudFront returned in the ``ID`` element when you created the origin access identity.
+       * If you're using origin access control (OAC) instead of origin access identity, specify an empty ``OriginAccessIdentity`` element. For more information, see [Restricting access to an](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-origin.html) in the *Amazon CloudFront Developer Guide*.
+        The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can *only* access objects in an Amazon S3 bucket through CloudFront. The format of the value is:
+        ``origin-access-identity/cloudfront/ID-of-origin-access-identity``
+       The ``ID-of-origin-access-identity`` is the value that CloudFront returned in the ``ID`` element when you created the origin access identity.
        If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an empty ``OriginAccessIdentity`` element.
        To delete the origin access identity from an existing distribution, update the distribution configuration and include an empty ``OriginAccessIdentity`` element.
        To replace the origin access identity, update the distribution configuration and specify the new origin access identity.