aws-sdk-datasync 1.64.0 → 1.65.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 57f28f79db439d714373ac5f32860203ba051d0049a3b3a999ae8dea31aa1675
4
- data.tar.gz: 7719ec1da51d741b92c4de227f2040219aac876f1538625397ff91027a972af4
3
+ metadata.gz: 6f9f352fa22503339a8961f2b68bde03a8843a13fe70c4b256ca106a8f8bb1d0
4
+ data.tar.gz: a43bb69777e189bccb2ef2acfb0dbad028eb943c78178637554e1f44d0be2114
5
5
  SHA512:
6
- metadata.gz: ff312076f54c88de8792694c943bfca0dba6163fca652a46eb675a36173bfc7d96a934ac89f7cd0adab30ebd612fd68cbf56fde5157fe05695b5879ec8b6f13e
7
- data.tar.gz: 992649735bbc619082bb1f6a9e023a7250a13e3b19cb60dd239c9d579213f1958f99305616ec0dbe0b7aa032a478fc0a5c6ddf970d82f8b894747084ca44f83c
6
+ metadata.gz: 928cbf6fe41e7079cd258a776890226a572f7542dbe9b46ede9e1a47ce17b0e493bcb33e800fb5dadb4f6603f157b47d4f4b9af819a297afbbdeac403ce8e838
7
+ data.tar.gz: a3f02df725fce3d709ba9dbfe86923d79151a92ede7186c10c5ebf75a8c345dfc05f9353271c691f014a370407c0e2d3c38f742bf0ae4e895be9d8ba1e3a3271
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.65.0 (2023-08-30)
5
+ ------------------
6
+
7
+ * Feature - AWS DataSync introduces Task Reports, a new feature that provides detailed reports of data transfer operations for each task execution.
8
+
4
9
  1.64.0 (2023-08-04)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.64.0
1
+ 1.65.0
@@ -1665,11 +1665,11 @@ module Aws::DataSync
1665
1665
  req.send_request(options)
1666
1666
  end
1667
1667
 
1668
- # Configures a task, which defines where and how DataSync transfers your
1669
- # data.
1668
+ # Configures a transfer task, which defines where and how DataSync moves
1669
+ # your data.
1670
1670
  #
1671
- # A task includes a source location, a destination location, and the
1672
- # preferences for how and when you want to transfer your data (such as
1671
+ # A task includes a source location, destination location, and the
1672
+ # options for how and when you want to transfer your data (such as
1673
1673
  # bandwidth limits, scheduling, among other options).
1674
1674
  #
1675
1675
  # If you're planning to transfer data to or from an Amazon S3 location,
@@ -1742,6 +1742,10 @@ module Aws::DataSync
1742
1742
  #
1743
1743
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
1744
1744
  #
1745
+ # @option params [Types::TaskReportConfig] :task_report_config
1746
+ # Specifies how you want to configure a task report, which provides
1747
+ # detailed information about for your DataSync transfer.
1748
+ #
1745
1749
  # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1746
1750
  #
1747
1751
  # * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1791,6 +1795,32 @@ module Aws::DataSync
1791
1795
  # value: "FilterValue",
1792
1796
  # },
1793
1797
  # ],
1798
+ # task_report_config: {
1799
+ # destination: {
1800
+ # s3: {
1801
+ # subdirectory: "S3Subdirectory",
1802
+ # s3_bucket_arn: "S3BucketArn", # required
1803
+ # bucket_access_role_arn: "IamRoleArn", # required
1804
+ # },
1805
+ # },
1806
+ # output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
1807
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1808
+ # object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
1809
+ # overrides: {
1810
+ # transferred: {
1811
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1812
+ # },
1813
+ # verified: {
1814
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1815
+ # },
1816
+ # deleted: {
1817
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1818
+ # },
1819
+ # skipped: {
1820
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
1821
+ # },
1822
+ # },
1823
+ # },
1794
1824
  # })
1795
1825
  #
1796
1826
  # @example Response structure
@@ -1856,7 +1886,7 @@ module Aws::DataSync
1856
1886
  req.send_request(options)
1857
1887
  end
1858
1888
 
1859
- # Deletes an DataSync task.
1889
+ # Deletes an DataSync transfer task.
1860
1890
  #
1861
1891
  # @option params [required, String] :task_arn
1862
1892
  # Specifies the Amazon Resource Name (ARN) of the task that you want to
@@ -2759,6 +2789,7 @@ module Aws::DataSync
2759
2789
  # * {Types::DescribeTaskResponse#error_detail #error_detail} => String
2760
2790
  # * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
2761
2791
  # * {Types::DescribeTaskResponse#includes #includes} => Array<Types::FilterRule>
2792
+ # * {Types::DescribeTaskResponse#task_report_config #task_report_config} => Types::TaskReportConfig
2762
2793
  #
2763
2794
  # @example Request syntax with placeholder values
2764
2795
  #
@@ -2804,6 +2835,16 @@ module Aws::DataSync
2804
2835
  # resp.includes #=> Array
2805
2836
  # resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
2806
2837
  # resp.includes[0].value #=> String
2838
+ # resp.task_report_config.destination.s3.subdirectory #=> String
2839
+ # resp.task_report_config.destination.s3.s3_bucket_arn #=> String
2840
+ # resp.task_report_config.destination.s3.bucket_access_role_arn #=> String
2841
+ # resp.task_report_config.output_type #=> String, one of "SUMMARY_ONLY", "STANDARD"
2842
+ # resp.task_report_config.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2843
+ # resp.task_report_config.object_version_ids #=> String, one of "INCLUDE", "NONE"
2844
+ # resp.task_report_config.overrides.transferred.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2845
+ # resp.task_report_config.overrides.verified.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2846
+ # resp.task_report_config.overrides.deleted.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2847
+ # resp.task_report_config.overrides.skipped.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2807
2848
  #
2808
2849
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
2809
2850
  #
@@ -2814,11 +2855,13 @@ module Aws::DataSync
2814
2855
  req.send_request(options)
2815
2856
  end
2816
2857
 
2817
- # Provides information about an DataSync transfer task that's running.
2858
+ # Provides information about an execution of your DataSync task. You can
2859
+ # use this operation to help monitor the progress of an ongoing transfer
2860
+ # or check the results of the transfer.
2818
2861
  #
2819
2862
  # @option params [required, String] :task_execution_arn
2820
- # Specifies the Amazon Resource Name (ARN) of the transfer task that's
2821
- # running.
2863
+ # Specifies the Amazon Resource Name (ARN) of the task execution that
2864
+ # you want information about.
2822
2865
  #
2823
2866
  # @return [Types::DescribeTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2824
2867
  #
@@ -2835,6 +2878,12 @@ module Aws::DataSync
2835
2878
  # * {Types::DescribeTaskExecutionResponse#bytes_transferred #bytes_transferred} => Integer
2836
2879
  # * {Types::DescribeTaskExecutionResponse#result #result} => Types::TaskExecutionResultDetail
2837
2880
  # * {Types::DescribeTaskExecutionResponse#bytes_compressed #bytes_compressed} => Integer
2881
+ # * {Types::DescribeTaskExecutionResponse#task_report_config #task_report_config} => Types::TaskReportConfig
2882
+ # * {Types::DescribeTaskExecutionResponse#files_deleted #files_deleted} => Integer
2883
+ # * {Types::DescribeTaskExecutionResponse#files_skipped #files_skipped} => Integer
2884
+ # * {Types::DescribeTaskExecutionResponse#files_verified #files_verified} => Integer
2885
+ # * {Types::DescribeTaskExecutionResponse#report_result #report_result} => Types::ReportResult
2886
+ # * {Types::DescribeTaskExecutionResponse#estimated_files_to_delete #estimated_files_to_delete} => Integer
2838
2887
  #
2839
2888
  # @example Request syntax with placeholder values
2840
2889
  #
@@ -2883,6 +2932,23 @@ module Aws::DataSync
2883
2932
  # resp.result.error_code #=> String
2884
2933
  # resp.result.error_detail #=> String
2885
2934
  # resp.bytes_compressed #=> Integer
2935
+ # resp.task_report_config.destination.s3.subdirectory #=> String
2936
+ # resp.task_report_config.destination.s3.s3_bucket_arn #=> String
2937
+ # resp.task_report_config.destination.s3.bucket_access_role_arn #=> String
2938
+ # resp.task_report_config.output_type #=> String, one of "SUMMARY_ONLY", "STANDARD"
2939
+ # resp.task_report_config.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2940
+ # resp.task_report_config.object_version_ids #=> String, one of "INCLUDE", "NONE"
2941
+ # resp.task_report_config.overrides.transferred.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2942
+ # resp.task_report_config.overrides.verified.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2943
+ # resp.task_report_config.overrides.deleted.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2944
+ # resp.task_report_config.overrides.skipped.report_level #=> String, one of "ERRORS_ONLY", "SUCCESSES_AND_ERRORS"
2945
+ # resp.files_deleted #=> Integer
2946
+ # resp.files_skipped #=> Integer
2947
+ # resp.files_verified #=> Integer
2948
+ # resp.report_result.status #=> String, one of "PENDING", "SUCCESS", "ERROR"
2949
+ # resp.report_result.error_code #=> String
2950
+ # resp.report_result.error_detail #=> String
2951
+ # resp.estimated_files_to_delete #=> Integer
2886
2952
  #
2887
2953
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
2888
2954
  #
@@ -3381,8 +3447,8 @@ module Aws::DataSync
3381
3447
  req.send_request(options)
3382
3448
  end
3383
3449
 
3384
- # Starts an DataSync task. For each task, you can only run one task
3385
- # execution at a time.
3450
+ # Starts an DataSync transfer task. For each task, you can only run one
3451
+ # task execution at a time.
3386
3452
  #
3387
3453
  # There are several phases to a task execution. For more information,
3388
3454
  # see [Task execution statuses][1].
@@ -3402,13 +3468,13 @@ module Aws::DataSync
3402
3468
  # start.
3403
3469
  #
3404
3470
  # @option params [Types::Options] :override_options
3405
- # Configures your DataSync task settings. These options include how
3406
- # DataSync handles files, objects, and their associated metadata. You
3407
- # also can specify how DataSync verifies data integrity, set bandwidth
3408
- # limits for your task, among other options.
3471
+ # Indicates how your transfer task is configured. These options include
3472
+ # how DataSync handles files, objects, and their associated metadata
3473
+ # during your transfer. You also can specify how to verify data
3474
+ # integrity, set bandwidth limits for your task, among other options.
3409
3475
  #
3410
- # Each task setting has a default value. Unless you need to, you don't
3411
- # have to configure any of these `Options` before starting your task.
3476
+ # Each option has a default value. Unless you need to, you don't have
3477
+ # to configure any of these options before starting your task.
3412
3478
  #
3413
3479
  # @option params [Array<Types::FilterRule>] :includes
3414
3480
  # Specifies a list of filter rules that determines which files to
@@ -3430,6 +3496,10 @@ module Aws::DataSync
3430
3496
  # *Tags* are key-value pairs that help you manage, filter, and search
3431
3497
  # for your DataSync resources.
3432
3498
  #
3499
+ # @option params [Types::TaskReportConfig] :task_report_config
3500
+ # Specifies how you want to configure a task report, which provides
3501
+ # detailed information about for your DataSync transfer.
3502
+ #
3433
3503
  # @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3434
3504
  #
3435
3505
  # * {Types::StartTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
@@ -3473,6 +3543,32 @@ module Aws::DataSync
3473
3543
  # value: "TagValue",
3474
3544
  # },
3475
3545
  # ],
3546
+ # task_report_config: {
3547
+ # destination: {
3548
+ # s3: {
3549
+ # subdirectory: "S3Subdirectory",
3550
+ # s3_bucket_arn: "S3BucketArn", # required
3551
+ # bucket_access_role_arn: "IamRoleArn", # required
3552
+ # },
3553
+ # },
3554
+ # output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
3555
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3556
+ # object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
3557
+ # overrides: {
3558
+ # transferred: {
3559
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3560
+ # },
3561
+ # verified: {
3562
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3563
+ # },
3564
+ # deleted: {
3565
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3566
+ # },
3567
+ # skipped: {
3568
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
3569
+ # },
3570
+ # },
3571
+ # },
3476
3572
  # })
3477
3573
  #
3478
3574
  # @example Response structure
@@ -4079,20 +4175,20 @@ module Aws::DataSync
4079
4175
  req.send_request(options)
4080
4176
  end
4081
4177
 
4082
- # Updates the metadata associated with a task.
4178
+ # Updates the configuration of a DataSync transfer task.
4083
4179
  #
4084
4180
  # @option params [required, String] :task_arn
4085
4181
  # The Amazon Resource Name (ARN) of the resource name of the task to
4086
4182
  # update.
4087
4183
  #
4088
4184
  # @option params [Types::Options] :options
4089
- # Configures your DataSync task settings. These options include how
4090
- # DataSync handles files, objects, and their associated metadata. You
4091
- # also can specify how DataSync verifies data integrity, set bandwidth
4092
- # limits for your task, among other options.
4185
+ # Indicates how your transfer task is configured. These options include
4186
+ # how DataSync handles files, objects, and their associated metadata
4187
+ # during your transfer. You also can specify how to verify data
4188
+ # integrity, set bandwidth limits for your task, among other options.
4093
4189
  #
4094
- # Each task setting has a default value. Unless you need to, you don't
4095
- # have to configure any of these `Options` before starting your task.
4190
+ # Each option has a default value. Unless you need to, you don't have
4191
+ # to configure any of these options before starting your task.
4096
4192
  #
4097
4193
  # @option params [Array<Types::FilterRule>] :excludes
4098
4194
  # Specifies a list of filter rules that exclude specific data during
@@ -4131,6 +4227,10 @@ module Aws::DataSync
4131
4227
  #
4132
4228
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
4133
4229
  #
4230
+ # @option params [Types::TaskReportConfig] :task_report_config
4231
+ # Specifies how you want to configure a task report, which provides
4232
+ # detailed information about for your DataSync transfer.
4233
+ #
4134
4234
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4135
4235
  #
4136
4236
  # @example Request syntax with placeholder values
@@ -4171,6 +4271,32 @@ module Aws::DataSync
4171
4271
  # value: "FilterValue",
4172
4272
  # },
4173
4273
  # ],
4274
+ # task_report_config: {
4275
+ # destination: {
4276
+ # s3: {
4277
+ # subdirectory: "S3Subdirectory",
4278
+ # s3_bucket_arn: "S3BucketArn", # required
4279
+ # bucket_access_role_arn: "IamRoleArn", # required
4280
+ # },
4281
+ # },
4282
+ # output_type: "SUMMARY_ONLY", # accepts SUMMARY_ONLY, STANDARD
4283
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4284
+ # object_version_ids: "INCLUDE", # accepts INCLUDE, NONE
4285
+ # overrides: {
4286
+ # transferred: {
4287
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4288
+ # },
4289
+ # verified: {
4290
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4291
+ # },
4292
+ # deleted: {
4293
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4294
+ # },
4295
+ # skipped: {
4296
+ # report_level: "ERRORS_ONLY", # accepts ERRORS_ONLY, SUCCESSES_AND_ERRORS
4297
+ # },
4298
+ # },
4299
+ # },
4174
4300
  # })
4175
4301
  #
4176
4302
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
@@ -4182,11 +4308,11 @@ module Aws::DataSync
4182
4308
  req.send_request(options)
4183
4309
  end
4184
4310
 
4185
- # Modifies a running DataSync task.
4311
+ # Updates the configuration of a running DataSync task execution.
4186
4312
  #
4187
4313
  # <note markdown="1"> Currently, the only `Option` that you can modify with
4188
4314
  # `UpdateTaskExecution` is ` BytesPerSecond `, which throttles bandwidth
4189
- # for a running or queued task.
4315
+ # for a running or queued task execution.
4190
4316
  #
4191
4317
  # </note>
4192
4318
  #
@@ -4195,13 +4321,13 @@ module Aws::DataSync
4195
4321
  # you're updating.
4196
4322
  #
4197
4323
  # @option params [required, Types::Options] :options
4198
- # Configures your DataSync task settings. These options include how
4199
- # DataSync handles files, objects, and their associated metadata. You
4200
- # also can specify how DataSync verifies data integrity, set bandwidth
4201
- # limits for your task, among other options.
4324
+ # Indicates how your transfer task is configured. These options include
4325
+ # how DataSync handles files, objects, and their associated metadata
4326
+ # during your transfer. You also can specify how to verify data
4327
+ # integrity, set bandwidth limits for your task, among other options.
4202
4328
  #
4203
- # Each task setting has a default value. Unless you need to, you don't
4204
- # have to configure any of these `Options` before starting your task.
4329
+ # Each option has a default value. Unless you need to, you don't have
4330
+ # to configure any of these options before starting your task.
4205
4331
  #
4206
4332
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4207
4333
  #
@@ -4250,7 +4376,7 @@ module Aws::DataSync
4250
4376
  params: params,
4251
4377
  config: config)
4252
4378
  context[:gem_name] = 'aws-sdk-datasync'
4253
- context[:gem_version] = '1.64.0'
4379
+ context[:gem_version] = '1.65.0'
4254
4380
  Seahorse::Client::Request.new(handlers, context)
4255
4381
  end
4256
4382
 
@@ -218,6 +218,7 @@ module Aws::DataSync
218
218
  ObjectStorageServerPort = Shapes::IntegerShape.new(name: 'ObjectStorageServerPort')
219
219
  ObjectStorageServerProtocol = Shapes::StringShape.new(name: 'ObjectStorageServerProtocol')
220
220
  ObjectTags = Shapes::StringShape.new(name: 'ObjectTags')
221
+ ObjectVersionIds = Shapes::StringShape.new(name: 'ObjectVersionIds')
221
222
  OnPremConfig = Shapes::StructureShape.new(name: 'OnPremConfig')
222
223
  Operator = Shapes::StringShape.new(name: 'Operator')
223
224
  Options = Shapes::StructureShape.new(name: 'Options')
@@ -243,6 +244,13 @@ module Aws::DataSync
243
244
  RecommendationsConfigMap = Shapes::MapShape.new(name: 'RecommendationsConfigMap')
244
245
  RemoveStorageSystemRequest = Shapes::StructureShape.new(name: 'RemoveStorageSystemRequest')
245
246
  RemoveStorageSystemResponse = Shapes::StructureShape.new(name: 'RemoveStorageSystemResponse')
247
+ ReportDestination = Shapes::StructureShape.new(name: 'ReportDestination')
248
+ ReportDestinationS3 = Shapes::StructureShape.new(name: 'ReportDestinationS3')
249
+ ReportLevel = Shapes::StringShape.new(name: 'ReportLevel')
250
+ ReportOutputType = Shapes::StringShape.new(name: 'ReportOutputType')
251
+ ReportOverride = Shapes::StructureShape.new(name: 'ReportOverride')
252
+ ReportOverrides = Shapes::StructureShape.new(name: 'ReportOverrides')
253
+ ReportResult = Shapes::StructureShape.new(name: 'ReportResult')
246
254
  ResourceDetails = Shapes::StructureShape.new(name: 'ResourceDetails')
247
255
  ResourceFilters = Shapes::MapShape.new(name: 'ResourceFilters')
248
256
  ResourceId = Shapes::StringShape.new(name: 'ResourceId')
@@ -293,6 +301,7 @@ module Aws::DataSync
293
301
  TaskList = Shapes::ListShape.new(name: 'TaskList')
294
302
  TaskListEntry = Shapes::StructureShape.new(name: 'TaskListEntry')
295
303
  TaskQueueing = Shapes::StringShape.new(name: 'TaskQueueing')
304
+ TaskReportConfig = Shapes::StructureShape.new(name: 'TaskReportConfig')
296
305
  TaskSchedule = Shapes::StructureShape.new(name: 'TaskSchedule')
297
306
  TaskStatus = Shapes::StringShape.new(name: 'TaskStatus')
298
307
  Throughput = Shapes::StructureShape.new(name: 'Throughput')
