aws-sdk-datasync 1.64.0 → 1.66.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57f28f79db439d714373ac5f32860203ba051d0049a3b3a999ae8dea31aa1675
-  data.tar.gz: 7719ec1da51d741b92c4de227f2040219aac876f1538625397ff91027a972af4
+  metadata.gz: 500986650a17cee914cf461d341c601891ffe719060e282729af743176f6618a
+  data.tar.gz: 99226e389e7422135db7159506f9f0fb93c623ede75cf04fe34e112495966944
 SHA512:
-  metadata.gz: ff312076f54c88de8792694c943bfca0dba6163fca652a46eb675a36173bfc7d96a934ac89f7cd0adab30ebd612fd68cbf56fde5157fe05695b5879ec8b6f13e
-  data.tar.gz: 992649735bbc619082bb1f6a9e023a7250a13e3b19cb60dd239c9d579213f1958f99305616ec0dbe0b7aa032a478fc0a5c6ddf970d82f8b894747084ca44f83c
+  metadata.gz: 45c4b3b5ab172d62013b3a7a753bd2bc6ba1df49ebbb49f0f55656ffa1d3fd9af172cd6a75294bae188bded7049b903e896dcf97541739d4a54fd1da7c5ca702
+  data.tar.gz: 825ed2e9fe2a63b7ba0d238cbdda2ba80ceec16937a6595211ca581319fc7225aefe74c2041b97380984e99f5fdfb3f13c84e2d7626b3727dacf167c86a64268

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.66.0 (2023-09-15)
+------------------
+
+* Feature - Documentation-only updates for AWS DataSync.
+
+1.65.0 (2023-08-30)
+------------------
+
+* Feature - AWS DataSync introduces Task Reports, a new feature that provides detailed reports of data transfer operations for each task execution.
+
 1.64.0 (2023-08-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.64.0
+1.66.0

data/lib/aws-sdk-datasync/client.rb

@@ -1665,11 +1665,11 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Configures a task, which defines where and how DataSync transfers your
-    # data.
+    # Configures a transfer task, which defines where and how DataSync moves
+    # your data.
     #
-    # A task includes a source location, a destination location, and the
-    # preferences for how and when you want to transfer your data (such as
+    # A task includes a source location, destination location, and the
+    # options for how and when you want to transfer your data (such as
     # bandwidth limits, scheduling, among other options).
     #
     # If you're planning to transfer data to or from an Amazon S3 location,
@@ -1742,6 +1742,10 @@ module Aws::DataSync
     #
     #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
     #
+    # @option params [Types::TaskReportConfig] :task_report_config
+    #   Specifies how you want to configure a task report, which provides
+    #   detailed information about for your DataSync transfer.
+    #
     # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1791,6 +1795,32 @@ module Aws::DataSync
     #         value: "FilterValue",
     #       },
     #     ],
+    #     task_report_config: {
+    #       destination: {
+    #         s3: {
+    #           subdirectory: "S3Subdirectory",
+    #           s3_bucket_arn: "S3BucketArn", # required
+    #           bucket_access_role_arn: "IamRoleArn", # required
+    #         },
+    #       },
+    #       output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
+    #       report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #       object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
+    #       overrides: {
+    #         transferred: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         verified: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         deleted: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         skipped: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -1856,7 +1886,7 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Deletes an DataSync task.
+    # Deletes an DataSync transfer task.
     #
     # @option params [required, String] :task_arn
     #   Specifies the Amazon Resource Name (ARN) of the task that you want to
@@ -2759,6 +2789,7 @@ module Aws::DataSync
     #   * {Types::DescribeTaskResponse#error_detail #error_detail} => String
     #   * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
     #   * {Types::DescribeTaskResponse#includes #includes} => Array<Types::FilterRule>
+    #   * {Types::DescribeTaskResponse#task_report_config #task_report_config} => Types::TaskReportConfig
     #
     # @example Request syntax with placeholder values
     #
@@ -2804,6 +2835,16 @@ module Aws::DataSync
     #   resp.includes #=> Array
     #   resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
     #   resp.includes[0].value #=> String
+    #   resp.task_report_config.destination.s3.subdirectory #=> String
+    #   resp.task_report_config.destination.s3.s3_bucket_arn #=> String
+    #   resp.task_report_config.destination.s3.bucket_access_role_arn #=> String
+    #   resp.task_report_config.output_type #=> String, one of "SUMMARY_ONLY", "STANDARD"
+    #   resp.task_report_config.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.object_version_ids #=> String, one of "INCLUDE", "NONE"
+    #   resp.task_report_config.overrides.transferred.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.overrides.verified.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.overrides.deleted.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.overrides.skipped.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
     #
@@ -2814,11 +2855,13 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Provides information about an DataSync transfer task that's running.
+    # Provides information about an execution of your DataSync task. You can
+    # use this operation to help monitor the progress of an ongoing transfer
+    # or check the results of the transfer.
     #
     # @option params [required, String] :task_execution_arn
-    #   Specifies the Amazon Resource Name (ARN) of the transfer task that's
-    #   running.
+    #   Specifies the Amazon Resource Name (ARN) of the task execution that
+    #   you want information about.
     #
     # @return [Types::DescribeTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2835,6 +2878,12 @@ module Aws::DataSync
     #   * {Types::DescribeTaskExecutionResponse#bytes_transferred #bytes_transferred} => Integer
     #   * {Types::DescribeTaskExecutionResponse#result #result} => Types::TaskExecutionResultDetail
     #   * {Types::DescribeTaskExecutionResponse#bytes_compressed #bytes_compressed} => Integer
+    #   * {Types::DescribeTaskExecutionResponse#task_report_config #task_report_config} => Types::TaskReportConfig
+    #   * {Types::DescribeTaskExecutionResponse#files_deleted #files_deleted} => Integer
+    #   * {Types::DescribeTaskExecutionResponse#files_skipped #files_skipped} => Integer
+    #   * {Types::DescribeTaskExecutionResponse#files_verified #files_verified} => Integer
+    #   * {Types::DescribeTaskExecutionResponse#report_result #report_result} => Types::ReportResult
+    #   * {Types::DescribeTaskExecutionResponse#estimated_files_to_delete #estimated_files_to_delete} => Integer
     #
     # @example Request syntax with placeholder values
     #
@@ -2883,6 +2932,23 @@ module Aws::DataSync
     #   resp.result.error_code #=> String
     #   resp.result.error_detail #=> String
     #   resp.bytes_compressed #=> Integer
+    #   resp.task_report_config.destination.s3.subdirectory #=> String
+    #   resp.task_report_config.destination.s3.s3_bucket_arn #=> String
+    #   resp.task_report_config.destination.s3.bucket_access_role_arn #=> String
+    #   resp.task_report_config.output_type #=> String, one of "SUMMARY_ONLY", "STANDARD"
+    #   resp.task_report_config.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.object_version_ids #=> String, one of "INCLUDE", "NONE"
+    #   resp.task_report_config.overrides.transferred.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.overrides.verified.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.overrides.deleted.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.task_report_config.overrides.skipped.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
+    #   resp.files_deleted #=> Integer
+    #   resp.files_skipped #=> Integer
+    #   resp.files_verified #=> Integer
+    #   resp.report_result.status #=> String, one of "PENDING", "SUCCESS", "ERROR"
+    #   resp.report_result.error_code #=> String
+    #   resp.report_result.error_detail #=> String
+    #   resp.estimated_files_to_delete #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
     #
@@ -2902,17 +2968,10 @@ module Aws::DataSync
     # Once generated, you can view your recommendations by using the
     # [DescribeStorageSystemResources][2] operation.
     #
-    # <note markdown="1"> If your [discovery job completes successfully][3], you don't need to
-    # use this operation. DataSync Discovery generates the recommendations
-    # for you automatically.
-    #
-    #  </note>
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
     # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeStorageSystemResources.html
-    # [3]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-job-statuses.html#discovery-job-statuses-table
     #
     # @option params [required, String] :discovery_job_arn
     #   Specifies the Amazon Resource Name (ARN) of the discovery job that
@@ -3381,8 +3440,8 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Starts an DataSync task. For each task, you can only run one task
-    # execution at a time.
+    # Starts an DataSync transfer task. For each task, you can only run one
+    # task execution at a time.
     #
     # There are several phases to a task execution. For more information,
     # see [Task execution statuses][1].
@@ -3402,13 +3461,13 @@ module Aws::DataSync
     #   start.
     #
     # @option params [Types::Options] :override_options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
+    #   Indicates how your transfer task is configured. These options include
+    #   how DataSync handles files, objects, and their associated metadata
+    #   during your transfer. You also can specify how to verify data
+    #   integrity, set bandwidth limits for your task, among other options.
     #
-    #   Each task setting has a default value. Unless you need to, you don't
-    #   have to configure any of these `Options` before starting your task.
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #
     # @option params [Array<Types::FilterRule>] :includes
     #   Specifies a list of filter rules that determines which files to
@@ -3430,6 +3489,10 @@ module Aws::DataSync
     #   *Tags* are key-value pairs that help you manage, filter, and search
     #   for your DataSync resources.
     #
+    # @option params [Types::TaskReportConfig] :task_report_config
+    #   Specifies how you want to configure a task report, which provides
+    #   detailed information about for your DataSync transfer.
+    #
     # @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
@@ -3473,6 +3536,32 @@ module Aws::DataSync
     #         value: "TagValue",
     #       },
     #     ],
+    #     task_report_config: {
+    #       destination: {
+    #         s3: {
+    #           subdirectory: "S3Subdirectory",
+    #           s3_bucket_arn: "S3BucketArn", # required
+    #           bucket_access_role_arn: "IamRoleArn", # required
+    #         },
+    #       },
+    #       output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
+    #       report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #       object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
+    #       overrides: {
+    #         transferred: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         verified: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         deleted: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         skipped: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -4079,20 +4168,20 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Updates the metadata associated with a task.
+    # Updates the configuration of a DataSync transfer task.
     #
     # @option params [required, String] :task_arn
     #   The Amazon Resource Name (ARN) of the resource name of the task to
     #   update.
     #
     # @option params [Types::Options] :options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
+    #   Indicates how your transfer task is configured. These options include
+    #   how DataSync handles files, objects, and their associated metadata
+    #   during your transfer. You also can specify how to verify data
+    #   integrity, set bandwidth limits for your task, among other options.
     #
-    #   Each task setting has a default value. Unless you need to, you don't
-    #   have to configure any of these `Options` before starting your task.
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #
     # @option params [Array<Types::FilterRule>] :excludes
     #   Specifies a list of filter rules that exclude specific data during
@@ -4131,6 +4220,10 @@ module Aws::DataSync
     #
     #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
     #
+    # @option params [Types::TaskReportConfig] :task_report_config
+    #   Specifies how you want to configure a task report, which provides
+    #   detailed information about for your DataSync transfer.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -4171,6 +4264,32 @@ module Aws::DataSync
     #         value: "FilterValue",
     #       },
     #     ],
+    #     task_report_config: {
+    #       destination: {
+    #         s3: {
+    #           subdirectory: "S3Subdirectory",
+    #           s3_bucket_arn: "S3BucketArn", # required
+    #           bucket_access_role_arn: "IamRoleArn", # required
+    #         },
+    #       },
+    #       output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
+    #       report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #       object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
+    #       overrides: {
+    #         transferred: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         verified: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         deleted: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #         skipped: {
+    #           report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
@@ -4182,11 +4301,11 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Modifies a running DataSync task.
+    # Updates the configuration of a running DataSync task execution.
     #
     # <note markdown="1"> Currently, the only `Option` that you can modify with
     # `UpdateTaskExecution` is ` BytesPerSecond `, which throttles bandwidth
-    # for a running or queued task.
+    # for a running or queued task execution.
     #
     #  </note>
     #
@@ -4195,13 +4314,13 @@ module Aws::DataSync
     #   you're updating.
     #
     # @option params [required, Types::Options] :options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
+    #   Indicates how your transfer task is configured. These options include
+    #   how DataSync handles files, objects, and their associated metadata
+    #   during your transfer. You also can specify how to verify data
+    #   integrity, set bandwidth limits for your task, among other options.
     #
-    #   Each task setting has a default value. Unless you need to, you don't
-    #   have to configure any of these `Options` before starting your task.
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4250,7 +4369,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.64.0'
+      context[:gem_version] = '1.66.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-datasync/client_api.rb

@@ -218,6 +218,7 @@ module Aws::DataSync
     ObjectStorageServerPort = Shapes::IntegerShape.new(name: 'ObjectStorageServerPort')
     ObjectStorageServerProtocol = Shapes::StringShape.new(name: 'ObjectStorageServerProtocol')
     ObjectTags = Shapes::StringShape.new(name: 'ObjectTags')
+    ObjectVersionIds = Shapes::StringShape.new(name: 'ObjectVersionIds')
     OnPremConfig = Shapes::StructureShape.new(name: 'OnPremConfig')
     Operator = Shapes::StringShape.new(name: 'Operator')
     Options = Shapes::StructureShape.new(name: 'Options')
@@ -243,6 +244,13 @@ module Aws::DataSync
     RecommendationsConfigMap = Shapes::MapShape.new(name: 'RecommendationsConfigMap')
     RemoveStorageSystemRequest = Shapes::StructureShape.new(name: 'RemoveStorageSystemRequest')
     RemoveStorageSystemResponse = Shapes::StructureShape.new(name: 'RemoveStorageSystemResponse')
+    ReportDestination = Shapes::StructureShape.new(name: 'ReportDestination')
+    ReportDestinationS3 = Shapes::StructureShape.new(name: 'ReportDestinationS3')
+    ReportLevel = Shapes::StringShape.new(name: 'ReportLevel')
+    ReportOutputType = Shapes::StringShape.new(name: 'ReportOutputType')
+    ReportOverride = Shapes::StructureShape.new(name: 'ReportOverride')
+    ReportOverrides = Shapes::StructureShape.new(name: 'ReportOverrides')
+    ReportResult = Shapes::StructureShape.new(name: 'ReportResult')
     ResourceDetails = Shapes::StructureShape.new(name: 'ResourceDetails')
     ResourceFilters = Shapes::MapShape.new(name: 'ResourceFilters')
     ResourceId = Shapes::StringShape.new(name: 'ResourceId')
@@ -293,6 +301,7 @@ module Aws::DataSync
     TaskList = Shapes::ListShape.new(name: 'TaskList')
     TaskListEntry = Shapes::StructureShape.new(name: 'TaskListEntry')
     TaskQueueing = Shapes::StringShape.new(name: 'TaskQueueing')
+    TaskReportConfig = Shapes::StructureShape.new(name: 'TaskReportConfig')
     TaskSchedule = Shapes::StructureShape.new(name: 'TaskSchedule')
     TaskStatus = Shapes::StringShape.new(name: 'TaskStatus')
     Throughput = Shapes::StructureShape.new(name: 'Throughput')
@@ -516,6 +525,7 @@ module Aws::DataSync
     CreateTaskRequest.add_member(:schedule, Shapes::ShapeRef.new(shape: TaskSchedule, location_name: "Schedule"))
     CreateTaskRequest.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
     CreateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
+    CreateTaskRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
     CreateTaskRequest.struct_class = Types::CreateTaskRequest
 
     CreateTaskResponse.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
@@ -748,6 +758,12 @@ module Aws::DataSync
     DescribeTaskExecutionResponse.add_member(:bytes_transferred, Shapes::ShapeRef.new(shape: long, location_name: "BytesTransferred"))
     DescribeTaskExecutionResponse.add_member(:result, Shapes::ShapeRef.new(shape: TaskExecutionResultDetail, location_name: "Result"))
     DescribeTaskExecutionResponse.add_member(:bytes_compressed, Shapes::ShapeRef.new(shape: long, location_name: "BytesCompressed"))
+    DescribeTaskExecutionResponse.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
+    DescribeTaskExecutionResponse.add_member(:files_deleted, Shapes::ShapeRef.new(shape: long, location_name: "FilesDeleted"))
+    DescribeTaskExecutionResponse.add_member(:files_skipped, Shapes::ShapeRef.new(shape: long, location_name: "FilesSkipped"))
+    DescribeTaskExecutionResponse.add_member(:files_verified, Shapes::ShapeRef.new(shape: long, location_name: "FilesVerified"))
+    DescribeTaskExecutionResponse.add_member(:report_result, Shapes::ShapeRef.new(shape: ReportResult, location_name: "ReportResult"))
+    DescribeTaskExecutionResponse.add_member(:estimated_files_to_delete, Shapes::ShapeRef.new(shape: long, location_name: "EstimatedFilesToDelete"))
     DescribeTaskExecutionResponse.struct_class = Types::DescribeTaskExecutionResponse
 
     DescribeTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
@@ -769,6 +785,7 @@ module Aws::DataSync
     DescribeTaskResponse.add_member(:error_detail, Shapes::ShapeRef.new(shape: string, location_name: "ErrorDetail"))
     DescribeTaskResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
     DescribeTaskResponse.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
+    DescribeTaskResponse.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
     DescribeTaskResponse.struct_class = Types::DescribeTaskResponse
 
     DestinationNetworkInterfaceArns.member = Shapes::ShapeRef.new(shape: NetworkInterfaceArn)
@@ -1052,6 +1069,28 @@ module Aws::DataSync
 
     RemoveStorageSystemResponse.struct_class = Types::RemoveStorageSystemResponse
 
+    ReportDestination.add_member(:s3, Shapes::ShapeRef.new(shape: ReportDestinationS3, location_name: "S3"))
+    ReportDestination.struct_class = Types::ReportDestination
+
+    ReportDestinationS3.add_member(:subdirectory, Shapes::ShapeRef.new(shape: S3Subdirectory, location_name: "Subdirectory"))
+    ReportDestinationS3.add_member(:s3_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "S3BucketArn"))
+    ReportDestinationS3.add_member(:bucket_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "BucketAccessRoleArn"))
+    ReportDestinationS3.struct_class = Types::ReportDestinationS3
+
+    ReportOverride.add_member(:report_level, Shapes::ShapeRef.new(shape: ReportLevel, location_name: "ReportLevel"))
+    ReportOverride.struct_class = Types::ReportOverride
+
+    ReportOverrides.add_member(:transferred, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Transferred"))
+    ReportOverrides.add_member(:verified, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Verified"))
+    ReportOverrides.add_member(:deleted, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Deleted"))
+    ReportOverrides.add_member(:skipped, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Skipped"))
+    ReportOverrides.struct_class = Types::ReportOverrides
+
+    ReportResult.add_member(:status, Shapes::ShapeRef.new(shape: PhaseStatus, location_name: "Status"))
+    ReportResult.add_member(:error_code, Shapes::ShapeRef.new(shape: string, location_name: "ErrorCode"))
+    ReportResult.add_member(:error_detail, Shapes::ShapeRef.new(shape: string, location_name: "ErrorDetail"))
+    ReportResult.struct_class = Types::ReportResult
+
     ResourceDetails.add_member(:net_app_ontapsv_ms, Shapes::ShapeRef.new(shape: NetAppONTAPSVMs, location_name: "NetAppONTAPSVMs"))
     ResourceDetails.add_member(:net_app_ontap_volumes, Shapes::ShapeRef.new(shape: NetAppONTAPVolumes, location_name: "NetAppONTAPVolumes"))
     ResourceDetails.add_member(:net_app_ontap_clusters, Shapes::ShapeRef.new(shape: NetAppONTAPClusters, location_name: "NetAppONTAPClusters"))
@@ -1091,6 +1130,7 @@ module Aws::DataSync
     StartTaskExecutionRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
     StartTaskExecutionRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
     StartTaskExecutionRequest.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
+    StartTaskExecutionRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
     StartTaskExecutionRequest.struct_class = Types::StartTaskExecutionRequest
 
     StartTaskExecutionResponse.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, location_name: "TaskExecutionArn"))
@@ -1150,6 +1190,13 @@ module Aws::DataSync
     TaskListEntry.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
     TaskListEntry.struct_class = Types::TaskListEntry
 
+    TaskReportConfig.add_member(:destination, Shapes::ShapeRef.new(shape: ReportDestination, location_name: "Destination"))
+    TaskReportConfig.add_member(:output_type, Shapes::ShapeRef.new(shape: ReportOutputType, location_name: "OutputType"))
+    TaskReportConfig.add_member(:report_level, Shapes::ShapeRef.new(shape: ReportLevel, location_name: "ReportLevel"))
+    TaskReportConfig.add_member(:object_version_ids, Shapes::ShapeRef.new(shape: ObjectVersionIds, location_name: "ObjectVersionIds"))
+    TaskReportConfig.add_member(:overrides, Shapes::ShapeRef.new(shape: ReportOverrides, location_name: "Overrides"))
+    TaskReportConfig.struct_class = Types::TaskReportConfig
+
     TaskSchedule.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpressionCron, required: true, location_name: "ScheduleExpression"))
     TaskSchedule.struct_class = Types::TaskSchedule
 
@@ -1259,6 +1306,7 @@ module Aws::DataSync
     UpdateTaskRequest.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
     UpdateTaskRequest.add_member(:cloud_watch_log_group_arn, Shapes::ShapeRef.new(shape: LogGroupArn, location_name: "CloudWatchLogGroupArn"))
     UpdateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
+    UpdateTaskRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
     UpdateTaskRequest.struct_class = Types::UpdateTaskRequest
 
     UpdateTaskResponse.struct_class = Types::UpdateTaskResponse

data/lib/aws-sdk-datasync/types.rb

@@ -133,8 +133,8 @@ module Aws::DataSync
     # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens
     #
     # @!attribute [rw] token
-    #   Specifies a SAS token that provides permissions at the Azure storage
-    #   account, container, or folder level.
+    #   Specifies a SAS token that provides permissions to access your Azure
+    #   Blob Storage.
     #
     #   The token is part of the SAS URI string that comes after the storage
     #   resource URI and a question mark. A token looks something like this:
@@ -1282,6 +1282,11 @@ module Aws::DataSync
     #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
     #   @return [Array<Types::FilterRule>]
     #
+    # @!attribute [rw] task_report_config
+    #   Specifies how you want to configure a task report, which provides
+    #   detailed information about for your DataSync transfer.
+    #   @return [Types::TaskReportConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateTaskRequest AWS API Documentation
     #
     class CreateTaskRequest < Struct.new(
@@ -1293,7 +1298,8 @@ module Aws::DataSync
       :excludes,
       :schedule,
       :tags,
-      :includes)
+      :includes,
+      :task_report_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2446,8 +2452,8 @@ module Aws::DataSync
     # DescribeTaskExecutionRequest
     #
     # @!attribute [rw] task_execution_arn
