aws-cdk-lib 2.171.1__py3-none-any.whl → 2.173.0__py3-none-any.whl

aws_cdk/aws_cloudfront/__init__.py

@@ -7541,9 +7541,13 @@ class CfnDistribution(
             include_cookies: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
             prefix: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''A complex type that controls whether access logs are written for the distribution.
+            '''A complex type that specifies whether access logs are written for the distribution.
+
+            .. epigraph::
 
-            :param bucket: The Amazon S3 bucket to store the access logs in, for example, ``myawslogbucket.s3.amazonaws.com`` .
+               If you already enabled standard logging (legacy) and you want to enable standard logging (v2) to send your access logs to Amazon S3, we recommend that you specify a *different* Amazon S3 bucket or use a *separate path* in the same bucket (for example, use a log prefix or partitioning). This helps you keep track of which log files are associated with which logging subscription and prevents log files from overwriting each other. For more information, see `Standard logging (access logs) <https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html>`_ in the *Amazon CloudFront Developer Guide* .
+
+            :param bucket: The Amazon S3 bucket to store the access logs in, for example, ``amzn-s3-demo-bucket.s3.amazonaws.com`` .
             :param include_cookies: Specifies whether you want CloudFront to include cookies in access logs, specify ``true`` for ``IncludeCookies`` . If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify ``false`` for ``IncludeCookies`` . Default: - false
             :param prefix: An optional string that you want CloudFront to prefix to the access log ``filenames`` for this distribution, for example, ``myprefix/`` . If you want to enable logging, but you don't want to specify a prefix, you still must include an empty ``Prefix`` element in the ``Logging`` element. Default: - ""
 
@@ -7579,7 +7583,7 @@ class CfnDistribution(
 
         @builtins.property
         def bucket(self) -> builtins.str:
-            '''The Amazon S3 bucket to store the access logs in, for example, ``myawslogbucket.s3.amazonaws.com`` .
+            '''The Amazon S3 bucket to store the access logs in, for example, ``amzn-s3-demo-bucket.s3.amazonaws.com`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-logging.html#cfn-cloudfront-distribution-logging-bucket
             '''
@@ -7904,9 +7908,11 @@ class CfnDistribution(
             id: builtins.str,
             members: typing.Union[_IResolvable_da3f097b, typing.Union["CfnDistribution.OriginGroupMembersProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''An origin group includes two origins (a primary origin and a second origin to failover to) and a failover criteria that you specify.
+            '''An origin group includes two origins (a primary origin and a secondary origin to failover to) and a failover criteria that you specify.
+
+            You create an origin group to support origin failover in CloudFront. When you create or update a distribution, you can specify the origin group instead of a single origin, and CloudFront will failover from the primary origin to the secondary origin under the failover conditions that you've chosen.
 
-            You create an origin group to support origin failover in CloudFront. When you create or update a distribution, you can specify the origin group instead of a single origin, and CloudFront will failover from the primary origin to the second origin under the failover conditions that you've chosen.
+            Optionally, you can choose selection criteria for your origin group to specify how your origins are selected when your distribution routes viewer requests.
 
             :param failover_criteria: A complex type that contains information about the failover criteria for an origin group.
             :param id: The origin group's ID.
@@ -14552,7 +14558,7 @@ class CfnStreamingDistribution(
         ) -> None:
             '''A complex type that controls whether access logs are written for the streaming distribution.
 
-            :param bucket: The Amazon S3 bucket to store the access logs in, for example, ``myawslogbucket.s3.amazonaws.com`` .
+            :param bucket: The Amazon S3 bucket to store the access logs in, for example, ``amzn-s3-demo-bucket.s3.amazonaws.com`` .
             :param enabled: Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a streaming distribution or if you want to disable logging for an existing streaming distribution, specify ``false`` for ``Enabled`` , and specify ``empty Bucket`` and ``Prefix`` elements. If you specify ``false`` for ``Enabled`` but you specify values for ``Bucket`` and ``Prefix`` , the values are automatically deleted.
             :param prefix: An optional string that you want CloudFront to prefix to the access log filenames for this streaming distribution, for example, ``myprefix/`` . If you want to enable logging, but you don't want to specify a prefix, you still must include an empty ``Prefix`` element in the ``Logging`` element.
 
@@ -14584,7 +14590,7 @@ class CfnStreamingDistribution(
 
         @builtins.property
         def bucket(self) -> builtins.str:
-            '''The Amazon S3 bucket to store the access logs in, for example, ``myawslogbucket.s3.amazonaws.com`` .
+            '''The Amazon S3 bucket to store the access logs in, for example, ``amzn-s3-demo-bucket.s3.amazonaws.com`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-streamingdistribution-logging.html#cfn-cloudfront-streamingdistribution-logging-bucket
             '''
@@ -23790,6 +23796,8 @@ class Distribution(
     def attach_web_acl_id(self, web_acl_id: builtins.str) -> None:
         '''Attach WAF WebACL to this CloudFront distribution.
 
+        WebACL must be in the us-east-1 region
+
         :param web_acl_id: The WAF WebACL to associate with this distribution.
         '''
         if __debug__: