aws-cdk-lib 2.204.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.

Files changed (49) hide show
  1. aws_cdk/__init__.py +170 -92
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.204.0.jsii.tgz → aws-cdk-lib@2.206.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_aiops/__init__.py +89 -39
  5. aws_cdk/aws_applicationautoscaling/__init__.py +2 -2
  6. aws_cdk/aws_arczonalshift/__init__.py +4 -1
  7. aws_cdk/aws_b2bi/__init__.py +32 -16
  8. aws_cdk/aws_bedrock/__init__.py +198 -10
  9. aws_cdk/aws_cassandra/__init__.py +156 -0
  10. aws_cdk/aws_cloudformation/__init__.py +74 -72
  11. aws_cdk/aws_cloudfront/__init__.py +1181 -485
  12. aws_cdk/aws_cloudfront_origins/__init__.py +26 -21
  13. aws_cdk/aws_cloudwatch/__init__.py +61 -0
  14. aws_cdk/aws_codebuild/__init__.py +216 -36
  15. aws_cdk/aws_datasync/__init__.py +2 -2
  16. aws_cdk/aws_docdb/__init__.py +78 -0
  17. aws_cdk/aws_dynamodb/__init__.py +207 -35
  18. aws_cdk/aws_ec2/__init__.py +32 -30
  19. aws_cdk/aws_ecs/__init__.py +718 -213
  20. aws_cdk/aws_emrserverless/__init__.py +5 -5
  21. aws_cdk/aws_events/__init__.py +58 -3
  22. aws_cdk/aws_events_targets/__init__.py +7 -2
  23. aws_cdk/aws_evs/__init__.py +7 -7
  24. aws_cdk/aws_fsx/__init__.py +138 -78
  25. aws_cdk/aws_gamelift/__init__.py +19 -0
  26. aws_cdk/aws_glue/__init__.py +3 -3
  27. aws_cdk/aws_iot/__init__.py +1 -1
  28. aws_cdk/aws_kinesis/__init__.py +67 -13
  29. aws_cdk/aws_kinesisfirehose/__init__.py +28 -1
  30. aws_cdk/aws_lex/__init__.py +36 -19
  31. aws_cdk/aws_neptune/__init__.py +12 -12
  32. aws_cdk/aws_odb/__init__.py +4049 -0
  33. aws_cdk/aws_omics/__init__.py +1 -1
  34. aws_cdk/aws_qbusiness/__init__.py +471 -4
  35. aws_cdk/aws_quicksight/__init__.py +185 -16
  36. aws_cdk/aws_rds/__init__.py +169 -17
  37. aws_cdk/aws_redshiftserverless/__init__.py +72 -45
  38. aws_cdk/aws_route53/__init__.py +41 -19
  39. aws_cdk/aws_s3tables/__init__.py +1005 -0
  40. aws_cdk/aws_sagemaker/__init__.py +20 -0
  41. aws_cdk/aws_synthetics/__init__.py +141 -37
  42. aws_cdk/aws_transfer/__init__.py +23 -1
  43. aws_cdk/custom_resources/__init__.py +32 -4
  44. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/METADATA +1 -1
  45. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/RECORD +49 -48
  46. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/LICENSE +0 -0
  47. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/NOTICE +0 -0
  48. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/WHEEL +0 -0
  49. {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/top_level.txt +0 -0
aws_cdk/__init__.py CHANGED
@@ -9205,17 +9205,17 @@ class CfnStackSetProps:
9205
9205
  ) -> None:
9206
9206
  '''Properties for defining a ``CfnStackSet``.
9207
9207
 
9208
- :param permission_model: Describes how the IAM roles required for stack set operations are created. - With ``SELF_MANAGED`` permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . - With ``SERVICE_MANAGED`` permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by AWS Organizations . For more information, see `Activate trusted access for stack sets with AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html>`_ in the *AWS CloudFormation User Guide* .
9209
- :param stack_set_name: The name to associate with the stack set. The name must be unique in the Region where you create your stack set.
9210
- :param administration_role_arn: The Amazon Resource Number (ARN) of the IAM role to use to create this stack set. Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. Use customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . Valid only if the permissions model is ``SELF_MANAGED`` .
9208
+ :param permission_model: Describes how the IAM roles required for StackSet operations are created. - With ``SELF_MANAGED`` permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . - With ``SERVICE_MANAGED`` permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by AWS Organizations . For more information, see `Activate trusted access for StackSets with AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html>`_ in the *AWS CloudFormation User Guide* .
9209
+ :param stack_set_name: The name to associate with the StackSet. The name must be unique in the Region where you create your StackSet.
9210
+ :param administration_role_arn: The Amazon Resource Number (ARN) of the IAM role to use to create this StackSet. Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific StackSets within the same administrator account. Use customized administrator roles to control which users or groups can manage specific StackSets within the same administrator account. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . Valid only if the permissions model is ``SELF_MANAGED`` .
9211
9211
  :param auto_deployment: Describes whether StackSets automatically deploys to AWS Organizations accounts that are added to a target organization or organizational unit (OU). For more information, see `Enable or disable automatic deployments for StackSets in AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-manage-auto-deployment.html>`_ in the *AWS CloudFormation User Guide* . Required if the permissions model is ``SERVICE_MANAGED`` . (Not used with self-managed permissions.)
9212
- :param call_as: Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. By default, ``SELF`` is specified. Use ``SELF`` for stack sets with self-managed permissions. - To create a stack set with service-managed permissions while signed in to the management account, specify ``SELF`` . - To create a stack set with service-managed permissions while signed in to a delegated administrator account, specify ``DELEGATED_ADMIN`` . Your AWS account must be registered as a delegated admin in the management account. For more information, see `Register a delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ in the *AWS CloudFormation User Guide* . Stack sets with service-managed permissions are created in the management account, including stack sets that are created by delegated administrators. Valid only if the permissions model is ``SERVICE_MANAGED`` .
9213
- :param capabilities: The capabilities that are allowed in the stack set. Some stack set templates might include resources that can affect permissions in your AWS account —for example, by creating new IAM users. For more information, see `Acknowledging IAM resources in CloudFormation templates <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities>`_ in the *AWS CloudFormation User Guide* .
9214
- :param description: A description of the stack set.
9215
- :param execution_role_name: The name of the IAM execution role to use to create the stack set. If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the stack set operation. Valid only if the permissions model is ``SELF_MANAGED`` . *Pattern* : ``[a-zA-Z_0-9+=,.@-]+``
9216
- :param managed_execution: Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations. When active, StackSets performs non-conflicting operations concurrently and queues conflicting operations. After conflicting operations finish, StackSets starts queued operations in request order. .. epigraph:: If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting. You can't modify your stack set's execution configuration while there are running or queued operations for that stack set. When inactive (default), StackSets performs one operation at a time in request order.
9217
- :param operation_preferences: The user-specified preferences for how CloudFormation performs a stack set operation.
9218
- :param parameters: The input parameters for the stack set template.
9212
+ :param call_as: Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. By default, ``SELF`` is specified. Use ``SELF`` for StackSets with self-managed permissions. - To create a StackSet with service-managed permissions while signed in to the management account, specify ``SELF`` . - To create a StackSet with service-managed permissions while signed in to a delegated administrator account, specify ``DELEGATED_ADMIN`` . Your AWS account must be registered as a delegated admin in the management account. For more information, see `Register a delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ in the *AWS CloudFormation User Guide* . StackSets with service-managed permissions are created in the management account, including StackSets that are created by delegated administrators. Valid only if the permissions model is ``SERVICE_MANAGED`` .
9213
+ :param capabilities: The capabilities that are allowed in the StackSet. Some StackSet templates might include resources that can affect permissions in your AWS account —for example, by creating new IAM users. For more information, see `Acknowledging IAM resources in CloudFormation templates <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities>`_ in the *AWS CloudFormation User Guide* .
9214
+ :param description: A description of the StackSet.
9215
+ :param execution_role_name: The name of the IAM execution role to use to create the StackSet. If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the StackSet operation. Valid only if the permissions model is ``SELF_MANAGED`` . *Pattern* : ``[a-zA-Z_0-9+=,.@-]+``
9216
+ :param managed_execution: Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations. When active, StackSets performs non-conflicting operations concurrently and queues conflicting operations. After conflicting operations finish, StackSets starts queued operations in request order. .. epigraph:: If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting. You can't modify your StackSet's execution configuration while there are running or queued operations for that StackSet. When inactive (default), StackSets performs one operation at a time in request order.
9217
+ :param operation_preferences: The user-specified preferences for how CloudFormation performs a StackSet operation.
9218
+ :param parameters: The input parameters for the StackSet template.
9219
9219
  :param stack_instances_group: A group of stack instances with parameters in some specific accounts and Regions.
9220
9220
  :param tags: Key-value pairs to associate with this stack. CloudFormation also propagates these tags to supported resources in the stack. You can specify a maximum number of 50 tags. If you don't specify this parameter, CloudFormation doesn't modify the stack's tags. If you specify an empty value, CloudFormation removes all associated tags.
9221
9221
  :param template_body: The structure that contains the template body, with a minimum length of 1 byte and a maximum length of 51,200 bytes. You must include either ``TemplateURL`` or ``TemplateBody`` in a StackSet, but you can't use both. Dynamic references in the ``TemplateBody`` may not work correctly in all cases. It's recommended to pass templates that contain dynamic references through ``TemplateUrl`` instead.
@@ -9333,10 +9333,10 @@ class CfnStackSetProps:
9333
9333
 
9334
9334
  @builtins.property
9335
9335
  def permission_model(self) -> builtins.str:
9336
- '''Describes how the IAM roles required for stack set operations are created.
9336
+ '''Describes how the IAM roles required for StackSet operations are created.
9337
9337
 
9338
9338
  - With ``SELF_MANAGED`` permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* .
9339
- - With ``SERVICE_MANAGED`` permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by AWS Organizations . For more information, see `Activate trusted access for stack sets with AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html>`_ in the *AWS CloudFormation User Guide* .
9339
+ - With ``SERVICE_MANAGED`` permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by AWS Organizations . For more information, see `Activate trusted access for StackSets with AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html>`_ in the *AWS CloudFormation User Guide* .
9340
9340
 
9341
9341
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-permissionmodel
9342
9342
  '''