-    #   Specifies the Amazon Resource Name (ARN) of the transfer task
-    #   that's running.
+    #   Specifies the Amazon Resource Name (ARN) of the task execution that
+    #   you want information about.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecutionRequest AWS API Documentation
@@ -2461,9 +2467,9 @@ module Aws::DataSync
     # DescribeTaskExecutionResponse
     #
     # @!attribute [rw] task_execution_arn
-    #   The Amazon Resource Name (ARN) of the task execution that was
-    #   described. `TaskExecutionArn` is hierarchical and includes `TaskArn`
-    #   for the task that was executed.
+    #   The ARN of the task execution that you wanted information about.
+    #   `TaskExecutionArn` is hierarchical and includes `TaskArn` for the
+    #   task that was executed.
     #
     #   For example, a `TaskExecution` value with the ARN
     #   `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b`
@@ -2473,20 +2479,17 @@ module Aws::DataSync
     #
     # @!attribute [rw] status
     #   The status of the task execution.
-    #
-    #   For detailed information about task execution statuses, see
-    #   Understanding Task Statuses in the *DataSync User Guide.*
     #   @return [String]
     #
     # @!attribute [rw] options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
-    #
-    #   Each task setting has a default value. Unless you need to, you
-    #   don't have to configure any of these `Options` before starting your
-    #   task.
+    #   Indicates how your transfer task is configured. These options
+    #   include how DataSync handles files, objects, and their associated
+    #   metadata during your transfer. You also can specify how to verify
+    #   data integrity, set bandwidth limits for your task, among other
+    #   options.
+    #
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #   @return [Types::Options]
     #
     # @!attribute [rw] excludes