@@ -516,6 +525,7 @@ module Aws::DataSync
516
525
  CreateTaskRequest.add_member(:schedule, Shapes::ShapeRef.new(shape: TaskSchedule, location_name: "Schedule"))
517
526
  CreateTaskRequest.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
518
527
  CreateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
528
+ CreateTaskRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
519
529
  CreateTaskRequest.struct_class = Types::CreateTaskRequest
520
530
 
521
531
  CreateTaskResponse.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
@@ -748,6 +758,12 @@ module Aws::DataSync
748
758
  DescribeTaskExecutionResponse.add_member(:bytes_transferred, Shapes::ShapeRef.new(shape: long, location_name: "BytesTransferred"))
749
759
  DescribeTaskExecutionResponse.add_member(:result, Shapes::ShapeRef.new(shape: TaskExecutionResultDetail, location_name: "Result"))
750
760
  DescribeTaskExecutionResponse.add_member(:bytes_compressed, Shapes::ShapeRef.new(shape: long, location_name: "BytesCompressed"))
761
+ DescribeTaskExecutionResponse.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
762
+ DescribeTaskExecutionResponse.add_member(:files_deleted, Shapes::ShapeRef.new(shape: long, location_name: "FilesDeleted"))
763
+ DescribeTaskExecutionResponse.add_member(:files_skipped, Shapes::ShapeRef.new(shape: long, location_name: "FilesSkipped"))
764
+ DescribeTaskExecutionResponse.add_member(:files_verified, Shapes::ShapeRef.new(shape: long, location_name: "FilesVerified"))
765
+ DescribeTaskExecutionResponse.add_member(:report_result, Shapes::ShapeRef.new(shape: ReportResult, location_name: "ReportResult"))
766
+ DescribeTaskExecutionResponse.add_member(:estimated_files_to_delete, Shapes::ShapeRef.new(shape: long, location_name: "EstimatedFilesToDelete"))
751
767
  DescribeTaskExecutionResponse.struct_class = Types::DescribeTaskExecutionResponse
752
768
 
753
769
  DescribeTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
@@ -769,6 +785,7 @@ module Aws::DataSync
769
785
  DescribeTaskResponse.add_member(:error_detail, Shapes::ShapeRef.new(shape: string, location_name: "ErrorDetail"))
770
786
  DescribeTaskResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
771
787
  DescribeTaskResponse.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
788
+ DescribeTaskResponse.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
772
789
  DescribeTaskResponse.struct_class = Types::DescribeTaskResponse
773
790
 
774
791
  DestinationNetworkInterfaceArns.member = Shapes::ShapeRef.new(shape: NetworkInterfaceArn)
@@ -1052,6 +1069,28 @@ module Aws::DataSync
1052
1069
 
1053
1070
  RemoveStorageSystemResponse.struct_class = Types::RemoveStorageSystemResponse
1054
1071
 
1072
+ ReportDestination.add_member(:s3, Shapes::ShapeRef.new(shape: ReportDestinationS3, location_name: "S3"))
1073
+ ReportDestination.struct_class = Types::ReportDestination
1074
+
1075
+ ReportDestinationS3.add_member(:subdirectory, Shapes::ShapeRef.new(shape: S3Subdirectory, location_name: "Subdirectory"))
1076
+ ReportDestinationS3.add_member(:s3_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "S3BucketArn"))
1077
+ ReportDestinationS3.add_member(:bucket_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, required: true, location_name: "BucketAccessRoleArn"))
1078
+ ReportDestinationS3.struct_class = Types::ReportDestinationS3
1079
+
1080
+ ReportOverride.add_member(:report_level, Shapes::ShapeRef.new(shape: ReportLevel, location_name: "ReportLevel"))
1081
+ ReportOverride.struct_class = Types::ReportOverride
1082
+
1083
+ ReportOverrides.add_member(:transferred, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Transferred"))
1084
+ ReportOverrides.add_member(:verified, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Verified"))
1085
+ ReportOverrides.add_member(:deleted, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Deleted"))
1086
+ ReportOverrides.add_member(:skipped, Shapes::ShapeRef.new(shape: ReportOverride, location_name: "Skipped"))
1087
+ ReportOverrides.struct_class = Types::ReportOverrides
1088
+
1089
+ ReportResult.add_member(:status, Shapes::ShapeRef.new(shape: PhaseStatus, location_name: "Status"))
1090
+ ReportResult.add_member(:error_code, Shapes::ShapeRef.new(shape: string, location_name: "ErrorCode"))
1091
+ ReportResult.add_member(:error_detail, Shapes::ShapeRef.new(shape: string, location_name: "ErrorDetail"))
1092
+ ReportResult.struct_class = Types::ReportResult
1093
+
1055
1094
  ResourceDetails.add_member(:net_app_ontapsv_ms, Shapes::ShapeRef.new(shape: NetAppONTAPSVMs, location_name: "NetAppONTAPSVMs"))
1056
1095
  ResourceDetails.add_member(:net_app_ontap_volumes, Shapes::ShapeRef.new(shape: NetAppONTAPVolumes, location_name: "NetAppONTAPVolumes"))
1057
1096
  ResourceDetails.add_member(:net_app_ontap_clusters, Shapes::ShapeRef.new(shape: NetAppONTAPClusters, location_name: "NetAppONTAPClusters"))
@@ -1091,6 +1130,7 @@ module Aws::DataSync
1091
1130
  StartTaskExecutionRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
1092
1131
  StartTaskExecutionRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
1093
1132
  StartTaskExecutionRequest.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
1133
+ StartTaskExecutionRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
1094
1134
  StartTaskExecutionRequest.struct_class = Types::StartTaskExecutionRequest
1095
1135
 
1096
1136
  StartTaskExecutionResponse.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, location_name: "TaskExecutionArn"))
@@ -1150,6 +1190,13 @@ module Aws::DataSync
1150
1190
  TaskListEntry.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
1151
1191
  TaskListEntry.struct_class = Types::TaskListEntry
1152
1192
 
1193
+ TaskReportConfig.add_member(:destination, Shapes::ShapeRef.new(shape: ReportDestination, location_name: "Destination"))
1194
+ TaskReportConfig.add_member(:output_type, Shapes::ShapeRef.new(shape: ReportOutputType, location_name: "OutputType"))
1195
+ TaskReportConfig.add_member(:report_level, Shapes::ShapeRef.new(shape: ReportLevel, location_name: "ReportLevel"))
1196
+ TaskReportConfig.add_member(:object_version_ids, Shapes::ShapeRef.new(shape: ObjectVersionIds, location_name: "ObjectVersionIds"))
1197
+ TaskReportConfig.add_member(:overrides, Shapes::ShapeRef.new(shape: ReportOverrides, location_name: "Overrides"))
1198
+ TaskReportConfig.struct_class = Types::TaskReportConfig
1199
+
1153
1200
  TaskSchedule.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpressionCron, required: true, location_name: "ScheduleExpression"))
