aws-cdk-lib 2.182.0__py3-none-any.whl → 2.183.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 +459 -33
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.182.0.jsii.tgz → aws-cdk-lib@2.183.0.jsii.tgz} +0 -0
- aws_cdk/aws_batch/__init__.py +15 -9
- aws_cdk/aws_bedrock/__init__.py +5804 -2325
- aws_cdk/aws_ce/__init__.py +141 -3
- aws_cdk/aws_cloudformation/__init__.py +26 -33
- aws_cdk/aws_cloudtrail/__init__.py +4 -4
- aws_cdk/aws_codebuild/__init__.py +4 -10
- aws_cdk/aws_cognito/__init__.py +3 -3
- aws_cdk/aws_dms/__init__.py +350 -0
- aws_cdk/aws_ec2/__init__.py +63 -5
- aws_cdk/aws_elasticache/__init__.py +3 -3
- aws_cdk/aws_emr/__init__.py +9 -3
- aws_cdk/aws_gameliftstreams/__init__.py +1205 -0
- aws_cdk/aws_iam/__init__.py +290 -35
- aws_cdk/aws_inspector/__init__.py +13 -10
- aws_cdk/aws_iot/__init__.py +616 -22
- aws_cdk/aws_iotfleetwise/__init__.py +72 -10
- aws_cdk/aws_iotsitewise/__init__.py +12 -8
- aws_cdk/aws_kafkaconnect/__init__.py +4 -2
- aws_cdk/aws_lambda/__init__.py +9 -0
- aws_cdk/aws_logs/__init__.py +133 -0
- aws_cdk/aws_medialive/__init__.py +86 -86
- aws_cdk/aws_msk/__init__.py +236 -128
- aws_cdk/aws_neptunegraph/__init__.py +3 -3
- aws_cdk/aws_opensearchserverless/__init__.py +1031 -0
- aws_cdk/aws_quicksight/__init__.py +6511 -20331
- aws_cdk/aws_rds/__init__.py +124 -17
- aws_cdk/aws_redshift/__init__.py +8 -8
- aws_cdk/aws_sagemaker/__init__.py +12 -5
- aws_cdk/aws_securitylake/__init__.py +3 -0
- aws_cdk/aws_synthetics/__init__.py +2 -0
- aws_cdk/aws_transfer/__init__.py +241 -40
- aws_cdk/aws_wafv2/__init__.py +118 -30
- aws_cdk/aws_xray/__init__.py +195 -0
- aws_cdk/custom_resources/__init__.py +65 -8
- {aws_cdk_lib-2.182.0.dist-info → aws_cdk_lib-2.183.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.182.0.dist-info → aws_cdk_lib-2.183.0.dist-info}/RECORD +43 -42
- {aws_cdk_lib-2.182.0.dist-info → aws_cdk_lib-2.183.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.182.0.dist-info → aws_cdk_lib-2.183.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.182.0.dist-info → aws_cdk_lib-2.183.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.182.0.dist-info → aws_cdk_lib-2.183.0.dist-info}/top_level.txt +0 -0
aws_cdk/__init__.py
CHANGED
|
@@ -8856,7 +8856,7 @@ class CfnStackProps:
|
|
|
8856
8856
|
'''Properties for defining a ``CfnStack``.
|
|
8857
8857
|
|
|
8858
8858
|
:param notification_arns: The Amazon SNS topic ARNs to publish stack related events. You can find your Amazon SNS topic ARNs using the Amazon SNS console or your Command Line Interface (CLI).
|
|
8859
|
-
:param parameters: The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created. Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter. .. epigraph:: If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks.
|
|
8859
|
+
:param parameters: The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created. Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter. .. epigraph:: If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks. Required if the nested stack requires input parameters. Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
|
|
8860
8860
|
:param tags: Key-value pairs to associate with this stack. CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 50 tags can be specified.
|
|
8861
8861
|
:param template_url: The URL of a file containing the template body. The URL must point to a template (max size: 1 MB) that's located in an Amazon S3 bucket. The location for an Amazon S3 bucket must start with ``https://`` . Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
|
|
8862
8862
|
:param timeout_in_minutes: The length of time, in minutes, that CloudFormation waits for the nested stack to reach the ``CREATE_COMPLETE`` state. The default is no timeout. When CloudFormation detects that the nested stack has reached the ``CREATE_COMPLETE`` state, it marks the nested stack resource as ``CREATE_COMPLETE`` in the parent stack and resumes creating the parent stack. If the timeout period expires before the nested stack reaches ``CREATE_COMPLETE`` , CloudFormation marks the nested stack as failed and rolls back both the nested stack and parent stack. Updates aren't supported.
|
|
@@ -8924,7 +8924,7 @@ class CfnStackProps:
|
|
|
8924
8924
|
|
|
8925
8925
|
If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks.
|
|
8926
8926
|
|
|
8927
|
-
|
|
8927
|
+
Required if the nested stack requires input parameters.
|
|
8928
8928
|
|
|
8929
8929
|
Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
|
|
8930
8930
|
|
|
@@ -9026,13 +9026,13 @@ class CfnStackSetProps:
|
|
|
9026
9026
|
'''Properties for defining a ``CfnStackSet``.
|
|
9027
9027
|
|
|
9028
9028
|
: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* .
|
|
9029
|
-
: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.
|
|
9030
|
-
: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* .
|
|
9031
|
-
:param auto_deployment:
|
|
9032
|
-
:param call_as:
|
|
9029
|
+
: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.
|
|
9030
|
+
: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`` .
|
|
9031
|
+
: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 `Manage automatic deployments for CloudFormation StackSets that use service-managed permissions <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.)
|
|
9032
|
+
: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`` .
|
|
9033
9033
|
: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* .
|
|
9034
|
-
:param description: A description of the stack set.
|
|
9035
|
-
: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.
|
|
9034
|
+
:param description: A description of the stack set.
|
|
9035
|
+
: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+=,.@-]+``
|
|
9036
9036
|
: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.
|
|
9037
9037
|
:param operation_preferences: The user-specified preferences for how CloudFormation performs a stack set operation.
|
|
9038
9038
|
:param parameters: The input parameters for the stack set template.
|
|
@@ -9169,9 +9169,6 @@ class CfnStackSetProps:
|
|
|
9169
9169
|
'''The name to associate with the stack set.
|
|
9170
9170
|
|
|
9171
9171
|
The name must be unique in the Region where you create your stack set.
|
|
9172
|
-
.. epigraph::
|
|
9173
|
-
|
|
9174
|
-
The ``StackSetName`` property is required.
|
|
9175
9172
|
|
|
9176
9173
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-stacksetname
|
|
9177
9174
|
'''
|
|
@@ -9187,9 +9184,7 @@ class CfnStackSetProps:
|
|
|
9187
9184
|
|
|
9188
9185
|
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* .
|
|
9189
9186
|
|
|
9190
|
-
|
|
9191
|
-
|
|
9192
|
-
*Maximum* : ``2048``
|
|
9187
|
+
Valid only if the permissions model is ``SELF_MANAGED`` .
|
|
9193
9188
|
|
|
9194
9189
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-administrationrolearn
|
|
9195
9190
|
'''
|
|
@@ -9200,7 +9195,11 @@ class CfnStackSetProps:
|
|
|
9200
9195
|
def auto_deployment(
|
|
9201
9196
|
self,
|
|
9202
9197
|
) -> typing.Optional[typing.Union["IResolvable", "CfnStackSet.AutoDeploymentProperty"]]:
|
|
9203
|
-
'''
|
|
9198
|
+
'''Describes whether StackSets automatically deploys to AWS Organizations accounts that are added to a target organization or organizational unit (OU).
|
|
9199
|
+
|
|
9200
|
+
For more information, see `Manage automatic deployments for CloudFormation StackSets that use service-managed permissions <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-manage-auto-deployment.html>`_ in the *AWS CloudFormation User Guide* .
|
|
9201
|
+
|
|
9202
|
+
Required if the permissions model is ``SERVICE_MANAGED`` . (Not used with self-managed permissions.)
|
|
9204
9203
|
|
|
9205
9204
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-autodeployment
|
|
9206
9205
|
'''
|
|
@@ -9209,7 +9208,7 @@ class CfnStackSetProps:
|
|
|
9209
9208
|
|
|
9210
9209
|
@builtins.property
|
|
9211
9210
|
def call_as(self) -> typing.Optional[builtins.str]:
|
|
9212
|
-
'''
|
|
9211
|
+
'''Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.
|
|
9213
9212
|
|
|
9214
9213
|
By default, ``SELF`` is specified. Use ``SELF`` for stack sets with self-managed permissions.
|
|
9215
9214
|
|
|
@@ -9220,7 +9219,7 @@ class CfnStackSetProps:
|
|
|
9220
9219
|
|
|
9221
9220
|
Stack sets with service-managed permissions are created in the management account, including stack sets that are created by delegated administrators.
|
|
9222
9221
|
|
|
9223
|
-
|
|
9222
|
+
Valid only if the permissions model is ``SERVICE_MANAGED`` .
|
|
9224
9223
|
|
|
9225
9224
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-callas
|
|
9226
9225
|
'''
|
|
@@ -9242,10 +9241,6 @@ class CfnStackSetProps:
|
|
|
9242
9241
|
def description(self) -> typing.Optional[builtins.str]:
|
|
9243
9242
|
'''A description of the stack set.
|
|
9244
9243
|
|
|
9245
|
-
*Minimum* : ``1``
|
|
9246
|
-
|
|
9247
|
-
*Maximum* : ``1024``
|
|
9248
|
-
|
|
9249
9244
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stackset.html#cfn-cloudformation-stackset-description
|
|
9250
9245
|
'''
|
|
9251
9246
|
result = self._values.get("description")
|
|
@@ -9257,9 +9252,7 @@ class CfnStackSetProps:
|
|
|
9257
9252
|
|
|
9258
9253
|
If you don't specify an execution role, CloudFormation uses the ``AWSCloudFormationStackSetExecutionRole`` role for the stack set operation.
|
|
9259
9254
|
|
|
9260
|
-
|
|
9261
|
-
|
|
9262
|
-
*Maximum* : ``64``
|
|
9255
|
+
Valid only if the permissions model is ``SELF_MANAGED`` .
|
|
9263
9256
|
|
|
9264
9257
|
*Pattern* : ``[a-zA-Z_0-9+=,.@-]+``
|
|
9265
9258
|
|
|
@@ -18170,6 +18163,151 @@ class LazyStringValueOptions:
|
|
|
18170
18163
|
)
|
|
18171
18164
|
|
|
18172
18165
|
|
|
18166
|
+
class MissingRemovalPolicies(
|
|
18167
|
+
metaclass=jsii.JSIIMeta,
|
|
18168
|
+
jsii_type="aws-cdk-lib.MissingRemovalPolicies",
|
|
18169
|
+
):
|
|
18170
|
+
'''Manages removal policies for resources without existing policies within a construct scope.
|
|
18171
|
+
|
|
18172
|
+
:exampleMetadata: fixture=_generated
|
|
18173
|
+
|
|
18174
|
+
Example::
|
|
18175
|
+
|
|
18176
|
+
# The code below shows an example of how to instantiate this type.
|
|
18177
|
+
# The values are placeholders you should change.
|
|
18178
|
+
import aws_cdk as cdk
|
|
18179
|
+
|
|
18180
|
+
missing_removal_policies = cdk.MissingRemovalPolicies.of(self)
|
|
18181
|
+
'''
|
|
18182
|
+
|
|
18183
|
+
@jsii.member(jsii_name="of")
|
|
18184
|
+
@builtins.classmethod
|
|
18185
|
+
def of(cls, scope: _constructs_77d1e7e8.IConstruct) -> "MissingRemovalPolicies":
|
|
18186
|
+
'''Returns the missing removal policies API for the given scope.
|
|
18187
|
+
|
|
18188
|
+
:param scope: The scope.
|
|
18189
|
+
'''
|
|
18190
|
+
if __debug__:
|
|
18191
|
+
type_hints = typing.get_type_hints(_typecheckingstub__53b49b542fe09ce9b0aa527b531ee0b1e7f57e7e0c6e23c2483a0b347d813ebb)
|
|
18192
|
+
check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
|
|
18193
|
+
return typing.cast("MissingRemovalPolicies", jsii.sinvoke(cls, "of", [scope]))
|
|
18194
|
+
|
|
18195
|
+
@jsii.member(jsii_name="apply")
|
|
18196
|
+
def apply(
|
|
18197
|
+
self,
|
|
18198
|
+
policy: "RemovalPolicy",
|
|
18199
|
+
*,
|
|
18200
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18201
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18202
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
18203
|
+
) -> None:
|
|
18204
|
+
'''Apply a removal policy only to resources without existing policies within this scope.
|
|
18205
|
+
|
|
18206
|
+
:param policy: The removal policy to apply.
|
|
18207
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
18208
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
18209
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
18210
|
+
'''
|
|
18211
|
+
if __debug__:
|
|
18212
|
+
type_hints = typing.get_type_hints(_typecheckingstub__b3f1229a84cb5fdb052e8db135be3d25670d9793cf44ddc71d8134240bed0efc)
|
|
18213
|
+
check_type(argname="argument policy", value=policy, expected_type=type_hints["policy"])
|
|
18214
|
+
props = RemovalPolicyProps(
|
|
18215
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
18216
|
+
exclude_resource_types=exclude_resource_types,
|
|
18217
|
+
priority=priority,
|
|
18218
|
+
)
|
|
18219
|
+
|
|
18220
|
+
return typing.cast(None, jsii.invoke(self, "apply", [policy, props]))
|
|
18221
|
+
|
|
18222
|
+
@jsii.member(jsii_name="destroy")
|
|
18223
|
+
def destroy(
|
|
18224
|
+
self,
|
|
18225
|
+
*,
|
|
18226
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18227
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18228
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
18229
|
+
) -> None:
|
|
18230
|
+
'''Apply DESTROY removal policy only to resources without existing policies within this scope.
|
|
18231
|
+
|
|
18232
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
18233
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
18234
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
18235
|
+
'''
|
|
18236
|
+
props = RemovalPolicyProps(
|
|
18237
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
18238
|
+
exclude_resource_types=exclude_resource_types,
|
|
18239
|
+
priority=priority,
|
|
18240
|
+
)
|
|
18241
|
+
|
|
18242
|
+
return typing.cast(None, jsii.invoke(self, "destroy", [props]))
|
|
18243
|
+
|
|
18244
|
+
@jsii.member(jsii_name="retain")
|
|
18245
|
+
def retain(
|
|
18246
|
+
self,
|
|
18247
|
+
*,
|
|
18248
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18249
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18250
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
18251
|
+
) -> None:
|
|
18252
|
+
'''Apply RETAIN removal policy only to resources without existing policies within this scope.
|
|
18253
|
+
|
|
18254
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
18255
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
18256
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
18257
|
+
'''
|
|
18258
|
+
props = RemovalPolicyProps(
|
|
18259
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
18260
|
+
exclude_resource_types=exclude_resource_types,
|
|
18261
|
+
priority=priority,
|
|
18262
|
+
)
|
|
18263
|
+
|
|
18264
|
+
return typing.cast(None, jsii.invoke(self, "retain", [props]))
|
|
18265
|
+
|
|
18266
|
+
@jsii.member(jsii_name="retainOnUpdateOrDelete")
|
|
18267
|
+
def retain_on_update_or_delete(
|
|
18268
|
+
self,
|
|
18269
|
+
*,
|
|
18270
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18271
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18272
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
18273
|
+
) -> None:
|
|
18274
|
+
'''Apply RETAIN_ON_UPDATE_OR_DELETE removal policy only to resources without existing policies within this scope.
|
|
18275
|
+
|
|
18276
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
18277
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
18278
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
18279
|
+
'''
|
|
18280
|
+
props = RemovalPolicyProps(
|
|
18281
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
18282
|
+
exclude_resource_types=exclude_resource_types,
|
|
18283
|
+
priority=priority,
|
|
18284
|
+
)
|
|
18285
|
+
|
|
18286
|
+
return typing.cast(None, jsii.invoke(self, "retainOnUpdateOrDelete", [props]))
|
|
18287
|
+
|
|
18288
|
+
@jsii.member(jsii_name="snapshot")
|
|
18289
|
+
def snapshot(
|
|
18290
|
+
self,
|
|
18291
|
+
*,
|
|
18292
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18293
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
18294
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
18295
|
+
) -> None:
|
|
18296
|
+
'''Apply SNAPSHOT removal policy only to resources without existing policies within this scope.
|
|
18297
|
+
|
|
18298
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
18299
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
18300
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
18301
|
+
'''
|
|
18302
|
+
props = RemovalPolicyProps(
|
|
18303
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
18304
|
+
exclude_resource_types=exclude_resource_types,
|
|
18305
|
+
priority=priority,
|
|
18306
|
+
)
|
|
18307
|
+
|
|
18308
|
+
return typing.cast(None, jsii.invoke(self, "snapshot", [props]))
|
|
18309
|
+
|
|
18310
|
+
|
|
18173
18311
|
class Names(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.Names"):
|
|
18174
18312
|
'''Functions for devising unique names for constructs.
|
|
18175
18313
|
|
|
@@ -19046,6 +19184,148 @@ class _ReferenceProxy(Reference):
|
|
|
19046
19184
|
typing.cast(typing.Any, Reference).__jsii_proxy_class__ = lambda : _ReferenceProxy
|
|
19047
19185
|
|
|
19048
19186
|
|
|
19187
|
+
class RemovalPolicies(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.RemovalPolicies"):
|
|
19188
|
+
'''Manages removal policies for all resources within a construct scope, overriding any existing policies by default.
|
|
19189
|
+
|
|
19190
|
+
:exampleMetadata: fixture=_generated
|
|
19191
|
+
|
|
19192
|
+
Example::
|
|
19193
|
+
|
|
19194
|
+
# The code below shows an example of how to instantiate this type.
|
|
19195
|
+
# The values are placeholders you should change.
|
|
19196
|
+
import aws_cdk as cdk
|
|
19197
|
+
|
|
19198
|
+
removal_policies = cdk.RemovalPolicies.of(self)
|
|
19199
|
+
'''
|
|
19200
|
+
|
|
19201
|
+
@jsii.member(jsii_name="of")
|
|
19202
|
+
@builtins.classmethod
|
|
19203
|
+
def of(cls, scope: _constructs_77d1e7e8.IConstruct) -> "RemovalPolicies":
|
|
19204
|
+
'''Returns the removal policies API for the given scope.
|
|
19205
|
+
|
|
19206
|
+
:param scope: The scope.
|
|
19207
|
+
'''
|
|
19208
|
+
if __debug__:
|
|
19209
|
+
type_hints = typing.get_type_hints(_typecheckingstub__16fdd678fafc26c9e1ca2d269cac449744dcfd65a4b8fce227879a53407f64f2)
|
|
19210
|
+
check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
|
|
19211
|
+
return typing.cast("RemovalPolicies", jsii.sinvoke(cls, "of", [scope]))
|
|
19212
|
+
|
|
19213
|
+
@jsii.member(jsii_name="apply")
|
|
19214
|
+
def apply(
|
|
19215
|
+
self,
|
|
19216
|
+
policy: "RemovalPolicy",
|
|
19217
|
+
*,
|
|
19218
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19219
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19220
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
19221
|
+
) -> None:
|
|
19222
|
+
'''Apply a removal policy to all resources within this scope, overriding any existing policies.
|
|
19223
|
+
|
|
19224
|
+
:param policy: The removal policy to apply.
|
|
19225
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
19226
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
19227
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
19228
|
+
'''
|
|
19229
|
+
if __debug__:
|
|
19230
|
+
type_hints = typing.get_type_hints(_typecheckingstub__d1a6f380a312346d77f5859f328e14cef3d77e7eb99ba0dffc2dd7da58b9b0ca)
|
|
19231
|
+
check_type(argname="argument policy", value=policy, expected_type=type_hints["policy"])
|
|
19232
|
+
props = RemovalPolicyProps(
|
|
19233
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
19234
|
+
exclude_resource_types=exclude_resource_types,
|
|
19235
|
+
priority=priority,
|
|
19236
|
+
)
|
|
19237
|
+
|
|
19238
|
+
return typing.cast(None, jsii.invoke(self, "apply", [policy, props]))
|
|
19239
|
+
|
|
19240
|
+
@jsii.member(jsii_name="destroy")
|
|
19241
|
+
def destroy(
|
|
19242
|
+
self,
|
|
19243
|
+
*,
|
|
19244
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19245
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19246
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
19247
|
+
) -> None:
|
|
19248
|
+
'''Apply DESTROY removal policy to all resources within this scope.
|
|
19249
|
+
|
|
19250
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
19251
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
19252
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
19253
|
+
'''
|
|
19254
|
+
props = RemovalPolicyProps(
|
|
19255
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
19256
|
+
exclude_resource_types=exclude_resource_types,
|
|
19257
|
+
priority=priority,
|
|
19258
|
+
)
|
|
19259
|
+
|
|
19260
|
+
return typing.cast(None, jsii.invoke(self, "destroy", [props]))
|
|
19261
|
+
|
|
19262
|
+
@jsii.member(jsii_name="retain")
|
|
19263
|
+
def retain(
|
|
19264
|
+
self,
|
|
19265
|
+
*,
|
|
19266
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19267
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19268
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
19269
|
+
) -> None:
|
|
19270
|
+
'''Apply RETAIN removal policy to all resources within this scope.
|
|
19271
|
+
|
|
19272
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
19273
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
19274
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
19275
|
+
'''
|
|
19276
|
+
props = RemovalPolicyProps(
|
|
19277
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
19278
|
+
exclude_resource_types=exclude_resource_types,
|
|
19279
|
+
priority=priority,
|
|
19280
|
+
)
|
|
19281
|
+
|
|
19282
|
+
return typing.cast(None, jsii.invoke(self, "retain", [props]))
|
|
19283
|
+
|
|
19284
|
+
@jsii.member(jsii_name="retainOnUpdateOrDelete")
|
|
19285
|
+
def retain_on_update_or_delete(
|
|
19286
|
+
self,
|
|
19287
|
+
*,
|
|
19288
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19289
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19290
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
19291
|
+
) -> None:
|
|
19292
|
+
'''Apply RETAIN_ON_UPDATE_OR_DELETE removal policy to all resources within this scope.
|
|
19293
|
+
|
|
19294
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
19295
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
19296
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
19297
|
+
'''
|
|
19298
|
+
props = RemovalPolicyProps(
|
|
19299
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
19300
|
+
exclude_resource_types=exclude_resource_types,
|
|
19301
|
+
priority=priority,
|
|
19302
|
+
)
|
|
19303
|
+
|
|
19304
|
+
return typing.cast(None, jsii.invoke(self, "retainOnUpdateOrDelete", [props]))
|
|
19305
|
+
|
|
19306
|
+
@jsii.member(jsii_name="snapshot")
|
|
19307
|
+
def snapshot(
|
|
19308
|
+
self,
|
|
19309
|
+
*,
|
|
19310
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19311
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19312
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
19313
|
+
) -> None:
|
|
19314
|
+
'''Apply SNAPSHOT removal policy to all resources within this scope.
|
|
19315
|
+
|
|
19316
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
19317
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
19318
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
19319
|
+
'''
|
|
19320
|
+
props = RemovalPolicyProps(
|
|
19321
|
+
apply_to_resource_types=apply_to_resource_types,
|
|
19322
|
+
exclude_resource_types=exclude_resource_types,
|
|
19323
|
+
priority=priority,
|
|
19324
|
+
)
|
|
19325
|
+
|
|
19326
|
+
return typing.cast(None, jsii.invoke(self, "snapshot", [props]))
|
|
19327
|
+
|
|
19328
|
+
|
|
19049
19329
|
@jsii.enum(jsii_type="aws-cdk-lib.RemovalPolicy")
|
|
19050
19330
|
class RemovalPolicy(enum.Enum):
|
|
19051
19331
|
'''Possible values for a resource's Removal Policy.
|
|
@@ -19221,6 +19501,106 @@ class RemovalPolicyOptions:
|
|
|
19221
19501
|
)
|
|
19222
19502
|
|
|
19223
19503
|
|
|
19504
|
+
@jsii.data_type(
|
|
19505
|
+
jsii_type="aws-cdk-lib.RemovalPolicyProps",
|
|
19506
|
+
jsii_struct_bases=[],
|
|
19507
|
+
name_mapping={
|
|
19508
|
+
"apply_to_resource_types": "applyToResourceTypes",
|
|
19509
|
+
"exclude_resource_types": "excludeResourceTypes",
|
|
19510
|
+
"priority": "priority",
|
|
19511
|
+
},
|
|
19512
|
+
)
|
|
19513
|
+
class RemovalPolicyProps:
|
|
19514
|
+
def __init__(
|
|
19515
|
+
self,
|
|
19516
|
+
*,
|
|
19517
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19518
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
19519
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
19520
|
+
) -> None:
|
|
19521
|
+
'''Properties for applying a removal policy.
|
|
19522
|
+
|
|
19523
|
+
:param apply_to_resource_types: Apply the removal policy only to specific resource types. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - apply to all resources
|
|
19524
|
+
:param exclude_resource_types: Exclude specific resource types from the removal policy. Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket'). Default: - no exclusions
|
|
19525
|
+
:param priority: The priority to use when applying this policy. The priority affects only the order in which aspects are applied during synthesis. For RemovalPolicies, the last applied policy will override previous ones. NOTE: Priority does NOT determine which policy "wins" when there are conflicts. The order of application determines the final policy, with later policies overriding earlier ones. Default: - AspectPriority.MUTATING
|
|
19526
|
+
|
|
19527
|
+
:exampleMetadata: fixture=_generated
|
|
19528
|
+
|
|
19529
|
+
Example::
|
|
19530
|
+
|
|
19531
|
+
# The code below shows an example of how to instantiate this type.
|
|
19532
|
+
# The values are placeholders you should change.
|
|
19533
|
+
import aws_cdk as cdk
|
|
19534
|
+
|
|
19535
|
+
removal_policy_props = cdk.RemovalPolicyProps(
|
|
19536
|
+
apply_to_resource_types=["applyToResourceTypes"],
|
|
19537
|
+
exclude_resource_types=["excludeResourceTypes"],
|
|
19538
|
+
priority=123
|
|
19539
|
+
)
|
|
19540
|
+
'''
|
|
19541
|
+
if __debug__:
|
|
19542
|
+
type_hints = typing.get_type_hints(_typecheckingstub__c5c7fd6f5b115619c0c625e32cc15eb9bdbfb4931f25b97d8db03b7037bf1a39)
|
|
19543
|
+
check_type(argname="argument apply_to_resource_types", value=apply_to_resource_types, expected_type=type_hints["apply_to_resource_types"])
|
|
19544
|
+
check_type(argname="argument exclude_resource_types", value=exclude_resource_types, expected_type=type_hints["exclude_resource_types"])
|
|
19545
|
+
check_type(argname="argument priority", value=priority, expected_type=type_hints["priority"])
|
|
19546
|
+
self._values: typing.Dict[builtins.str, typing.Any] = {}
|
|
19547
|
+
if apply_to_resource_types is not None:
|
|
19548
|
+
self._values["apply_to_resource_types"] = apply_to_resource_types
|
|
19549
|
+
if exclude_resource_types is not None:
|
|
19550
|
+
self._values["exclude_resource_types"] = exclude_resource_types
|
|
19551
|
+
if priority is not None:
|
|
19552
|
+
self._values["priority"] = priority
|
|
19553
|
+
|
|
19554
|
+
@builtins.property
|
|
19555
|
+
def apply_to_resource_types(self) -> typing.Optional[typing.List[builtins.str]]:
|
|
19556
|
+
'''Apply the removal policy only to specific resource types.
|
|
19557
|
+
|
|
19558
|
+
Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket').
|
|
19559
|
+
|
|
19560
|
+
:default: - apply to all resources
|
|
19561
|
+
'''
|
|
19562
|
+
result = self._values.get("apply_to_resource_types")
|
|
19563
|
+
return typing.cast(typing.Optional[typing.List[builtins.str]], result)
|
|
19564
|
+
|
|
19565
|
+
@builtins.property
|
|
19566
|
+
def exclude_resource_types(self) -> typing.Optional[typing.List[builtins.str]]:
|
|
19567
|
+
'''Exclude specific resource types from the removal policy.
|
|
19568
|
+
|
|
19569
|
+
Can be a CloudFormation resource type string (e.g., 'AWS::S3::Bucket').
|
|
19570
|
+
|
|
19571
|
+
:default: - no exclusions
|
|
19572
|
+
'''
|
|
19573
|
+
result = self._values.get("exclude_resource_types")
|
|
19574
|
+
return typing.cast(typing.Optional[typing.List[builtins.str]], result)
|
|
19575
|
+
|
|
19576
|
+
@builtins.property
|
|
19577
|
+
def priority(self) -> typing.Optional[jsii.Number]:
|
|
19578
|
+
'''The priority to use when applying this policy.
|
|
19579
|
+
|
|
19580
|
+
The priority affects only the order in which aspects are applied during synthesis.
|
|
19581
|
+
For RemovalPolicies, the last applied policy will override previous ones.
|
|
19582
|
+
|
|
19583
|
+
NOTE: Priority does NOT determine which policy "wins" when there are conflicts.
|
|
19584
|
+
The order of application determines the final policy, with later policies
|
|
19585
|
+
overriding earlier ones.
|
|
19586
|
+
|
|
19587
|
+
:default: - AspectPriority.MUTATING
|
|
19588
|
+
'''
|
|
19589
|
+
result = self._values.get("priority")
|
|
19590
|
+
return typing.cast(typing.Optional[jsii.Number], result)
|
|
19591
|
+
|
|
19592
|
+
def __eq__(self, rhs: typing.Any) -> builtins.bool:
|
|
19593
|
+
return isinstance(rhs, self.__class__) and rhs._values == self._values
|
|
19594
|
+
|
|
19595
|
+
def __ne__(self, rhs: typing.Any) -> builtins.bool:
|
|
19596
|
+
return not (rhs == self)
|
|
19597
|
+
|
|
19598
|
+
def __repr__(self) -> str:
|
|
19599
|
+
return "RemovalPolicyProps(%s)" % ", ".join(
|
|
19600
|
+
k + "=" + repr(v) for k, v in self._values.items()
|
|
19601
|
+
)
|
|
19602
|
+
|
|
19603
|
+
|
|
19224
19604
|
@jsii.implements(IAspect)
|
|
19225
19605
|
class RemoveTag(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.RemoveTag"):
|
|
19226
19606
|
'''The RemoveTag Aspect will handle removing tags from this node and children.
|
|
@@ -32160,7 +32540,7 @@ class CfnStack(CfnResource, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.CfnS
|
|
|
32160
32540
|
:param scope: Scope in which this resource is defined.
|
|
32161
32541
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
32162
32542
|
:param notification_arns: The Amazon SNS topic ARNs to publish stack related events. You can find your Amazon SNS topic ARNs using the Amazon SNS console or your Command Line Interface (CLI).
|
|
32163
|
-
:param parameters: The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created. Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter. .. epigraph:: If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks.
|
|
32543
|
+
:param parameters: The set value pairs that represent the parameters passed to CloudFormation when this nested stack is created. Each parameter has a name corresponding to a parameter defined in the embedded template and a value representing the value that you want to set for the parameter. .. epigraph:: If you use the ``Ref`` function to pass a parameter value to a nested stack, comma-delimited list parameters must be of type ``String`` . In other words, you can't pass values that are of type ``CommaDelimitedList`` to nested stacks. Required if the nested stack requires input parameters. Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
|
|
32164
32544
|
:param tags: Key-value pairs to associate with this stack. CloudFormation also propagates these tags to the resources created in the stack. A maximum number of 50 tags can be specified.
|
|
32165
32545
|
:param template_url: The URL of a file containing the template body. The URL must point to a template (max size: 1 MB) that's located in an Amazon S3 bucket. The location for an Amazon S3 bucket must start with ``https://`` . Whether an update causes interruptions depends on the resources that are being updated. An update never causes a nested stack to be replaced.
|
|
32166
32546
|
:param timeout_in_minutes: The length of time, in minutes, that CloudFormation waits for the nested stack to reach the ``CREATE_COMPLETE`` state. The default is no timeout. When CloudFormation detects that the nested stack has reached the ``CREATE_COMPLETE`` state, it marks the nested stack resource as ``CREATE_COMPLETE`` in the parent stack and resumes creating the parent stack. If the timeout period expires before the nested stack reaches ``CREATE_COMPLETE`` , CloudFormation marks the nested stack as failed and rolls back both the nested stack and parent stack. Updates aren't supported.
|
|
@@ -32577,13 +32957,13 @@ class CfnStackSet(
|
|
|
32577
32957
|
:param scope: Scope in which this resource is defined.
|
|
32578
32958
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
32579
32959
|
: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* .
|
|
32580
|
-
: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.
|
|
32581
|
-
: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* .
|
|
32582
|
-
:param auto_deployment:
|
|
32583
|
-
:param call_as:
|
|
32960
|
+
: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.
|
|
32961
|
+
: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`` .
|
|
32962
|
+
: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 `Manage automatic deployments for CloudFormation StackSets that use service-managed permissions <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.)
|
|
32963
|
+
: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`` .
|
|
32584
32964
|
: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* .
|
|
32585
|
-
:param description: A description of the stack set.
|
|
32586
|
-
: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.
|
|
32965
|
+
:param description: A description of the stack set.
|
|
32966
|
+
: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+=,.@-]+``
|
|
32587
32967
|
: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.
|
|
32588
32968
|
:param operation_preferences: The user-specified preferences for how CloudFormation performs a stack set operation.
|
|
32589
32969
|
:param parameters: The input parameters for the stack set template.
|
|
@@ -32710,7 +33090,7 @@ class CfnStackSet(
|
|
|
32710
33090
|
def auto_deployment(
|
|
32711
33091
|
self,
|
|
32712
33092
|
) -> typing.Optional[typing.Union[IResolvable, "CfnStackSet.AutoDeploymentProperty"]]:
|
|
32713
|
-
'''
|
|
33093
|
+
'''Describes whether StackSets automatically deploys to AWS Organizations accounts that are added to a target organization or organizational unit (OU).'''
|
|
32714
33094
|
return typing.cast(typing.Optional[typing.Union[IResolvable, "CfnStackSet.AutoDeploymentProperty"]], jsii.get(self, "autoDeployment"))
|
|
32715
33095
|
|
|
32716
33096
|
@auto_deployment.setter
|
|
@@ -32726,7 +33106,7 @@ class CfnStackSet(
|
|
|
32726
33106
|
@builtins.property
|
|
32727
33107
|
@jsii.member(jsii_name="callAs")
|
|
32728
33108
|
def call_as(self) -> typing.Optional[builtins.str]:
|
|
32729
|
-
'''
|
|
33109
|
+
'''Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.'''
|
|
32730
33110
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "callAs"))
|
|
32731
33111
|
|
|
32732
33112
|
@call_as.setter
|
|
@@ -36556,6 +36936,7 @@ __all__ = [
|
|
|
36556
36936
|
"LazyListValueOptions",
|
|
36557
36937
|
"LazyStringValueOptions",
|
|
36558
36938
|
"LegacyStackSynthesizer",
|
|
36939
|
+
"MissingRemovalPolicies",
|
|
36559
36940
|
"Names",
|
|
36560
36941
|
"NestedStack",
|
|
36561
36942
|
"NestedStackProps",
|
|
@@ -36568,8 +36949,10 @@ __all__ = [
|
|
|
36568
36949
|
"PolicyViolatingResourceBeta1",
|
|
36569
36950
|
"PolicyViolationBeta1",
|
|
36570
36951
|
"Reference",
|
|
36952
|
+
"RemovalPolicies",
|
|
36571
36953
|
"RemovalPolicy",
|
|
36572
36954
|
"RemovalPolicyOptions",
|
|
36955
|
+
"RemovalPolicyProps",
|
|
36573
36956
|
"RemoveTag",
|
|
36574
36957
|
"ResolutionTypeHint",
|
|
36575
36958
|
"ResolveChangeContextOptions",
|
|
@@ -36726,6 +37109,7 @@ __all__ = [
|
|
|
36726
37109
|
"aws_frauddetector",
|
|
36727
37110
|
"aws_fsx",
|
|
36728
37111
|
"aws_gamelift",
|
|
37112
|
+
"aws_gameliftstreams",
|
|
36729
37113
|
"aws_globalaccelerator",
|
|
36730
37114
|
"aws_globalaccelerator_endpoints",
|
|
36731
37115
|
"aws_glue",
|
|
@@ -37019,6 +37403,7 @@ from . import aws_forecast
|
|
|
37019
37403
|
from . import aws_frauddetector
|
|
37020
37404
|
from . import aws_fsx
|
|
37021
37405
|
from . import aws_gamelift
|
|
37406
|
+
from . import aws_gameliftstreams
|
|
37022
37407
|
from . import aws_globalaccelerator
|
|
37023
37408
|
from . import aws_globalaccelerator_endpoints
|
|
37024
37409
|
from . import aws_glue
|
|
@@ -39297,6 +39682,22 @@ def _typecheckingstub__283fa3218deb31c702af8ec0f581964e58afe471191dd394e1567cb4d
|
|
|
39297
39682
|
"""Type checking stubs"""
|
|
39298
39683
|
pass
|
|
39299
39684
|
|
|
39685
|
+
def _typecheckingstub__53b49b542fe09ce9b0aa527b531ee0b1e7f57e7e0c6e23c2483a0b347d813ebb(
|
|
39686
|
+
scope: _constructs_77d1e7e8.IConstruct,
|
|
39687
|
+
) -> None:
|
|
39688
|
+
"""Type checking stubs"""
|
|
39689
|
+
pass
|
|
39690
|
+
|
|
39691
|
+
def _typecheckingstub__b3f1229a84cb5fdb052e8db135be3d25670d9793cf44ddc71d8134240bed0efc(
|
|
39692
|
+
policy: RemovalPolicy,
|
|
39693
|
+
*,
|
|
39694
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
39695
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
39696
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
39697
|
+
) -> None:
|
|
39698
|
+
"""Type checking stubs"""
|
|
39699
|
+
pass
|
|
39700
|
+
|
|
39300
39701
|
def _typecheckingstub__569ac5c6adbac9575b4137a0343aea0625df007d849957bfacf2e65a01153962(
|
|
39301
39702
|
node: _constructs_77d1e7e8.Node,
|
|
39302
39703
|
) -> None:
|
|
@@ -39388,6 +39789,22 @@ def _typecheckingstub__46271c1d495743d8b70cfe27766a83a4dfd7bc3e4cf9af80b7823e48a
|
|
|
39388
39789
|
"""Type checking stubs"""
|
|
39389
39790
|
pass
|
|
39390
39791
|
|
|
39792
|
+
def _typecheckingstub__16fdd678fafc26c9e1ca2d269cac449744dcfd65a4b8fce227879a53407f64f2(
|
|
39793
|
+
scope: _constructs_77d1e7e8.IConstruct,
|
|
39794
|
+
) -> None:
|
|
39795
|
+
"""Type checking stubs"""
|
|
39796
|
+
pass
|
|
39797
|
+
|
|
39798
|
+
def _typecheckingstub__d1a6f380a312346d77f5859f328e14cef3d77e7eb99ba0dffc2dd7da58b9b0ca(
|
|
39799
|
+
policy: RemovalPolicy,
|
|
39800
|
+
*,
|
|
39801
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
39802
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
39803
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
39804
|
+
) -> None:
|
|
39805
|
+
"""Type checking stubs"""
|
|
39806
|
+
pass
|
|
39807
|
+
|
|
39391
39808
|
def _typecheckingstub__cf59d09830cb04cd8d888f7fcdf115e700dad2a3650ac4a9beaed76aea901790(
|
|
39392
39809
|
*,
|
|
39393
39810
|
apply_to_update_replace_policy: typing.Optional[builtins.bool] = None,
|
|
@@ -39396,6 +39813,15 @@ def _typecheckingstub__cf59d09830cb04cd8d888f7fcdf115e700dad2a3650ac4a9beaed76ae
|
|
|
39396
39813
|
"""Type checking stubs"""
|
|
39397
39814
|
pass
|
|
39398
39815
|
|
|
39816
|
+
def _typecheckingstub__c5c7fd6f5b115619c0c625e32cc15eb9bdbfb4931f25b97d8db03b7037bf1a39(
|
|
39817
|
+
*,
|
|
39818
|
+
apply_to_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
39819
|
+
exclude_resource_types: typing.Optional[typing.Sequence[builtins.str]] = None,
|
|
39820
|
+
priority: typing.Optional[jsii.Number] = None,
|
|
39821
|
+
) -> None:
|
|
39822
|
+
"""Type checking stubs"""
|
|
39823
|
+
pass
|
|
39824
|
+
|
|
39399
39825
|
def _typecheckingstub__944c89fd9e400a7d6e966cc04588226988866735f42049e619d446afc77d54c6(
|
|
39400
39826
|
key: builtins.str,
|
|
39401
39827
|
*,
|