@@ -2510,41 +2513,39 @@ module Aws::DataSync
     #   @return [Array<Types::FilterRule>]
     #
     # @!attribute [rw] start_time
-    #   The time that the task execution was started.
+    #   The time when the task execution started.
     #   @return [Time]
     #
     # @!attribute [rw] estimated_files_to_transfer
-    #   The expected number of files that is to be transferred over the
-    #   network. This value is calculated during the `PREPARING` phase
-    #   before the `TRANSFERRING` phase of the task execution. This value is
-    #   the expected number of files to be transferred. It's calculated
-    #   based on comparing the content of the source and destination
-    #   locations and finding the delta that needs to be transferred.
+    #   The expected number of files, objects, and directories that DataSync
+    #   will transfer over the network. This value is calculated during the
+    #   task execution's `PREPARING` phase before the `TRANSFERRING` phase.
+    #   The calculation is based on comparing the content of the source and
+    #   destination locations and finding the difference that needs to be
+    #   transferred.
     #   @return [Integer]
     #
     # @!attribute [rw] estimated_bytes_to_transfer
-    #   The estimated physical number of bytes that is to be transferred
-    #   over the network.
+    #   The estimated physical number of bytes that will transfer over the
+    #   network.
     #   @return [Integer]
     #
     # @!attribute [rw] files_transferred
