aws-cdk-lib 2.180.0__py3-none-any.whl → 2.181.1__py3-none-any.whl

aws_cdk/__init__.py

@@ -5267,8 +5267,8 @@ class CfnGuardHookProps:
         :param target_operations: Specifies the list of operations the Hook is run against. For more information, see `Hook targets <https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hooks-concepts.html#hook-terms-hook-target>`_ in the *AWS CloudFormation Hooks User Guide* . Valid values: ``STACK`` | ``RESOURCE`` | ``CHANGE_SET`` | ``CLOUD_CONTROL``
         :param log_bucket: Specifies the name of an S3 bucket to store the Guard output report. This report contains the results of your Guard rule validations.
         :param options: Specifies the S3 location of your input parameters.
-        :param stack_filters: Specifies the stack level filters for the Hook.
-        :param target_filters: Specifies the target filters for the Hook.
+        :param stack_filters: Specifies the stack level filters for the Hook. Example stack level filter in JSON: ``"StackFilters": {"FilteringCriteria": "ALL", "StackNames": {"Exclude": [ "stack-1", "stack-2"]}}`` Example stack level filter in YAML: ``StackFilters: FilteringCriteria: ALL StackNames: Exclude: - stack-1 - stack-2``
+        :param target_filters: Specifies the target filters for the Hook. Example target filter in JSON: ``"TargetFilters": {"Actions": [ "Create", "Update", "Delete" ]}`` Example target filter in YAML: ``TargetFilters: Actions: - CREATE - UPDATE - DELETE``
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-guardhook.html
         :exampleMetadata: fixture=_generated
@@ -5454,6 +5454,14 @@ class CfnGuardHookProps:
     ) -> typing.Optional[typing.Union["IResolvable", "CfnGuardHook.StackFiltersProperty"]]:
         '''Specifies the stack level filters for the Hook.
 
+        Example stack level filter in JSON:
+
+        ``"StackFilters": {"FilteringCriteria": "ALL", "StackNames": {"Exclude": [ "stack-1", "stack-2"]}}``
+
+        Example stack level filter in YAML:
+
+        ``StackFilters: FilteringCriteria: ALL StackNames: Exclude: - stack-1 - stack-2``
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-guardhook.html#cfn-cloudformation-guardhook-stackfilters
         '''
         result = self._values.get("stack_filters")
@@ -5465,6 +5473,14 @@ class CfnGuardHookProps:
     ) -> typing.Optional[typing.Union["IResolvable", "CfnGuardHook.TargetFiltersProperty"]]:
         '''Specifies the target filters for the Hook.
 
+        Example target filter in JSON:
+
+        ``"TargetFilters": {"Actions": [ "Create", "Update", "Delete" ]}``
+
+        Example target filter in YAML:
+
+        ``TargetFilters: Actions: - CREATE - UPDATE - DELETE``
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-guardhook.html#cfn-cloudformation-guardhook-targetfilters
         '''
         result = self._values.get("target_filters")
@@ -6058,8 +6074,8 @@ class CfnLambdaHookProps:
         :param hook_status: Specifies if the Hook is ``ENABLED`` or ``DISABLED`` . Default: - "ENABLED"
         :param lambda_function: Specifies the Lambda function for the Hook. You can use:. - The full Amazon Resource Name (ARN) without a suffix. - A qualified ARN with a version or alias suffix.
         :param target_operations: Specifies the list of operations the Hook is run against. For more information, see `Hook targets <https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hooks-concepts.html#hook-terms-hook-target>`_ in the *AWS CloudFormation Hooks User Guide* . Valid values: ``STACK`` | ``RESOURCE`` | ``CHANGE_SET`` | ``CLOUD_CONTROL``
-        :param stack_filters: Specifies the stack level filters for the Hook.
-        :param target_filters: Specifies the target filters for the Hook.
+        :param stack_filters: Specifies the stack level filters for the Hook. Example stack level filter in JSON: ``"StackFilters": {"FilteringCriteria": "ALL", "StackNames": {"Exclude": [ "stack-1", "stack-2"]}}`` Example stack level filter in YAML: ``StackFilters: FilteringCriteria: ALL StackNames: Exclude: - stack-1 - stack-2``
+        :param target_filters: Specifies the target filters for the Hook. Example target filter in JSON: ``"TargetFilters": {"Actions": [ "Create", "Update", "Delete" ]}`` Example target filter in YAML: ``TargetFilters: Actions: - CREATE - UPDATE - DELETE``
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-lambdahook.html
         :exampleMetadata: fixture=_generated
