aws-cdk-lib 2.199.0__py3-none-any.whl → 2.200.0__py3-none-any.whl

aws_cdk/aws_lambda/__init__.py

@@ -227,6 +227,71 @@ lambda_.Function(self, "Lambda",
 
 To use `applicationLogLevelV2` and/or `systemLogLevelV2` you must set `loggingFormat` to `LoggingFormat.JSON`.
 
+## Customizing Log Group Creation
+
+### Log Group Creation Methods
+
+| Method | Description | Tag Propagation | Prop Injection | Aspects | Notes |
+|--------|-------------|-----------------|----------------|---------|-------|
+| **logRetention prop** | Legacy approach using Custom Resource | False | False | False | Does not support TPA |
+| **logGroup prop** | Explicitly supplied by user in CDK app | True | True | True | Full support for TPA |
+| **Lazy creation** | Lambda service creates logGroup on first invocation | False | False | False | Occurs when both logRetention and logGroup are undefined and USE_CDK_MANAGED_LAMBDA_LOGGROUP is false |
+| **USE_CDK_MANAGED_LAMBDA_LOGGROUP** | CDK Lambda function construct creates log group with default props | True | True | True | Feature flag must be enabled |
+
+*TPA: Tag propagation, Prop Injection, Aspects*
+
+#### Order of precedence
+
+```text
+                       Highest Precedence
+                             |
+             +---------------+---------------+
+             |                               |
+  +-------------------------+      +------------------------+
+  |   logRetention is set   |      |     logGroup is set    |
+  +-----------+-------------+      +----------+-------------+
+              |                               |
+              v                               v
+      Create LogGroup via            Use the provided LogGroup
+  Custom Resource (retention       instance (CDK-managed,
+  managed, logGroup disallowed)    logRetention disallowed)
+              |                               |
+              +---------------+---------------+
+                              |
+                              v
+          +-----------------------------------------------+
+          |         Feature flag enabled:                 |
+          | aws-cdk:aws-lambda:useCdkManagedLogGroup      |
+          +------------------ +---------------------------+
+                              |
+                              v
+              Create LogGroup at synth time
+          (CDK-managed, default settings for logGroup)
+                              |
+                              v
+                  +---------------------------+
+                  | Default (no config set)   |
+                  +------------+--------------+
+                              |
+                              v
+     Lambda service creates log group on first invocation runtime
+            (CDK does not manage the log group resource)
+```
+
+### Tag Propagation
+
+Refer section `Log Group Creation Methods` to find out which modes support tag propagation.
+As an example, adding the following line in your cdk app will also propagate to the logGroup.
+
+```
+const fn = new lambda.Function(this, 'MyFunctionWithFFTrue', {
+  runtime: lambda.Runtime.NODEJS_20_X,
+  handler: 'handler.main',
+  code: lambda.Code.fromAsset('lambda'),
+});
+cdk.Tags.of(fn).add('env', 'dev'); // the tag is also added to the log group
+```
+
 ## Resource-based Policies
 
 AWS Lambda supports resource-based policies for controlling access to Lambda
@@ -10779,15 +10844,12 @@ class CfnVersion(
         # The values are placeholders you should change.
         from aws_cdk import aws_lambda as lambda_
         
-        # policy: Any
-        
         cfn_version = lambda_.CfnVersion(self, "MyCfnVersion",
             function_name="functionName",
         
             # the properties below are optional
             code_sha256="codeSha256",
             description="description",
-            policy=policy,
             provisioned_concurrency_config=lambda.CfnVersion.ProvisionedConcurrencyConfigurationProperty(
                 provisioned_concurrent_executions=123
             ),
@@ -10808,7 +10870,6 @@ class CfnVersion(
         function_name: builtins.str,
         code_sha256: typing.Optional[builtins.str] = None,
         description: typing.Optional[builtins.str] = None,
-        policy: typing.Any = None,
         provisioned_concurrency_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnVersion.ProvisionedConcurrencyConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         runtime_policy: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnVersion.RuntimePolicyProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
@@ -10818,7 +10879,6 @@ class CfnVersion(
         :param function_name: The name or ARN of the Lambda function. **Name formats** - *Function name* - ``MyFunction`` . - *Function ARN* - ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction`` . - *Partial ARN* - ``123456789012:function:MyFunction`` . The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
         :param code_sha256: Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. Updates are not supported for this property.
         :param description: A description for the version to override the description in the function configuration. Updates are not supported for this property.
-        :param policy: The resource policy of your function.
         :param provisioned_concurrency_config: Specifies a provisioned concurrency configuration for a function's version. Updates are not supported for this property.
         :param runtime_policy: Runtime Management Config of a function.
         '''
@@ -10830,7 +10890,6 @@ class CfnVersion(
             function_name=function_name,
             code_sha256=code_sha256,
             description=description,
-            policy=policy,
             provisioned_concurrency_config=provisioned_concurrency_config,
             runtime_policy=runtime_policy,
         )
@@ -10929,19 +10988,6 @@ class CfnVersion(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "description", value) # pyright: ignore[reportArgumentType]
 
-    @builtins.property
-    @jsii.member(jsii_name="policy")
-    def policy(self) -> typing.Any:
-        '''The resource policy of your function.'''
-        return typing.cast(typing.Any, jsii.get(self, "policy"))
-
-    @policy.setter
-    def policy(self, value: typing.Any) -> None:
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__ca802d0cfdb44c8f362bdb1d342a752f1a5ebd921d11a7b2fd0806cca5d9200a)
-            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "policy", value) # pyright: ignore[reportArgumentType]
-
     @builtins.property
     @jsii.member(jsii_name="provisionedConcurrencyConfig")
     def provisioned_concurrency_config(
@@ -11128,7 +11174,6 @@ class CfnVersion(
         "function_name": "functionName",
         "code_sha256": "codeSha256",
         "description": "description",
-        "policy": "policy",
         "provisioned_concurrency_config": "provisionedConcurrencyConfig",
         "runtime_policy": "runtimePolicy",
     },
@@ -11140,7 +11185,6 @@ class CfnVersionProps:
         function_name: builtins.str,
         code_sha256: typing.Optional[builtins.str] = None,
         description: typing.Optional[builtins.str] = None,
-        policy: typing.Any = None,
         provisioned_concurrency_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnVersion.ProvisionedConcurrencyConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         runtime_policy: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnVersion.RuntimePolicyProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
@@ -11149,7 +11193,6 @@ class CfnVersionProps:
         :param function_name: The name or ARN of the Lambda function. **Name formats** - *Function name* - ``MyFunction`` . - *Function ARN* - ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction`` . - *Partial ARN* - ``123456789012:function:MyFunction`` . The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
         :param code_sha256: Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. Updates are not supported for this property.
         :param description: A description for the version to override the description in the function configuration. Updates are not supported for this property.
-        :param policy: The resource policy of your function.
         :param provisioned_concurrency_config: Specifies a provisioned concurrency configuration for a function's version. Updates are not supported for this property.
         :param runtime_policy: Runtime Management Config of a function.
 
@@ -11162,15 +11205,12 @@ class CfnVersionProps:
             # The values are placeholders you should change.
             from aws_cdk import aws_lambda as lambda_
             
-            # policy: Any
-            
             cfn_version_props = lambda.CfnVersionProps(
                 function_name="functionName",
             
                 # the properties below are optional
                 code_sha256="codeSha256",
                 description="description",
-                policy=policy,
                 provisioned_concurrency_config=lambda.CfnVersion.ProvisionedConcurrencyConfigurationProperty(
                     provisioned_concurrent_executions=123
                 ),
@@ -11187,7 +11227,6 @@ class CfnVersionProps:
             check_type(argname="argument function_name", value=function_name, expected_type=type_hints["function_name"])
             check_type(argname="argument code_sha256", value=code_sha256, expected_type=type_hints["code_sha256"])
             check_type(argname="argument description", value=description, expected_type=type_hints["description"])
-            check_type(argname="argument policy", value=policy, expected_type=type_hints["policy"])
             check_type(argname="argument provisioned_concurrency_config", value=provisioned_concurrency_config, expected_type=type_hints["provisioned_concurrency_config"])
             check_type(argname="argument runtime_policy", value=runtime_policy, expected_type=type_hints["runtime_policy"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -11197,8 +11236,6 @@ class CfnVersionProps:
             self._values["code_sha256"] = code_sha256
         if description is not None:
             self._values["description"] = description
-        if policy is not None:
-            self._values["policy"] = policy
         if provisioned_concurrency_config is not None:
             self._values["provisioned_concurrency_config"] = provisioned_concurrency_config
         if runtime_policy is not None:
@@ -11243,15 +11280,6 @@ class CfnVersionProps:
         result = self._values.get("description")
         return typing.cast(typing.Optional[builtins.str], result)
 
-    @builtins.property
-    def policy(self) -> typing.Any:
-        '''The resource policy of your function.
-
-        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-version.html#cfn-lambda-version-policy
-        '''
-        result = self._values.get("policy")
-        return typing.cast(typing.Any, result)
-
     @builtins.property
     def provisioned_concurrency_config(
         self,
@@ -30700,7 +30728,6 @@ def _typecheckingstub__1d4b3bf8a38fd246db911713fe99ad93f55dc635dbdaae114631921a1
     function_name: builtins.str,
     code_sha256: typing.Optional[builtins.str] = None,
     description: typing.Optional[builtins.str] = None,
-    policy: typing.Any = None,
     provisioned_concurrency_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnVersion.ProvisionedConcurrencyConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     runtime_policy: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnVersion.RuntimePolicyProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
@@ -30737,12 +30764,6 @@ def _typecheckingstub__f00e141771e43b8312d6a22399ba2d956886a5861db2296d1a2f16f8b
     """Type checking stubs"""
     pass
 
-def _typecheckingstub__ca802d0cfdb44c8f362bdb1d342a752f1a5ebd921d11a7b2fd0806cca5d9200a(
-    value: typing.Any,
-) -> None:
-    """Type checking stubs"""
-    pass
-
 def _typecheckingstub__e46534e1d83b58a93edc70a851ca891701ea58cfe9a3fc7dc106915c1a475fa6(
     value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnVersion.ProvisionedConcurrencyConfigurationProperty]],
 ) -> None:
@@ -30775,7 +30796,6 @@ def _typecheckingstub__63ba63c43bc52bb365203cebb308fd393d4c03a8aee52a0336a139696
     function_name: builtins.str,
     code_sha256: typing.Optional[builtins.str] = None,
     description: typing.Optional[builtins.str] = None,
-    policy: typing.Any = None,
     provisioned_concurrency_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnVersion.ProvisionedConcurrencyConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     runtime_policy: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnVersion.RuntimePolicyProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:

aws_cdk/aws_lex/__init__.py

@@ -9898,9 +9898,10 @@ class CfnBot(
             slot_type_id: builtins.str,
             value_elicitation_setting: typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.SubSlotValueElicitationSettingProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''
-            :param slot_type_id: 
-            :param value_elicitation_setting: 
+            '''Subslot specifications.
+
+            :param slot_type_id: The unique identifier assigned to the slot type.
+            :param value_elicitation_setting: Specifies the elicitation setting details for constituent sub slots of a composite slot.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-specifications.html
             :exampleMetadata: fixture=_generated
@@ -10186,7 +10187,8 @@ class CfnBot(
 
         @builtins.property
         def slot_type_id(self) -> builtins.str:
-            '''
+            '''The unique identifier assigned to the slot type.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-specifications.html#cfn-lex-bot-specifications-slottypeid
             '''
             result = self._values.get("slot_type_id")
@@ -10197,7 +10199,8 @@ class CfnBot(
         def value_elicitation_setting(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnBot.SubSlotValueElicitationSettingProperty"]:
-            '''
+            '''Specifies the elicitation setting details for constituent sub slots of a composite slot.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-specifications.html#cfn-lex-bot-specifications-valueelicitationsetting
             '''
             result = self._values.get("value_elicitation_setting")
@@ -10391,9 +10394,10 @@ class CfnBot(
             expression: typing.Optional[builtins.str] = None,
             slot_specifications: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.SpecificationsProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         ) -> None:
-            '''
-            :param expression: 
-            :param slot_specifications: 
+            '''Specifications for the constituent sub slots and the expression for the composite slot.
+
+            :param expression: The expression text for defining the constituent sub slots in the composite slot using logical AND and OR operators.
+            :param slot_specifications: Specifications for the constituent sub slots of a composite slot.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-subslotsetting.html
             :exampleMetadata: fixture=_generated
@@ -10685,7 +10689,8 @@ class CfnBot(
 
         @builtins.property
         def expression(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The expression text for defining the constituent sub slots in the composite slot using logical AND and OR operators.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-subslotsetting.html#cfn-lex-bot-subslotsetting-expression
             '''
             result = self._values.get("expression")
@@ -10695,7 +10700,8 @@ class CfnBot(
         def slot_specifications(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, typing.Union[_IResolvable_da3f097b, "CfnBot.SpecificationsProperty"]]]]:
-            '''
+            '''Specifications for the constituent sub slots of a composite slot.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-subslotsetting.html#cfn-lex-bot-subslotsetting-slotspecifications
             '''
             result = self._values.get("slot_specifications")
@@ -10799,10 +10805,15 @@ class CfnBot(
             sample_utterances: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.SampleUtteranceProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
             wait_and_continue_specification: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnBot.WaitAndContinueSpecificationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
+            '''Subslot elicitation settings.
+
+            ``DefaultValueSpecification`` is a list of default values for a constituent sub slot in a composite slot. Default values are used when Amazon Lex hasn't determined a value for a slot. You can specify default values from context variables, session attributes, and defined values. This is similar to ``DefaultValueSpecification`` for slots.
+
+            ``PromptSpecification`` is the prompt that Amazon Lex uses to elicit the sub slot value from the user. This is similar to ``PromptSpecification`` for slots.
+
             :param default_value_specification: 
             :param prompt_specification: 
-            :param sample_utterances: 
+            :param sample_utterances: If you know a specific pattern that users might respond to an Amazon Lex request for a sub slot value, you can provide those utterances to improve accuracy. This is optional. In most cases Amazon Lex is capable of understanding user utterances. This is similar to ``SampleUtterances`` for slots.
             :param wait_and_continue_specification: 
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-subslotvalueelicitationsetting.html
@@ -11115,7 +11126,10 @@ class CfnBot(
         def sample_utterances(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnBot.SampleUtteranceProperty"]]]]:
-            '''
+            '''If you know a specific pattern that users might respond to an Amazon Lex request for a sub slot value, you can provide those utterances to improve accuracy.
+
+            This is optional. In most cases Amazon Lex is capable of understanding user utterances. This is similar to ``SampleUtterances`` for slots.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lex-bot-subslotvalueelicitationsetting.html#cfn-lex-bot-subslotvalueelicitationsetting-sampleutterances
             '''
             result = self._values.get("sample_utterances")