-    #   The actual number of files that was transferred over the network.
-    #   This value is calculated and updated on an ongoing basis during the
-    #   `TRANSFERRING` phase of the task execution. It's updated
-    #   periodically when each file is read from the source and sent over
-    #   the network.
+    #   The actual number of files, objects, and directories that DataSync
+    #   transferred over the network. This value is updated periodically
+    #   during the task execution's `TRANSFERRING` phase when something is
+    #   read from the source and sent over the network.
     #
-    #   If failures occur during a transfer, this value can be less than
+    #   If DataSync fails to transfer something, this value can be less than
     #   `EstimatedFilesToTransfer`. In some cases, this value can also be
     #   greater than `EstimatedFilesToTransfer`. This element is
     #   implementation-specific for some location types, so don't use it as
-    #   an indicator for a correct file number or to monitor your task
+    #   an exact indication of what transferred or to monitor your task
     #   execution.
     #   @return [Integer]
     #
     # @!attribute [rw] bytes_written
-    #   The number of logical bytes written to the destination Amazon Web
-    #   Services storage resource.
+    #   The number of logical bytes written to the destination location.
     #   @return [Integer]
     #
     # @!attribute [rw] bytes_transferred
@@ -2562,6 +2563,52 @@ module Aws::DataSync
     #   `BytesTransferred` unless the data isn't compressible.
     #   @return [Integer]
     #