@@ -9346,9 +9346,9 @@ class CfnStackSetProps:
9346
9346
 
9347
9347
  @builtins.property
9348
9348
  def stack_set_name(self) -> builtins.str:
9349
- '''The name to associate with the stack set.
9349
+ '''The name to associate with the StackSet.
9350
9350
 
9351
- The name must be unique in the Region where you create your stack set.
9351
+ The name must be unique in the Region where you create your StackSet.
9352
9352
 
9353
9353
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-stacksetname
9354
9354
  '''
@@ -9358,11 +9358,11 @@ class CfnStackSetProps:
9358
9358
 
9359
9359
  @builtins.property
9360
9360
  def administration_role_arn(self) -> typing.Optional[builtins.str]:
9361
- '''The Amazon Resource Number (ARN) of the IAM role to use to create this stack set.
9361
+ '''The Amazon Resource Number (ARN) of the IAM role to use to create this StackSet.
9362
9362
 
9363
- Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account.
9363
+ Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific StackSets within the same administrator account.
9364
9364
 
9365
- Use customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* .
9365
+ Use customized administrator roles to control which users or groups can manage specific StackSets within the same administrator account. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* .
9366
9366
 
9367
9367
  Valid only if the permissions model is ``SELF_MANAGED`` .
9368
9368
 
@@ -9390,14 +9390,14 @@ class CfnStackSetProps:
9390
9390
  def call_as(self) -> typing.Optional[builtins.str]:
9391
9391
  '''Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.
9392
9392
 
9393
- By default, ``SELF`` is specified. Use ``SELF`` for stack sets with self-managed permissions.
9393
+ By default, ``SELF`` is specified. Use ``SELF`` for StackSets with self-managed permissions.
9394
9394
 
9395
- - To create a stack set with service-managed permissions while signed in to the management account, specify ``SELF`` .
9396
- - To create a stack set with service-managed permissions while signed in to a delegated administrator account, specify ``DELEGATED_ADMIN`` .
9395
+ - To create a StackSet with service-managed permissions while signed in to the management account, specify ``SELF`` .
9396
+ - To create a StackSet with service-managed permissions while signed in to a delegated administrator account, specify ``DELEGATED_ADMIN`` .
9397
9397
 