@@ -6202,6 +6218,14 @@ class CfnLambdaHookProps:
     ) -> typing.Optional[typing.Union["IResolvable", "CfnLambdaHook.StackFiltersProperty"]]:
         '''Specifies the stack level filters for the Hook.
 
+        Example stack level filter in JSON:
+
+        ``"StackFilters": {"FilteringCriteria": "ALL", "StackNames": {"Exclude": [ "stack-1", "stack-2"]}}``
+
+        Example stack level filter in YAML:
+
+        ``StackFilters: FilteringCriteria: ALL StackNames: Exclude: - stack-1 - stack-2``
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-lambdahook.html#cfn-cloudformation-lambdahook-stackfilters
         '''
         result = self._values.get("stack_filters")
@@ -6213,6 +6237,14 @@ class CfnLambdaHookProps:
     ) -> typing.Optional[typing.Union["IResolvable", "CfnLambdaHook.TargetFiltersProperty"]]:
         '''Specifies the target filters for the Hook.
 
+        Example target filter in JSON:
+
+        ``"TargetFilters": {"Actions": [ "Create", "Update", "Delete" ]}``
+
+        Example target filter in YAML:
+
+        ``TargetFilters: Actions: - CREATE - UPDATE - DELETE``
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-lambdahook.html#cfn-cloudformation-lambdahook-targetfilters
         '''
         result = self._values.get("target_filters")
@@ -7260,10 +7292,16 @@ class CfnParameterProps:
 
         Example::
 
-            CfnParameter(self, "MyParameter",
-                type="Number",
-                default=1337
-            )
+            param = CfnParameter(self, "ParameterName")
+            
+            # If the parameter is a String
+            param.value_as_string
+            
+            # If the parameter is a Number
+            param.value_as_number
+            
+            # If the parameter is a List
+            param.value_as_list
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__6d425fa390023c3d5a204065fa1d0abca878458a00e8f9bd0859be42e4cc9e66)
@@ -10663,21 +10701,20 @@ class CustomResourceProps:
         :param properties: Properties to pass to the Lambda. Values in this ``properties`` dictionary can possibly overwrite other values in ``CustomResourceProps`` E.g. ``ServiceToken`` and ``ServiceTimeout`` It is recommended to avoid using same keys that exist in ``CustomResourceProps`` Default: - No properties.
         :param removal_policy: The policy to apply when this resource is removed from the application. Default: cdk.RemovalPolicy.Destroy
         :param resource_type: For custom resources, you can specify AWS::CloudFormation::CustomResource (the default) as the resource type, or you can specify your own resource type name. For example, you can use "Custom::MyCustomResourceTypeName". Custom resource type names must begin with "Custom::" and can include alphanumeric characters and the following characters: _@-. You can specify a custom resource type name up to a maximum length of 60 characters. You cannot change the type during an update. Using your own resource type names helps you quickly differentiate the types of custom resources in your stack. For example, if you had two custom resources that conduct two different ping tests, you could name their type as Custom::PingTester to make them easily identifiable as ping testers (instead of using AWS::CloudFormation::CustomResource). Default: - AWS::CloudFormation::CustomResource
-        :param service_timeout: The maximum time that can elapse before a custom resource operation times out. The value must be between 1 second and 3600 seconds. Maps to `ServiceTimeout <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-customresource.html#cfn-cloudformation-customresource-servicetimeout>`_ property for the ``AWS::CloudFormation::CustomResource`` resource Default: Duration.seconds(3600)
+        :param service_timeout: The maximum time that can elapse before a custom resource operation times out. The value must be between 1 second and 3600 seconds. Maps to `ServiceTimeout <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-customresource.html#cfn-cloudformation-customresource-servicetimeout>`_ property for the ``AWS::CloudFormation::CustomResource`` resource A token can be specified for this property, but it must be specified with ``Duration.seconds()``. Default: Duration.seconds(3600)
 
         :exampleMetadata: infused
 
         Example::
 
