aws-cdk-lib 2.140.0__py3-none-any.whl → 2.142.0__py3-none-any.whl

aws_cdk/aws_cloudfront/__init__.py

@@ -544,13 +544,12 @@ Additionally, you can load the function's code from a file using the `FunctionCo
 
 If you set `autoPublish` to false, the function will not be automatically published to the LIVE stage when it’s created.
 
-``ts
-new cloudfront.Function(this, 'Function', {
-code: cloudfront.FunctionCode.fromInline('function handler(event) { return event.request }'),
-runtime: cloudfront.FunctionRuntime.JS_2_0,
-autoPublish: false
-});
-
+```python
+cloudfront.Function(self, "Function",
+    code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }"),
+    runtime=cloudfront.FunctionRuntime.JS_2_0,
+    auto_publish=False
+)
 ```
 
 ### Key Value Store
@@ -560,8 +559,8 @@ by default.
 
 To create an empty Key Value Store:
 
-```ts
-const store = new cloudfront.KeyValueStore(this, 'KeyValueStore');
+```python
+store = cloudfront.KeyValueStore(self, "KeyValueStore")
 ```
 
 To also include an initial set of values, the `source` property can be specified, either from a
@@ -16480,20 +16479,12 @@ class FunctionCode(
 
     Example::
 
-        # s3_bucket: s3.Bucket
-        # Add a cloudfront Function to a Distribution
-        cf_function = cloudfront.Function(self, "Function",
+        store = cloudfront.KeyValueStore(self, "KeyValueStore")
+        cloudfront.Function(self, "Function",
             code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }"),
-            runtime=cloudfront.FunctionRuntime.JS_2_0
-        )
-        cloudfront.Distribution(self, "distro",
-            default_behavior=cloudfront.BehaviorOptions(
-                origin=origins.S3Origin(s3_bucket),
-                function_associations=[cloudfront.FunctionAssociation(
-                    function=cf_function,
-                    event_type=cloudfront.FunctionEventType.VIEWER_REQUEST
-                )]
-            )
+            # Note that JS_2_0 must be used for Key Value Store support
+            runtime=cloudfront.FunctionRuntime.JS_2_0,
+            key_value_store=store
         )
     '''
 
@@ -16611,20 +16602,12 @@ class FunctionProps:
 
         Example::
 
-            # s3_bucket: s3.Bucket
-            # Add a cloudfront Function to a Distribution
-            cf_function = cloudfront.Function(self, "Function",
+            store = cloudfront.KeyValueStore(self, "KeyValueStore")
+            cloudfront.Function(self, "Function",
                 code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }"),
-                runtime=cloudfront.FunctionRuntime.JS_2_0
-            )
-            cloudfront.Distribution(self, "distro",
-                default_behavior=cloudfront.BehaviorOptions(
-                    origin=origins.S3Origin(s3_bucket),
-                    function_associations=[cloudfront.FunctionAssociation(
-                        function=cf_function,
-                        event_type=cloudfront.FunctionEventType.VIEWER_REQUEST
-                    )]
-                )
+                # Note that JS_2_0 must be used for Key Value Store support
+                runtime=cloudfront.FunctionRuntime.JS_2_0,
+                key_value_store=store
             )
         '''
         if __debug__:
@@ -16726,20 +16709,12 @@ class FunctionRuntime(
 
     Example::
 
-        # s3_bucket: s3.Bucket
-        # Add a cloudfront Function to a Distribution
-        cf_function = cloudfront.Function(self, "Function",
+        store = cloudfront.KeyValueStore(self, "KeyValueStore")
+        cloudfront.Function(self, "Function",
             code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }"),
-            runtime=cloudfront.FunctionRuntime.JS_2_0
-        )
-        cloudfront.Distribution(self, "distro",
-            default_behavior=cloudfront.BehaviorOptions(
-                origin=origins.S3Origin(s3_bucket),
-                function_associations=[cloudfront.FunctionAssociation(
-                    function=cf_function,
-                    event_type=cloudfront.FunctionEventType.VIEWER_REQUEST
-                )]
-            )
+            # Note that JS_2_0 must be used for Key Value Store support
+            runtime=cloudfront.FunctionRuntime.JS_2_0,
+            key_value_store=store
         )
     '''
 
@@ -17941,23 +17916,12 @@ class KeyValueStore(
 
     Example::
 
-        store_asset = cloudfront.KeyValueStore(self, "KeyValueStoreAsset",
-            key_value_store_name="KeyValueStoreAsset",
-            source=cloudfront.ImportSource.from_asset("path-to-data.json")
-        )
-        
-        store_inline = cloudfront.KeyValueStore(self, "KeyValueStoreInline",
-            key_value_store_name="KeyValueStoreInline",
-            source=cloudfront.ImportSource.from_inline(JSON.stringify({
-                "data": [{
-                    "key": "key1",
-                    "value": "value1"
-                }, {
-                    "key": "key2",
-                    "value": "value2"
-                }
-                ]
-            }))
+        store = cloudfront.KeyValueStore(self, "KeyValueStore")
+        cloudfront.Function(self, "Function",
+            code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }"),
+            # Note that JS_2_0 must be used for Key Value Store support
+            runtime=cloudfront.FunctionRuntime.JS_2_0,
+            key_value_store=store
         )
     '''
 
@@ -23802,20 +23766,12 @@ class Function(
 
     Example::
 
-        # s3_bucket: s3.Bucket
-        # Add a cloudfront Function to a Distribution
-        cf_function = cloudfront.Function(self, "Function",
+        store = cloudfront.KeyValueStore(self, "KeyValueStore")
+        cloudfront.Function(self, "Function",
             code=cloudfront.FunctionCode.from_inline("function handler(event) { return event.request }"),
-            runtime=cloudfront.FunctionRuntime.JS_2_0
-        )
-        cloudfront.Distribution(self, "distro",
-            default_behavior=cloudfront.BehaviorOptions(
-                origin=origins.S3Origin(s3_bucket),
-                function_associations=[cloudfront.FunctionAssociation(
-                    function=cf_function,
-                    event_type=cloudfront.FunctionEventType.VIEWER_REQUEST
-                )]
-            )
+            # Note that JS_2_0 must be used for Key Value Store support
+            runtime=cloudfront.FunctionRuntime.JS_2_0,
+            key_value_store=store
         )
     '''
 

aws_cdk/aws_cloudtrail/__init__.py

@@ -3383,9 +3383,18 @@ class CfnTrail(
             type: builtins.str,
             values: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
-            '''The Amazon S3 buckets, AWS Lambda functions, or Amazon DynamoDB tables that you specify in your event selectors for your trail to log data events.
+            '''Data events provide information about the resource operations performed on or within a resource itself.
+
+            These are also known as data plane operations. You can specify up to 250 data resources for a trail.
+
+            Configure the ``DataResource`` to specify the resource type and resource ARNs for which you want to log data events.
+
+            You can specify the following resource types in your event selectors for your trail:
+
+            - ``AWS::DynamoDB::Table``
+            - ``AWS::Lambda::Function``
+            - ``AWS::S3::Object``
 
-            Data events provide information about the resource operations performed on or within a resource itself. These are also known as data plane operations. You can specify up to 250 data resources for a trail.
             .. epigraph::
 
                The total number of allowed data resources is 250. This number can be distributed between 1 and 5 event selectors, but the total cannot exceed 250 across all selectors for the trail.
@@ -3406,7 +3415,7 @@ class CfnTrail(
             - The ``Invoke`` API operation on *MyOtherLambdaFunction* is an Lambda API. Because the CloudTrail user did not specify logging data events for all Lambda functions, the ``Invoke`` operation for *MyOtherLambdaFunction* does not match the function specified for the trail. The trail doesn’t log the event.
 
             :param type: The resource type in which you want to log data events. You can specify the following *basic* event selector resource types: - ``AWS::DynamoDB::Table`` - ``AWS::Lambda::Function`` - ``AWS::S3::Object`` Additional resource types are available through *advanced* event selectors. For more information about these additional resource types, see `AdvancedFieldSelector <https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html>`_ .
-            :param values: An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified objects. - To log data events for all objects in all S3 buckets in your AWS account , specify the prefix as ``arn:aws:s3`` . .. epigraph:: This also enables logging of data event activity performed by any user or role in your AWS account , even if that activity is performed on a bucket that belongs to another AWS account . - To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as ``arn:aws:s3:::bucket-1/`` . The trail logs data events for all objects in this S3 bucket. - To log data events for specific objects, specify the S3 bucket and object prefix such as ``arn:aws:s3:::bucket-1/example-images`` . The trail logs data events for objects in this S3 bucket that match the prefix. - To log data events for all Lambda functions in your AWS account , specify the prefix as ``arn:aws:lambda`` . .. epigraph:: This also enables logging of ``Invoke`` activity performed by any user or role in your AWS account , even if that activity is performed on a function that belongs to another AWS account . - To log data events for a specific Lambda function, specify the function ARN. .. epigraph:: Lambda function ARNs are exact. For example, if you specify a function ARN *arn:aws:lambda:us-west-2:111111111111:function:helloworld* , data events will only be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld* . They will not be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld2* . - To log data events for all DynamoDB tables in your AWS account , specify the prefix as ``arn:aws:dynamodb`` .
+            :param values: An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified resource type. - To log data events for all objects in all S3 buckets in your AWS account , specify the prefix as ``arn:aws:s3`` . .. epigraph:: This also enables logging of data event activity performed by any user or role in your AWS account , even if that activity is performed on a bucket that belongs to another AWS account . - To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as ``arn:aws:s3:::bucket-1/`` . The trail logs data events for all objects in this S3 bucket. - To log data events for specific objects, specify the S3 bucket and object prefix such as ``arn:aws:s3:::bucket-1/example-images`` . The trail logs data events for objects in this S3 bucket that match the prefix. - To log data events for all Lambda functions in your AWS account , specify the prefix as ``arn:aws:lambda`` . .. epigraph:: This also enables logging of ``Invoke`` activity performed by any user or role in your AWS account , even if that activity is performed on a function that belongs to another AWS account . - To log data events for a specific Lambda function, specify the function ARN. .. epigraph:: Lambda function ARNs are exact. For example, if you specify a function ARN *arn:aws:lambda:us-west-2:111111111111:function:helloworld* , data events will only be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld* . They will not be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld2* . - To log data events for all DynamoDB tables in your AWS account , specify the prefix as ``arn:aws:dynamodb`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-trail-dataresource.html
             :exampleMetadata: fixture=_generated
@@ -3454,7 +3463,7 @@ class CfnTrail(
 
         @builtins.property
         def values(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified objects.
+            '''An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified resource type.
 
             - To log data events for all objects in all S3 buckets in your AWS account , specify the prefix as ``arn:aws:s3`` .