aws-cdk-lib 2.205.0__py3-none-any.whl → 2.206.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

@@ -123,6 +123,8 @@ def is_complete(event, context):
123
123
  > Do not use this library if your threat model requires that you cannot trust actors who are able
124
124
  > to list StepFunction executions in your account.
125
125
 
126
+ > **Default behaviour change Note**: the Custom Resource Provider doesn't log anything by default. To enable logging for the Provider framework, toggle `disableWaiterStateMachineLogging` and `disableFrameworkLambdaLogging` depending on you requirement to see waiter state machine logs or provider framework lambda logs
127
+
126
128
  ### Handling Lifecycle Events: onEvent
127
129
 
128
130
  The user-defined `onEvent` AWS Lambda function is invoked whenever a resource
@@ -1020,7 +1022,11 @@ from ..aws_iam import (
1020
1022
  PolicyStatement as _PolicyStatement_0fe33853,
1021
1023
  )
1022
1024
  from ..aws_kms import IKey as _IKey_5f11635f
1023
- from ..aws_lambda import IFunction as _IFunction_6adb0ab8, Runtime as _Runtime_b4eaa844
1025
+ from ..aws_lambda import (
1026
+ ApplicationLogLevel as _ApplicationLogLevel_cd92660a,
1027
+ IFunction as _IFunction_6adb0ab8,
1028
+ Runtime as _Runtime_b4eaa844,
1029
+ )
1024
1030
  from ..aws_logs import (
1025
1031
  ILogGroup as _ILogGroup_3c4fa718, RetentionDays as _RetentionDays_070f99f0
1026
1032
  )
