@awboost/cfn-resource-types 0.1.197 → 0.1.198

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.

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

@@ -1,13 +1,29 @@
 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::Function
+ * Creates a CF function.
+ To create a function, you provide the function code and some configuration information about the function. The response contains an Amazon Resource Name (ARN) that uniquely identifies the function, and the function’s stage.
+ By default, when you create a function, it’s in the ``DEVELOPMENT`` stage. In this stage, you can [test the function](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/test-function.html) in the CF console (or with ``TestFunction`` in the CF API).
+ When you’re ready to use your function with a CF distribution, publish the function to the ``LIVE`` stage. You can do this in the CF console, with ``PublishFunction`` in the CF API, or by updating the ``AWS::CloudFront::Function`` resource with the ``AutoPublish`` property set to ``true``. When the function is published to the ``LIVE`` stage, you can attach it to a distribution’s cache behavior, using the function’s ARN.
+ To automatically publish the function to the ``LIVE`` stage when it’s created, set the ``AutoPublish`` property to ``true``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-function.html}
  */
 export type CloudFrontFunctionProperties = {
+    /**
+     * A flag that determines whether to automatically publish the function to the ``LIVE`` stage when it’s created. To automatically publish to the ``LIVE`` stage, set this property to ``true``.
+     */
     AutoPublish?: boolean;
+    /**
+     * The function code. For more information about writing a CloudFront function, see [Writing function code for CloudFront Functions](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/writing-function-code.html) in the *Amazon CloudFront Developer Guide*.
+     */
     FunctionCode: string;
+    /**
+     * Contains configuration information about a CloudFront function.
+     */
     FunctionConfig: FunctionConfig;
+    /**
+     * A name to identify the function.
+     */
     Name: string;
 };
 /**
@@ -16,29 +32,53 @@ export type CloudFrontFunctionProperties = {
  */
 export type CloudFrontFunctionAttributes = {
     FunctionARN: string;
+    /**
+     * Contains metadata about a CloudFront function.
+     */
     FunctionMetadata: {
+        /**
+         * The Amazon Resource Name (ARN) of the function. The ARN uniquely identifies the function.
+         */
         FunctionARN: string;
     };
     Stage: string;
 };
 /**
  * Type definition for `AWS::CloudFront::Function.FunctionConfig`.
+ * Contains configuration information about a CloudFront function.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-function-functionconfig.html}
  */
 export type FunctionConfig = {
+    /**
+     * A comment to describe the function.
+     */
     Comment: string;
+    /**
+     * The configuration for the key value store associations.
+     */
     KeyValueStoreAssociations?: KeyValueStoreAssociation[];
+    /**
+     * The function's runtime environment version.
+     */
     Runtime: string;
 };
 /**
  * Type definition for `AWS::CloudFront::Function.KeyValueStoreAssociation`.
+ * The key value store association.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-function-keyvaluestoreassociation.html}
  */
 export type KeyValueStoreAssociation = {
+    /**
+     * The Amazon Resource Name (ARN) of the key value store association.
+     */
     KeyValueStoreARN: string;
 };
 /**
- * Resource Type definition for AWS::CloudFront::Function
+ * Creates a CF function.
+ To create a function, you provide the function code and some configuration information about the function. The response contains an Amazon Resource Name (ARN) that uniquely identifies the function, and the function’s stage.
+ By default, when you create a function, it’s in the ``DEVELOPMENT`` stage. In this stage, you can [test the function](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/test-function.html) in the CF console (or with ``TestFunction`` in the CF API).
+ When you’re ready to use your function with a CF distribution, publish the function to the ``LIVE`` stage. You can do this in the CF console, with ``PublishFunction`` in the CF API, or by updating the ``AWS::CloudFront::Function`` resource with the ``AutoPublish`` property set to ``true``. When the function is published to the ``LIVE`` stage, you can attach it to a distribution’s cache behavior, using the function’s ARN.
+ To automatically publish the function to the ``LIVE`` stage when it’s created, set the ``AutoPublish`` property to ``true``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-function.html}
  */
 export declare class CloudFrontFunction extends $Resource<"AWS::CloudFront::Function", CloudFrontFunctionProperties, CloudFrontFunctionAttributes> {

package/lib/AWS-CloudFront-Function.js

@@ -1,6 +1,10 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::Function
+ * Creates a CF function.
+ To create a function, you provide the function code and some configuration information about the function. The response contains an Amazon Resource Name (ARN) that uniquely identifies the function, and the function’s stage.
+ By default, when you create a function, it’s in the ``DEVELOPMENT`` stage. In this stage, you can [test the function](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/test-function.html) in the CF console (or with ``TestFunction`` in the CF API).
+ When you’re ready to use your function with a CF distribution, publish the function to the ``LIVE`` stage. You can do this in the CF console, with ``PublishFunction`` in the CF API, or by updating the ``AWS::CloudFront::Function`` resource with the ``AutoPublish`` property set to ``true``. When the function is published to the ``LIVE`` stage, you can attach it to a distribution’s cache behavior, using the function’s ARN.
+ To automatically publish the function to the ``LIVE`` stage when it’s created, set the ``AutoPublish`` property to ``true``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-function.html}
  */
 export class CloudFrontFunction extends $Resource {

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

@@ -1,10 +1,15 @@
 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::KeyGroup
+ * Resource type definition for `AWS::CloudFront::KeyGroup`.
+ * A key group.
+ A key group contains a list of public keys that you can use with [CloudFront signed URLs and signed cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-keygroup.html}
  */
 export type CloudFrontKeyGroupProperties = {
+    /**
+     * The key group configuration.
+     */
     KeyGroupConfig: KeyGroupConfig;
 };
 /**
@@ -17,15 +22,28 @@ export type CloudFrontKeyGroupAttributes = {
 };
 /**
  * Type definition for `AWS::CloudFront::KeyGroup.KeyGroupConfig`.
+ * A key group configuration.
+ A key group contains a list of public keys that you can use with [CloudFront signed URLs and signed cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-keygroup-keygroupconfig.html}
  */
 export type KeyGroupConfig = {
+    /**
+     * A comment to describe the key group. The comment cannot be longer than 128 characters.
+     */
     Comment?: string;
+    /**
+     * A list of the identifiers of the public keys in the key group.
+     */
     Items: string[];
+    /**
+     * A name to identify the key group.
+     */
     Name: string;
 };
 /**
- * Resource Type definition for AWS::CloudFront::KeyGroup
+ * Resource type definition for `AWS::CloudFront::KeyGroup`.
+ * A key group.
+ A key group contains a list of public keys that you can use with [CloudFront signed URLs and signed cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-keygroup.html}
  */
 export declare class CloudFrontKeyGroup extends $Resource<"AWS::CloudFront::KeyGroup", CloudFrontKeyGroupProperties, CloudFrontKeyGroupAttributes> {

package/lib/AWS-CloudFront-KeyGroup.js

@@ -1,6 +1,8 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::KeyGroup
+ * Resource type definition for `AWS::CloudFront::KeyGroup`.
+ * A key group.
+ A key group contains a list of public keys that you can use with [CloudFront signed URLs and signed cookies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/PrivateContent.html).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-keygroup.html}
  */
 export class CloudFrontKeyGroup extends $Resource {

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

@@ -1,12 +1,22 @@
 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::KeyValueStore
+ * Resource type definition for `AWS::CloudFront::KeyValueStore`.
+ * The key value store. Use this to separate data from function code, allowing you to update data without having to publish a new version of a function. The key value store holds keys and their corresponding values.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-keyvaluestore.html}
  */
 export type CloudFrontKeyValueStoreProperties = {
+    /**
+     * A comment for the key value store.
+     */
     Comment?: string;
+    /**
+     * The import source for the key value store.
+     */
     ImportSource?: ImportSource;
+    /**
+     * The name of the key value store.
+     */
     Name: string;
 };
 /**
@@ -20,14 +30,22 @@ export type CloudFrontKeyValueStoreAttributes = {
 };
 /**
  * Type definition for `AWS::CloudFront::KeyValueStore.ImportSource`.
+ * The import source for the key value store.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-keyvaluestore-importsource.html}
  */
 export type ImportSource = {
+    /**
+     * The Amazon Resource Name (ARN) of the import source for the key value store.
+     */
     SourceArn: string;
+    /**
+     * The source type of the import source for the key value store.
+     */
     SourceType: string;
 };
 /**
- * Resource Type definition for AWS::CloudFront::KeyValueStore
+ * Resource type definition for `AWS::CloudFront::KeyValueStore`.
+ * The key value store. Use this to separate data from function code, allowing you to update data without having to publish a new version of a function. The key value store holds keys and their corresponding values.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-keyvaluestore.html}
  */
 export declare class CloudFrontKeyValueStore extends $Resource<"AWS::CloudFront::KeyValueStore", CloudFrontKeyValueStoreProperties, CloudFrontKeyValueStoreAttributes> {

package/lib/AWS-CloudFront-KeyValueStore.js

@@ -1,6 +1,7 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::KeyValueStore
+ * Resource type definition for `AWS::CloudFront::KeyValueStore`.
+ * The key value store. Use this to separate data from function code, allowing you to update data without having to publish a new version of a function. The key value store holds keys and their corresponding values.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-keyvaluestore.html}
  */
 export class CloudFrontKeyValueStore extends $Resource {

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

@@ -1,29 +1,45 @@
 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::MonitoringSubscription
+ * Resource type definition for `AWS::CloudFront::MonitoringSubscription`.
+ * A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-monitoringsubscription.html}
  */
 export type CloudFrontMonitoringSubscriptionProperties = {
+    /**
+     * The ID of the distribution that you are enabling metrics for.
+     */
     DistributionId: string;
+    /**
+     * A subscription configuration for additional CloudWatch metrics.
+     */
     MonitoringSubscription: MonitoringSubscription;
 };
 /**
  * Type definition for `AWS::CloudFront::MonitoringSubscription.MonitoringSubscription`.
+ * A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-monitoringsubscription-monitoringsubscription.html}
  */
 export type MonitoringSubscription = {
+    /**
+     * A subscription configuration for additional CloudWatch metrics.
+     */
     RealtimeMetricsSubscriptionConfig?: RealtimeMetricsSubscriptionConfig;
 };
 /**
  * Type definition for `AWS::CloudFront::MonitoringSubscription.RealtimeMetricsSubscriptionConfig`.
+ * A subscription configuration for additional CloudWatch metrics.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-monitoringsubscription-realtimemetricssubscriptionconfig.html}
  */
 export type RealtimeMetricsSubscriptionConfig = {
+    /**
+     * A flag that indicates whether additional CloudWatch metrics are enabled for a given CloudFront distribution.
+     */
     RealtimeMetricsSubscriptionStatus: "Enabled" | "Disabled";
 };
 /**
- * Resource Type definition for AWS::CloudFront::MonitoringSubscription
+ * Resource type definition for `AWS::CloudFront::MonitoringSubscription`.
+ * A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-monitoringsubscription.html}
  */
 export declare class CloudFrontMonitoringSubscription extends $Resource<"AWS::CloudFront::MonitoringSubscription", CloudFrontMonitoringSubscriptionProperties, Record<string, never>> {

package/lib/AWS-CloudFront-MonitoringSubscription.js

@@ -1,6 +1,7 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 /**
- * Resource Type definition for AWS::CloudFront::MonitoringSubscription
+ * Resource type definition for `AWS::CloudFront::MonitoringSubscription`.
+ * A monitoring subscription. This structure contains information about whether additional CloudWatch metrics are enabled for a given CloudFront distribution.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-monitoringsubscription.html}
  */
 export class CloudFrontMonitoringSubscription extends $Resource {