aws-cdk-lib 2.96.2__py3-none-any.whl → 2.97.1__py3-none-any.whl

aws_cdk/aws_sagemaker/__init__.py

@@ -2219,7 +2219,7 @@ class CfnDataQualityJobDefinition(
             :param container_entrypoint: The entrypoint for a container used to run a monitoring job.
             :param environment: Sets the environment variables in the container that the monitoring job runs.
             :param post_analytics_processor_source_uri: An Amazon S3 URI to a script that is called after analysis has been performed. Applicable only for the built-in (first party) containers.
-            :param record_preprocessor_source_uri: An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
+            :param record_preprocessor_source_uri: An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flattened JSON so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-dataqualityjobdefinition-dataqualityappspecification.html
             :exampleMetadata: fixture=_generated
@@ -2319,7 +2319,7 @@ class CfnDataQualityJobDefinition(
         def record_preprocessor_source_uri(self) -> typing.Optional[builtins.str]:
             '''An Amazon S3 URI to a script that is called per row prior to running analysis.
 
-            It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
+            It can base64 decode the payload and convert it into a flattened JSON so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-dataqualityjobdefinition-dataqualityappspecification.html#cfn-sagemaker-dataqualityjobdefinition-dataqualityappspecification-recordpreprocessorsourceuri
             '''
@@ -2658,7 +2658,7 @@ class CfnDataQualityJobDefinition(
 
             :param endpoint_name: An endpoint in customer's account which has enabled ``DataCaptureConfig`` enabled.
             :param local_path: Path to the filesystem where the endpoint data is available to the container.
-            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key. Defaults to ``FullyReplicated``
+            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key. Defaults to ``FullyReplicated``
             :param s3_input_mode: Whether the ``Pipe`` or ``File`` is used as the input mode for transferring data for the monitoring job. ``Pipe`` mode is recommended for large datasets. ``File`` mode is useful for small files that fit in memory. Defaults to ``File`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-dataqualityjobdefinition-endpointinput.html
@@ -2716,7 +2716,7 @@ class CfnDataQualityJobDefinition(
 
         @builtins.property
         def s3_data_distribution_type(self) -> typing.Optional[builtins.str]:
-            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key.
+            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key.
 
             Defaults to ``FullyReplicated``
 
@@ -2822,7 +2822,7 @@ class CfnDataQualityJobDefinition(
             '''The output configuration for monitoring jobs.
 
             :param monitoring_outputs: Monitoring outputs for monitoring jobs. This is where the output of the periodic monitoring jobs is uploaded.
-            :param kms_key_id: The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-dataqualityjobdefinition-monitoringoutputconfig.html
             :exampleMetadata: fixture=_generated
@@ -2874,7 +2874,7 @@ class CfnDataQualityJobDefinition(
 
         @builtins.property
         def kms_key_id(self) -> typing.Optional[builtins.str]:
-            '''The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            '''The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-dataqualityjobdefinition-monitoringoutputconfig.html#cfn-sagemaker-dataqualityjobdefinition-monitoringoutputconfig-kmskeyid
             '''
@@ -12444,9 +12444,9 @@ class CfnInferenceExperiment(
         ) -> None:
             '''Configuration specifying how to treat different headers.
 
-            If no headers are specified SageMaker will by default base64 encode when capturing the data.
+            If no headers are specified Amazon SageMaker will by default base64 encode when capturing the data.
 
-            :param csv_content_types: The list of all content type headers that SageMaker will treat as CSV and capture accordingly.
+            :param csv_content_types: The list of all content type headers that Amazon SageMaker will treat as CSV and capture accordingly.
             :param json_content_types: The list of all content type headers that SageMaker will treat as JSON and capture accordingly.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-inferenceexperiment-capturecontenttypeheader.html
@@ -12475,7 +12475,7 @@ class CfnInferenceExperiment(
 
         @builtins.property
         def csv_content_types(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''The list of all content type headers that SageMaker will treat as CSV and capture accordingly.
+            '''The list of all content type headers that Amazon SageMaker will treat as CSV and capture accordingly.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-inferenceexperiment-capturecontenttypeheader.html#cfn-sagemaker-inferenceexperiment-capturecontenttypeheader-csvcontenttypes
             '''
@@ -15354,7 +15354,7 @@ class CfnModelBiasJobDefinition(
             :param inference_attribute: The attribute of the input data that represents the ground truth label.
             :param probability_attribute: In a classification problem, the attribute that represents the class probability.
             :param probability_threshold_attribute: The threshold for the class probability to be evaluated as a positive result.
-            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key. Defaults to ``FullyReplicated``
+            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key. Defaults to ``FullyReplicated``
             :param s3_input_mode: Whether the ``Pipe`` or ``File`` is used as the input mode for transferring data for the monitoring job. ``Pipe`` mode is recommended for large datasets. ``File`` mode is useful for small files that fit in memory. Defaults to ``File`` .
             :param start_time_offset: If specified, monitoring jobs substract this time from the start time. For information about using offsets for scheduling monitoring jobs, see `Schedule Model Quality Monitoring Jobs <https://docs.aws.amazon.com/sagemaker/latest/dg/model-monitor-model-quality-schedule.html>`_ .
 
@@ -15484,7 +15484,7 @@ class CfnModelBiasJobDefinition(
 
         @builtins.property
         def s3_data_distribution_type(self) -> typing.Optional[builtins.str]:
-            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key.
+            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key.
 
             Defaults to ``FullyReplicated``
 
@@ -15963,7 +15963,7 @@ class CfnModelBiasJobDefinition(
             '''The output configuration for monitoring jobs.
 
             :param monitoring_outputs: Monitoring outputs for monitoring jobs. This is where the output of the periodic monitoring jobs is uploaded.
-            :param kms_key_id: The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelbiasjobdefinition-monitoringoutputconfig.html
             :exampleMetadata: fixture=_generated
@@ -16015,7 +16015,7 @@ class CfnModelBiasJobDefinition(
 
         @builtins.property
         def kms_key_id(self) -> typing.Optional[builtins.str]:
-            '''The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            '''The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelbiasjobdefinition-monitoringoutputconfig.html#cfn-sagemaker-modelbiasjobdefinition-monitoringoutputconfig-kmskeyid
             '''
@@ -21234,7 +21234,7 @@ class CfnModelExplainabilityJobDefinition(
             :param features_attribute: The attributes of the input data that are the input features.
             :param inference_attribute: The attribute of the input data that represents the ground truth label.
             :param probability_attribute: In a classification problem, the attribute that represents the class probability.
-            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key. Defaults to ``FullyReplicated``
+            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key. Defaults to ``FullyReplicated``
             :param s3_input_mode: Whether the ``Pipe`` or ``File`` is used as the input mode for transferring data for the monitoring job. ``Pipe`` mode is recommended for large datasets. ``File`` mode is useful for small files that fit in memory. Defaults to ``File`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelexplainabilityjobdefinition-endpointinput.html
@@ -21331,7 +21331,7 @@ class CfnModelExplainabilityJobDefinition(
 
         @builtins.property
         def s3_data_distribution_type(self) -> typing.Optional[builtins.str]:
-            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key.
+            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key.
 
             Defaults to ``FullyReplicated``
 
@@ -21438,7 +21438,7 @@ class CfnModelExplainabilityJobDefinition(
         ) -> None:
             '''Docker container image configuration object for the model explainability job.
 
-            :param config_uri: JSON formatted S3 file that defines explainability parameters. For more information on this JSON configuration file, see `Configure model explainability parameters <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-config-json-monitor-model-explainability-parameters.html>`_ .
+            :param config_uri: JSON formatted Amazon S3 file that defines explainability parameters. For more information on this JSON configuration file, see `Configure model explainability parameters <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-config-json-monitor-model-explainability-parameters.html>`_ .
             :param image_uri: The container image to be run by the model explainability job.
             :param environment: Sets the environment variables in the Docker container.
 
@@ -21475,7 +21475,7 @@ class CfnModelExplainabilityJobDefinition(
 
         @builtins.property
         def config_uri(self) -> builtins.str:
-            '''JSON formatted S3 file that defines explainability parameters.
+            '''JSON formatted Amazon S3 file that defines explainability parameters.
 
             For more information on this JSON configuration file, see `Configure model explainability parameters <https://docs.aws.amazon.com/sagemaker/latest/dg/clarify-config-json-monitor-model-explainability-parameters.html>`_ .
 
@@ -21718,7 +21718,7 @@ class CfnModelExplainabilityJobDefinition(
             '''The output configuration for monitoring jobs.
 
             :param monitoring_outputs: Monitoring outputs for monitoring jobs. This is where the output of the periodic monitoring jobs is uploaded.
-            :param kms_key_id: The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelexplainabilityjobdefinition-monitoringoutputconfig.html
             :exampleMetadata: fixture=_generated
@@ -21770,7 +21770,7 @@ class CfnModelExplainabilityJobDefinition(
 
         @builtins.property
         def kms_key_id(self) -> typing.Optional[builtins.str]:
-            '''The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            '''The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelexplainabilityjobdefinition-monitoringoutputconfig.html#cfn-sagemaker-modelexplainabilityjobdefinition-monitoringoutputconfig-kmskeyid
             '''
@@ -28897,7 +28897,7 @@ class CfnModelQualityJobDefinition(
             :param inference_attribute: The attribute of the input data that represents the ground truth label.
             :param probability_attribute: In a classification problem, the attribute that represents the class probability.
             :param probability_threshold_attribute: The threshold for the class probability to be evaluated as a positive result.
-            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key. Defaults to ``FullyReplicated``
+            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key. Defaults to ``FullyReplicated``
             :param s3_input_mode: Whether the ``Pipe`` or ``File`` is used as the input mode for transferring data for the monitoring job. ``Pipe`` mode is recommended for large datasets. ``File`` mode is useful for small files that fit in memory. Defaults to ``File`` .
             :param start_time_offset: If specified, monitoring jobs substract this time from the start time. For information about using offsets for scheduling monitoring jobs, see `Schedule Model Quality Monitoring Jobs <https://docs.aws.amazon.com/sagemaker/latest/dg/model-monitor-model-quality-schedule.html>`_ .
 
@@ -29014,7 +29014,7 @@ class CfnModelQualityJobDefinition(
 
         @builtins.property
         def s3_data_distribution_type(self) -> typing.Optional[builtins.str]:
-            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key.
+            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key.
 
             Defaults to ``FullyReplicated``
 
@@ -29146,7 +29146,7 @@ class CfnModelQualityJobDefinition(
             :param container_entrypoint: Specifies the entrypoint for a container that the monitoring job runs.
             :param environment: Sets the environment variables in the container that the monitoring job runs.
             :param post_analytics_processor_source_uri: An Amazon S3 URI to a script that is called after analysis has been performed. Applicable only for the built-in (first party) containers.
-            :param record_preprocessor_source_uri: An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
+            :param record_preprocessor_source_uri: An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flattened JSON so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelqualityjobdefinition-modelqualityappspecification.html
             :exampleMetadata: fixture=_generated
@@ -29259,7 +29259,7 @@ class CfnModelQualityJobDefinition(
         def record_preprocessor_source_uri(self) -> typing.Optional[builtins.str]:
             '''An Amazon S3 URI to a script that is called per row prior to running analysis.
 
-            It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
+            It can base64 decode the payload and convert it into a flattened JSON so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelqualityjobdefinition-modelqualityappspecification.html#cfn-sagemaker-modelqualityjobdefinition-modelqualityappspecification-recordpreprocessorsourceuri
             '''
@@ -29375,7 +29375,7 @@ class CfnModelQualityJobDefinition(
         ) -> None:
             '''The input for the model quality monitoring job.
 
-            Currently endponts are supported for input for model quality monitoring jobs.
+            Currently endpoints are supported for input for model quality monitoring jobs.
 
             :param ground_truth_s3_input: The ground truth label provided for the model.
             :param batch_transform_input: The batch transform input for a monitoring job.
@@ -29561,7 +29561,7 @@ class CfnModelQualityJobDefinition(
             '''The output configuration for monitoring jobs.
 
             :param monitoring_outputs: Monitoring outputs for monitoring jobs. This is where the output of the periodic monitoring jobs is uploaded.
-            :param kms_key_id: The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelqualityjobdefinition-monitoringoutputconfig.html
             :exampleMetadata: fixture=_generated
@@ -29613,7 +29613,7 @@ class CfnModelQualityJobDefinition(
 
         @builtins.property
         def kms_key_id(self) -> typing.Optional[builtins.str]:
-            '''The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            '''The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-modelqualityjobdefinition-monitoringoutputconfig.html#cfn-sagemaker-modelqualityjobdefinition-monitoringoutputconfig-kmskeyid
             '''
@@ -31335,7 +31335,7 @@ class CfnMonitoringSchedule(
 
             :param endpoint_name: An endpoint in customer's account which has enabled ``DataCaptureConfig`` enabled.
             :param local_path: Path to the filesystem where the endpoint data is available to the container.
-            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key. Defaults to ``FullyReplicated``
+            :param s3_data_distribution_type: Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key. Defaults to ``FullyReplicated``
             :param s3_input_mode: Whether the ``Pipe`` or ``File`` is used as the input mode for transferring data for the monitoring job. ``Pipe`` mode is recommended for large datasets. ``File`` mode is useful for small files that fit in memory. Defaults to ``File`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-monitoringschedule-endpointinput.html
@@ -31393,7 +31393,7 @@ class CfnMonitoringSchedule(
 
         @builtins.property
         def s3_data_distribution_type(self) -> typing.Optional[builtins.str]:
-            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an S3 key.
+            '''Whether input data distributed in Amazon S3 is fully replicated or sharded by an Amazon S3 key.
 
             Defaults to ``FullyReplicated``
 
@@ -31508,7 +31508,7 @@ class CfnMonitoringSchedule(
             :param container_arguments: An array of arguments for the container used to run the monitoring job.
             :param container_entrypoint: Specifies the entrypoint for a container used to run the monitoring job.
             :param post_analytics_processor_source_uri: An Amazon S3 URI to a script that is called after analysis has been performed. Applicable only for the built-in (first party) containers.
-            :param record_preprocessor_source_uri: An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
+            :param record_preprocessor_source_uri: An Amazon S3 URI to a script that is called per row prior to running analysis. It can base64 decode the payload and convert it into a flattened JSON so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-monitoringschedule-monitoringappspecification.html
             :exampleMetadata: fixture=_generated
@@ -31591,7 +31591,7 @@ class CfnMonitoringSchedule(
         def record_preprocessor_source_uri(self) -> typing.Optional[builtins.str]:
             '''An Amazon S3 URI to a script that is called per row prior to running analysis.
 
-            It can base64 decode the payload and convert it into a flatted json so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
+            It can base64 decode the payload and convert it into a flattened JSON so that the built-in container can use the converted data. Applicable only for the built-in (first party) containers.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-monitoringschedule-monitoringappspecification.html#cfn-sagemaker-monitoringschedule-monitoringappspecification-recordpreprocessorsourceuri
             '''
@@ -31914,7 +31914,7 @@ class CfnMonitoringSchedule(
 
             :param monitoring_app_specification: Configures the monitoring job to run a specified Docker container image.
             :param monitoring_inputs: The array of inputs for the monitoring job. Currently we support monitoring an Amazon SageMaker Endpoint.
-            :param monitoring_output_config: The array of outputs from the monitoring job to be uploaded to Amazon Simple Storage Service (Amazon S3).
+            :param monitoring_output_config: The array of outputs from the monitoring job to be uploaded to Amazon S3.
             :param monitoring_resources: Identifies the resources, ML compute instances, and ML storage volumes to deploy for a monitoring job. In distributed processing, you specify more than one instance.
             :param role_arn: The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf.
             :param baseline_config: Baseline configuration used to validate that the data conforms to the specified constraints and statistics.
@@ -32076,7 +32076,7 @@ class CfnMonitoringSchedule(
         def monitoring_output_config(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnMonitoringSchedule.MonitoringOutputConfigProperty"]:
-            '''The array of outputs from the monitoring job to be uploaded to Amazon Simple Storage Service (Amazon S3).
+            '''The array of outputs from the monitoring job to be uploaded to Amazon S3.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-monitoringschedule-monitoringjobdefinition.html#cfn-sagemaker-monitoringschedule-monitoringjobdefinition-monitoringoutputconfig
             '''
@@ -32181,7 +32181,7 @@ class CfnMonitoringSchedule(
             '''The output configuration for monitoring jobs.
 
             :param monitoring_outputs: Monitoring outputs for monitoring jobs. This is where the output of the periodic monitoring jobs is uploaded.
-            :param kms_key_id: The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            :param kms_key_id: The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-monitoringschedule-monitoringoutputconfig.html
             :exampleMetadata: fixture=_generated
@@ -32233,7 +32233,7 @@ class CfnMonitoringSchedule(
 
         @builtins.property
         def kms_key_id(self) -> typing.Optional[builtins.str]:
-            '''The AWS Key Management Service ( AWS KMS) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
+            '''The AWS Key Management Service ( AWS KMS ) key that Amazon SageMaker uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-monitoringschedule-monitoringoutputconfig.html#cfn-sagemaker-monitoringschedule-monitoringoutputconfig-kmskeyid
             '''

aws_cdk/aws_stepfunctions/__init__.py

@@ -343,6 +343,20 @@ ship_the_item = sfn.Pass(self, "ShipTheItem")
 choice.afterwards().next(ship_the_item)
 ```
 
+You can add comments to `Choice` states as well as conditions that use `choice.when`.
+
+```python
+choice = sfn.Choice(self, "What color is it?",
+    comment="color comment"
+)
+handle_blue_item = sfn.Pass(self, "HandleBlueItem")
+handle_other_item_color = sfn.Pass(self, "HanldeOtherItemColor")
+choice.when(sfn.Condition.string_equals("$.color", "BLUE"), handle_blue_item,
+    comment="blue item comment"
+)
+choice.otherwise(handle_other_item_color)
+```
+
 If your `Choice` doesn't have an `otherwise()` and none of the conditions match
 the JSON state, a `NoChoiceMatched` error will be thrown. Wrap the state machine
 in a `Parallel` state if you want to catch and recover from this.
@@ -3397,19 +3411,19 @@ class ChoiceProps:
         :param input_path: JSONPath expression to select part of the state to be the input to this state. May also be the special value JsonPath.DISCARD, which will cause the effective input to be the empty object {}. Default: $
         :param output_path: JSONPath expression to select part of the state to be the output to this state. May also be the special value JsonPath.DISCARD, which will cause the effective output to be the empty object {}. Default: $
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         Example::
 
-            # The code below shows an example of how to instantiate this type.
-            # The values are placeholders you should change.
-            from aws_cdk import aws_stepfunctions as stepfunctions
-            
-            choice_props = stepfunctions.ChoiceProps(
-                comment="comment",
-                input_path="inputPath",
-                output_path="outputPath"
+            choice = sfn.Choice(self, "What color is it?",
+                comment="color comment"
+            )
+            handle_blue_item = sfn.Pass(self, "HandleBlueItem")
+            handle_other_item_color = sfn.Pass(self, "HanldeOtherItemColor")
+            choice.when(sfn.Condition.string_equals("$.color", "BLUE"), handle_blue_item,
+                comment="blue item comment"
             )
+            choice.otherwise(handle_other_item_color)
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a926bb3a79f5cf3706dd32093c49a75fa6045aeefbff3e1b4943eb654489e685)
@@ -3469,6 +3483,59 @@ class ChoiceProps:
         )
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_stepfunctions.ChoiceTransitionOptions",
+    jsii_struct_bases=[],
+    name_mapping={"comment": "comment"},
+)
+class ChoiceTransitionOptions:
+    def __init__(self, *, comment: typing.Optional[builtins.str] = None) -> None:
+        '''Options for Choice Transition.
+
+        :param comment: An optional description for the choice transition. Default: No comment
+
+        :exampleMetadata: infused
+
+        Example::
+
+            choice = sfn.Choice(self, "What color is it?",
+                comment="color comment"
+            )
+            handle_blue_item = sfn.Pass(self, "HandleBlueItem")
+            handle_other_item_color = sfn.Pass(self, "HanldeOtherItemColor")
+            choice.when(sfn.Condition.string_equals("$.color", "BLUE"), handle_blue_item,
+                comment="blue item comment"
+            )
+            choice.otherwise(handle_other_item_color)
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__254c8670f15896e504e7f2c5398c9717ddc003fe66835e546b52b1693c004add)
+            check_type(argname="argument comment", value=comment, expected_type=type_hints["comment"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if comment is not None:
+            self._values["comment"] = comment
+
+    @builtins.property
+    def comment(self) -> typing.Optional[builtins.str]:
+        '''An optional description for the choice transition.
+
+        :default: No comment
+        '''
+        result = self._values.get("comment")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "ChoiceTransitionOptions(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 class Condition(
     metaclass=jsii.JSIIAbstractClass,
     jsii_type="aws-cdk-lib.aws_stepfunctions.Condition",
@@ -7800,7 +7867,7 @@ class State(
 
     @jsii.member(jsii_name="addBranch")
     def _add_branch(self, branch: "StateGraph") -> None:
-        '''Add a paralle branch to this state.
+        '''Add a parallel branch to this state.
 
         :param branch: -
         '''
@@ -7810,17 +7877,26 @@ class State(
         return typing.cast(None, jsii.invoke(self, "addBranch", [branch]))
 
     @jsii.member(jsii_name="addChoice")
-    def _add_choice(self, condition: Condition, next: "State") -> None:
+    def _add_choice(
+        self,
+        condition: Condition,
+        next: "State",
+        *,
+        comment: typing.Optional[builtins.str] = None,
+    ) -> None:
         '''Add a choice branch to this state.
 
         :param condition: -
         :param next: -
+        :param comment: An optional description for the choice transition. Default: No comment
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__df2c90f3de37dcdaf38ae6a3e70460c7cdfd78a154847df351088cd8a3b22960)
             check_type(argname="argument condition", value=condition, expected_type=type_hints["condition"])
             check_type(argname="argument next", value=next, expected_type=type_hints["next"])
-        return typing.cast(None, jsii.invoke(self, "addChoice", [condition, next]))
+        options = ChoiceTransitionOptions(comment=comment)
+
+        return typing.cast(None, jsii.invoke(self, "addChoice", [condition, next, options]))
 
     @jsii.member(jsii_name="addIterator")
     def _add_iterator(self, iteration: "StateGraph") -> None:
@@ -12113,17 +12189,26 @@ class Choice(
         return typing.cast(typing.Mapping[typing.Any, typing.Any], jsii.invoke(self, "toStateJson", []))
 
     @jsii.member(jsii_name="when")
-    def when(self, condition: Condition, next: IChainable) -> "Choice":
+    def when(
+        self,
+        condition: Condition,
+        next: IChainable,
+        *,
+        comment: typing.Optional[builtins.str] = None,
+    ) -> "Choice":
         '''If the given condition matches, continue execution with the given state.
 
         :param condition: -
         :param next: -
+        :param comment: An optional description for the choice transition. Default: No comment
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c5351e3ee5e1f4b5b58ec322e57749fdd65cdc8bb76443318ef63b4eedc5cb0b)
             check_type(argname="argument condition", value=condition, expected_type=type_hints["condition"])
             check_type(argname="argument next", value=next, expected_type=type_hints["next"])
-        return typing.cast("Choice", jsii.invoke(self, "when", [condition, next]))
+        options = ChoiceTransitionOptions(comment=comment)
+
+        return typing.cast("Choice", jsii.invoke(self, "when", [condition, next, options]))
 
     @builtins.property
     @jsii.member(jsii_name="endStates")
@@ -12769,6 +12854,7 @@ __all__ = [
     "ChainDefinitionBody",
     "Choice",
     "ChoiceProps",
+    "ChoiceTransitionOptions",
     "Condition",
     "Credentials",
     "CustomState",
@@ -13187,6 +13273,13 @@ def _typecheckingstub__a926bb3a79f5cf3706dd32093c49a75fa6045aeefbff3e1b4943eb654
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__254c8670f15896e504e7f2c5398c9717ddc003fe66835e546b52b1693c004add(
+    *,
+    comment: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__71eb0d2598d910c950378149f21b99ac6c39c861109d3ab21b603c6dd4a39f67(
     *conditions: Condition,
 ) -> None:
@@ -14008,6 +14101,8 @@ def _typecheckingstub__d9f89078424459b1c694d56e01d3910a25c8af32756935aaace102680
 def _typecheckingstub__df2c90f3de37dcdaf38ae6a3e70460c7cdfd78a154847df351088cd8a3b22960(
     condition: Condition,
     next: State,
+    *,
+    comment: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -14595,6 +14690,8 @@ def _typecheckingstub__58e659f8b3dba6c37e918b57bca058880f69e9f4da0a230edb80f223a
 def _typecheckingstub__c5351e3ee5e1f4b5b58ec322e57749fdd65cdc8bb76443318ef63b4eedc5cb0b(
     condition: Condition,
     next: IChainable,
+    *,
+    comment: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/aws_transfer/__init__.py

@@ -1409,7 +1409,7 @@ class CfnConnector(
         ) -> None:
             '''A structure that contains the parameters for an SFTP connector object.
 
-            :param trusted_host_keys: The public portion of the host key, or keys, that are used to authenticate the user to the external server to which you are connecting. You can use the ``ssh-keyscan`` command against the SFTP server to retrieve the necessary key. The three standard SSH public key format elements are ``<key type>`` , ``<body base64>`` , and an optional ``<comment>`` , with spaces between each element. For the trusted host key, AWS Transfer Family accepts RSA and ECDSA keys. - For RSA keys, the key type is ``ssh-rsa`` . - For ECDSA keys, the key type is either ``ecdsa-sha2-nistp256`` , ``ecdsa-sha2-nistp384`` , or ``ecdsa-sha2-nistp521`` , depending on the size of the key you generated.
+            :param trusted_host_keys: The public portion of the host key, or keys, that are used to authenticate the user to the external server to which you are connecting. You can use the ``ssh-keyscan`` command against the SFTP server to retrieve the necessary key. The three standard SSH public key format elements are ``<key type>`` , ``<body base64>`` , and an optional ``<comment>`` , with spaces between each element. Specify only the ``<key type>`` and ``<body base64>`` : do not enter the ``<comment>`` portion of the key. For the trusted host key, AWS Transfer Family accepts RSA and ECDSA keys. - For RSA keys, the key type is ``ssh-rsa`` . - For ECDSA keys, the key type is either ``ecdsa-sha2-nistp256`` , ``ecdsa-sha2-nistp384`` , or ``ecdsa-sha2-nistp521`` , depending on the size of the key you generated.
             :param user_secret_id: The identifier for the secret (in AWS Secrets Manager) that contains the SFTP user's private key, password, or both. The identifier can be either the Amazon Resource Name (ARN) or the name of the secret.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-transfer-connector-sftpconfig.html
@@ -1442,7 +1442,7 @@ class CfnConnector(
 
             You can use the ``ssh-keyscan`` command against the SFTP server to retrieve the necessary key.
 
-            The three standard SSH public key format elements are ``<key type>`` , ``<body base64>`` , and an optional ``<comment>`` , with spaces between each element.
+            The three standard SSH public key format elements are ``<key type>`` , ``<body base64>`` , and an optional ``<comment>`` , with spaces between each element. Specify only the ``<key type>`` and ``<body base64>`` : do not enter the ``<comment>`` portion of the key.
 
             For the trusted host key, AWS Transfer Family accepts RSA and ECDSA keys.