aws-cdk-lib 2.95.1__py3-none-any.whl → 2.96.0__py3-none-any.whl

aws_cdk/aws_datasync/__init__.py

@@ -6769,7 +6769,7 @@ class CfnTask(
         :param options: Specifies the configuration options for a task. Some options include preserving file or object metadata and verifying data integrity. You can also override these options before starting an individual run of a task (also known as a *task execution* ). For more information, see `StartTaskExecution <https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html>`_ .
         :param schedule: Specifies a schedule used to periodically transfer files from a source to a destination location. The schedule should be specified in UTC time. For more information, see `Scheduling your task <https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html>`_ .
         :param tags: Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task. *Tags* are key-value pairs that help you manage, filter, and search for your DataSync resources.
-        :param task_report_config: 
+        :param task_report_config: Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__9add9673a1f0ceb078949e967bce91066ff7e0441dae95d55c11c4a503a397a6)
@@ -7012,6 +7012,7 @@ class CfnTask(
     def task_report_config(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.TaskReportConfigProperty"]]:
+        '''Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.TaskReportConfigProperty"]], jsii.get(self, "taskReportConfig"))
 
     @task_report_config.setter
@@ -7035,8 +7036,9 @@ class CfnTask(
             *,
             report_level: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param report_level: 
+            '''The reporting level for the deleted section of your DataSync task report.
+
+            :param report_level: Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. - ``ERRORS_ONLY`` : A report shows what DataSync was unable to delete. - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to delete.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-deleted.html
             :exampleMetadata: fixture=_generated
@@ -7060,7 +7062,11 @@ class CfnTask(
 
         @builtins.property
         def report_level(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't.
+
+            - ``ERRORS_ONLY`` : A report shows what DataSync was unable to delete.
+            - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to delete.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-deleted.html#cfn-datasync-task-deleted-reportlevel
             '''
             result = self._values.get("report_level")
@@ -7088,8 +7094,9 @@ class CfnTask(
             *,
             s3: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.S3Property", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
-            :param s3: 
+            '''Specifies where DataSync uploads your `task report <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html>`_ .
+
+            :param s3: Specifies the Amazon S3 bucket where DataSync uploads your task report.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-destination.html
             :exampleMetadata: fixture=_generated
@@ -7119,7 +7126,8 @@ class CfnTask(
         def s3(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.S3Property"]]:
-            '''
+            '''Specifies the Amazon S3 bucket where DataSync uploads your task report.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-destination.html#cfn-datasync-task-destination-s3
             '''
             result = self._values.get("s3")
@@ -7633,11 +7641,14 @@ class CfnTask(
             transferred: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.TransferredProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             verified: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.VerifiedProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
-            :param deleted: 
-            :param skipped: 
-            :param transferred: 
-            :param verified: 
+            '''Customizes the reporting level for aspects of your task report.
+
+            For example, your report might generally only include errors, but you could specify that you want a list of successes and errors just for the files that DataSync attempted to delete in your destination location.
+
+            :param deleted: Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you `configure your task <https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html>`_ to delete data in the destination that isn't in the source.
+            :param skipped: Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer.
+            :param transferred: Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer.
+            :param verified: Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify during your transfer.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-overrides.html
             :exampleMetadata: fixture=_generated
@@ -7683,7 +7694,10 @@ class CfnTask(
         def deleted(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.DeletedProperty"]]:
-            '''
+            '''Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location.
+
+            This only applies if you `configure your task <https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html>`_ to delete data in the destination that isn't in the source.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-overrides.html#cfn-datasync-task-overrides-deleted
             '''
             result = self._values.get("deleted")
@@ -7693,7 +7707,8 @@ class CfnTask(
         def skipped(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.SkippedProperty"]]:
-            '''
+            '''Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-overrides.html#cfn-datasync-task-overrides-skipped
             '''
             result = self._values.get("skipped")
@@ -7703,7 +7718,8 @@ class CfnTask(
         def transferred(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.TransferredProperty"]]:
-            '''
+            '''Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-overrides.html#cfn-datasync-task-overrides-transferred
             '''
             result = self._values.get("transferred")
@@ -7713,7 +7729,8 @@ class CfnTask(
         def verified(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.VerifiedProperty"]]:
-            '''
+            '''Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify during your transfer.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-overrides.html#cfn-datasync-task-overrides-verified
             '''
             result = self._values.get("verified")
@@ -7747,10 +7764,11 @@ class CfnTask(
             s3_bucket_arn: typing.Optional[builtins.str] = None,
             subdirectory: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param bucket_access_role_arn: 
-            :param s3_bucket_arn: 
-            :param subdirectory: 
+            '''Specifies the Amazon S3 bucket where DataSync uploads your `task report <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html>`_ .
+
+            :param bucket_access_role_arn: Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket. For more information, see `Allowing DataSync to upload a task report to an Amazon S3 bucket <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html>`_ .
+            :param s3_bucket_arn: Specifies the ARN of the S3 bucket where DataSync uploads your report.
+            :param subdirectory: Specifies a bucket prefix for your report.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-s3.html
             :exampleMetadata: fixture=_generated
@@ -7782,7 +7800,10 @@ class CfnTask(
 
         @builtins.property
         def bucket_access_role_arn(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket.
+
+            For more information, see `Allowing DataSync to upload a task report to an Amazon S3 bucket <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html>`_ .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-s3.html#cfn-datasync-task-s3-bucketaccessrolearn
             '''
             result = self._values.get("bucket_access_role_arn")
@@ -7790,7 +7811,8 @@ class CfnTask(
 
         @builtins.property
         def s3_bucket_arn(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies the ARN of the S3 bucket where DataSync uploads your report.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-s3.html#cfn-datasync-task-s3-s3bucketarn
             '''
             result = self._values.get("s3_bucket_arn")
@@ -7798,7 +7820,8 @@ class CfnTask(
 
         @builtins.property
         def subdirectory(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies a bucket prefix for your report.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-s3.html#cfn-datasync-task-s3-subdirectory
             '''
             result = self._values.get("subdirectory")
@@ -7826,8 +7849,9 @@ class CfnTask(
             *,
             report_level: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param report_level: 
+            '''The reporting level for the skipped section of your DataSync task report.
+
+            :param report_level: Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. - ``ERRORS_ONLY`` : A report shows what DataSync was unable to skip. - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to skip.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-skipped.html
             :exampleMetadata: fixture=_generated
@@ -7851,7 +7875,11 @@ class CfnTask(
 
         @builtins.property
         def report_level(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't.
+
+            - ``ERRORS_ONLY`` : A report shows what DataSync was unable to skip.
+            - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to skip.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-skipped.html#cfn-datasync-task-skipped-reportlevel
             '''
             result = self._values.get("report_level")
@@ -7889,12 +7917,15 @@ class CfnTask(
             overrides: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnTask.OverridesProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             report_level: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param destination: 
-            :param output_type: 
-            :param object_version_ids: 
-            :param overrides: 
-            :param report_level: 
+            '''Specifies how you want to configure a task report, which provides detailed information about for your AWS DataSync transfer.
+
+            For more information, see `Task reports <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html>`_ .
+
+            :param destination: Specifies the Amazon S3 bucket where DataSync uploads your task report. For more information, see `Task reports <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html#task-report-access>`_ .
+            :param output_type: Specifies the type of task report that you want:. - ``SUMMARY_ONLY`` : Provides necessary details about your task, including the number of files, objects, and directories transferred and transfer duration. - ``STANDARD`` : Provides complete details about your task, including a full list of files, objects, and directories that were transferred, skipped, verified, and more.
+            :param object_version_ids: Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you `enable versioning on your bucket <https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html>`_ . Keep in mind that setting this to ``INCLUDE`` can increase the duration of your task execution.
+            :param overrides: Customizes the reporting level for aspects of your task report. For example, your report might generally only include errors, but you could specify that you want a list of successes and errors just for the files that DataSync attempted to delete in your destination location.
+            :param report_level: Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. - ``ERRORS_ONLY`` : A report shows what DataSync was unable to transfer, skip, verify, and delete. - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to transfer, skip, verify, and delete.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskreportconfig.html
             :exampleMetadata: fixture=_generated
@@ -7956,7 +7987,10 @@ class CfnTask(
         def destination(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnTask.DestinationProperty"]:
-            '''
+            '''Specifies the Amazon S3 bucket where DataSync uploads your task report.
+
+            For more information, see `Task reports <https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html#task-report-access>`_ .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskreportconfig.html#cfn-datasync-task-taskreportconfig-destination
             '''
             result = self._values.get("destination")
@@ -7965,7 +7999,11 @@ class CfnTask(
 
         @builtins.property
         def output_type(self) -> builtins.str:
-            '''
+            '''Specifies the type of task report that you want:.
+
+            - ``SUMMARY_ONLY`` : Provides necessary details about your task, including the number of files, objects, and directories transferred and transfer duration.
+            - ``STANDARD`` : Provides complete details about your task, including a full list of files, objects, and directories that were transferred, skipped, verified, and more.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskreportconfig.html#cfn-datasync-task-taskreportconfig-outputtype
             '''
             result = self._values.get("output_type")
@@ -7974,7 +8012,10 @@ class CfnTask(
 
         @builtins.property
         def object_version_ids(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies whether your task report includes the new version of each object transferred into an S3 bucket.
+
+            This only applies if you `enable versioning on your bucket <https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html>`_ . Keep in mind that setting this to ``INCLUDE`` can increase the duration of your task execution.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskreportconfig.html#cfn-datasync-task-taskreportconfig-objectversionids
             '''
             result = self._values.get("object_version_ids")
@@ -7984,7 +8025,10 @@ class CfnTask(
         def overrides(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnTask.OverridesProperty"]]:
-            '''
+            '''Customizes the reporting level for aspects of your task report.
+
+            For example, your report might generally only include errors, but you could specify that you want a list of successes and errors just for the files that DataSync attempted to delete in your destination location.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskreportconfig.html#cfn-datasync-task-taskreportconfig-overrides
             '''
             result = self._values.get("overrides")
@@ -7992,7 +8036,11 @@ class CfnTask(
 
         @builtins.property
         def report_level(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't.
+
+            - ``ERRORS_ONLY`` : A report shows what DataSync was unable to transfer, skip, verify, and delete.
+            - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to transfer, skip, verify, and delete.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskreportconfig.html#cfn-datasync-task-taskreportconfig-reportlevel
             '''
             result = self._values.get("report_level")
@@ -8074,8 +8122,9 @@ class CfnTask(
             *,
             report_level: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param report_level: 
+            '''The reporting level for the transferred section of your DataSync task report.
+
+            :param report_level: Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. - ``ERRORS_ONLY`` : A report shows what DataSync was unable to transfer. - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to transfer.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-transferred.html
             :exampleMetadata: fixture=_generated
@@ -8099,7 +8148,11 @@ class CfnTask(
 
         @builtins.property
         def report_level(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't.
+
+            - ``ERRORS_ONLY`` : A report shows what DataSync was unable to transfer.
+            - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to transfer.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-transferred.html#cfn-datasync-task-transferred-reportlevel
             '''
             result = self._values.get("report_level")
@@ -8127,8 +8180,9 @@ class CfnTask(
             *,
             report_level: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param report_level: 
+            '''The reporting level for the verified section of your DataSync task report.
+
+            :param report_level: Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't. - ``ERRORS_ONLY`` : A report shows what DataSync was unable to verify. - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to verify.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-verified.html
             :exampleMetadata: fixture=_generated
@@ -8152,7 +8206,11 @@ class CfnTask(
 
         @builtins.property
         def report_level(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't.
+
+            - ``ERRORS_ONLY`` : A report shows what DataSync was unable to verify.
+            - ``SUCCESSES_AND_ERRORS`` : A report shows what DataSync was able and unable to verify.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-verified.html#cfn-datasync-task-verified-reportlevel
             '''
             result = self._values.get("report_level")
@@ -8212,7 +8270,7 @@ class CfnTaskProps:
         :param options: Specifies the configuration options for a task. Some options include preserving file or object metadata and verifying data integrity. You can also override these options before starting an individual run of a task (also known as a *task execution* ). For more information, see `StartTaskExecution <https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html>`_ .
         :param schedule: Specifies a schedule used to periodically transfer files from a source to a destination location. The schedule should be specified in UTC time. For more information, see `Scheduling your task <https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html>`_ .
         :param tags: Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task. *Tags* are key-value pairs that help you manage, filter, and search for your DataSync resources.
-        :param task_report_config: 
+        :param task_report_config: Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-task.html
         :exampleMetadata: fixture=_generated
@@ -8436,7 +8494,8 @@ class CfnTaskProps:
     def task_report_config(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnTask.TaskReportConfigProperty]]:
-        '''
+        '''Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-task.html#cfn-datasync-task-taskreportconfig
         '''
         result = self._values.get("task_report_config")

aws_cdk/aws_dms/__init__.py

@@ -613,7 +613,7 @@ class CfnEndpoint(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param endpoint_type: The type of endpoint. Valid values are ``source`` and ``target`` .
-        :param engine_name: The type of engine for the endpoint, depending on the ``EndpointType`` value. *Valid values* : ``mysql`` | ``oracle`` | ``postgres`` | ``mariadb`` | ``aurora`` | ``aurora-postgresql`` | ``opensearch`` | ``redshift`` | ``s3`` | ``db2`` | ``azuredb`` | ``sybase`` | ``dynamodb`` | ``mongodb`` | ``kinesis`` | ``kafka`` | ``elasticsearch`` | ``docdb`` | ``sqlserver`` | ``neptune``
+        :param engine_name: The type of engine for the endpoint, depending on the ``EndpointType`` value. *Valid values* : ``mysql`` | ``oracle`` | ``postgres`` | ``mariadb`` | ``aurora`` | ``aurora-postgresql`` | ``opensearch`` | ``redshift`` | ``redshift-serverless`` | ``s3`` | ``db2`` | ``azuredb`` | ``sybase`` | ``dynamodb`` | ``mongodb`` | ``kinesis`` | ``kafka`` | ``elasticsearch`` | ``docdb`` | ``sqlserver`` | ``neptune``
         :param certificate_arn: The Amazon Resource Name (ARN) for the certificate.
         :param database_name: The name of the endpoint database. For a MySQL source or target endpoint, don't specify ``DatabaseName`` . To migrate to a specific database, use this setting and ``targetDbType`` .
         :param doc_db_settings: Settings in JSON format for the source and target DocumentDB endpoint. For more information about other available settings, see `Using extra connections attributes with Amazon DocumentDB as a source <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Source.DocumentDB.html#CHAP_Source.DocumentDB.ECAs>`_ and `Using Amazon DocumentDB as a target for AWS Database Migration Service <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Target.DocumentDB.html>`_ in the *AWS Database Migration Service User Guide* .
@@ -6165,7 +6165,7 @@ class CfnEndpointProps:
         '''Properties for defining a ``CfnEndpoint``.
 
         :param endpoint_type: The type of endpoint. Valid values are ``source`` and ``target`` .
-        :param engine_name: The type of engine for the endpoint, depending on the ``EndpointType`` value. *Valid values* : ``mysql`` | ``oracle`` | ``postgres`` | ``mariadb`` | ``aurora`` | ``aurora-postgresql`` | ``opensearch`` | ``redshift`` | ``s3`` | ``db2`` | ``azuredb`` | ``sybase`` | ``dynamodb`` | ``mongodb`` | ``kinesis`` | ``kafka`` | ``elasticsearch`` | ``docdb`` | ``sqlserver`` | ``neptune``
+        :param engine_name: The type of engine for the endpoint, depending on the ``EndpointType`` value. *Valid values* : ``mysql`` | ``oracle`` | ``postgres`` | ``mariadb`` | ``aurora`` | ``aurora-postgresql`` | ``opensearch`` | ``redshift`` | ``redshift-serverless`` | ``s3`` | ``db2`` | ``azuredb`` | ``sybase`` | ``dynamodb`` | ``mongodb`` | ``kinesis`` | ``kafka`` | ``elasticsearch`` | ``docdb`` | ``sqlserver`` | ``neptune``
         :param certificate_arn: The Amazon Resource Name (ARN) for the certificate.
         :param database_name: The name of the endpoint database. For a MySQL source or target endpoint, don't specify ``DatabaseName`` . To migrate to a specific database, use this setting and ``targetDbType`` .
         :param doc_db_settings: Settings in JSON format for the source and target DocumentDB endpoint. For more information about other available settings, see `Using extra connections attributes with Amazon DocumentDB as a source <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Source.DocumentDB.html#CHAP_Source.DocumentDB.ECAs>`_ and `Using Amazon DocumentDB as a target for AWS Database Migration Service <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Target.DocumentDB.html>`_ in the *AWS Database Migration Service User Guide* .
@@ -6589,7 +6589,7 @@ class CfnEndpointProps:
     def engine_name(self) -> builtins.str:
         '''The type of engine for the endpoint, depending on the ``EndpointType`` value.
 
-        *Valid values* : ``mysql`` | ``oracle`` | ``postgres`` | ``mariadb`` | ``aurora`` | ``aurora-postgresql`` | ``opensearch`` | ``redshift`` | ``s3`` | ``db2`` | ``azuredb`` | ``sybase`` | ``dynamodb`` | ``mongodb`` | ``kinesis`` | ``kafka`` | ``elasticsearch`` | ``docdb`` | ``sqlserver`` | ``neptune``
+        *Valid values* : ``mysql`` | ``oracle`` | ``postgres`` | ``mariadb`` | ``aurora`` | ``aurora-postgresql`` | ``opensearch`` | ``redshift`` | ``redshift-serverless`` | ``s3`` | ``db2`` | ``azuredb`` | ``sybase`` | ``dynamodb`` | ``mongodb`` | ``kinesis`` | ``kafka`` | ``elasticsearch`` | ``docdb`` | ``sqlserver`` | ``neptune``
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dms-endpoint.html#cfn-dms-endpoint-enginename
         '''

aws_cdk/aws_dynamodb/__init__.py

@@ -10508,7 +10508,7 @@ class TableProps(TableOptions):
             chain = sfn.Chain.start(custom).next(final_status)
             
             sm = sfn.StateMachine(self, "StateMachine",
-                definition=chain,
+                definition_body=sfn.DefinitionBody.from_chainable(chain),
                 timeout=Duration.seconds(30),
                 comment="a super cool state machine"
             )
@@ -12538,7 +12538,7 @@ class Table(
         chain = sfn.Chain.start(custom).next(final_status)
         
         sm = sfn.StateMachine(self, "StateMachine",
-            definition=chain,
+            definition_body=sfn.DefinitionBody.from_chainable(chain),
             timeout=Duration.seconds(30),
             comment="a super cool state machine"
         )

aws_cdk/aws_ec2/__init__.py

@@ -13411,7 +13411,7 @@ class CfnEIPAssociation(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param allocation_id: The allocation ID. This is required.
-        :param eip: Deprecated.
+        :param eip: 
         :param instance_id: The ID of the instance. The instance must have exactly one attached network interface. You can specify either the instance ID or the network interface ID, but not both.
         :param network_interface_id: The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID. You can specify either the instance ID or the network interface ID, but not both.
         :param private_ip_address: The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.
@@ -13489,7 +13489,6 @@ class CfnEIPAssociation(
     @builtins.property
     @jsii.member(jsii_name="eip")
     def eip(self) -> typing.Optional[builtins.str]:
-        '''Deprecated.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "eip"))
 
     @eip.setter
@@ -13563,7 +13562,7 @@ class CfnEIPAssociationProps:
         '''Properties for defining a ``CfnEIPAssociation``.
 
         :param allocation_id: The allocation ID. This is required.
-        :param eip: Deprecated.
+        :param eip: 
         :param instance_id: The ID of the instance. The instance must have exactly one attached network interface. You can specify either the instance ID or the network interface ID, but not both.
         :param network_interface_id: The ID of the network interface. If the instance has more than one network interface, you must specify a network interface ID. You can specify either the instance ID or the network interface ID, but not both.
         :param private_ip_address: The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.
@@ -13617,8 +13616,7 @@ class CfnEIPAssociationProps:
 
     @builtins.property
     def eip(self) -> typing.Optional[builtins.str]:
-        '''Deprecated.
-
+        '''
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-eipassociation.html#cfn-ec2-eipassociation-eip
         '''
         result = self._values.get("eip")
@@ -24700,7 +24698,7 @@ class CfnLaunchTemplate(
             :param disable_api_termination: If you set this parameter to ``true`` , you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can. To change this attribute after launch, use `ModifyInstanceAttribute <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html>`_ . Alternatively, if you set ``InstanceInitiatedShutdownBehavior`` to ``terminate`` , you can terminate the instance by running the shutdown command from the instance.
             :param ebs_optimized: Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized instance.
             :param elastic_gpu_specifications: An elastic GPU to associate with the instance.
-            :param elastic_inference_accelerators: The elastic inference accelerator for the instance.
+            :param elastic_inference_accelerators: An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads. You cannot specify accelerators from different generations in the same request. .. epigraph:: Starting April 15, 2023, AWS will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service.
             :param enclave_options: Indicates whether the instance is enabled for AWS Nitro Enclaves. For more information, see `What is AWS Nitro Enclaves? <https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html>`_ in the *AWS Nitro Enclaves User Guide* . You can't enable AWS Nitro Enclaves and hibernation on the same instance.
             :param hibernation_options: Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the `hibernation prerequisites <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hibernating-prerequisites.html>`_ . For more information, see `Hibernate your instance <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html>`_ in the *Amazon Elastic Compute Cloud User Guide* .
             :param iam_instance_profile: The name or Amazon Resource Name (ARN) of an IAM instance profile.
@@ -25127,7 +25125,14 @@ class CfnLaunchTemplate(
         def elastic_inference_accelerators(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnLaunchTemplate.LaunchTemplateElasticInferenceAcceleratorProperty"]]]]:
-            '''The elastic inference accelerator for the instance.
+            '''An elastic inference accelerator to associate with the instance.
+
+            Elastic inference accelerators are a resource you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads.
+
+            You cannot specify accelerators from different generations in the same request.
+            .. epigraph::
+
+               Starting April 15, 2023, AWS will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-launchtemplate-launchtemplatedata.html#cfn-ec2-launchtemplate-launchtemplatedata-elasticinferenceaccelerators
             '''

aws_cdk/aws_ecs/__init__.py

@@ -496,8 +496,7 @@ new_container.add_secret("API_KEY", ecs.Secret.from_secrets_manager(secret))
 new_container.add_secret("DB_PASSWORD", ecs.Secret.from_secrets_manager(secret, "password"))
 ```
 
-The task execution role is automatically granted read permissions on the secrets/parameters. Support for environment
-files is restricted to the EC2 launch type for files hosted on S3. Further details provided in the AWS documentation
+The task execution role is automatically granted read permissions on the secrets/parameters. Further details provided in the AWS documentation
 about [specifying environment variables](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/taskdef-envfiles.html).
 
 ### Linux parameters
@@ -19207,20 +19206,29 @@ class ContainerImage(
 
     Example::
 
-        import aws_cdk as cdk
+        # cluster: ecs.Cluster
         
-        # my_secret: secretsmanager.ISecret
+        load_balanced_fargate_service = ecs_patterns.ApplicationLoadBalancedFargateService(self, "Service",
+            cluster=cluster,
+            memory_limit_mi_b=1024,
+            desired_count=1,
+            cpu=512,
+            task_image_options=ecsPatterns.ApplicationLoadBalancedTaskImageOptions(
+                image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample")
+            )
+        )
+        
+        scalable_target = load_balanced_fargate_service.service.auto_scale_task_count(
+            min_capacity=1,
+            max_capacity=20
+        )
         
+        scalable_target.scale_on_cpu_utilization("CpuScaling",
+            target_utilization_percent=50
+        )
         
-        job_defn = batch.EcsJobDefinition(self, "JobDefn",
-            container=batch.EcsEc2ContainerDefinition(self, "containerDefn",
-                image=ecs.ContainerImage.from_registry("public.ecr.aws/amazonlinux/amazonlinux:latest"),
-                memory=cdk.Size.mebibytes(2048),
-                cpu=256,
-                secrets={
-                    "MY_SECRET_ENV_VAR": batch.Secret.from_secrets_manager(my_secret)
-                }
-            )
+        scalable_target.scale_on_memory_utilization("MemoryScaling",
+            target_utilization_percent=50
         )
     '''
 
@@ -19317,18 +19325,18 @@ class ContainerImage(
     def from_ecr_repository(
         cls,
         repository: _IRepository_e6004aa6,
-        tag: typing.Optional[builtins.str] = None,
+        tag_or_digest: typing.Optional[builtins.str] = None,
     ) -> "EcrImage":
         '''Reference an image in an ECR repository.
 
-        :param repository: -
-        :param tag: -
+        :param repository: ECR repository.
+        :param tag_or_digest: Optional image tag or digest (digests must start with ``sha256:``).
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c7678d92c566cb839a4e76a199bb9ba47a55910493c94a6a2568984d1b6bd374)
             check_type(argname="argument repository", value=repository, expected_type=type_hints["repository"])
-            check_type(argname="argument tag", value=tag, expected_type=type_hints["tag"])
-        return typing.cast("EcrImage", jsii.sinvoke(cls, "fromEcrRepository", [repository, tag]))
+            check_type(argname="argument tag_or_digest", value=tag_or_digest, expected_type=type_hints["tag_or_digest"])
+        return typing.cast("EcrImage", jsii.sinvoke(cls, "fromEcrRepository", [repository, tag_or_digest]))
 
     @jsii.member(jsii_name="fromRegistry")
     @builtins.classmethod
@@ -21127,6 +21135,26 @@ class EcsOptimizedImage(
 
         return typing.cast("EcsOptimizedImage", jsii.sinvoke(cls, "amazonLinux2", [hardware_type, options]))
 
+    @jsii.member(jsii_name="amazonLinux2023")
+    @builtins.classmethod
+    def amazon_linux2023(
+        cls,
+        hardware_type: typing.Optional[AmiHardwareType] = None,
+        *,
+        cached_in_context: typing.Optional[builtins.bool] = None,
+    ) -> "EcsOptimizedImage":
+        '''Construct an Amazon Linux 2023 image from the latest ECS Optimized AMI published in SSM.
+
+        :param hardware_type: ECS-optimized AMI variant to use.
+        :param cached_in_context: Whether the AMI ID is cached to be stable between deployments. By default, the newest image is used on each deployment. This will cause instances to be replaced whenever a new version is released, and may cause downtime if there aren't enough running instances in the AutoScalingGroup to reschedule the tasks on. If set to true, the AMI ID will be cached in ``cdk.context.json`` and the same value will be used on future runs. Your instances will not be replaced but your AMI version will grow old over time. To refresh the AMI lookup, you will have to evict the value from the cache using the ``cdk context`` command. See https://docs.aws.amazon.com/cdk/latest/guide/context.html for more information. Can not be set to ``true`` in environment-agnostic stacks. Default: false
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__fc44eec88f6aaee7e170f453974183a08768efc2af4f04d00c94c131fb83f5da)
+            check_type(argname="argument hardware_type", value=hardware_type, expected_type=type_hints["hardware_type"])
+        options = EcsOptimizedImageOptions(cached_in_context=cached_in_context)
+
+        return typing.cast("EcsOptimizedImage", jsii.sinvoke(cls, "amazonLinux2023", [hardware_type, options]))
+
     @jsii.member(jsii_name="windows")
     @builtins.classmethod
     def windows(
@@ -38948,7 +38976,7 @@ def _typecheckingstub__56a966c7a28ee434f164ef54e3efaa94f5c7d56a677eccaf0a5a33efd
 
 def _typecheckingstub__c7678d92c566cb839a4e76a199bb9ba47a55910493c94a6a2568984d1b6bd374(
     repository: _IRepository_e6004aa6,
-    tag: typing.Optional[builtins.str] = None,
+    tag_or_digest: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -39125,6 +39153,14 @@ def _typecheckingstub__5924678ba20215bbadbd6bba47ff2a6c9af00997d08c131de1b7efc27
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__fc44eec88f6aaee7e170f453974183a08768efc2af4f04d00c94c131fb83f5da(
+    hardware_type: typing.Optional[AmiHardwareType] = None,
+    *,
+    cached_in_context: typing.Optional[builtins.bool] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__2b2ecfae2d485e25e72afeff56a0440720bb0614429d89d481532900bc2f7e9c(
     windows_version: WindowsOptimizedVersion,
     *,