-            service_token = CustomResourceProvider.get_or_create(self, "Custom::MyCustomResourceType",
-                code_directory=f"{__dirname}/my-handler",
-                runtime=CustomResourceProviderRuntime.NODEJS_18_X,
-                description="Lambda function created by the custom resource provider"
+            stack = Stack()
+            dur_token = CfnParameter(stack, "MyParameter",
+                type="Number",
+                default=60
             )
-            
-            CustomResource(self, "MyResource",
-                resource_type="Custom::MyCustomResourceType",
-                service_token=service_token
+            CustomResource(stack, "MyCustomResource",
+                service_token="MyServiceToken",
+                service_timeout=Duration.seconds(dur_token.value_as_number)
             )
         '''
         if __debug__:
@@ -10808,7 +10845,21 @@ class CustomResourceProps:
 
         Maps to `ServiceTimeout <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-customresource.html#cfn-cloudformation-customresource-servicetimeout>`_ property for the ``AWS::CloudFormation::CustomResource`` resource
 
+        A token can be specified for this property, but it must be specified with ``Duration.seconds()``.
+
         :default: Duration.seconds(3600)
+
+        Example::
+
+            stack = Stack()
+            dur_token = CfnParameter(stack, "MyParameter",
+                type="Number",
+                default=60
+            )
+            CustomResource(stack, "MyCustomResource",
+                service_token="MyServiceToken",
+                service_timeout=Duration.seconds(dur_token.value_as_number)
+            )
         '''
         result = self._values.get("service_timeout")
         return typing.cast(typing.Optional["Duration"], result)
@@ -28353,8 +28404,8 @@ class CfnGuardHook(
         :param target_operations: Specifies the list of operations the Hook is run against. For more information, see `Hook targets <https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hooks-concepts.html#hook-terms-hook-target>`_ in the *AWS CloudFormation Hooks User Guide* . Valid values: ``STACK`` | ``RESOURCE`` | ``CHANGE_SET`` | ``CLOUD_CONTROL``
         :param log_bucket: Specifies the name of an S3 bucket to store the Guard output report. This report contains the results of your Guard rule validations.
         :param options: Specifies the S3 location of your input parameters.
-        :param stack_filters: Specifies the stack level filters for the Hook.
-        :param target_filters: Specifies the target filters for the Hook.
+        :param stack_filters: Specifies the stack level filters for the Hook. Example stack level filter in JSON: ``"StackFilters": {"FilteringCriteria": "ALL", "StackNames": {"Exclude": [ "stack-1", "stack-2"]}}`` Example stack level filter in YAML: ``StackFilters: FilteringCriteria: ALL StackNames: Exclude: - stack-1 - stack-2``
+        :param target_filters: Specifies the target filters for the Hook. Example target filter in JSON: ``"TargetFilters": {"Actions": [ "Create", "Update", "Delete" ]}`` Example target filter in YAML: ``TargetFilters: Actions: - CREATE - UPDATE - DELETE``
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__af8d2663a8bac5046ca50537b031b46f870c6edd4948ed8528ca4e3ff9367b17)
@@ -29817,8 +29868,8 @@ class CfnLambdaHook(
         :param hook_status: Specifies if the Hook is ``ENABLED`` or ``DISABLED`` . Default: - "ENABLED"
         :param lambda_function: Specifies the Lambda function for the Hook. You can use:. - The full Amazon Resource Name (ARN) without a suffix. - A qualified ARN with a version or alias suffix.
         :param target_operations: Specifies the list of operations the Hook is run against. For more information, see `Hook targets <https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hooks-concepts.html#hook-terms-hook-target>`_ in the *AWS CloudFormation Hooks User Guide* . Valid values: ``STACK`` | ``RESOURCE`` | ``CHANGE_SET`` | ``CLOUD_CONTROL``
-        :param stack_filters: Specifies the stack level filters for the Hook.
-        :param target_filters: Specifies the target filters for the Hook.
+        :param stack_filters: Specifies the stack level filters for the Hook. Example stack level filter in JSON: ``"StackFilters": {"FilteringCriteria": "ALL", "StackNames": {"Exclude": [ "stack-1", "stack-2"]}}`` Example stack level filter in YAML: ``StackFilters: FilteringCriteria: ALL StackNames: Exclude: - stack-1 - stack-2``
+        :param target_filters: Specifies the target filters for the Hook. Example target filter in JSON: ``"TargetFilters": {"Actions": [ "Create", "Update", "Delete" ]}`` Example target filter in YAML: ``TargetFilters: Actions: - CREATE - UPDATE - DELETE``
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__407b4a631e3a832f02376728222302ded8f1ba90d2538b0469e5b99641f17447)
@@ -33797,15 +33848,14 @@ class CustomResource(
 
     Example::
 
-        service_token = CustomResourceProvider.get_or_create(self, "Custom::MyCustomResourceType",
-            code_directory=f"{__dirname}/my-handler",
-            runtime=CustomResourceProviderRuntime.NODEJS_18_X,
-            description="Lambda function created by the custom resource provider"
+        stack = Stack()
+        dur_token = CfnParameter(stack, "MyParameter",
+            type="Number",
+            default=60
         )
-        
-        CustomResource(self, "MyResource",
-            resource_type="Custom::MyCustomResourceType",
-            service_token=service_token
+        CustomResource(stack, "MyCustomResource",
+            service_token="MyServiceToken",
+            service_timeout=Duration.seconds(dur_token.value_as_number)
         )
     '''
 
@@ -33829,7 +33879,7 @@ class CustomResource(
         :param properties: Properties to pass to the Lambda. Values in this ``properties`` dictionary can possibly overwrite other values in ``CustomResourceProps`` E.g. ``ServiceToken`` and ``ServiceTimeout`` It is recommended to avoid using same keys that exist in ``CustomResourceProps`` Default: - No properties.
         :param removal_policy: The policy to apply when this resource is removed from the application. Default: cdk.RemovalPolicy.Destroy
         :param resource_type: For custom resources, you can specify AWS::CloudFormation::CustomResource (the default) as the resource type, or you can specify your own resource type name. For example, you can use "Custom::MyCustomResourceTypeName". Custom resource type names must begin with "Custom::" and can include alphanumeric characters and the following characters: _@-. You can specify a custom resource type name up to a maximum length of 60 characters. You cannot change the type during an update. Using your own resource type names helps you quickly differentiate the types of custom resources in your stack. For example, if you had two custom resources that conduct two different ping tests, you could name their type as Custom::PingTester to make them easily identifiable as ping testers (instead of using AWS::CloudFormation::CustomResource). Default: - AWS::CloudFormation::CustomResource
-        :param service_timeout: The maximum time that can elapse before a custom resource operation times out. The value must be between 1 second and 3600 seconds. Maps to `ServiceTimeout <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-customresource.html#cfn-cloudformation-customresource-servicetimeout>`_ property for the ``AWS::CloudFormation::CustomResource`` resource Default: Duration.seconds(3600)
+        :param service_timeout: The maximum time that can elapse before a custom resource operation times out. The value must be between 1 second and 3600 seconds. Maps to `ServiceTimeout <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-customresource.html#cfn-cloudformation-customresource-servicetimeout>`_ property for the ``AWS::CloudFormation::CustomResource`` resource A token can be specified for this property, but it must be specified with ``Duration.seconds()``. Default: Duration.seconds(3600)
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__5c89cdcdef1901fae8effe187c732f9fbf4ec5793ae2938cebb924671df2c26f)

aws_cdk/_jsii/__init__.py

@@ -34,7 +34,7 @@ import aws_cdk.cloud_assembly_schema._jsii
 import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
-    "aws-cdk-lib", "2.180.0", __name__[0:-6], "aws-cdk-lib@2.180.0.jsii.tgz"
+    "aws-cdk-lib", "2.181.1", __name__[0:-6], "aws-cdk-lib@2.181.1.jsii.tgz"
 )
 
 __all__ = [

aws_cdk/aws_acmpca/__init__.py

@@ -118,7 +118,7 @@ class CertificateAuthority(
         
         cluster = msk.Cluster(self, "Cluster",
             cluster_name="myCluster",
-            kafka_version=msk.KafkaVersion.V2_8_1,
+            kafka_version=msk.KafkaVersion.V3_8_X,
             vpc=vpc,
             encryption_in_transit=msk.EncryptionInTransitConfig(
                 client_broker=msk.ClientBrokerEncryption.TLS