1154
1201
  TaskSchedule.struct_class = Types::TaskSchedule
1155
1202
 
@@ -1259,6 +1306,7 @@ module Aws::DataSync
1259
1306
  UpdateTaskRequest.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
1260
1307
  UpdateTaskRequest.add_member(:cloud_watch_log_group_arn, Shapes::ShapeRef.new(shape: LogGroupArn, location_name: "CloudWatchLogGroupArn"))
1261
1308
  UpdateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
1309
+ UpdateTaskRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
1262
1310
  UpdateTaskRequest.struct_class = Types::UpdateTaskRequest
1263
1311
 
1264
1312
  UpdateTaskResponse.struct_class = Types::UpdateTaskResponse
@@ -133,8 +133,8 @@ module Aws::DataSync
133
133
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens
134
134
  #
135
135
  # @!attribute [rw] token
136
- # Specifies a SAS token that provides permissions at the Azure storage
137
- # account, container, or folder level.
136
+ # Specifies a SAS token that provides permissions to access your Azure
137
+ # Blob Storage.
138
138
  #
139
139
  # The token is part of the SAS URI string that comes after the storage
140
140
  # resource URI and a question mark. A token looks something like this:
@@ -1282,6 +1282,11 @@ module Aws::DataSync
1282
1282
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
1283
1283
  # @return [Array<Types::FilterRule>]
1284
1284
  #
1285
+ # @!attribute [rw] task_report_config
1286
+ # Specifies how you want to configure a task report, which provides
1287
+ # detailed information about for your DataSync transfer.
1288
+ # @return [Types::TaskReportConfig]
1289
+ #
1285
1290
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateTaskRequest AWS API Documentation
1286
1291
  #
1287
1292
  class CreateTaskRequest < Struct.new(
@@ -1293,7 +1298,8 @@ module Aws::DataSync
1293
1298
  :excludes,
1294
1299
  :schedule,
1295
1300
  :tags,
1296
- :includes)
1301
+ :includes,
1302
+ :task_report_config)
1297
1303
  SENSITIVE = []
1298
1304
  include Aws::Structure
1299
1305
  end
@@ -2446,8 +2452,8 @@ module Aws::DataSync
2446
2452
  # DescribeTaskExecutionRequest
2447
2453
  #
2448
2454
  # @!attribute [rw] task_execution_arn
2449
- # Specifies the Amazon Resource Name (ARN) of the transfer task
2450
- # that's running.
2455
+ # Specifies the Amazon Resource Name (ARN) of the task execution that
2456
+ # you want information about.
2451
2457
  # @return [String]
2452
2458
  #
2453
2459
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecutionRequest AWS API Documentation
@@ -2461,9 +2467,9 @@ module Aws::DataSync
2461
2467
  # DescribeTaskExecutionResponse
2462
2468
  #
2463
2469
  # @!attribute [rw] task_execution_arn
2464
- # The Amazon Resource Name (ARN) of the task execution that was
2465
- # described. `TaskExecutionArn` is hierarchical and includes `TaskArn`
2466
- # for the task that was executed.
2470
+ # The ARN of the task execution that you wanted information about.
2471
+ # `TaskExecutionArn` is hierarchical and includes `TaskArn` for the
2472
+ # task that was executed.
2467
2473
  #
2468
2474
  # For example, a `TaskExecution` value with the ARN
2469
2475
  # `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b`
@@ -2473,20 +2479,17 @@ module Aws::DataSync
2473
2479
  #
2474
2480
  # @!attribute [rw] status
2475
2481
  # The status of the task execution.
2476
- #
2477
- # For detailed information about task execution statuses, see
2478
- # Understanding Task Statuses in the *DataSync User Guide.*
2479
2482
  # @return [String]
2480
2483
  #
2481
2484
  # @!attribute [rw] options
2482
- # Configures your DataSync task settings. These options include how
2483
- # DataSync handles files, objects, and their associated metadata. You
2484
- # also can specify how DataSync verifies data integrity, set bandwidth
2485
- # limits for your task, among other options.
2486
- #
2487
- # Each task setting has a default value. Unless you need to, you
2488
- # don't have to configure any of these `Options` before starting your
2489
- # task.
2485
+ # Indicates how your transfer task is configured. These options
2486
+ # include how DataSync handles files, objects, and their associated
2487
+ # metadata during your transfer. You also can specify how to verify
2488
+ # data integrity, set bandwidth limits for your task, among other
2489
+ # options.
2490
+ #
2491
+ # Each option has a default value. Unless you need to, you don't have
2492
+ # to configure any of these options before starting your task.
2490
2493
  # @return [Types::Options]
2491
2494
  #
2492
2495
  # @!attribute [rw] excludes
@@ -2510,41 +2513,39 @@ module Aws::DataSync
2510
2513
  # @return [Array<Types::FilterRule>]
2511
2514
  #
2512
2515
  # @!attribute [rw] start_time
2513
- # The time that the task execution was started.
2516
+ # The time when the task execution started.
2514
2517
  # @return [Time]
2515
2518
  #
2516
2519
  # @!attribute [rw] estimated_files_to_transfer
2517
- # The expected number of files that is to be transferred over the
2518
- # network. This value is calculated during the `PREPARING` phase
2519
- # before the `TRANSFERRING` phase of the task execution. This value is
2520
- # the expected number of files to be transferred. It's calculated
2521
- # based on comparing the content of the source and destination
2522
- # locations and finding the delta that needs to be transferred.
2520
+ # The expected number of files, objects, and directories that DataSync
2521
+ # will transfer over the network. This value is calculated during the
2522
+ # task execution's `PREPARING` phase before the `TRANSFERRING` phase.
2523
+ # The calculation is based on comparing the content of the source and
2524
+ # destination locations and finding the difference that needs to be
2525
+ # transferred.
2523
2526
  # @return [Integer]
2524
2527
  #
2525
2528
  # @!attribute [rw] estimated_bytes_to_transfer
2526
- # The estimated physical number of bytes that is to be transferred
2527
- # over the network.
2529
+ # The estimated physical number of bytes that will transfer over the
2530
+ # network.
2528
2531
  # @return [Integer]
2529
2532
  #
2530
2533
  # @!attribute [rw] files_transferred
2531
- # The actual number of files that was transferred over the network.
2532
- # This value is calculated and updated on an ongoing basis during the
2533
- # `TRANSFERRING` phase of the task execution. It's updated
2534
- # periodically when each file is read from the source and sent over
2535
- # the network.
2534
+ # The actual number of files, objects, and directories that DataSync
2535
+ # transferred over the network. This value is updated periodically
2536
+ # during the task execution's `TRANSFERRING` phase when something is
2537
+ # read from the source and sent over the network.
2536
2538
  #
