aws-cdk-lib 2.187.0__py3-none-any.whl → 2.189.0__py3-none-any.whl

aws_cdk/aws_appconfig/__init__.py

@@ -1415,7 +1415,7 @@ class CfnConfigurationProfile(
         :param application_id: The application ID.
         :param location_uri: A URI to locate the configuration. You can specify the following:. - For the AWS AppConfig hosted configuration store and for feature flags, specify ``hosted`` . - For an AWS Systems Manager Parameter Store parameter, specify either the parameter name in the format ``ssm-parameter://<parameter name>`` or the ARN. - For an AWS CodePipeline pipeline, specify the URI in the following format: ``codepipeline`` ://. - For an AWS Secrets Manager secret, specify the URI in the following format: ``secretsmanager`` ://. - For an Amazon S3 object, specify the URI in the following format: ``s3://<bucket>/<objectKey>`` . Here is an example: ``s3://amzn-s3-demo-bucket/my-app/us-east-1/my-config.json`` - For an SSM document, specify either the document name in the format ``ssm-document://<document name>`` or the Amazon Resource Name (ARN).
         :param name: A name for the configuration profile.
-        :param deletion_protection_check: On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting. See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
+        :param deletion_protection_check: A parameter to configure deletion protection. Deletion protection prevents a user from deleting a configuration profile if your application has called either `GetLatestConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html>`_ or `GetConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html>`_ for the configuration profile during the specified interval. This parameter supports the following values: - ``BYPASS`` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it. - ``APPLY`` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. ``APPLY`` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks. - ``ACCOUNT_DEFAULT`` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the ``UpdateAccountSettings`` API.
         :param description: A description of the configuration profile.
         :param kms_key_identifier: The AWS Key Management Service key identifier (key ID, key alias, or key ARN) provided when the resource was created or updated.
         :param retrieval_role_arn: The ARN of an IAM role with permission to access the configuration at the specified ``LocationUri`` . .. epigraph:: A retrieval role ARN is not required for configurations stored in AWS CodePipeline or the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.
@@ -1548,7 +1548,7 @@ class CfnConfigurationProfile(
     @builtins.property
     @jsii.member(jsii_name="deletionProtectionCheck")
     def deletion_protection_check(self) -> typing.Optional[builtins.str]:
-        '''On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting.'''
+        '''A parameter to configure deletion protection.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "deletionProtectionCheck"))
 
     @deletion_protection_check.setter
@@ -1750,7 +1750,7 @@ class CfnConfigurationProfileProps:
         :param application_id: The application ID.
         :param location_uri: A URI to locate the configuration. You can specify the following:. - For the AWS AppConfig hosted configuration store and for feature flags, specify ``hosted`` . - For an AWS Systems Manager Parameter Store parameter, specify either the parameter name in the format ``ssm-parameter://<parameter name>`` or the ARN. - For an AWS CodePipeline pipeline, specify the URI in the following format: ``codepipeline`` ://. - For an AWS Secrets Manager secret, specify the URI in the following format: ``secretsmanager`` ://. - For an Amazon S3 object, specify the URI in the following format: ``s3://<bucket>/<objectKey>`` . Here is an example: ``s3://amzn-s3-demo-bucket/my-app/us-east-1/my-config.json`` - For an SSM document, specify either the document name in the format ``ssm-document://<document name>`` or the Amazon Resource Name (ARN).
         :param name: A name for the configuration profile.
-        :param deletion_protection_check: On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting. See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
+        :param deletion_protection_check: A parameter to configure deletion protection. Deletion protection prevents a user from deleting a configuration profile if your application has called either `GetLatestConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html>`_ or `GetConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html>`_ for the configuration profile during the specified interval. This parameter supports the following values: - ``BYPASS`` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it. - ``APPLY`` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. ``APPLY`` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks. - ``ACCOUNT_DEFAULT`` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the ``UpdateAccountSettings`` API.
         :param description: A description of the configuration profile.
         :param kms_key_identifier: The AWS Key Management Service key identifier (key ID, key alias, or key ARN) provided when the resource was created or updated.
         :param retrieval_role_arn: The ARN of an IAM role with permission to access the configuration at the specified ``LocationUri`` . .. epigraph:: A retrieval role ARN is not required for configurations stored in AWS CodePipeline or the AWS AppConfig hosted configuration store. It is required for all other sources that store your configuration.
@@ -1859,9 +1859,15 @@ class CfnConfigurationProfileProps:
 
     @builtins.property
     def deletion_protection_check(self) -> typing.Optional[builtins.str]:
-        '''On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting.
+        '''A parameter to configure deletion protection.
 
-        See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
+        Deletion protection prevents a user from deleting a configuration profile if your application has called either `GetLatestConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html>`_ or `GetConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html>`_ for the configuration profile during the specified interval.
+
+        This parameter supports the following values:
+
+        - ``BYPASS`` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it.
+        - ``APPLY`` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. ``APPLY`` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks.
+        - ``ACCOUNT_DEFAULT`` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the ``UpdateAccountSettings`` API.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appconfig-configurationprofile.html#cfn-appconfig-configurationprofile-deletionprotectioncheck
         '''
@@ -3017,7 +3023,7 @@ class CfnEnvironment(
         :param id: Construct identifier for this resource (unique in its scope).
         :param application_id: The application ID.
         :param name: A name for the environment.
-        :param deletion_protection_check: On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting. See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
+        :param deletion_protection_check: A parameter to configure deletion protection. Deletion protection prevents a user from deleting an environment if your application called either `GetLatestConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html>`_ or `GetConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html>`_ in the environment during the specified interval. This parameter supports the following values: - ``BYPASS`` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it. - ``APPLY`` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. ``APPLY`` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks. - ``ACCOUNT_DEFAULT`` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the ``UpdateAccountSettings`` API.
         :param description: A description of the environment.
         :param monitors: Amazon CloudWatch alarms to monitor during the deployment process.
         :param tags: Metadata to assign to the environment. Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.
@@ -3116,7 +3122,7 @@ class CfnEnvironment(
     @builtins.property
     @jsii.member(jsii_name="deletionProtectionCheck")
     def deletion_protection_check(self) -> typing.Optional[builtins.str]:
-        '''On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting.'''
+        '''A parameter to configure deletion protection.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "deletionProtectionCheck"))
 
     @deletion_protection_check.setter
@@ -3338,7 +3344,7 @@ class CfnEnvironmentProps:
 
         :param application_id: The application ID.
         :param name: A name for the environment.
-        :param deletion_protection_check: On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting. See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
+        :param deletion_protection_check: A parameter to configure deletion protection. Deletion protection prevents a user from deleting an environment if your application called either `GetLatestConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html>`_ or `GetConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html>`_ in the environment during the specified interval. This parameter supports the following values: - ``BYPASS`` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it. - ``APPLY`` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. ``APPLY`` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks. - ``ACCOUNT_DEFAULT`` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the ``UpdateAccountSettings`` API.
         :param description: A description of the environment.
         :param monitors: Amazon CloudWatch alarms to monitor during the deployment process.
         :param tags: Metadata to assign to the environment. Tags help organize and categorize your AWS AppConfig resources. Each tag consists of a key and an optional value, both of which you define.
@@ -3412,9 +3418,15 @@ class CfnEnvironmentProps:
 
     @builtins.property
     def deletion_protection_check(self) -> typing.Optional[builtins.str]:
-        '''On resource deletion this controls whether the Deletion Protection check should be applied, bypassed, or (the default) whether the behavior should be controlled by the account-level Deletion Protection setting.
+        '''A parameter to configure deletion protection.
+
+        Deletion protection prevents a user from deleting an environment if your application called either `GetLatestConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html>`_ or `GetConfiguration <https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html>`_ in the environment during the specified interval.
+
+        This parameter supports the following values:
 
-        See https://docs.aws.amazon.com/appconfig/latest/userguide/deletion-protection.html
+        - ``BYPASS`` : Instructs AWS AppConfig to bypass the deletion protection check and delete a configuration profile even if deletion protection would have otherwise prevented it.
+        - ``APPLY`` : Instructs the deletion protection check to run, even if deletion protection is disabled at the account level. ``APPLY`` also forces the deletion protection check to run against resources created in the past hour, which are normally excluded from deletion protection checks.
+        - ``ACCOUNT_DEFAULT`` : The default setting, which instructs AWS AppConfig to implement the deletion protection value specified in the ``UpdateAccountSettings`` API.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appconfig-environment.html#cfn-appconfig-environment-deletionprotectioncheck
         '''
@@ -3726,7 +3738,7 @@ class CfnExtension(
         ) -> None:
             '''The actions defined in the extension.
 
-            :param name: The action name.
+            :param name: The extension name.
             :param uri: The extension URI associated to the action point in the extension definition. The URI can be an Amazon Resource Name (ARN) for one of the following: an AWS Lambda function, an Amazon Simple Queue Service queue, an Amazon Simple Notification Service topic, or the Amazon EventBridge default event bus.
             :param description: Information about actions defined in the extension.
             :param role_arn: An Amazon Resource Name (ARN) for an AWS Identity and Access Management assume role.
@@ -3766,7 +3778,7 @@ class CfnExtension(
 
         @builtins.property
         def name(self) -> builtins.str:
-            '''The action name.
+            '''The extension name.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appconfig-extension-action.html#cfn-appconfig-extension-action-name
             '''
@@ -4488,7 +4500,7 @@ class CfnHostedConfigurationVersion(
         :param configuration_profile_id: The configuration profile ID.
         :param content: The configuration data, as bytes. .. epigraph:: AWS AppConfig accepts any type of data, including text formats like JSON or TOML, or binary formats like protocol buffers or compressed data.
         :param content_type: A standard MIME type describing the format of the configuration content. For more information, see `Content-Type <https://docs.aws.amazon.com/https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17>`_ .
-        :param description: A description of the configuration.
+        :param description: A description of the configuration. .. epigraph:: Due to HTTP limitations, this field only supports ASCII characters.
         :param latest_version_number: An optional locking token used to prevent race conditions from overwriting configuration updates when creating a new version. To ensure your data is not overwritten when creating multiple hosted configuration versions in rapid succession, specify the version number of the latest hosted configuration version.
         :param version_label: A user-defined label for an AWS AppConfig hosted configuration version.
         '''
@@ -4675,7 +4687,7 @@ class CfnHostedConfigurationVersionProps:
         :param configuration_profile_id: The configuration profile ID.
         :param content: The configuration data, as bytes. .. epigraph:: AWS AppConfig accepts any type of data, including text formats like JSON or TOML, or binary formats like protocol buffers or compressed data.
         :param content_type: A standard MIME type describing the format of the configuration content. For more information, see `Content-Type <https://docs.aws.amazon.com/https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17>`_ .
-        :param description: A description of the configuration.
+        :param description: A description of the configuration. .. epigraph:: Due to HTTP limitations, this field only supports ASCII characters.
         :param latest_version_number: An optional locking token used to prevent race conditions from overwriting configuration updates when creating a new version. To ensure your data is not overwritten when creating multiple hosted configuration versions in rapid succession, specify the version number of the latest hosted configuration version.
         :param version_label: A user-defined label for an AWS AppConfig hosted configuration version.
 
@@ -4772,6 +4784,10 @@ class CfnHostedConfigurationVersionProps:
     def description(self) -> typing.Optional[builtins.str]:
         '''A description of the configuration.
 
+        .. epigraph::
+
+           Due to HTTP limitations, this field only supports ASCII characters.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appconfig-hostedconfigurationversion.html#cfn-appconfig-hostedconfigurationversion-description
         '''
         result = self._values.get("description")

aws_cdk/aws_arczonalshift/__init__.py

@@ -294,7 +294,7 @@ class CfnZonalAutoshiftConfiguration(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param resource_identifier: The identifier for the resource that AWS shifts traffic for. The identifier is the Amazon Resource Name (ARN) for the resource. At this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
-        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
+        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
         :param zonal_autoshift_status: When zonal autoshift is ``ENABLED`` , you authorize AWS to shift away resource traffic for an application from an Availability Zone during events, on your behalf, to help reduce time to recovery. Traffic is also shifted away for the required weekly practice runs.
         '''
         if __debug__:
@@ -622,7 +622,7 @@ class CfnZonalAutoshiftConfigurationProps:
         '''Properties for defining a ``CfnZonalAutoshiftConfiguration``.
 
         :param resource_identifier: The identifier for the resource that AWS shifts traffic for. The identifier is the Amazon Resource Name (ARN) for the resource. At this time, supported resources are Network Load Balancers and Application Load Balancers with cross-zone load balancing turned off.
-        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
+        :param practice_run_configuration: A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run. When a resource has a practice run configuration, ARC shifts traffic for the resource weekly for practice runs. Practice runs are required for zonal autoshift. The zonal shifts that ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application. You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
         :param zonal_autoshift_status: When zonal autoshift is ``ENABLED`` , you authorize AWS to shift away resource traffic for an application from an Availability Zone during events, on your behalf, to help reduce time to recovery. Traffic is also shifted away for the required weekly practice runs.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-arczonalshift-zonalautoshiftconfiguration.html
@@ -688,9 +688,9 @@ class CfnZonalAutoshiftConfigurationProps:
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnZonalAutoshiftConfiguration.PracticeRunConfigurationProperty]]:
         '''A practice run configuration for a resource includes the Amazon CloudWatch alarms that you've specified for a practice run, as well as any blocked dates or blocked windows for the practice run.
 
-        When a resource has a practice run configuration, Route 53 ARC shifts traffic for the resource weekly for practice runs.
+        When a resource has a practice run configuration, ARC shifts traffic for the resource weekly for practice runs.
 
-        Practice runs are required for zonal autoshift. The zonal shifts that Route 53 ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application.
+        Practice runs are required for zonal autoshift. The zonal shifts that ARC starts for practice runs help you to ensure that shifting away traffic from an Availability Zone during an autoshift is safe for your application.
 
         You can update or delete a practice run configuration. Before you delete a practice run configuration, you must disable zonal autoshift for the resource. A practice run configuration is required when zonal autoshift is enabled.
 

aws_cdk/aws_batch/__init__.py

@@ -51,6 +51,8 @@ and only applies to `ManagedEc2EcsComputeEnvironment`s.
 The following code configures a Compute Environment to only use spot instances that
 are at most 20% the price of the on-demand instance price:
 
+*Note*: For `FargateComputeEnvironment`, while the `FargateComputeEnvironmentProps` interface includes properties like `replaceComputeEnvironment`, `terminateOnUpdate`, `updateTimeout`, and `updateToLatestImageVersion`, these specific properties are **not applicable** when configuring AWS Batch Fargate compute environments. They primarily apply to EC2-based compute environments. Please refer to the official [AWS Batch UpdateComputeEnvironment API documentation](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) and [User Guide](https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html) for details on updating Fargate compute environments.
+
 ```python
 vpc = ec2.Vpc(self, "VPC")
 batch.ManagedEc2EcsComputeEnvironment(self, "myEc2ComputeEnv",