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.
- aws_cdk/__init__.py +170 -92
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.204.0.jsii.tgz → aws-cdk-lib@2.206.0.jsii.tgz} +0 -0
- aws_cdk/aws_aiops/__init__.py +89 -39
- aws_cdk/aws_applicationautoscaling/__init__.py +2 -2
- aws_cdk/aws_arczonalshift/__init__.py +4 -1
- aws_cdk/aws_b2bi/__init__.py +32 -16
- aws_cdk/aws_bedrock/__init__.py +198 -10
- aws_cdk/aws_cassandra/__init__.py +156 -0
- aws_cdk/aws_cloudformation/__init__.py +74 -72
- aws_cdk/aws_cloudfront/__init__.py +1181 -485
- aws_cdk/aws_cloudfront_origins/__init__.py +26 -21
- aws_cdk/aws_cloudwatch/__init__.py +61 -0
- aws_cdk/aws_codebuild/__init__.py +216 -36
- aws_cdk/aws_datasync/__init__.py +2 -2
- aws_cdk/aws_docdb/__init__.py +78 -0
- aws_cdk/aws_dynamodb/__init__.py +207 -35
- aws_cdk/aws_ec2/__init__.py +32 -30
- aws_cdk/aws_ecs/__init__.py +718 -213
- aws_cdk/aws_emrserverless/__init__.py +5 -5
- aws_cdk/aws_events/__init__.py +58 -3
- aws_cdk/aws_events_targets/__init__.py +7 -2
- aws_cdk/aws_evs/__init__.py +7 -7
- aws_cdk/aws_fsx/__init__.py +138 -78
- aws_cdk/aws_gamelift/__init__.py +19 -0
- aws_cdk/aws_glue/__init__.py +3 -3
- aws_cdk/aws_iot/__init__.py +1 -1
- aws_cdk/aws_kinesis/__init__.py +67 -13
- aws_cdk/aws_kinesisfirehose/__init__.py +28 -1
- aws_cdk/aws_lex/__init__.py +36 -19
- aws_cdk/aws_neptune/__init__.py +12 -12
- aws_cdk/aws_odb/__init__.py +4049 -0
- aws_cdk/aws_omics/__init__.py +1 -1
- aws_cdk/aws_qbusiness/__init__.py +471 -4
- aws_cdk/aws_quicksight/__init__.py +185 -16
- aws_cdk/aws_rds/__init__.py +169 -17
- aws_cdk/aws_redshiftserverless/__init__.py +72 -45
- aws_cdk/aws_route53/__init__.py +41 -19
- aws_cdk/aws_s3tables/__init__.py +1005 -0
- aws_cdk/aws_sagemaker/__init__.py +20 -0
- aws_cdk/aws_synthetics/__init__.py +141 -37
- aws_cdk/aws_transfer/__init__.py +23 -1
- aws_cdk/custom_resources/__init__.py +32 -4
- {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/RECORD +49 -48
- {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.206.0.dist-info}/WHEEL +0 -0
- {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
|
|
9209
|
-
:param stack_set_name: The name to associate with the
|
|
9210
|
-
:param administration_role_arn: The Amazon Resource Number (ARN) of the IAM role to use to create this
|
|
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
|
|
9213
|
-
:param capabilities: The capabilities that are allowed in the
|
|
9214
|
-
:param description: A description of the
|
|
9215
|
-
:param execution_role_name: The name of the IAM execution role to use to create the
|
|
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
|
|
9217
|
-
:param operation_preferences: The user-specified preferences for how CloudFormation performs a
|
|
9218
|
-
:param parameters: The input parameters for the
|
|
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
|
|
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
|
|
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
|
|
9349
|
+
'''The name to associate with the StackSet.
|
|
9350
9350
|
|
|
9351
|
-
The name must be unique in the Region where you create your
|
|
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
|
|
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
|
|
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
|
|
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
|
|
9393
|
+
By default, ``SELF`` is specified. Use ``SELF`` for StackSets with self-managed permissions.
|
|
9394
9394
|
|
|
9395
|
-
- To create a
|
|
9396
|
-
- To create a
|
|
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
|
-
|
|
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
|
|
9411
|
+
'''The capabilities that are allowed in the StackSet.
|
|
9412
9412
|
|
|
9413
|
-
Some
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
'''
|
|
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
|
-
|
|
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:
|
|
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:
|
|
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
|
-
'''
|
|
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
|
-
'''
|
|
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
|
-
#
|
|
24894
|
+
# resource: SomeScalableResource
|
|
24841
24895
|
|
|
24842
|
-
|
|
24843
|
-
|
|
24844
|
-
|
|
24845
|
-
|
|
24846
|
-
|
|
24847
|
-
|
|
24848
|
-
|
|
24849
|
-
|
|
24850
|
-
|
|
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
|
|
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
|
|
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/
|
|
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
|
|
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
|
|
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
|
|
33585
|
+
'''The ``AWS::CloudFormation::StackSet`` resource contains information about a StackSet.
|
|
33524
33586
|
|
|
33525
|
-
|
|
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
|
|
33619
|
-
:param stack_set_name: The name to associate with the
|
|
33620
|
-
:param administration_role_arn: The Amazon Resource Number (ARN) of the IAM role to use to create this
|
|
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
|
|
33623
|
-
:param capabilities: The capabilities that are allowed in the
|
|
33624
|
-
:param description: A description of the
|
|
33625
|
-
:param execution_role_name: The name of the IAM execution role to use to create the
|
|
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
|
|
33627
|
-
:param operation_preferences: The user-specified preferences for how CloudFormation performs a
|
|
33628
|
-
:param parameters: The input parameters for the
|
|
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
|
-
'''
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 `
|
|
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
|
|
34215
|
-
:param failure_tolerance_count: The number of accounts
|
|
34216
|
-
:param failure_tolerance_percentage: The percentage of accounts
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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/
|
|
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
|
-
'''
|
|
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,
|