2537
- # If failures occur during a transfer, this value can be less than
2539
+ # If DataSync fails to transfer something, this value can be less than
2538
2540
  # `EstimatedFilesToTransfer`. In some cases, this value can also be
2539
2541
  # greater than `EstimatedFilesToTransfer`. This element is
2540
2542
  # implementation-specific for some location types, so don't use it as
2541
- # an indicator for a correct file number or to monitor your task
2543
+ # an exact indication of what transferred or to monitor your task
2542
2544
  # execution.
2543
2545
  # @return [Integer]
2544
2546
  #
2545
2547
  # @!attribute [rw] bytes_written
2546
- # The number of logical bytes written to the destination Amazon Web
2547
- # Services storage resource.
2548
+ # The number of logical bytes written to the destination location.
2548
2549
  # @return [Integer]
2549
2550
  #
2550
2551
  # @!attribute [rw] bytes_transferred
@@ -2562,6 +2563,52 @@ module Aws::DataSync
2562
2563
  # `BytesTransferred` unless the data isn't compressible.
2563
2564
  # @return [Integer]
2564
2565
  #
2566
+ # @!attribute [rw] task_report_config
2567
+ # The configuration of your task report, which provides detailed
2568
+ # information about for your DataSync transfer.
2569
+ # @return [Types::TaskReportConfig]
2570
+ #
2571
+ # @!attribute [rw] files_deleted
2572
+ # The number of files, objects, and directories that DataSync deleted
2573
+ # in your destination location. If you don't [configure your task][1]
2574
+ # to delete data in the destination that isn't in the source, the
2575
+ # value is always `0`.
2576
+ #
2577
+ #
2578
+ #
2579
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
2580
+ # @return [Integer]
2581
+ #
2582
+ # @!attribute [rw] files_skipped
2583
+ # The number of files, objects, and directories that DataSync skipped
2584
+ # during your transfer.
2585
+ # @return [Integer]
2586
+ #
2587
+ # @!attribute [rw] files_verified
2588
+ # The number of files, objects, and directories that DataSync verified
2589
+ # during your transfer.
2590
+ # @return [Integer]
2591
+ #
2592
+ # @!attribute [rw] report_result
2593
+ # Indicates whether DataSync generated a complete [task report][1] for
2594
+ # your transfer.
2595
+ #
2596
+ #
2597
+ #
2598
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
2599
+ # @return [Types::ReportResult]
2600
+ #
2601
+ # @!attribute [rw] estimated_files_to_delete
2602
+ # The expected number of files, objects, and directories that DataSync
2603
+ # will delete in your destination location. If you don't [configure
2604
+ # your task][1] to delete data in the destination that isn't in the
2605
+ # source, the value is always `0`.
2606
+ #
2607
+ #
2608
+ #
2609
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
2610
+ # @return [Integer]
2611
+ #
2565
2612
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecutionResponse AWS API Documentation
2566
2613
  #
2567
2614
  class DescribeTaskExecutionResponse < Struct.new(
@@ -2577,7 +2624,13 @@ module Aws::DataSync
2577
2624
  :bytes_written,
2578
2625
  :bytes_transferred,
2579
2626
  :result,
2580
- :bytes_compressed)
2627
+ :bytes_compressed,
2628
+ :task_report_config,
2629
+ :files_deleted,
2630
+ :files_skipped,
2631
+ :files_verified,
2632
+ :report_result,
2633
+ :estimated_files_to_delete)
2581
2634
  SENSITIVE = []
2582
2635
  include Aws::Structure
2583
2636
  end
@@ -2709,6 +2762,15 @@ module Aws::DataSync
2709
2762
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
2710
2763
  # @return [Array<Types::FilterRule>]
2711
2764
  #
2765
+ # @!attribute [rw] task_report_config
2766
+ # The configuration of your task report. For more information, see
2767
+ # [Creating a task report][1].
2768
+ #
2769
+ #
2770
+ #
2771
+ # [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
2772
+ # @return [Types::TaskReportConfig]
2773
+ #
2712
2774
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskResponse AWS API Documentation
2713
2775
  #
2714
2776
  class DescribeTaskResponse < Struct.new(
@@ -2727,7 +2789,8 @@ module Aws::DataSync
2727
2789
  :error_code,
2728
2790
  :error_detail,
2729
2791
  :creation_time,
2730
- :includes)
2792
+ :includes,
2793
+ :task_report_config)
2731
2794
  SENSITIVE = []
2732
2795
  include Aws::Structure
2733
2796
  end
@@ -3895,13 +3958,13 @@ module Aws::DataSync
3895
3958
  include Aws::Structure
3896
3959
  end
3897
3960
 
3898
- # Configures your DataSync task settings. These options include how
3899
- # DataSync handles files, objects, and their associated metadata. You
3900
- # also can specify how DataSync verifies data integrity, set bandwidth
3901
- # limits for your task, among other options.
3961
+ # Indicates how your transfer task is configured. These options include
3962
+ # how DataSync handles files, objects, and their associated metadata
3963
+ # during your transfer. You also can specify how to verify data
3964
+ # integrity, set bandwidth limits for your task, among other options.
3902
3965
  #
3903
- # Each task setting has a default value. Unless you need to, you don't
3904
- # have to configure any of these `Options` before starting your task.
3966
+ # Each option has a default value. Unless you need to, you don't have
3967
+ # to configure any of these options before starting your task.
3905
3968
  #
3906
3969
  # @!attribute [rw] verify_mode
3907
3970
  # Specifies how and when DataSync checks the integrity of your data
@@ -4377,6 +4440,175 @@ module Aws::DataSync
4377
4440
  #
4378
4441
  class RemoveStorageSystemResponse < Aws::EmptyStructure; end
4379
4442
 
