aws-cdk-lib 2.149.0__py3-none-any.whl → 2.151.0__py3-none-any.whl

aws_cdk/aws_s3/__init__.py

@@ -4014,7 +4014,7 @@ class CfnBucket(
         :param public_access_block_configuration: Configuration that defines how Amazon S3 handles public access.
         :param replication_configuration: Configuration for replicating objects in an S3 bucket. To enable replication, you must also enable versioning by using the ``VersioningConfiguration`` property. Amazon S3 can store replicated objects in a single destination bucket or multiple destination buckets. The destination bucket or buckets must already exist.
         :param tags: An arbitrary set of tags (key-value pairs) for this S3 bucket.
-        :param versioning_configuration: Enables multiple versions of all objects in this bucket. You might enable versioning to prevent objects from being deleted or overwritten by mistake or to archive objects so that you can retrieve previous versions of them.
+        :param versioning_configuration: Enables multiple versions of all objects in this bucket. You might enable versioning to prevent objects from being deleted or overwritten by mistake or to archive objects so that you can retrieve previous versions of them. .. epigraph:: When you enable versioning on a bucket for the first time, it might take a short amount of time for the change to be fully propagated. We recommend that you wait for 15 minutes after enabling versioning before issuing write operations ( ``PUT`` or ``DELETE`` ) on objects in the bucket.
         :param website_configuration: Information used to configure the bucket as a static website. For more information, see `Hosting Websites on Amazon S3 <https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html>`_ .
         '''
         if __debug__:
@@ -10049,6 +10049,9 @@ class CfnBucket(
             '''Describes the versioning state of an Amazon S3 bucket.
 
             For more information, see `PUT Bucket versioning <https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html>`_ in the *Amazon S3 API Reference* .
+            .. epigraph::
+
+               When you enable versioning on a bucket for the first time, it might take a short amount of time for the change to be fully propagated. We recommend that you wait for 15 minutes after enabling versioning before issuing write operations ( ``PUT`` or ``DELETE`` ) on objects in the bucket.
 
             :param status: The versioning state of the bucket. Default: - "Suspended"
 
@@ -10494,7 +10497,7 @@ class CfnBucketProps:
         :param public_access_block_configuration: Configuration that defines how Amazon S3 handles public access.
         :param replication_configuration: Configuration for replicating objects in an S3 bucket. To enable replication, you must also enable versioning by using the ``VersioningConfiguration`` property. Amazon S3 can store replicated objects in a single destination bucket or multiple destination buckets. The destination bucket or buckets must already exist.
         :param tags: An arbitrary set of tags (key-value pairs) for this S3 bucket.
-        :param versioning_configuration: Enables multiple versions of all objects in this bucket. You might enable versioning to prevent objects from being deleted or overwritten by mistake or to archive objects so that you can retrieve previous versions of them.
+        :param versioning_configuration: Enables multiple versions of all objects in this bucket. You might enable versioning to prevent objects from being deleted or overwritten by mistake or to archive objects so that you can retrieve previous versions of them. .. epigraph:: When you enable versioning on a bucket for the first time, it might take a short amount of time for the change to be fully propagated. We recommend that you wait for 15 minutes after enabling versioning before issuing write operations ( ``PUT`` or ``DELETE`` ) on objects in the bucket.
         :param website_configuration: Information used to configure the bucket as a static website. For more information, see `Hosting Websites on Amazon S3 <https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-bucket.html
@@ -10817,6 +10820,9 @@ class CfnBucketProps:
         '''Enables multiple versions of all objects in this bucket.
 
         You might enable versioning to prevent objects from being deleted or overwritten by mistake or to archive objects so that you can retrieve previous versions of them.
+        .. epigraph::
+
+           When you enable versioning on a bucket for the first time, it might take a short amount of time for the change to be fully propagated. We recommend that you wait for 15 minutes after enabling versioning before issuing write operations ( ``PUT`` or ``DELETE`` ) on objects in the bucket.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-bucket.html#cfn-s3-bucket-versioningconfiguration
         '''

aws_cdk/aws_sagemaker/__init__.py

@@ -3725,9 +3725,9 @@ class CfnDataQualityJobDefinition(
     )
     class StoppingConditionProperty:
         def __init__(self, *, max_runtime_in_seconds: jsii.Number) -> None:
-            '''Specifies a limit to how long a model training job or model compilation job can run.
+            '''Specifies a limit to how long a job can run.
 
-            It also specifies how long a managed spot training job has to complete. When the job reaches the time limit, SageMaker ends the training or compilation job. Use this API to cap model training costs.
+            When the job reaches the time limit, SageMaker ends the job. Use this API to cap costs.
 
             To stop a training job, SageMaker sends the algorithm the ``SIGTERM`` signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
 
@@ -20279,9 +20279,9 @@ class CfnModelBiasJobDefinition(
     )
     class StoppingConditionProperty:
         def __init__(self, *, max_runtime_in_seconds: jsii.Number) -> None:
-            '''Specifies a limit to how long a model training job or model compilation job can run.
+            '''Specifies a limit to how long a job can run.
 
-            It also specifies how long a managed spot training job has to complete. When the job reaches the time limit, SageMaker ends the training or compilation job. Use this API to cap model training costs.
+            When the job reaches the time limit, SageMaker ends the job. Use this API to cap costs.
 
             To stop a training job, SageMaker sends the algorithm the ``SIGTERM`` signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
 
@@ -26021,9 +26021,9 @@ class CfnModelExplainabilityJobDefinition(
     )
     class StoppingConditionProperty:
         def __init__(self, *, max_runtime_in_seconds: jsii.Number) -> None:
-            '''Specifies a limit to how long a model training job or model compilation job can run.
+            '''Specifies a limit to how long a job can run.
 
-            It also specifies how long a managed spot training job has to complete. When the job reaches the time limit, SageMaker ends the training or compilation job. Use this API to cap model training costs.
+            When the job reaches the time limit, SageMaker ends the job. Use this API to cap costs.
 
             To stop a training job, SageMaker sends the algorithm the ``SIGTERM`` signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
 
@@ -33926,9 +33926,9 @@ class CfnModelQualityJobDefinition(
     )
     class StoppingConditionProperty:
         def __init__(self, *, max_runtime_in_seconds: jsii.Number) -> None:
-            '''Specifies a limit to how long a model training job or model compilation job can run.
+            '''Specifies a limit to how long a job can run.
 
-            It also specifies how long a managed spot training job has to complete. When the job reaches the time limit, SageMaker ends the training or compilation job. Use this API to cap model training costs.
+            When the job reaches the time limit, SageMaker ends the job. Use this API to cap costs.
 
             To stop a training job, SageMaker sends the algorithm the ``SIGTERM`` signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
 
@@ -36982,9 +36982,9 @@ class CfnMonitoringSchedule(
     )
     class StoppingConditionProperty:
         def __init__(self, *, max_runtime_in_seconds: jsii.Number) -> None:
-            '''Specifies a limit to how long a model training job or model compilation job can run.
+            '''Specifies a limit to how long a job can run.
 
-            It also specifies how long a managed spot training job has to complete. When the job reaches the time limit, SageMaker ends the training or compilation job. Use this API to cap model training costs.
+            When the job reaches the time limit, SageMaker ends the job. Use this API to cap costs.
 
             To stop a training job, SageMaker sends the algorithm the ``SIGTERM`` signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
 

aws_cdk/aws_ses/__init__.py

@@ -6759,7 +6759,7 @@ class ConfigurationSetProps:
         :param configuration_set_name: A name for the configuration set. Default: - a CloudFormation generated name
         :param custom_tracking_redirect_domain: The custom subdomain that is used to redirect email recipients to the Amazon SES event tracking domain. Default: - use the default awstrack.me domain
         :param dedicated_ip_pool: The dedicated IP pool to associate with the configuration set. Default: - do not use a dedicated IP pool
-        :param reputation_metrics: Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch. Default: false
+        :param reputation_metrics: Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch. Default: true
         :param sending_enabled: Whether email sending is enabled. Default: true
         :param suppression_reasons: The reasons for which recipient email addresses should be automatically added to your account's suppression list. Default: - use account level settings
         :param tls_policy: Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). Default: ConfigurationSetTlsPolicy.OPTIONAL
@@ -6840,7 +6840,7 @@ class ConfigurationSetProps:
     def reputation_metrics(self) -> typing.Optional[builtins.bool]:
         '''Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch.
 
-        :default: false
+        :default: true
         '''
         result = self._values.get("reputation_metrics")
         return typing.cast(typing.Optional[builtins.bool], result)
@@ -9912,7 +9912,7 @@ class ConfigurationSet(
         :param configuration_set_name: A name for the configuration set. Default: - a CloudFormation generated name
         :param custom_tracking_redirect_domain: The custom subdomain that is used to redirect email recipients to the Amazon SES event tracking domain. Default: - use the default awstrack.me domain
         :param dedicated_ip_pool: The dedicated IP pool to associate with the configuration set. Default: - do not use a dedicated IP pool
-        :param reputation_metrics: Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch. Default: false
+        :param reputation_metrics: Whether to publish reputation metrics for the configuration set, such as bounce and complaint rates, to Amazon CloudWatch. Default: true
         :param sending_enabled: Whether email sending is enabled. Default: true
         :param suppression_reasons: The reasons for which recipient email addresses should be automatically added to your account's suppression list. Default: - use account level settings
         :param tls_policy: Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). Default: ConfigurationSetTlsPolicy.OPTIONAL

aws_cdk/aws_sns/__init__.py

@@ -5248,7 +5248,7 @@ class TopicProps:
         '''Properties for a new SNS topic.
 
         :param content_based_deduplication: Enables content-based deduplication for FIFO topics. Default: None
-        :param display_name: A developer-defined string that can be used to identify this SNS topic. Default: None
+        :param display_name: A developer-defined string that can be used to identify this SNS topic. The display name must be maximum 100 characters long, including hyphens (-), underscores (_), spaces, and tabs. Default: None
         :param enforce_ssl: Adds a statement to enforce encryption of data in transit when publishing to the topic. Default: false
         :param fifo: Set to true to create a FIFO topic. Default: None
         :param logging_configs: The list of delivery status logging configurations for the topic. Default: None
@@ -5313,6 +5313,9 @@ class TopicProps:
     def display_name(self) -> typing.Optional[builtins.str]:
         '''A developer-defined string that can be used to identify this SNS topic.
 
+        The display name must be maximum 100 characters long, including hyphens (-),
+        underscores (_), spaces, and tabs.
+
         :default: None
         '''
         result = self._values.get("display_name")
@@ -5780,7 +5783,7 @@ class Topic(TopicBase, metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_sns.T
         :param scope: -
         :param id: -
         :param content_based_deduplication: Enables content-based deduplication for FIFO topics. Default: None
-        :param display_name: A developer-defined string that can be used to identify this SNS topic. Default: None
+        :param display_name: A developer-defined string that can be used to identify this SNS topic. The display name must be maximum 100 characters long, including hyphens (-), underscores (_), spaces, and tabs. Default: None
         :param enforce_ssl: Adds a statement to enforce encryption of data in transit when publishing to the topic. Default: false
         :param fifo: Set to true to create a FIFO topic. Default: None
         :param logging_configs: The list of delivery status logging configurations for the topic. Default: None

aws_cdk/aws_stepfunctions/__init__.py

@@ -2649,7 +2649,7 @@ class CfnStateMachineAlias(
 
             :param state_machine_version_arn: The Amazon Resource Name (ARN) of the ```AWS::StepFunctions::StateMachineVersion`` <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachineversion.html>`_ resource that will be the final version to which the alias points to when the traffic shifting is complete. While performing gradual deployments, you can only provide a single state machine version ARN. To explicitly set version weights in a CloudFormation template, use ``RoutingConfiguration`` instead.
             :param type: The type of deployment you want to perform. You can specify one of the following types:. - ``LINEAR`` - Shifts traffic to the new version in equal increments with an equal number of minutes between each increment. For example, if you specify the increment percent as ``20`` with an interval of ``600`` minutes, this deployment increases traffic by 20 percent every 600 minutes until the new version receives 100 percent of the traffic. This deployment immediately rolls back the new version if any CloudWatch alarms are triggered. - ``ALL_AT_ONCE`` - Shifts 100 percent of traffic to the new version immediately. CloudFormation monitors the new version and rolls it back automatically to the previous version if any CloudWatch alarms are triggered. - ``CANARY`` - Shifts traffic in two increments. In the first increment, a small percentage of traffic, for example, 10 percent is shifted to the new version. In the second increment, before a specified time interval in seconds gets over, the remaining traffic is shifted to the new version. The shift to the new version for the remaining traffic takes place only if no CloudWatch alarms are triggered during the specified time interval.
-            :param alarms: A list of Amazon CloudWatch alarms to be monitored during the deployment. The deployment fails and rolls back if any of these alarms go into the ``ALARM`` state.
+            :param alarms: A list of Amazon CloudWatch alarm names to be monitored during the deployment. The deployment fails and rolls back if any of these alarms go into the ``ALARM`` state. .. epigraph:: Amazon CloudWatch considers nonexistent alarms to have an ``OK`` state. If you provide an invalid alarm name or provide the ARN of an alarm instead of its name, your deployment may not roll back correctly.
             :param interval: The time in minutes between each traffic shifting increment.
             :param percentage: The percentage of traffic to shift to the new version in each increment.
 
@@ -2723,9 +2723,12 @@ class CfnStateMachineAlias(
 
         @builtins.property
         def alarms(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''A list of Amazon CloudWatch alarms to be monitored during the deployment.
+            '''A list of Amazon CloudWatch alarm names to be monitored during the deployment.
 
             The deployment fails and rolls back if any of these alarms go into the ``ALARM`` state.
+            .. epigraph::
+
+               Amazon CloudWatch considers nonexistent alarms to have an ``OK`` state. If you provide an invalid alarm name or provide the ARN of an alarm instead of its name, your deployment may not roll back correctly.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stepfunctions-statemachinealias-deploymentpreference.html#cfn-stepfunctions-statemachinealias-deploymentpreference-alarms
             '''

aws_cdk/aws_stepfunctions_tasks/__init__.py

@@ -420,6 +420,23 @@ task = tasks.BedrockInvokeModel(self, "Prompt Model",
 )
 ```
 
+### Using Input Path
+
+Provide S3 URI as an input or output path to invoke a model
+
+```python
+import aws_cdk.aws_bedrock as bedrock
+
+
+model = bedrock.FoundationModel.from_foundation_model_id(self, "Model", bedrock.FoundationModelIdentifier.AMAZON_TITAN_TEXT_G1_EXPRESS_V1)
+
+task = tasks.BedrockInvokeModel(self, "Prompt Model",
+    model=model,
+    input_path=sfn.JsonPath.string_at("$.prompt"),
+    output_path=sfn.JsonPath.string_at("$.prompt")
+)
+```
+
 You can apply a guardrail to the invocation by setting `guardrail`.
 
 ```python
@@ -7003,11 +7020,11 @@ class CallAwsServiceCrossRegion(
         :param action: The API action to call. Use camelCase.
         :param iam_resources: The resources for the IAM statement that will be added to the Lambda function role's policy to allow the state machine to make the API call.
         :param region: The AWS region to call this AWS API for.
-        :param service: The AWS service to call in AWS SDK for JavaScript v3 style.
+        :param service: The AWS service to call in AWS SDK for JavaScript v3 format.
         :param additional_iam_statements: Additional IAM statements that will be added to the state machine role's policy. Use in the case where the call requires more than a single statement to be executed, e.g. ``rekognition:detectLabels`` requires also S3 permissions to read the object on which it must act. Default: - no additional statements are added
         :param endpoint: The AWS API endpoint. Default: Do not override API endpoint.
         :param iam_action: The action for the IAM statement that will be added to the Lambda function role's policy to allow the state machine to make the API call. By default the action for this IAM statement will be ``service:action``. Use in the case where the IAM action name does not match with the API service/action name, e.g. ``s3:ListBuckets`` requires ``s3:ListAllMyBuckets``. Default: - service:action
-        :param parameters: Parameters for the API action call. Use PascalCase for the parameter names. Default: - no parameters
+        :param parameters: Parameters for the API action call in AWS SDK for JavaScript v3 format. Default: - no parameters
         :param retry_on_service_exceptions: Whether to retry on the backend Lambda service exceptions. This handles ``Lambda.ServiceException``, ``Lambda.AWSLambdaException``, ``Lambda.SdkClientException``, and ``Lambda.ClientExecutionTimeoutException`` with an interval of 2 seconds, a back-off rate of 2 and 6 maximum attempts. Default: true
         :param comment: An optional description for this state. Default: - No comment
         :param credentials: Credentials for an IAM Role that the State Machine assumes for executing the task. This enables cross-account resource invocations. Default: - None (Task is executed using the State Machine's execution role)
@@ -7138,11 +7155,11 @@ class CallAwsServiceCrossRegionProps(_TaskStateBaseProps_3a62b6d0):
         :param action: The API action to call. Use camelCase.
         :param iam_resources: The resources for the IAM statement that will be added to the Lambda function role's policy to allow the state machine to make the API call.
         :param region: The AWS region to call this AWS API for.
-        :param service: The AWS service to call in AWS SDK for JavaScript v3 style.
+        :param service: The AWS service to call in AWS SDK for JavaScript v3 format.
         :param additional_iam_statements: Additional IAM statements that will be added to the state machine role's policy. Use in the case where the call requires more than a single statement to be executed, e.g. ``rekognition:detectLabels`` requires also S3 permissions to read the object on which it must act. Default: - no additional statements are added
         :param endpoint: The AWS API endpoint. Default: Do not override API endpoint.
         :param iam_action: The action for the IAM statement that will be added to the Lambda function role's policy to allow the state machine to make the API call. By default the action for this IAM statement will be ``service:action``. Use in the case where the IAM action name does not match with the API service/action name, e.g. ``s3:ListBuckets`` requires ``s3:ListAllMyBuckets``. Default: - service:action
-        :param parameters: Parameters for the API action call. Use PascalCase for the parameter names. Default: - no parameters
+        :param parameters: Parameters for the API action call in AWS SDK for JavaScript v3 format. Default: - no parameters
         :param retry_on_service_exceptions: Whether to retry on the backend Lambda service exceptions. This handles ``Lambda.ServiceException``, ``Lambda.AWSLambdaException``, ``Lambda.SdkClientException``, and ``Lambda.ClientExecutionTimeoutException`` with an interval of 2 seconds, a back-off rate of 2 and 6 maximum attempts. Default: true
 
         :exampleMetadata: infused
@@ -7414,7 +7431,7 @@ class CallAwsServiceCrossRegionProps(_TaskStateBaseProps_3a62b6d0):
 
     @builtins.property
     def service(self) -> builtins.str:
-        '''The AWS service to call in AWS SDK for JavaScript v3 style.
+        '''The AWS service to call in AWS SDK for JavaScript v3 format.
 
         :see: https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/
 
@@ -7466,9 +7483,7 @@ class CallAwsServiceCrossRegionProps(_TaskStateBaseProps_3a62b6d0):
 
     @builtins.property
     def parameters(self) -> typing.Optional[typing.Mapping[builtins.str, typing.Any]]:
-        '''Parameters for the API action call.
-
-        Use PascalCase for the parameter names.
+        '''Parameters for the API action call in AWS SDK for JavaScript v3 format.
 
         :default: - no parameters
         '''