9398
9398
  Your AWS account must be registered as a delegated admin in the management account. For more information, see `Register a delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ in the *AWS CloudFormation User Guide* .
9399
9399
 
9400
- Stack sets with service-managed permissions are created in the management account, including stack sets that are created by delegated administrators.
9400
+ StackSets with service-managed permissions are created in the management account, including StackSets that are created by delegated administrators.
9401
9401
 
9402
9402
  Valid only if the permissions model is ``SERVICE_MANAGED`` .
9403
9403
 
@@ -9408,9 +9408,9 @@ class CfnStackSetProps:
9408
9408
 
9409
9409
  @builtins.property
9410
9410
  def capabilities(self) -> typing.Optional[typing.List[builtins.str]]:
9411
- '''The capabilities that are allowed in the stack set.
9411
+ '''The capabilities that are allowed in the StackSet.
9412
9412
 
9413
- Some stack set templates might include resources that can affect permissions in your AWS account —for example, by creating new IAM users. For more information, see `Acknowledging IAM resources in CloudFormation templates <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities>`_ in the *AWS CloudFormation User Guide* .
9413
+ Some StackSet templates might include resources that can affect permissions in your AWS account —for example, by creating new IAM users. For more information, see `Acknowledging IAM resources in CloudFormation templates <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities>`_ in the *AWS CloudFormation User Guide* .
9414
9414
 
9415
9415
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-capabilities
9416
9416
  '''
@@ -9419,7 +9419,7 @@ class CfnStackSetProps:
9419
9419
 
9420
9420
  @builtins.property
9421
9421
  def description(self) -> typing.Optional[builtins.str]:
9422
- '''A description of the stack set.
9422
+ '''A description of the StackSet.
9423
9423
 
9424
9424
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-description
9425
9425
  '''
@@ -9428,9 +9428,9 @@ class CfnStackSetProps:
9428
9428
 
9429
9429
  @builtins.property
9430
9430
  def execution_role_name(self) -> typing.Optional[builtins.str]:
9431
- '''The name of the IAM execution role to use to create the stack set.
9431
+ '''The name of the IAM execution role to use to create the StackSet.
9432
9432
 
9433
- If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the stack set operation.
9433
+ If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the StackSet operation.
9434
9434
 
9435
9435
  Valid only if the permissions model is ``SELF_MANAGED`` .
9436
9436
 
@@ -9450,7 +9450,7 @@ class CfnStackSetProps:
9450
9450
 
9451
9451
  If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting.
9452
9452
 
9453
- You can't modify your stack set's execution configuration while there are running or queued operations for that stack set.
9453
+ You can't modify your StackSet's execution configuration while there are running or queued operations for that StackSet.
9454
9454
 
9455
9455
  When inactive (default), StackSets performs one operation at a time in request order.
9456
9456
 
@@ -9463,7 +9463,7 @@ class CfnStackSetProps:
9463
9463
  def operation_preferences(
9464
9464
  self,
9465
9465
  ) -> typing.Optional[typing.Union["IResolvable", "CfnStackSet.OperationPreferencesProperty"]]:
9466
- '''The user-specified preferences for how CloudFormation performs a stack set operation.
9466
+ '''The user-specified preferences for how CloudFormation performs a StackSet operation.
9467
9467
 
9468
9468
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-operationpreferences
9469
9469
  '''
@@ -9474,7 +9474,7 @@ class CfnStackSetProps:
9474
9474
  def parameters(
9475
9475
  self,
9476
9476
  ) -> typing.Optional[typing.Union["IResolvable", typing.List[typing.Union["IResolvable", "CfnStackSet.ParameterProperty"]]]]:
9477
- '''The input parameters for the stack set template.
9477
+ '''The input parameters for the StackSet template.
9478
9478
 
9479
9479
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-parameters
9480
9480
  '''
@@ -20005,13 +20005,12 @@ class RemovalPolicy(enum.Enum):
20005
20005
  '''
20006
20006
 
20007
20007
  DESTROY = "DESTROY"
20008
- '''This is the default removal policy.
20008
+ '''When this removal policy is applied, the resource will be physically destroyed when it is removed from the stack or when the stack is deleted.'''
20009
+ RETAIN = "RETAIN"
20010
+ '''This uses the 'Retain' DeletionPolicy, which will cause the resource to be retained in the account, but orphaned from the stack.
20009
20011
 
20010
- It means that when the resource is
20011
- removed from the app, it will be physically destroyed.
20012
+ Most resources default to this removal policy.
20012
20013
  '''
20013
- RETAIN = "RETAIN"
20014
- '''This uses the 'Retain' DeletionPolicy, which will cause the resource to be retained in the account, but orphaned from the stack.'''
20015
20014
  SNAPSHOT = "SNAPSHOT"
20016
20015
  '''This retention policy deletes the resource, but saves a snapshot of its data before deleting, so that it can be re-created later.
20017
20016
 
@@ -21844,7 +21843,7 @@ class Stack(
21844
21843
  :param stack_name: Name to deploy the stack with. Default: - Derived from construct path.
21845
21844
  :param suppress_template_indentation: Enable this flag to suppress indentation in generated CloudFormation templates. If not specified, the value of the ``@aws-cdk/core:suppressTemplateIndentation`` context key will be used. If that is not specified, then the default value ``false`` will be used. Default: - the value of ``@aws-cdk/core:suppressTemplateIndentation``, or ``false`` if that is not set.
21846
21845
  :param synthesizer: Synthesis method to use while deploying this stack. The Stack Synthesizer controls aspects of synthesis and deployment, like how assets are referenced and what IAM roles to use. For more information, see the README of the main CDK package. If not specified, the ``defaultStackSynthesizer`` from ``App`` will be used. If that is not specified, ``DefaultStackSynthesizer`` is used if ``@aws-cdk/core:newStyleStackSynthesis`` is set to ``true`` or the CDK major version is v2. In CDK v1 ``LegacyStackSynthesizer`` is the default if no other synthesizer is specified. Default: - The synthesizer specified on ``App``, or ``DefaultStackSynthesizer`` otherwise.
21847
- :param tags: Stack tags that will be applied to all the taggable resources and the stack itself. Default: {}
21846
+ :param tags: Tags that will be applied to the Stack. These tags are applied to the CloudFormation Stack itself. They will not appear in the CloudFormation template. However, at deployment time, CloudFormation will apply these tags to all resources in the stack that support tagging. You will not be able to exempt resources from tagging (using the ``excludeResourceTypes`` property of ``Tags.of(...).add()``) for tags applied in this way. Default: {}
21848
21847
  :param termination_protection: Whether to enable termination protection for this stack. Default: false
21849
21848
  '''
21850
21849
  if __debug__:
@@ -21933,6 +21932,21 @@ class Stack(
21933
21932
  check_type(argname="argument value", value=value, expected_type=type_hints["value"])
21934
21933
  return typing.cast(None, jsii.invoke(self, "addMetadata", [key, value]))
21935
21934
 
21935
+ @jsii.member(jsii_name="addStackTag")
21936
+ def add_stack_tag(self, tag_name: builtins.str, tag_value: builtins.str) -> None:
21937
+ '''Configure a stack tag.
21938
+
21939
+ At deploy time, CloudFormation will automatically apply all stack tags to all resources in the stack.
21940
+
21941
+ :param tag_name: -
21942
+ :param tag_value: -
21943
+ '''
21944
+ if __debug__:
21945
+ type_hints = typing.get_type_hints(_typecheckingstub__c79ea9b0cd54830acfa2c93ac0786782e515591ac5cda10c42b42f8ff76457a0)
21946
+ check_type(argname="argument tag_name", value=tag_name, expected_type=type_hints["tag_name"])
21947
+ check_type(argname="argument tag_value", value=tag_value, expected_type=type_hints["tag_value"])
21948
+ return typing.cast(None, jsii.invoke(self, "addStackTag", [tag_name, tag_value]))
21949
+
21936
21950
  @jsii.member(jsii_name="addTransform")
21937
21951
  def add_transform(self, transform: builtins.str) -> None:
21938
21952
  '''Add a Transform to this stack. A Transform is a macro that AWS CloudFormation uses to process your template.
@@ -22204,6 +22218,19 @@ class Stack(
22204
22218
  check_type(argname="argument default_value", value=default_value, expected_type=type_hints["default_value"])
22205
22219
  return typing.cast(builtins.str, jsii.invoke(self, "regionalFact", [fact_name, default_value]))
22206
22220
 
22221
+ @jsii.member(jsii_name="removeStackTag")
22222
+ def remove_stack_tag(self, tag_name: builtins.str) -> None:
22223
+ '''Remove a stack tag.
22224
+
22225
+ At deploy time, CloudFormation will automatically apply all stack tags to all resources in the stack.
22226
+
22227
+ :param tag_name: -
22228
+ '''
22229
+ if __debug__:
22230
+ type_hints = typing.get_type_hints(_typecheckingstub__25f39c18a619c464f8e693cb5c5847cdf10f847438cac04672be8ba78d2b49d0)
22231
+ check_type(argname="argument tag_name", value=tag_name, expected_type=type_hints["tag_name"])
22232
+ return typing.cast(None, jsii.invoke(self, "removeStackTag", [tag_name]))
22233
+
22207
22234
  @jsii.member(jsii_name="renameLogicalId")
22208
22235
  def rename_logical_id(self, old_id: builtins.str, new_id: builtins.str) -> None:
22209
22236
  '''Rename a generated logical identities.
@@ -22555,7 +22582,7 @@ class StackProps:
22555
22582
  :param stack_name: Name to deploy the stack with. Default: - Derived from construct path.
22556
22583
  :param suppress_template_indentation: Enable this flag to suppress indentation in generated CloudFormation templates. If not specified, the value of the ``@aws-cdk/core:suppressTemplateIndentation`` context key will be used. If that is not specified, then the default value ``false`` will be used. Default: - the value of ``@aws-cdk/core:suppressTemplateIndentation``, or ``false`` if that is not set.
22557
22584
  :param synthesizer: Synthesis method to use while deploying this stack. The Stack Synthesizer controls aspects of synthesis and deployment, like how assets are referenced and what IAM roles to use. For more information, see the README of the main CDK package. If not specified, the ``defaultStackSynthesizer`` from ``App`` will be used. If that is not specified, ``DefaultStackSynthesizer`` is used if ``@aws-cdk/core:newStyleStackSynthesis`` is set to ``true`` or the CDK major version is v2. In CDK v1 ``LegacyStackSynthesizer`` is the default if no other synthesizer is specified. Default: - The synthesizer specified on ``App``, or ``DefaultStackSynthesizer`` otherwise.
22558
- :param tags: Stack tags that will be applied to all the taggable resources and the stack itself. Default: {}
22585
+ :param tags: Tags that will be applied to the Stack. These tags are applied to the CloudFormation Stack itself. They will not appear in the CloudFormation template. However, at deployment time, CloudFormation will apply these tags to all resources in the stack that support tagging. You will not be able to exempt resources from tagging (using the ``excludeResourceTypes`` property of ``Tags.of(...).add()``) for tags applied in this way. Default: {}
22559
22586
  :param termination_protection: Whether to enable termination protection for this stack. Default: false
22560
22587
 
22561
22588
  :exampleMetadata: infused
@@ -22804,7 +22831,15 @@ class StackProps:
22804
22831
 
22805
22832
  @builtins.property
22806
22833
  def tags(self) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
22807
- '''Stack tags that will be applied to all the taggable resources and the stack itself.
22834
+ '''Tags that will be applied to the Stack.
22835
+
22836
+ These tags are applied to the CloudFormation Stack itself. They will not
22837
+ appear in the CloudFormation template.
22838
+
22839
+ However, at deployment time, CloudFormation will apply these tags to all
22840
+ resources in the stack that support tagging. You will not be able to exempt
22841
+ resources from tagging (using the ``excludeResourceTypes`` property of
22842
+ ``Tags.of(...).add()``) for tags applied in this way.
22808
22843
 
22809
22844
  :default: {}
22810
22845
  '''
@@ -24723,7 +24758,26 @@ class Tags(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Tags"):
24723
24758
  include_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
24724
24759
  priority: typing.Optional[jsii.Number] = None,
24725
24760
  ) -> None:
24726
- '''add tags to the node of a construct and all its the taggable children.
24761
+ '''Add tags to the node of a construct and all its the taggable children.
24762
+
24763
+
24764
+
24765
+ Tagging and CloudFormation Stacks
24766
+
24767
+ If the feature flag ``@aws-cdk/core:explicitStackTags`` is set to ``true``
24768
+ (recommended modern behavior), Stacks will not automatically be tagged.
24769
+ Stack tags should be configured on Stacks directly (preferred), or
24770
+ you must explicitly include the resource type ``aws:cdk:stack`` in the
24771
+ ``includeResourceTypes`` array.
24772
+
24773
+ If the feature flag is set to ``false`` (legacy behavior) then both Stacks
24774
+ and resources in the indicated scope will both be tagged by default, which
24775
+ leads to tags being applied twice (once in the template, and then once
24776
+ again automatically by CloudFormation as part of the stack deployment).
24777
+ That behavior leads to loss of control as ``excludeResourceTypes`` will
24778
+ prevent tags from appearing in the template, but they will still be
24779
+ applied to the Stack and hence CloudFormation will still apply them
24780
+ to the resource.
24727
24781
 
24728
24782
  :param key: -
24729
24783
  :param value: -
@@ -24837,18 +24891,25 @@ class TimeZone(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.TimeZone"):
24837
24891
  Example::
24838
24892
 
24839
24893
  from aws_cdk import TimeZone
24840
- # plan: backup.BackupPlan
24894
+ # resource: SomeScalableResource
24841
24895
 
24842
- plan.add_rule(backup.BackupPlanRule(
24843
- completion_window=Duration.hours(2),
24844
- start_window=Duration.hours(1),
24845
- schedule_expression=events.Schedule.cron( # Only cron expressions are supported
24846
- day="15",
24847
- hour="3",
24848
- minute="30"),
24849
- schedule_expression_timezone=TimeZone.ETC_UTC,
24850
- move_to_cold_storage_after=Duration.days(30)
24851
- ))
24896
+
24897
+ capacity = resource.auto_scale_capacity(
24898
+ min_capacity=1,
24899
+ max_capacity=50
24900
+ )
24901
+
24902
+ capacity.scale_on_schedule("PrescaleInTheMorning",
24903
+ schedule=appscaling.Schedule.cron(hour="8", minute="0"),
24904
+ min_capacity=20,
24905
+ time_zone=TimeZone.AMERICA_DENVER
24906
+ )
24907
+
24908
+ capacity.scale_on_schedule("AllowDownscalingAtNight",
24909
+ schedule=appscaling.Schedule.cron(hour="20", minute="0"),
24910
+ min_capacity=1,
24911
+ time_zone=TimeZone.AMERICA_DENVER
24912
+ )
24852
24913
  '''
24853
24914
 
24854
24915
  @jsii.member(jsii_name="of")
@@ -30396,7 +30457,7 @@ class CfnHookDefaultVersion(
30396
30457
  @builtins.property
30397
30458
  @jsii.member(jsii_name="attrArn")
30398
30459
  def attr_arn(self) -> builtins.str:
30399
- '''The Amazon Resource Number (ARN) of the activated Hook, in this account and Region.
30460
+ '''The Amazon Resource Number (ARN) of the activated Hook in this account and Region.
30400
30461
 
30401
30462
  :cloudformationAttribute: Arn
30402
30463
  '''
@@ -30541,7 +30602,7 @@ class CfnHookTypeConfig(
30541
30602
  @builtins.property
30542
30603
  @jsii.member(jsii_name="attrConfigurationArn")
30543
30604
  def attr_configuration_arn(self) -> builtins.str:
30544
- '''The Amazon Resource Number (ARN) of the activated Hook type configuration, in this account and Region.
30605
+ '''The Amazon Resource Number (ARN) of the activated Hook type configuration in this account and Region.
30545
30606
 
30546
30607
  :cloudformationAttribute: ConfigurationArn
30547
30608
  '''
@@ -31808,7 +31869,8 @@ class CfnMacro(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnM
31808
31869
  @builtins.property
31809
31870
  @jsii.member(jsii_name="attrId")
31810
31871
  def attr_id(self) -> builtins.str:
31811
- '''
31872
+ '''Returns a unique identifier for the resource.
31873
+
31812
31874
  :cloudformationAttribute: Id
31813
31875
  '''
31814
31876
  return typing.cast(builtins.str, jsii.get(self, "attrId"))
@@ -33117,7 +33179,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
33117
33179
 
33118
33180
  For more information, see `Nested stacks <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html>`_ in the *AWS CloudFormation User Guide* .
33119
33181
 
33120
- You can add output values from a nested stack within the containing template. You use the `GetAtt <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html>`_ function with the nested stack's logical name and the name of the output value in the nested stack in the format ``Outputs. *NestedStackOutputName*`` .
33182
+ You can add output values from a nested stack within the containing template. You use the `GetAtt <https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html>`_ function with the nested stack's logical name and the name of the output value in the nested stack in the format ``Outputs. *NestedStackOutputName*`` .
33121
33183
 
33122
33184
  We strongly recommend that updates to nested stacks are run from the parent stack.
33123
33185
 
@@ -33251,7 +33313,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
33251
33313
  @builtins.property
33252
33314
  @jsii.member(jsii_name="attrChangeSetId")
33253
33315
  def attr_change_set_id(self) -> builtins.str:
33254
- '''Returns the unique ID of the change set.
33316
+ '''Returns the unique identifier of the change set.
33255
33317
 
33256
33318
  :cloudformationAttribute: ChangeSetId
33257
33319
  '''
@@ -33260,7 +33322,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
33260
33322
  @builtins.property
33261
33323
  @jsii.member(jsii_name="attrCreationTime")
33262
33324
  def attr_creation_time(self) -> builtins.str:
33263
- '''Returns The time at which the stack was created.
33325
+ '''Returns the time the stack was created.
33264
33326
 
33265
33327
  :cloudformationAttribute: CreationTime
33266
33328
  '''
@@ -33520,9 +33582,9 @@ class CfnStackSet(
33520
33582
  metaclass=jsii.JSIIMeta,
33521
33583
  jsii_type="aws-cdk-lib.CfnStackSet",
33522
33584
  ):
33523
- '''The ``AWS::CloudFormation::StackSet`` resource enables you to provision stacks into AWS accounts and across Regions by using a single CloudFormation template.
33585
+ '''The ``AWS::CloudFormation::StackSet`` resource contains information about a StackSet.
33524
33586
 
33525
- In the stack set, you specify the template to use, in addition to any parameters and capabilities that the template requires.
33587
+ With StackSets, you can provision stacks across AWS accounts and Regions from a single CloudFormation template. Each stack is based on the same CloudFormation template, but you can customize individual stacks using parameters.
33526
33588
  .. epigraph::
33527
33589
 
33528
33590
  Run deployments to nested StackSets from the parent stack, not directly through the StackSet API.
@@ -33615,17 +33677,17 @@ class CfnStackSet(
33615
33677
  '''
33616
33678
  :param scope: Scope in which this resource is defined.
33617
33679
  :param id: Construct identifier for this resource (unique in its scope).
33618
- :param permission_model: Describes how the IAM roles required for stack set operations are created. - With ``SELF_MANAGED`` permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . - With ``SERVICE_MANAGED`` permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by AWS Organizations . For more information, see `Activate trusted access for stack sets with AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html>`_ in the *AWS CloudFormation User Guide* .
33619
- :param stack_set_name: The name to associate with the stack set. The name must be unique in the Region where you create your stack set.
33620
- :param administration_role_arn: The Amazon Resource Number (ARN) of the IAM role to use to create this stack set. Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. Use customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . Valid only if the permissions model is ``SELF_MANAGED`` .
33680
+ :param permission_model: Describes how the IAM roles required for StackSet operations are created. - With ``SELF_MANAGED`` permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . - With ``SERVICE_MANAGED`` permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by AWS Organizations . For more information, see `Activate trusted access for StackSets with AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-activate-trusted-access.html>`_ in the *AWS CloudFormation User Guide* .
33681
+ :param stack_set_name: The name to associate with the StackSet. The name must be unique in the Region where you create your StackSet.
33682
+ :param administration_role_arn: The Amazon Resource Number (ARN) of the IAM role to use to create this StackSet. Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific StackSets within the same administrator account. Use customized administrator roles to control which users or groups can manage specific StackSets within the same administrator account. For more information, see `Grant self-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html>`_ in the *AWS CloudFormation User Guide* . Valid only if the permissions model is ``SELF_MANAGED`` .
33621
33683
  :param auto_deployment: Describes whether StackSets automatically deploys to AWS Organizations accounts that are added to a target organization or organizational unit (OU). For more information, see `Enable or disable automatic deployments for StackSets in AWS Organizations <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-manage-auto-deployment.html>`_ in the *AWS CloudFormation User Guide* . Required if the permissions model is ``SERVICE_MANAGED`` . (Not used with self-managed permissions.)
33622
- :param call_as: Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. By default, ``SELF`` is specified. Use ``SELF`` for stack sets with self-managed permissions. - To create a stack set with service-managed permissions while signed in to the management account, specify ``SELF`` . - To create a stack set with service-managed permissions while signed in to a delegated administrator account, specify ``DELEGATED_ADMIN`` . Your AWS account must be registered as a delegated admin in the management account. For more information, see `Register a delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ in the *AWS CloudFormation User Guide* . Stack sets with service-managed permissions are created in the management account, including stack sets that are created by delegated administrators. Valid only if the permissions model is ``SERVICE_MANAGED`` .
33623
- :param capabilities: The capabilities that are allowed in the stack set. Some stack set templates might include resources that can affect permissions in your AWS account —for example, by creating new IAM users. For more information, see `Acknowledging IAM resources in CloudFormation templates <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities>`_ in the *AWS CloudFormation User Guide* .
33624
- :param description: A description of the stack set.
33625
- :param execution_role_name: The name of the IAM execution role to use to create the stack set. If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the stack set operation. Valid only if the permissions model is ``SELF_MANAGED`` . *Pattern* : ``[a-zA-Z_0-9+=,.@-]+``
33626
- :param managed_execution: Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations. When active, StackSets performs non-conflicting operations concurrently and queues conflicting operations. After conflicting operations finish, StackSets starts queued operations in request order. .. epigraph:: If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting. You can't modify your stack set's execution configuration while there are running or queued operations for that stack set. When inactive (default), StackSets performs one operation at a time in request order.
33627
- :param operation_preferences: The user-specified preferences for how CloudFormation performs a stack set operation.
33628
- :param parameters: The input parameters for the stack set template.
33684
+ :param call_as: Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. By default, ``SELF`` is specified. Use ``SELF`` for StackSets with self-managed permissions. - To create a StackSet with service-managed permissions while signed in to the management account, specify ``SELF`` . - To create a StackSet with service-managed permissions while signed in to a delegated administrator account, specify ``DELEGATED_ADMIN`` . Your AWS account must be registered as a delegated admin in the management account. For more information, see `Register a delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ in the *AWS CloudFormation User Guide* . StackSets with service-managed permissions are created in the management account, including StackSets that are created by delegated administrators. Valid only if the permissions model is ``SERVICE_MANAGED`` .
33685
+ :param capabilities: The capabilities that are allowed in the StackSet. Some StackSet templates might include resources that can affect permissions in your AWS account —for example, by creating new IAM users. For more information, see `Acknowledging IAM resources in CloudFormation templates <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/control-access-with-iam.html#using-iam-capabilities>`_ in the *AWS CloudFormation User Guide* .
33686
+ :param description: A description of the StackSet.
33687
+ :param execution_role_name: The name of the IAM execution role to use to create the StackSet. If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the StackSet operation. Valid only if the permissions model is ``SELF_MANAGED`` . *Pattern* : ``[a-zA-Z_0-9+=,.@-]+``
33688
+ :param managed_execution: Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations. When active, StackSets performs non-conflicting operations concurrently and queues conflicting operations. After conflicting operations finish, StackSets starts queued operations in request order. .. epigraph:: If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting. You can't modify your StackSet's execution configuration while there are running or queued operations for that StackSet. When inactive (default), StackSets performs one operation at a time in request order.
33689
+ :param operation_preferences: The user-specified preferences for how CloudFormation performs a StackSet operation.
33690
+ :param parameters: The input parameters for the StackSet template.
33629
33691
  :param stack_instances_group: A group of stack instances with parameters in some specific accounts and Regions.