4443
+ # Specifies where DataSync uploads your [task report][1].
4444
+ #
4445
+ #
4446
+ #
4447
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
4448
+ #
4449
+ # @!attribute [rw] s3
4450
+ # Specifies the Amazon S3 bucket where DataSync uploads your task
4451
+ # report.
4452
+ # @return [Types::ReportDestinationS3]
4453
+ #
4454
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportDestination AWS API Documentation
4455
+ #
4456
+ class ReportDestination < Struct.new(
4457
+ :s3)
4458
+ SENSITIVE = []
4459
+ include Aws::Structure
4460
+ end
4461
+
4462
+ # Specifies the Amazon S3 bucket where DataSync uploads your [task
4463
+ # report][1].
4464
+ #
4465
+ #
4466
+ #
4467
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
4468
+ #
4469
+ # @!attribute [rw] subdirectory
4470
+ # Specifies a bucket prefix for your report.
4471
+ # @return [String]
4472
+ #
4473
+ # @!attribute [rw] s3_bucket_arn
4474
+ # Specifies the ARN of the S3 bucket where DataSync uploads your
4475
+ # report.
4476
+ # @return [String]
4477
+ #
4478
+ # @!attribute [rw] bucket_access_role_arn
4479
+ # Specifies the Amazon Resource Name (ARN) of the IAM policy that
4480
+ # allows DataSync to upload a task report to your S3 bucket. For more
4481
+ # information, see [Allowing DataSync to upload a task report to an
4482
+ # Amazon S3 bucket][1].
4483
+ #
4484
+ #
4485
+ #
4486
+ # [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
4487
+ # @return [String]
4488
+ #
4489
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportDestinationS3 AWS API Documentation
4490
+ #
4491
+ class ReportDestinationS3 < Struct.new(
4492
+ :subdirectory,
4493
+ :s3_bucket_arn,
4494
+ :bucket_access_role_arn)
4495
+ SENSITIVE = []
4496
+ include Aws::Structure
4497
+ end
4498
+
4499
+ # Specifies the level of detail for a particular aspect of your DataSync
4500
+ # [task report][1].
4501
+ #
4502
+ #
4503
+ #
4504
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
4505
+ #
4506
+ # @!attribute [rw] report_level
4507
+ # Specifies whether your task report includes errors only or successes
4508
+ # and errors.
4509
+ #
4510
+ # For example, your report might mostly include only what didn't go
4511
+ # well in your transfer (`ERRORS_ONLY`). At the same time, you want to
4512
+ # verify that your [task filter][1] is working correctly. In this
4513
+ # situation, you can get a list of what files DataSync successfully
4514
+ # skipped and if something transferred that you didn't to transfer
4515
+ # (`SUCCESSES_AND_ERRORS`).
4516
+ #
4517
+ #
4518
+ #
4519
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
4520
+ # @return [String]
4521
+ #
4522
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportOverride AWS API Documentation
4523
+ #
4524
+ class ReportOverride < Struct.new(
4525
+ :report_level)
4526
+ SENSITIVE = []
4527
+ include Aws::Structure
4528
+ end
4529
+
4530
+ # The level of detail included in each aspect of your DataSync [task
4531
+ # report][1].
4532
+ #
4533
+ #
4534
+ #
4535
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
4536
+ #
4537
+ # @!attribute [rw] transferred
4538
+ # Specifies the level of reporting for the files, objects, and
4539
+ # directories that DataSync attempted to transfer.
4540
+ # @return [Types::ReportOverride]
4541
+ #
4542
+ # @!attribute [rw] verified
4543
+ # Specifies the level of reporting for the files, objects, and
4544
+ # directories that DataSync attempted to verify at the end of your
4545
+ # transfer. This only applies if you [configure your task][1] to
4546
+ # verify data during and after the transfer (which DataSync does by
4547
+ # default).
4548
+ #
4549
+ #
4550
+ #
4551
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html
4552
+ # @return [Types::ReportOverride]
4553
+ #
4554
+ # @!attribute [rw] deleted
4555
+ # Specifies the level of reporting for the files, objects, and
4556
+ # directories that DataSync attempted to delete in your destination
4557
+ # location. This only applies if you [configure your task][1] to
4558
+ # delete data in the destination that isn't in the source.
4559
+ #
4560
+ #
4561
+ #
4562
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
4563
+ # @return [Types::ReportOverride]
4564
+ #
4565
+ # @!attribute [rw] skipped
4566
+ # Specifies the level of reporting for the files, objects, and
4567
+ # directories that DataSync attempted to skip during your transfer.
4568
+ # @return [Types::ReportOverride]
4569
+ #
4570
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportOverrides AWS API Documentation
4571
+ #
4572
+ class ReportOverrides < Struct.new(
4573
+ :transferred,
4574
+ :verified,
4575
+ :deleted,
4576
+ :skipped)
4577
+ SENSITIVE = []
4578
+ include Aws::Structure
4579
+ end
4580
+
4581
+ # Indicates whether DataSync created a complete [task report][1] for
4582
+ # your transfer.
4583
+ #
4584
+ #
4585
+ #
4586
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
4587
+ #
4588
+ # @!attribute [rw] status
4589
+ # Indicates whether DataSync is still working on your report, created
4590
+ # a report, or can't create a complete report.
4591
+ # @return [String]
4592
+ #
4593
+ # @!attribute [rw] error_code
4594
+ # Indicates the code associated with the error if DataSync can't
4595
+ # create a complete report.
4596
+ # @return [String]
4597
+ #
4598
+ # @!attribute [rw] error_detail
4599
+ # Provides details about issues creating a report.
4600
+ # @return [String]
4601
+ #
4602
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportResult AWS API Documentation
4603
+ #
4604
+ class ReportResult < Struct.new(
4605
+ :status,
4606
+ :error_code,
4607
+ :error_detail)
4608
+ SENSITIVE = []
4609
+ include Aws::Structure
4610
+ end
4611
+
4380
4612
  # Information provided by DataSync Discovery about the resources in your
4381
4613
  # on-premises storage system.
4382
4614
  #
@@ -4573,14 +4805,14 @@ module Aws::DataSync
4573
4805
  # @return [String]
4574
4806
  #
4575
4807
  # @!attribute [rw] override_options
4576
- # Configures your DataSync task settings. These options include how
4577
- # DataSync handles files, objects, and their associated metadata. You
4578
- # also can specify how DataSync verifies data integrity, set bandwidth
4579
- # limits for your task, among other options.
4580
- #
4581
- # Each task setting has a default value. Unless you need to, you
4582
- # don't have to configure any of these `Options` before starting your
4583
- # task.
4808
+ # Indicates how your transfer task is configured. These options
4809
+ # include how DataSync handles files, objects, and their associated
4810
+ # metadata during your transfer. You also can specify how to verify
4811
+ # data integrity, set bandwidth limits for your task, among other
4812
+ # options.
4813
+ #
4814
+ # Each option has a default value. Unless you need to, you don't have
4815
+ # to configure any of these options before starting your task.
4584
4816
  # @return [Types::Options]
4585
4817
  #
4586
4818
  # @!attribute [rw] includes
@@ -4606,6 +4838,11 @@ module Aws::DataSync
4606
4838
  # for your DataSync resources.
4607
4839
  # @return [Array<Types::TagListEntry>]
4608
4840
  #
4841
+ # @!attribute [rw] task_report_config
4842
+ # Specifies how you want to configure a task report, which provides
4843
+ # detailed information about for your DataSync transfer.
4844
+ # @return [Types::TaskReportConfig]
4845
+ #
4609
4846
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartTaskExecutionRequest AWS API Documentation
4610
4847
  #
4611
4848
  class StartTaskExecutionRequest < Struct.new(
@@ -4613,7 +4850,8 @@ module Aws::DataSync
4613
4850
  :override_options,
4614
4851
  :includes,
4615
4852
  :excludes,
4616
- :tags)
4853
+ :tags,
4854
+ :task_report_config)
4617
4855
  SENSITIVE = []