+    # @!attribute [rw] task_report_config
+    #   The configuration of your task report, which provides detailed
+    #   information about for your DataSync transfer.
+    #   @return [Types::TaskReportConfig]
+    #
+    # @!attribute [rw] files_deleted
+    #   The number of files, objects, and directories that DataSync deleted
+    #   in your destination location. If you don't [configure your task][1]
+    #   to delete data in the destination that isn't in the source, the
+    #   value is always `0`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
+    #   @return [Integer]
+    #
+    # @!attribute [rw] files_skipped
+    #   The number of files, objects, and directories that DataSync skipped
+    #   during your transfer.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] files_verified
+    #   The number of files, objects, and directories that DataSync verified
+    #   during your transfer.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] report_result
+    #   Indicates whether DataSync generated a complete [task report][1] for
+    #   your transfer.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #   @return [Types::ReportResult]
+    #
+    # @!attribute [rw] estimated_files_to_delete
+    #   The expected number of files, objects, and directories that DataSync
+    #   will delete in your destination location. If you don't [configure
+    #   your task][1] to delete data in the destination that isn't in the
+    #   source, the value is always `0`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecutionResponse AWS API Documentation
     #
     class DescribeTaskExecutionResponse < Struct.new(
@@ -2577,7 +2624,13 @@ module Aws::DataSync
       :bytes_written,
       :bytes_transferred,
       :result,
-      :bytes_compressed)
+      :bytes_compressed,
+      :task_report_config,
+      :files_deleted,
+      :files_skipped,
+      :files_verified,
+      :report_result,
+      :estimated_files_to_delete)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2709,6 +2762,15 @@ module Aws::DataSync
     #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
     #   @return [Array<Types::FilterRule>]
     #