@@ -2467,6 +2473,7 @@ class Provider(
2467
2473
  on_event_handler: _IFunction_6adb0ab8,
2468
2474
  disable_waiter_state_machine_logging: typing.Optional[builtins.bool] = None,
2469
2475
  framework_complete_and_timeout_role: typing.Optional[_IRole_235f5d8e] = None,
2476
+ framework_lambda_logging_level: typing.Optional[_ApplicationLogLevel_cd92660a] = None,
2470
2477
  framework_on_event_role: typing.Optional[_IRole_235f5d8e] = None,
2471
2478
  is_complete_handler: typing.Optional[_IFunction_6adb0ab8] = None,
2472
2479
  log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
@@ -2485,8 +2492,9 @@ class Provider(
2485
2492
  :param scope: -
2486
2493
  :param id: -
2487
2494
  :param on_event_handler: The AWS Lambda function to invoke for all resource lifecycle operations (CREATE/UPDATE/DELETE). This function is responsible to begin the requested resource operation (CREATE/UPDATE/DELETE) and return any additional properties to add to the event, which will later be passed to ``isComplete``. The ``PhysicalResourceId`` property must be included in the response.
2488
- :param disable_waiter_state_machine_logging: Whether logging for the waiter state machine is disabled. Default: - false
2495
+ :param disable_waiter_state_machine_logging: Whether logging for the waiter state machine is disabled. Default: - true
2489
2496
  :param framework_complete_and_timeout_role: Lambda execution role for provider framework's isComplete/onTimeout Lambda function. Note that this role must be assumed by the 'lambda.amazonaws.com' service principal. To prevent circular dependency problem in the provider framework, please ensure you specify a different IAM Role for 'frameworkCompleteAndTimeoutRole' from 'frameworkOnEventRole'. This property cannot be used with 'role' property Default: - A default role will be created.
2497
+ :param framework_lambda_logging_level: Log level of the provider framework lambda. Default: true - Logging is disabled by default
2490
2498
  :param framework_on_event_role: Lambda execution role for provider framework's onEvent Lambda function. Note that this role must be assumed by the 'lambda.amazonaws.com' service principal. This property cannot be used with 'role' property Default: - A default role will be created.
2491
2499
  :param is_complete_handler: The AWS Lambda function to invoke in order to determine if the operation is complete. This function will be called immediately after ``onEvent`` and then periodically based on the configured query interval as long as it returns ``false``. If the function still returns ``false`` and the alloted timeout has passed, the operation will fail. Default: - provider is synchronous. This means that the ``onEvent`` handler is expected to finish all lifecycle operations within the initial invocation.
2492
2500
  :param log_group: The Log Group used for logging of events emitted by the custom resource's lambda function. Providing a user-controlled log group was rolled out to commercial regions on 2023-11-16. If you are deploying to another type of region, please check regional availability first. Default: - a default log group created by AWS Lambda
@@ -2509,6 +2517,7 @@ class Provider(
2509
2517
  on_event_handler=on_event_handler,
2510
2518
  disable_waiter_state_machine_logging=disable_waiter_state_machine_logging,
2511
2519
  framework_complete_and_timeout_role=framework_complete_and_timeout_role,
2520
+ framework_lambda_logging_level=framework_lambda_logging_level,
2512
2521
  framework_on_event_role=framework_on_event_role,
2513
2522
  is_complete_handler=is_complete_handler,
2514
2523
  log_group=log_group,
@@ -2558,6 +2567,7 @@ class Provider(
2558
2567
  "on_event_handler": "onEventHandler",
2559
2568
  "disable_waiter_state_machine_logging": "disableWaiterStateMachineLogging",
2560
2569
  "framework_complete_and_timeout_role": "frameworkCompleteAndTimeoutRole",
2570
+ "framework_lambda_logging_level": "frameworkLambdaLoggingLevel",
2561
2571
  "framework_on_event_role": "frameworkOnEventRole",
2562
2572
  "is_complete_handler": "isCompleteHandler",
2563
2573
  "log_group": "logGroup",
@@ -2580,6 +2590,7 @@ class ProviderProps:
2580
2590
  on_event_handler: _IFunction_6adb0ab8,
2581
2591
  disable_waiter_state_machine_logging: typing.Optional[builtins.bool] = None,
2582
2592
  framework_complete_and_timeout_role: typing.Optional[_IRole_235f5d8e] = None,
2593
+ framework_lambda_logging_level: typing.Optional[_ApplicationLogLevel_cd92660a] = None,
2583
2594
  framework_on_event_role: typing.Optional[_IRole_235f5d8e] = None,
2584
2595
  is_complete_handler: typing.Optional[_IFunction_6adb0ab8] = None,
2585
2596
  log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
@@ -2597,8 +2608,9 @@ class ProviderProps:
2597
2608
  '''Initialization properties for the ``Provider`` construct.
2598
2609
 
2599
2610
  :param on_event_handler: The AWS Lambda function to invoke for all resource lifecycle operations (CREATE/UPDATE/DELETE). This function is responsible to begin the requested resource operation (CREATE/UPDATE/DELETE) and return any additional properties to add to the event, which will later be passed to ``isComplete``. The ``PhysicalResourceId`` property must be included in the response.
2600
- :param disable_waiter_state_machine_logging: Whether logging for the waiter state machine is disabled. Default: - false
2611
+ :param disable_waiter_state_machine_logging: Whether logging for the waiter state machine is disabled. Default: - true
2601
2612
  :param framework_complete_and_timeout_role: Lambda execution role for provider framework's isComplete/onTimeout Lambda function. Note that this role must be assumed by the 'lambda.amazonaws.com' service principal. To prevent circular dependency problem in the provider framework, please ensure you specify a different IAM Role for 'frameworkCompleteAndTimeoutRole' from 'frameworkOnEventRole'. This property cannot be used with 'role' property Default: - A default role will be created.
2613
+ :param framework_lambda_logging_level: Log level of the provider framework lambda. Default: true - Logging is disabled by default
2602
2614
  :param framework_on_event_role: Lambda execution role for provider framework's onEvent Lambda function. Note that this role must be assumed by the 'lambda.amazonaws.com' service principal. This property cannot be used with 'role' property Default: - A default role will be created.
2603
2615
  :param is_complete_handler: The AWS Lambda function to invoke in order to determine if the operation is complete. This function will be called immediately after ``onEvent`` and then periodically based on the configured query interval as long as it returns ``false``. If the function still returns ``false`` and the alloted timeout has passed, the operation will fail. Default: - provider is synchronous. This means that the ``onEvent`` handler is expected to finish all lifecycle operations within the initial invocation.
2604
2616
  :param log_group: The Log Group used for logging of events emitted by the custom resource's lambda function. Providing a user-controlled log group was rolled out to commercial regions on 2023-11-16. If you are deploying to another type of region, please check regional availability first. Default: - a default log group created by AWS Lambda
@@ -2653,6 +2665,7 @@ class ProviderProps:
2653
2665
  check_type(argname="argument on_event_handler", value=on_event_handler, expected_type=type_hints["on_event_handler"])
2654
2666
  check_type(argname="argument disable_waiter_state_machine_logging", value=disable_waiter_state_machine_logging, expected_type=type_hints["disable_waiter_state_machine_logging"])
2655
2667
  check_type(argname="argument framework_complete_and_timeout_role", value=framework_complete_and_timeout_role, expected_type=type_hints["framework_complete_and_timeout_role"])
2668
+ check_type(argname="argument framework_lambda_logging_level", value=framework_lambda_logging_level, expected_type=type_hints["framework_lambda_logging_level"])
2656
2669
  check_type(argname="argument framework_on_event_role", value=framework_on_event_role, expected_type=type_hints["framework_on_event_role"])
2657
2670
  check_type(argname="argument is_complete_handler", value=is_complete_handler, expected_type=type_hints["is_complete_handler"])
2658
2671
  check_type(argname="argument log_group", value=log_group, expected_type=type_hints["log_group"])
@@ -2673,6 +2686,8 @@ class ProviderProps:
2673
2686
  self._values["disable_waiter_state_machine_logging"] = disable_waiter_state_machine_logging
2674
2687
  if framework_complete_and_timeout_role is not None:
2675
2688
  self._values["framework_complete_and_timeout_role"] = framework_complete_and_timeout_role
2689
+ if framework_lambda_logging_level is not None:
2690
+ self._values["framework_lambda_logging_level"] = framework_lambda_logging_level
2676
2691
  if framework_on_event_role is not None:
2677
2692
  self._values["framework_on_event_role"] = framework_on_event_role
2678
2693
  if is_complete_handler is not None:
@@ -2717,7 +2732,7 @@ class ProviderProps:
2717
2732
  def disable_waiter_state_machine_logging(self) -> typing.Optional[builtins.bool]:
2718
2733
  '''Whether logging for the waiter state machine is disabled.
2719
2734
 
2720
- :default: - false
2735
+ :default: - true
2721
2736
  '''
2722
2737
  result = self._values.get("disable_waiter_state_machine_logging")
2723
2738
  return typing.cast(typing.Optional[builtins.bool], result)
@@ -2738,6 +2753,17 @@ class ProviderProps:
2738
2753
  result = self._values.get("framework_complete_and_timeout_role")
2739
2754
  return typing.cast(typing.Optional[_IRole_235f5d8e], result)
2740
2755
 
2756
+ @builtins.property
2757
+ def framework_lambda_logging_level(
2758
+ self,
2759
+ ) -> typing.Optional[_ApplicationLogLevel_cd92660a]:
2760
+ '''Log level of the provider framework lambda.
2761
+
2762
+ :default: true - Logging is disabled by default
2763
+ '''
2764
+ result = self._values.get("framework_lambda_logging_level")
2765
+ return typing.cast(typing.Optional[_ApplicationLogLevel_cd92660a], result)
2766
+
2741
2767
  @builtins.property
2742
2768
  def framework_on_event_role(self) -> typing.Optional[_IRole_235f5d8e]:
2743
2769
  '''Lambda execution role for provider framework's onEvent Lambda function.
@@ -3445,6 +3471,7 @@ def _typecheckingstub__29415d7bf7977fcf110b77ce69cec309dcf0404601944735020770ddf
3445
3471
  on_event_handler: _IFunction_6adb0ab8,
3446
3472
  disable_waiter_state_machine_logging: typing.Optional[builtins.bool] = None,
3447
3473
  framework_complete_and_timeout_role: typing.Optional[_IRole_235f5d8e] = None,
3474
+ framework_lambda_logging_level: typing.Optional[_ApplicationLogLevel_cd92660a] = None,
3448
3475
  framework_on_event_role: typing.Optional[_IRole_235f5d8e] = None,
3449
3476
  is_complete_handler: typing.Optional[_IFunction_6adb0ab8] = None,
3450
3477
  log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
@@ -3467,6 +3494,7 @@ def _typecheckingstub__32b03803ee02437d8d83814282c700ede5633030e4d9f7ebdaf3b9d07
3467
3494
  on_event_handler: _IFunction_6adb0ab8,
3468
3495
  disable_waiter_state_machine_logging: typing.Optional[builtins.bool] = None,
3469
3496
  framework_complete_and_timeout_role: typing.Optional[_IRole_235f5d8e] = None,
3497
+ framework_lambda_logging_level: typing.Optional[_ApplicationLogLevel_cd92660a] = None,
3470
3498
  framework_on_event_role: typing.Optional[_IRole_235f5d8e] = None,
3471
3499
  is_complete_handler: typing.Optional[_IFunction_6adb0ab8] = None,
3472
3500
  log_group: typing.Optional[_ILogGroup_3c4fa718] = None,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: aws-cdk-lib
3
- Version: 2.205.0
3
+ Version: 2.206.0
4
4
  Summary: Version 2 of the AWS Cloud Development Kit library
5
5
  Home-page: https://github.com/aws/aws-cdk
6
6
  Author: Amazon Web Services
@@ -1,7 +1,7 @@
1
1
  aws_cdk/__init__.py,sha256=8qL1pI85kr-yW7FIK4IhvPPFYkmn2ApdGj9ALtOTPms,2038140
2
2
  aws_cdk/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
- aws_cdk/_jsii/__init__.py,sha256=9DUX2JkEHRomSl_3mm-27TeddlTKFhe_5viYKAlvlIw,1543
4
- aws_cdk/_jsii/aws-cdk-lib@2.205.0.jsii.tgz,sha256=X_pC3pwnO-XM9OogPpxU1-wWSEfsmw_tS462J4jPPdg,25769381
3
+ aws_cdk/_jsii/__init__.py,sha256=TLKcsIWubf-hKA7Un-ys_qm5bbdnemNb6i5UHnBmBUw,1543
4
+ aws_cdk/_jsii/aws-cdk-lib@2.206.0.jsii.tgz,sha256=L9w6aQaz_564IQfqGydll8YQaY-05ml3nmyO4vn15L0,25777604
5
5
  aws_cdk/alexa_ask/__init__.py,sha256=yF4ftch7XArzAniw_xoUmGi3wLGeBqIUlOjBTHSxDb4,36370
6
6
  aws_cdk/assertions/__init__.py,sha256=Fe7BZZpx5cUrxKtNdGbU4eXue79txDh_GqjfLV5wgCM,94355
7
7
  aws_cdk/aws_accessanalyzer/__init__.py,sha256=DUc3YNvhPHvaaAXxcjJAyWmO9wHDdiZnn2VPkI2XSEw,76243
@@ -96,7 +96,7 @@ aws_cdk/aws_dynamodb/__init__.py,sha256=HsWXTg9jvtF_ChCn3cBQsN5zkV4yKxAvLgcZruSX
96
96
  aws_cdk/aws_ec2/__init__.py,sha256=zC1of2Plu1TCcBItPsGTfEtyB0a92l-4Be7xu956H1I,6241632
97
97
  aws_cdk/aws_ecr/__init__.py,sha256=6a87DaHOUNNYUt9p5GShotmKT1jF9fiFpRAr0i5A0y8,332045
98
98
  aws_cdk/aws_ecr_assets/__init__.py,sha256=h-ry7VGmOgTsHSW9-BfgXOmDCk4QES88onu750Nekrg,94631
99
- aws_cdk/aws_ecs/__init__.py,sha256=wzZZjqkS_8uorXBgmEkkWUirEe-yDLpQCQooMdO7zm4,2771399
99
+ aws_cdk/aws_ecs/__init__.py,sha256=Gd0o4Ahr6QG_FblBlBC8cPxKG7RvKp50Y68wxZ_DU2A,2798520
100
100
  aws_cdk/aws_ecs_patterns/__init__.py,sha256=m5XkB-bDzyBKfQHKsfLgirHU2OuyOSxzWf1V_XrGYr8,1046527
101
101
  aws_cdk/aws_efs/__init__.py,sha256=jm7xAwwa9jsAUVlpjFaC6ZNu9OJoDBpzRcYAmsR7zus,292545
102
102
  aws_cdk/aws_eks/__init__.py,sha256=0Ikr3jWhUnnZLOaeiQ0lxLhvPvGjPaHf9qIzCbLDtWc,1271812
@@ -294,16 +294,16 @@ aws_cdk/aws_workspacesweb/__init__.py,sha256=CppQEMxEhUPkEPh6MmFFfhsm1c2TybopdiZ
294
294
  aws_cdk/aws_xray/__init__.py,sha256=xEfRY-cPsnAqrrYueXFUxXskU4CxwejB1wrTMGrNKCc,106868
295
295
  aws_cdk/cloud_assembly_schema/__init__.py,sha256=aEAwlI1TH_6LLg11wa6HiH2X3Lec65SLU8nas2j5ZJg,458584
296
296
  aws_cdk/cloudformation_include/__init__.py,sha256=nWU59UskSwMHLVfmA2qrsTOqUk65NWElIPTvp-KLA_8,50358
297
- aws_cdk/custom_resources/__init__.py,sha256=IorblVcNTO7BzZ0Z7euhn-rFiGYIdlijEju9A2W9nMk,173844
297
+ aws_cdk/custom_resources/__init__.py,sha256=Jm9DODjo6QOE2yY0OzrJbLi9bxCoQZ1ku2Dckkg4ffI,175757
298
298
  aws_cdk/cx_api/__init__.py,sha256=anzkjfehtwI4LL0b3frKKPWmiumDemdvDLYF8KVwgcY,183874
299
299
  aws_cdk/lambda_layer_awscli/__init__.py,sha256=1ZBjCh1TECo3vET4aUe1fPjA9hy1ZUw8WyXsOKNe-MM,3555
300
300
  aws_cdk/lambda_layer_node_proxy_agent/__init__.py,sha256=ssdgQwTnWcr4HFK6euFpZ93GJTPpLGRD19LJGXCwZ1I,3570
301
301
  aws_cdk/pipelines/__init__.py,sha256=B3zHQMnbrmzONJslo84_s4WbFcqcx-OrDt2d2t8V60E,409841
302
302
  aws_cdk/region_info/__init__.py,sha256=5GAO_ld0t-3caLW28eV9FWHMrqRq5CyV1L4pFALx9Y4,39656
303
303
  aws_cdk/triggers/__init__.py,sha256=Rd5_IJ-9VJ-qzPzLfiLVMT6WA9NqoTDukBEwIcqJXIw,126167
304
- aws_cdk_lib-2.205.0.dist-info/LICENSE,sha256=y47tc38H0C4DpGljYUZDl8XxidQjNxxGLq-K4jwv6Xc,11391
305
- aws_cdk_lib-2.205.0.dist-info/METADATA,sha256=j1WIqt_fPMb0wbhYm9RVxKpB5256WHCJtV1bWCfzcUo,62895
306
- aws_cdk_lib-2.205.0.dist-info/NOTICE,sha256=lrDSwMl9zn-5xv2z3qp2Rw6Nm8pARejpIJ5eXzJtuQk,41177
307
- aws_cdk_lib-2.205.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
308
- aws_cdk_lib-2.205.0.dist-info/top_level.txt,sha256=1TALAKbuUGsMSrfKWEf268lySCmcqSEO6cDYe_XlLHM,8
309
- aws_cdk_lib-2.205.0.dist-info/RECORD,,
304
+ aws_cdk_lib-2.206.0.dist-info/LICENSE,sha256=y47tc38H0C4DpGljYUZDl8XxidQjNxxGLq-K4jwv6Xc,11391
305
+ aws_cdk_lib-2.206.0.dist-info/METADATA,sha256=Myvb83xh2CneQ7oTfve_WLYg34dxoSRliR8ROYFknDU,62895
306
+ aws_cdk_lib-2.206.0.dist-info/NOTICE,sha256=lrDSwMl9zn-5xv2z3qp2Rw6Nm8pARejpIJ5eXzJtuQk,41177
307
+ aws_cdk_lib-2.206.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
308
+ aws_cdk_lib-2.206.0.dist-info/top_level.txt,sha256=1TALAKbuUGsMSrfKWEf268lySCmcqSEO6cDYe_XlLHM,8
309
+ aws_cdk_lib-2.206.0.dist-info/RECORD,,