33630
33692
  :param tags: Key-value pairs to associate with this stack. CloudFormation also propagates these tags to supported resources in the stack. You can specify a maximum number of 50 tags. If you don't specify this parameter, CloudFormation doesn't modify the stack's tags. If you specify an empty value, CloudFormation removes all associated tags.
33631
33693
  :param template_body: The structure that contains the template body, with a minimum length of 1 byte and a maximum length of 51,200 bytes. You must include either ``TemplateURL`` or ``TemplateBody`` in a StackSet, but you can't use both. Dynamic references in the ``TemplateBody`` may not work correctly in all cases. It's recommended to pass templates that contain dynamic references through ``TemplateUrl`` instead.
@@ -33688,7 +33750,7 @@ class CfnStackSet(
33688
33750
  @builtins.property
33689
33751
  @jsii.member(jsii_name="attrStackSetId")
33690
33752
  def attr_stack_set_id(self) -> builtins.str:
33691
- '''The ID of the stack that you're creating.
33753
+ '''Returns the unique identifier of the resource.
33692
33754
 
33693
33755
  :cloudformationAttribute: StackSetId
33694
33756
  '''
@@ -33708,7 +33770,7 @@ class CfnStackSet(
33708
33770
  @builtins.property
33709
33771
  @jsii.member(jsii_name="permissionModel")
33710
33772
  def permission_model(self) -> builtins.str:
33711
- '''Describes how the IAM roles required for stack set operations are created.'''
33773
+ '''Describes how the IAM roles required for StackSet operations are created.'''
33712
33774
  return typing.cast(builtins.str, jsii.get(self, "permissionModel"))
33713
33775
 
33714
33776
  @permission_model.setter
@@ -33721,7 +33783,7 @@ class CfnStackSet(
33721
33783
  @builtins.property
33722
33784
  @jsii.member(jsii_name="stackSetName")
33723
33785
  def stack_set_name(self) -> builtins.str:
33724
- '''The name to associate with the stack set.'''
33786
+ '''The name to associate with the StackSet.'''
33725
33787
  return typing.cast(builtins.str, jsii.get(self, "stackSetName"))
33726
33788
 
33727
33789
  @stack_set_name.setter
@@ -33734,7 +33796,7 @@ class CfnStackSet(
33734
33796
  @builtins.property
33735
33797
  @jsii.member(jsii_name="administrationRoleArn")
33736
33798
  def administration_role_arn(self) -> typing.Optional[builtins.str]:
33737
- '''The Amazon Resource Number (ARN) of the IAM role to use to create this stack set.'''
33799
+ '''The Amazon Resource Number (ARN) of the IAM role to use to create this StackSet.'''
33738
33800
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "administrationRoleArn"))
33739
33801
 
33740
33802
  @administration_role_arn.setter
@@ -33778,7 +33840,7 @@ class CfnStackSet(
33778
33840
  @builtins.property
33779
33841
  @jsii.member(jsii_name="capabilities")
33780
33842
  def capabilities(self) -> typing.Optional[typing.List[builtins.str]]:
33781
- '''The capabilities that are allowed in the stack set.'''
33843
+ '''The capabilities that are allowed in the StackSet.'''
33782
33844
  return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "capabilities"))
33783
33845
 
33784
33846
  @capabilities.setter
@@ -33791,7 +33853,7 @@ class CfnStackSet(
33791
33853
  @builtins.property
33792
33854
  @jsii.member(jsii_name="description")
33793
33855
  def description(self) -> typing.Optional[builtins.str]:
33794
- '''A description of the stack set.'''
33856
+ '''A description of the StackSet.'''
33795
33857
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "description"))
33796
33858
 
33797
33859
  @description.setter
@@ -33804,7 +33866,7 @@ class CfnStackSet(
33804
33866
  @builtins.property
33805
33867
  @jsii.member(jsii_name="executionRoleName")
33806
33868
  def execution_role_name(self) -> typing.Optional[builtins.str]:
33807
- '''The name of the IAM execution role to use to create the stack set.'''
33869
+ '''The name of the IAM execution role to use to create the StackSet.'''
33808
33870
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "executionRoleName"))
33809
33871
 
33810
33872
  @execution_role_name.setter
@@ -33832,7 +33894,7 @@ class CfnStackSet(
33832
33894
  def operation_preferences(
33833
33895
  self,
33834
33896
  ) -> typing.Optional[typing.Union[IResolvable, "CfnStackSet.OperationPreferencesProperty"]]:
33835
- '''The user-specified preferences for how CloudFormation performs a stack set operation.'''
33897
+ '''The user-specified preferences for how CloudFormation performs a StackSet operation.'''
33836
33898
  return typing.cast(typing.Optional[typing.Union[IResolvable, "CfnStackSet.OperationPreferencesProperty"]], jsii.get(self, "operationPreferences"))
33837
33899
 
33838
33900
  @operation_preferences.setter
@@ -33850,7 +33912,7 @@ class CfnStackSet(
33850
33912
  def parameters(
33851
33913
  self,
33852
33914
  ) -> typing.Optional[typing.Union[IResolvable, typing.List[typing.Union[IResolvable, "CfnStackSet.ParameterProperty"]]]]:
33853
- '''The input parameters for the stack set template.'''
33915
+ '''The input parameters for the StackSet template.'''
33854
33916
  return typing.cast(typing.Optional[typing.Union[IResolvable, typing.List[typing.Union[IResolvable, "CfnStackSet.ParameterProperty"]]]], jsii.get(self, "parameters"))
33855
33917
 
33856
33918
  @parameters.setter
@@ -34018,7 +34080,7 @@ class CfnStackSet(
34018
34080
  accounts_url: typing.Optional[builtins.str] = None,
34019
34081
  organizational_unit_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
34020
34082
  ) -> None:
34021
- '''The AWS OrganizationalUnitIds or Accounts for which to create stack instances in the specified Regions.
34083
+ '''The AWS ``OrganizationalUnitIds`` or ``Accounts`` for which to create stack instances in the specified Regions.
34022
34084
 
34023
34085
  :param account_filter_type: Limit deployment targets to individual accounts or include additional accounts with provided OUs. The following is a list of possible values for the ``AccountFilterType`` operation. - ``INTERSECTION`` : StackSet deploys to the accounts specified in the ``Accounts`` parameter. - ``DIFFERENCE`` : StackSet deploys to the OU, excluding the accounts specified in the ``Accounts`` parameter. - ``UNION`` StackSet deploys to the OU, and the accounts specified in the ``Accounts`` parameter. ``UNION`` is not supported for create operations when using StackSet as a resource.
34024
34086
  :param accounts: The account IDs of the AWS accounts . If you have many account numbers, you can provide those accounts using the ``AccountsUrl`` property instead. *Pattern* : ``^[0-9]{12}$``
@@ -34131,7 +34193,7 @@ class CfnStackSet(
34131
34193
  ) -> None:
34132
34194
  '''Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.
34133
34195
 
34134
- :param active: When ``true`` , StackSets performs non-conflicting operations concurrently and queues conflicting operations. After conflicting operations finish, StackSets starts queued operations in request order. .. epigraph:: If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting. You can't modify your stack set's execution configuration while there are running or queued operations for that stack set. When ``false`` (default), StackSets performs one operation at a time in request order.
34196
+ :param active: When ``true`` , StackSets performs non-conflicting operations concurrently and queues conflicting operations. After conflicting operations finish, StackSets starts queued operations in request order. .. epigraph:: If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting. You can't modify your StackSet's execution configuration while there are running or queued operations for that StackSet. When ``false`` (default), StackSets performs one operation at a time in request order.
34135
34197
 
34136
34198
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stackset-managedexecution.html
34137
34199
  :exampleMetadata: fixture=_generated
@@ -34162,7 +34224,7 @@ class CfnStackSet(
34162
34224
 
34163
34225
  If there are already running or queued operations, StackSets queues all incoming operations even if they are non-conflicting.
34164
34226
 
34165
- You can't modify your stack set's execution configuration while there are running or queued operations for that stack set.
34227
+ You can't modify your StackSet's execution configuration while there are running or queued operations for that StackSet.
34166
34228
 
34167
34229
  When ``false`` (default), StackSets performs one operation at a time in request order.
34168
34230
 
@@ -34207,13 +34269,13 @@ class CfnStackSet(
34207
34269
  region_concurrency_type: typing.Optional[builtins.str] = None,
34208
34270
  region_order: typing.Optional[typing.Sequence[builtins.str]] = None,
34209
34271
  ) -> None:
34210
- '''The user-specified preferences for how CloudFormation performs a stack set operation.
34272
+ '''The user-specified preferences for how CloudFormation performs a StackSet operation.
34211
34273
 
34212
- For more information on maximum concurrent accounts and failure tolerance, see `Stack set operation options <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options>`_ in the *AWS CloudFormation User Guide* .
34274
+ For more information on maximum concurrent accounts and failure tolerance, see `StackSet operation options <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options>`_ in the *AWS CloudFormation User Guide* .
34213
34275
 
34214
- :param concurrency_mode: Specifies how the concurrency level behaves during the operation execution. - ``STRICT_FAILURE_TOLERANCE`` : This option dynamically lowers the concurrency level to ensure the number of failed accounts never exceeds the value of ``FailureToleranceCount`` +1. The initial actual concurrency is set to the lower of either the value of the ``MaxConcurrentCount`` , or the value of ``FailureToleranceCount`` +1. The actual concurrency is then reduced proportionally by the number of failures. This is the default behavior. If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior is similar. - ``SOFT_FAILURE_TOLERANCE`` : This option decouples ``FailureToleranceCount`` from the actual concurrency. This allows stack set operations to run at the concurrency level set by the ``MaxConcurrentCount`` value, or ``MaxConcurrentPercentage`` , regardless of the number of failures.
34215
- :param failure_tolerance_count: The number of accounts, per Region, for which this operation can fail before CloudFormation stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions. Conditional: You must specify either ``FailureToleranceCount`` or ``FailureTolerancePercentage`` (but not both).
34216
- :param failure_tolerance_percentage: The percentage of accounts, per Region, for which this stack operation can fail before CloudFormation stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions. When calculating the number of accounts based on the specified percentage, CloudFormation rounds *down* to the next whole number. Conditional: You must specify either ``FailureToleranceCount`` or ``FailureTolerancePercentage`` , but not both.
34276
+ :param concurrency_mode: Specifies how the concurrency level behaves during the operation execution. - ``STRICT_FAILURE_TOLERANCE`` : This option dynamically lowers the concurrency level to ensure the number of failed accounts never exceeds the value of ``FailureToleranceCount`` +1. The initial actual concurrency is set to the lower of either the value of the ``MaxConcurrentCount`` , or the value of ``FailureToleranceCount`` +1. The actual concurrency is then reduced proportionally by the number of failures. This is the default behavior. If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior is similar. - ``SOFT_FAILURE_TOLERANCE`` : This option decouples ``FailureToleranceCount`` from the actual concurrency. This allows StackSet operations to run at the concurrency level set by the ``MaxConcurrentCount`` value, or ``MaxConcurrentPercentage`` , regardless of the number of failures.
34277
+ :param failure_tolerance_count: The number of accounts per Region this operation can fail in before CloudFormation stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions. Conditional: You must specify either ``FailureToleranceCount`` or ``FailureTolerancePercentage`` (but not both).
34278
+ :param failure_tolerance_percentage: The percentage of accounts per Region this stack operation can fail in before CloudFormation stops the operation in that Region. If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions. When calculating the number of accounts based on the specified percentage, CloudFormation rounds *down* to the next whole number. Conditional: You must specify either ``FailureToleranceCount`` or ``FailureTolerancePercentage`` , but not both.
34217
34279
  :param max_concurrent_count: The maximum number of accounts in which to perform this operation at one time. This is dependent on the value of ``FailureToleranceCount`` . ``MaxConcurrentCount`` is at most one more than the ``FailureToleranceCount`` . Note that this setting lets you specify the *maximum* for operations. For large deployments, under certain circumstances the actual number of accounts acted upon concurrently may be lower due to service throttling. Conditional: You must specify either ``MaxConcurrentCount`` or ``MaxConcurrentPercentage`` , but not both.
34218
34280
  :param max_concurrent_percentage: The maximum percentage of accounts in which to perform this operation at one time. When calculating the number of accounts based on the specified percentage, CloudFormation rounds down to the next whole number. This is true except in cases where rounding down would result is zero. In this case, CloudFormation sets the number as one instead. Note that this setting lets you specify the *maximum* for operations. For large deployments, under certain circumstances the actual number of accounts acted upon concurrently may be lower due to service throttling. Conditional: You must specify either ``MaxConcurrentCount`` or ``MaxConcurrentPercentage`` , but not both.
34219
34281
  :param region_concurrency_type: The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time.
@@ -34271,7 +34333,7 @@ class CfnStackSet(
34271
34333
 
34272
34334
  If failure tolerance or Maximum concurrent accounts are set to percentages, the behavior is similar.
34273
34335
 
34274
- - ``SOFT_FAILURE_TOLERANCE`` : This option decouples ``FailureToleranceCount`` from the actual concurrency. This allows stack set operations to run at the concurrency level set by the ``MaxConcurrentCount`` value, or ``MaxConcurrentPercentage`` , regardless of the number of failures.
34336
+ - ``SOFT_FAILURE_TOLERANCE`` : This option decouples ``FailureToleranceCount`` from the actual concurrency. This allows StackSet operations to run at the concurrency level set by the ``MaxConcurrentCount`` value, or ``MaxConcurrentPercentage`` , regardless of the number of failures.
34275
34337
 
34276
34338
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stackset-operationpreferences.html#cfn-cloudformation-stackset-operationpreferences-concurrencymode
34277
34339
  '''
@@ -34280,7 +34342,7 @@ class CfnStackSet(
34280
34342
 
34281
34343
  @builtins.property
34282
34344
  def failure_tolerance_count(self) -> typing.Optional[jsii.Number]:
34283
- '''The number of accounts, per Region, for which this operation can fail before CloudFormation stops the operation in that Region.
34345
+ '''The number of accounts per Region this operation can fail in before CloudFormation stops the operation in that Region.
34284
34346
 
34285
34347
  If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions.
34286
34348
 
@@ -34293,7 +34355,7 @@ class CfnStackSet(
34293
34355
 
34294
34356
  @builtins.property
34295
34357
  def failure_tolerance_percentage(self) -> typing.Optional[jsii.Number]:
34296
- '''The percentage of accounts, per Region, for which this stack operation can fail before CloudFormation stops the operation in that Region.
34358
+ '''The percentage of accounts per Region this stack operation can fail in before CloudFormation stops the operation in that Region.
34297
34359
 
34298
34360
  If the operation is stopped in a Region, CloudFormation doesn't attempt the operation in any subsequent Regions.
34299
34361
 
@@ -34462,7 +34524,7 @@ class CfnStackSet(
34462
34524
 
34463
34525
  :param deployment_targets: The AWS ``OrganizationalUnitIds`` or ``Accounts`` for which to create stack instances in the specified Regions.
34464
34526
  :param regions: The names of one or more Regions where you want to create stack instances using the specified AWS accounts .
34465
- :param parameter_overrides: A list of stack set parameters whose values you want to override in the selected stack instances.
34527
+ :param parameter_overrides: A list of StackSet parameters whose values you want to override in the selected stack instances.
34466
34528
 
34467
34529
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stackset-stackinstances.html
34468
34530
  :exampleMetadata: fixture=_generated
@@ -34527,7 +34589,7 @@ class CfnStackSet(
34527
34589
  def parameter_overrides(
34528
34590
  self,
34529
34591
  ) -> typing.Optional[typing.Union[IResolvable, typing.List[typing.Union[IResolvable, "CfnStackSet.ParameterProperty"]]]]:
34530
- '''A list of stack set parameters whose values you want to override in the selected stack instances.
34592
+ '''A list of StackSet parameters whose values you want to override in the selected stack instances.
34531
34593
 
34532
34594
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudformation-stackset-stackinstances.html#cfn-cloudformation-stackset-stackinstances-parameteroverrides
34533
34595
  '''
@@ -34893,7 +34955,7 @@ class CfnWaitCondition(
34893
34955
  ):
34894
34956
  '''The ``AWS::CloudFormation::WaitCondition`` resource provides a way to coordinate stack resource creation with configuration actions that are external to the stack creation or to track the status of a configuration process.
34895
34957
 
34896
- In these situations, we recommend that you associate a ``CreationPolicy`` attribute with the wait condition instead of using a wait condition handle. For more information and an example, see `CreationPolicy attribute <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-creationpolicy.html>`_ in the *AWS CloudFormation User Guide* . If you use a ``CreationPolicy`` with a wait condition, don't specify any of the wait condition's properties.
34958
+ In these situations, we recommend that you associate a ``CreationPolicy`` attribute with the wait condition instead of using a wait condition handle. For more information and an example, see `CreationPolicy attribute <https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-creationpolicy.html>`_ in the *AWS CloudFormation User Guide* . If you use a ``CreationPolicy`` with a wait condition, don't specify any of the wait condition's properties.
34897
34959
  .. epigraph::
34898
34960
 
34899
34961
  If you use AWS PrivateLink , resources in the VPC that respond to wait conditions must have access to CloudFormation , specific Amazon S3 buckets. Resources must send wait condition responses to a presigned Amazon S3 URL. If they can't send responses to Amazon S3 , CloudFormation won't receive a response and the stack operation fails. For more information, see `Access CloudFormation using an interface endpoint ( AWS PrivateLink ) <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/vpc-interface-endpoints.html>`_ in the *AWS CloudFormation User Guide* . > For Amazon EC2 and Auto Scaling resources, we recommend that you use a ``CreationPolicy`` attribute instead of wait conditions. Add a ``CreationPolicy`` attribute to those resources, and use the ``cfn-signal`` helper script to signal when an instance creation process has completed successfully.
@@ -34980,7 +35042,8 @@ class CfnWaitCondition(
34980
35042
  @builtins.property
34981
35043
  @jsii.member(jsii_name="attrId")
34982
35044
  def attr_id(self) -> builtins.str:
34983
- '''
35045
+ '''Returns a unique identifier for the resource.
35046
+
34984
35047
  :cloudformationAttribute: Id
34985
35048
  '''
34986
35049
  return typing.cast(builtins.str, jsii.get(self, "attrId"))
@@ -35105,7 +35168,7 @@ class CfnWaitConditionHandle(
35105
35168
  @builtins.property
35106
35169
  @jsii.member(jsii_name="attrId")
35107
35170
  def attr_id(self) -> builtins.str:
35108
- '''A unique identifier for the resource.
35171
+ '''Returns a unique identifier for the resource.
35109
35172
 
35110
35173
  :cloudformationAttribute: Id
35111
35174
  '''
@@ -37898,6 +37961,7 @@ __all__ = [
37898
37961
  "aws_notifications",
37899
37962
  "aws_notificationscontacts",
37900
37963
  "aws_oam",
37964
+ "aws_odb",
37901
37965
  "aws_omics",
37902
37966
  "aws_opensearchserverless",
37903
37967
  "aws_opensearchservice",
@@ -38200,6 +38264,7 @@ from . import aws_nimblestudio
38200
38264
  from . import aws_notifications
38201
38265
  from . import aws_notificationscontacts
38202
38266
  from . import aws_oam
38267
+ from . import aws_odb
38203
38268
  from . import aws_omics
38204
38269
  from . import aws_opensearchserverless
38205
38270
  from . import aws_opensearchservice
@@ -40929,6 +40994,13 @@ def _typecheckingstub__2747e69e9678b96621f1476e1bee4426100a530229cea9dce16210392
40929
40994
  """Type checking stubs"""
40930
40995
  pass
40931
40996
 
40997
+ def _typecheckingstub__c79ea9b0cd54830acfa2c93ac0786782e515591ac5cda10c42b42f8ff76457a0(
40998
+ tag_name: builtins.str,
40999
+ tag_value: builtins.str,
41000
+ ) -> None:
41001
+ """Type checking stubs"""
41002
+ pass
41003
+
40932
41004
  def _typecheckingstub__4b8bfc7ce675d439b6218b58ddc312a45cfe87ee7179a489f0cc18c67560faac(
40933
41005
  transform: builtins.str,
40934
41006
  ) -> None:
@@ -40972,6 +41044,12 @@ def _typecheckingstub__1f4a18c1188f55ad7c4058f8aace9f6ebb7b7e9b596dd51616883b350
40972
41044
  """Type checking stubs"""
40973
41045
  pass
40974
41046
 
41047
+ def _typecheckingstub__25f39c18a619c464f8e693cb5c5847cdf10f847438cac04672be8ba78d2b49d0(
41048
+ tag_name: builtins.str,
41049
+ ) -> None:
41050
+ """Type checking stubs"""
41051
+ pass
41052
+
40975
41053
  def _typecheckingstub__363ae1d6a0b84b63acd48fd337e70f58cc140887b9d61b4f55f925b3a7e2cded(
40976
41054
  old_id: builtins.str,
40977
41055
  new_id: builtins.str,