+    # @!attribute [rw] task_report_config
+    #   The configuration of your task report. For more information, see
+    #   [Creating a task report][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #   @return [Types::TaskReportConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskResponse AWS API Documentation
     #
     class DescribeTaskResponse < Struct.new(
@@ -2727,7 +2789,8 @@ module Aws::DataSync
       :error_code,
       :error_detail,
       :creation_time,
-      :includes)
+      :includes,
+      :task_report_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3895,13 +3958,13 @@ module Aws::DataSync
       include Aws::Structure
     end
 
-    # Configures your DataSync task settings. These options include how
-    # DataSync handles files, objects, and their associated metadata. You
-    # also can specify how DataSync verifies data integrity, set bandwidth
-    # limits for your task, among other options.
+    # Indicates how your transfer task is configured. These options include
+    # how DataSync handles files, objects, and their associated metadata
+    # during your transfer. You also can specify how to verify data
+    # integrity, set bandwidth limits for your task, among other options.
     #
-    # Each task setting has a default value. Unless you need to, you don't
-    # have to configure any of these `Options` before starting your task.
+    # Each option has a default value. Unless you need to, you don't have
+    # to configure any of these options before starting your task.
     #
     # @!attribute [rw] verify_mode
     #   Specifies how and when DataSync checks the integrity of your data
@@ -4377,6 +4440,169 @@ module Aws::DataSync
     #
     class RemoveStorageSystemResponse < Aws::EmptyStructure; end
 