4618
4856
  include Aws::Structure
4619
4857
  end
@@ -4872,6 +5110,79 @@ module Aws::DataSync
4872
5110
  include Aws::Structure
4873
5111
  end
4874
5112
 
5113
+ # Specifies how you want to configure a task report, which provides
5114
+ # detailed information about for your DataSync transfer.
5115
+ #
5116
+ # For more information, see [Task reports][1].
5117
+ #
5118
+ #
5119
+ #
5120
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
5121
+ #
5122
+ # @!attribute [rw] destination
5123
+ # Specifies the Amazon S3 bucket where DataSync uploads your task
5124
+ # report. For more information, see [Task reports][1].
5125
+ #
5126
+ #
5127
+ #
5128
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html#task-report-access
5129
+ # @return [Types::ReportDestination]
5130
+ #
5131
+ # @!attribute [rw] output_type
5132
+ # Specifies the type of task report that you want:
5133
+ #
5134
+ # * `SUMMARY_ONLY`: Provides necessary details about your task,
5135
+ # including the number of files, objects, and directories
5136
+ # transferred and transfer duration.
5137
+ #
5138
+ # * `STANDARD`: Provides complete details about your task, including a
5139
+ # full list of files, objects, and directories that were
5140
+ # transferred, skipped, verified, and more.
5141
+ # @return [String]
5142
+ #
5143
+ # @!attribute [rw] report_level
5144
+ # Specifies whether you want your task report to include only what
5145
+ # went wrong with your transfer or a list of what succeeded and
5146
+ # didn't.
5147
+ #
5148
+ # * `ERRORS_ONLY`: A report shows what DataSync was unable to
5149
+ # transfer, skip, verify, and delete.
5150
+ #
5151
+ # * `SUCCESSES_AND_ERRORS`: A report shows what DataSync was able and
5152
+ # unable to transfer, skip, verify, and delete.
5153
+ # @return [String]
5154
+ #
5155
+ # @!attribute [rw] object_version_ids
5156
+ # Specifies whether your task report includes the new version of each
5157
+ # object transferred into an S3 bucket. This only applies if you
5158
+ # [enable versioning on your bucket][1]. Keep in mind that setting
5159
+ # this to `INCLUDE` can increase the duration of your task execution.
5160
+ #
5161
+ #
5162
+ #
5163
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
5164
+ # @return [String]
5165
+ #
5166
+ # @!attribute [rw] overrides
5167
+ # Customizes the reporting level for aspects of your task report. For
5168
+ # example, your report might generally only include errors, but you
5169
+ # could specify that you want a list of successes and errors just for
5170
+ # the files that DataSync attempted to delete in your destination
5171
+ # location.
5172
+ # @return [Types::ReportOverrides]
5173
+ #
5174
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskReportConfig AWS API Documentation
5175
+ #
5176
+ class TaskReportConfig < Struct.new(
5177
+ :destination,
5178
+ :output_type,
5179
+ :report_level,
5180
+ :object_version_ids,
5181
+ :overrides)
5182
+ SENSITIVE = []
5183
+ include Aws::Structure
5184
+ end
5185
+
4875
5186
  # Specifies the schedule you want your task to use for repeated
4876
5187
  # executions. For more information, see [Schedule Expressions for
4877
5188
  # Rules][1].
@@ -5399,14 +5710,14 @@ module Aws::DataSync
5399
5710
  # @return [String]
5400
5711
  #
5401
5712
  # @!attribute [rw] options
5402
- # Configures your DataSync task settings. These options include how
5403
- # DataSync handles files, objects, and their associated metadata. You
5404
- # also can specify how DataSync verifies data integrity, set bandwidth
5405
- # limits for your task, among other options.
5406
- #
5407
- # Each task setting has a default value. Unless you need to, you
5408
- # don't have to configure any of these `Options` before starting your
5409
- # task.
5713
+ # Indicates how your transfer task is configured. These options
5714
+ # include how DataSync handles files, objects, and their associated
5715
+ # metadata during your transfer. You also can specify how to verify
5716
+ # data integrity, set bandwidth limits for your task, among other
5717
+ # options.
5718
+ #
5719
+ # Each option has a default value. Unless you need to, you don't have
5720
+ # to configure any of these options before starting your task.
5410
5721
  # @return [Types::Options]
5411
5722
  #
5412
5723
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecutionRequest AWS API Documentation
@@ -5430,14 +5741,14 @@ module Aws::DataSync
5430
5741
  # @return [String]
5431
5742
  #
5432
5743
  # @!attribute [rw] options
5433
- # Configures your DataSync task settings. These options include how
5434
- # DataSync handles files, objects, and their associated metadata. You
5435
- # also can specify how DataSync verifies data integrity, set bandwidth
5436
- # limits for your task, among other options.
5437
- #
5438
- # Each task setting has a default value. Unless you need to, you
5439
- # don't have to configure any of these `Options` before starting your
5440
- # task.
5744
+ # Indicates how your transfer task is configured. These options
5745
+ # include how DataSync handles files, objects, and their associated
5746
+ # metadata during your transfer. You also can specify how to verify
5747
+ # data integrity, set bandwidth limits for your task, among other
5748
+ # options.
5749
+ #
5750
+ # Each option has a default value. Unless you need to, you don't have
5751
+ # to configure any of these options before starting your task.
5441
5752
  # @return [Types::Options]
5442
5753
  #
5443
5754
  # @!attribute [rw] excludes
@@ -5482,6 +5793,11 @@ module Aws::DataSync
5482
5793
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
5483
5794
  # @return [Array<Types::FilterRule>]
5484
5795
  #
5796
+ # @!attribute [rw] task_report_config
5797
+ # Specifies how you want to configure a task report, which provides
5798
+ # detailed information about for your DataSync transfer.
5799
+ # @return [Types::TaskReportConfig]
5800
+ #
5485
5801
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskRequest AWS API Documentation
5486
5802
  #
5487
5803
  class UpdateTaskRequest < Struct.new(
@@ -5491,7 +5807,8 @@ module Aws::DataSync
5491
5807
  :schedule,
5492
5808
  :name,
5493
5809
  :cloud_watch_log_group_arn,
5494
- :includes)
5810
+ :includes,
5811
+ :task_report_config)
5495
5812
  SENSITIVE = []
5496
5813
  include Aws::Structure
5497
5814
  end
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-datasync/customizations'
52
52
  # @!group service
53
53
  module Aws::DataSync
54
54
 
55
- GEM_VERSION = '1.64.0'
55
+ GEM_VERSION = '1.65.0'
56
56
 
57
57
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-datasync
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.64.0
4
+ version: 1.65.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-08-04 00:00:00.000000000 Z
11
+ date: 2023-08-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core