+    # Specifies where DataSync uploads your [task report][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #
+    # @!attribute [rw] s3
+    #   Specifies the Amazon S3 bucket where DataSync uploads your task
+    #   report.
+    #   @return [Types::ReportDestinationS3]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportDestination AWS API Documentation
+    #
+    class ReportDestination < Struct.new(
+      :s3)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Specifies the Amazon S3 bucket where DataSync uploads your [task
+    # report][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #
+    # @!attribute [rw] subdirectory
+    #   Specifies a bucket prefix for your report.
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_bucket_arn
+    #   Specifies the ARN of the S3 bucket where DataSync uploads your
+    #   report.
+    #   @return [String]
+    #
+    # @!attribute [rw] 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][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportDestinationS3 AWS API Documentation
+    #
+    class ReportDestinationS3 < Struct.new(
+      :subdirectory,
+      :s3_bucket_arn,
+      :bucket_access_role_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Specifies the level of detail for a particular aspect of your DataSync
+    # [task report][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #
+    # @!attribute [rw] report_level
+    #   Specifies whether your task report includes errors only or successes
+    #   and errors.
+    #
+    #   For example, your report might mostly include only what didn't go
+    #   well in your transfer (`ERRORS_ONLY`). At the same time, you want to
+    #   verify that your [task filter][1] is working correctly. In this
+    #   situation, you can get a list of what files DataSync successfully
+    #   skipped and if something transferred that you didn't to transfer
+    #   (`SUCCESSES_AND_ERRORS`).
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportOverride AWS API Documentation
+    #
+    class ReportOverride < Struct.new(
+      :report_level)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The level of detail included in each aspect of your DataSync [task
+    # report][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #
+    # @!attribute [rw] transferred
+    #   Specifies the level of reporting for the files, objects, and
+    #   directories that DataSync attempted to transfer.
+    #   @return [Types::ReportOverride]
+    #
+    # @!attribute [rw] verified
+    #   Specifies the level of reporting for the files, objects, and
+    #   directories that DataSync attempted to verify at the end of your
+    #   transfer.
+    #   @return [Types::ReportOverride]
+    #
+    # @!attribute [rw] 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][1] to
+    #   delete data in the destination that isn't in the source.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
+    #   @return [Types::ReportOverride]
+    #
+    # @!attribute [rw] skipped
+    #   Specifies the level of reporting for the files, objects, and
+    #   directories that DataSync attempted to skip during your transfer.
+    #   @return [Types::ReportOverride]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportOverrides AWS API Documentation
+    #
+    class ReportOverrides < Struct.new(
+      :transferred,
+      :verified,
+      :deleted,
+      :skipped)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Indicates whether DataSync created a complete [task report][1] for
+    # your transfer.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #
+    # @!attribute [rw] status
+    #   Indicates whether DataSync is still working on your report, created
+    #   a report, or can't create a complete report.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_code
+    #   Indicates the code associated with the error if DataSync can't
+    #   create a complete report.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_detail
+    #   Provides details about issues creating a report.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportResult AWS API Documentation
+    #
+    class ReportResult < Struct.new(
+      :status,
+      :error_code,
+      :error_detail)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information provided by DataSync Discovery about the resources in your
     # on-premises storage system.
     #
@@ -4573,14 +4799,14 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] override_options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
-    #
-    #   Each task setting has a default value. Unless you need to, you
-    #   don't have to configure any of these `Options` before starting your
-    #   task.
+    #   Indicates how your transfer task is configured. These options
+    #   include how DataSync handles files, objects, and their associated
+    #   metadata during your transfer. You also can specify how to verify
+    #   data integrity, set bandwidth limits for your task, among other
+    #   options.
+    #
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #   @return [Types::Options]
     #
     # @!attribute [rw] includes
@@ -4606,6 +4832,11 @@ module Aws::DataSync
     #   for your DataSync resources.
     #   @return [Array<Types::TagListEntry>]
     #
+    # @!attribute [rw] task_report_config
+    #   Specifies how you want to configure a task report, which provides
+    #   detailed information about for your DataSync transfer.
+    #   @return [Types::TaskReportConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartTaskExecutionRequest AWS API Documentation
     #
     class StartTaskExecutionRequest < Struct.new(
@@ -4613,7 +4844,8 @@ module Aws::DataSync
       :override_options,
       :includes,
       :excludes,
-      :tags)
+      :tags,
+      :task_report_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4872,6 +5104,79 @@ module Aws::DataSync
       include Aws::Structure
     end
 
+    # Specifies how you want to configure a task report, which provides
+    # detailed information about for your DataSync transfer.
+    #
+    # For more information, see [Task reports][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #
+    # @!attribute [rw] destination
+    #   Specifies the Amazon S3 bucket where DataSync uploads your task
+    #   report. For more information, see [Task reports][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html#task-report-access
+    #   @return [Types::ReportDestination]
+    #
+    # @!attribute [rw] 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.
+    #   @return [String]
+    #
+    # @!attribute [rw] 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.
+    #   @return [String]
+    #
+    # @!attribute [rw] 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][1]. Keep in mind that setting
+    #   this to `INCLUDE` can increase the duration of your task execution.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
+    #   @return [String]
+    #
+    # @!attribute [rw] 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.
+    #   @return [Types::ReportOverrides]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskReportConfig AWS API Documentation
+    #
+    class TaskReportConfig < Struct.new(
+      :destination,
+      :output_type,
+      :report_level,
+      :object_version_ids,
+      :overrides)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Specifies the schedule you want your task to use for repeated
     # executions. For more information, see [Schedule Expressions for
     # Rules][1].
@@ -5399,14 +5704,14 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
-    #
-    #   Each task setting has a default value. Unless you need to, you
-    #   don't have to configure any of these `Options` before starting your
-    #   task.
+    #   Indicates how your transfer task is configured. These options
+    #   include how DataSync handles files, objects, and their associated
+    #   metadata during your transfer. You also can specify how to verify
+    #   data integrity, set bandwidth limits for your task, among other
+    #   options.
+    #
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #   @return [Types::Options]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecutionRequest AWS API Documentation
@@ -5430,14 +5735,14 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] options
-    #   Configures your DataSync task settings. These options include how
-    #   DataSync handles files, objects, and their associated metadata. You
-    #   also can specify how DataSync verifies data integrity, set bandwidth
-    #   limits for your task, among other options.
-    #
-    #   Each task setting has a default value. Unless you need to, you
-    #   don't have to configure any of these `Options` before starting your
-    #   task.
+    #   Indicates how your transfer task is configured. These options
+    #   include how DataSync handles files, objects, and their associated
+    #   metadata during your transfer. You also can specify how to verify
+    #   data integrity, set bandwidth limits for your task, among other
+    #   options.
+    #
+    #   Each option has a default value. Unless you need to, you don't have
+    #   to configure any of these options before starting your task.
     #   @return [Types::Options]
     #
     # @!attribute [rw] excludes
@@ -5482,6 +5787,11 @@ module Aws::DataSync
     #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
     #   @return [Array<Types::FilterRule>]
     #
+    # @!attribute [rw] task_report_config
+    #   Specifies how you want to configure a task report, which provides
+    #   detailed information about for your DataSync transfer.
+    #   @return [Types::TaskReportConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskRequest AWS API Documentation
     #
     class UpdateTaskRequest < Struct.new(
@@ -5491,7 +5801,8 @@ module Aws::DataSync
       :schedule,
       :name,
       :cloud_watch_log_group_arn,
-      :includes)
+      :includes,
+      :task_report_config)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-datasync.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.64.0'
+  GEM_VERSION = '1.66.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.64.0
+  version: 1.66.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-04 00:00:00.000000000 Z
+date: 2023-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core