aws-sdk-datasync 1.90.0 → 1.92.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -217,7 +217,7 @@ module Aws::DataSync
217
217
  #
218
218
  # @!attribute [rw] activation_key
219
219
  # Specifies your DataSync agent's activation key. If you don't have
220
- # an activation key, see [Activate your agent][1].
220
+ # an activation key, see [Activating your agent][1].
221
221
  #
222
222
  #
223
223
  #
@@ -225,8 +225,8 @@ module Aws::DataSync
225
225
  # @return [String]
226
226
  #
227
227
  # @!attribute [rw] agent_name
228
- # Specifies a name for your agent. You can see this name in the
229
- # DataSync console.
228
+ # Specifies a name for your agent. We recommend specifying a name that
229
+ # you can remember.
230
230
  # @return [String]
231
231
  #
232
232
  # @!attribute [rw] tags
@@ -236,34 +236,27 @@ module Aws::DataSync
236
236
  # @return [Array<Types::TagListEntry>]
237
237
  #
238
238
  # @!attribute [rw] vpc_endpoint_id
239
- # Specifies the ID of the VPC endpoint that you want your agent to
240
- # connect to. For example, a VPC endpoint ID looks like
239
+ # Specifies the ID of the [VPC service endpoint][1] that you're
240
+ # using. For example, a VPC endpoint ID looks like
241
241
  # `vpce-01234d5aff67890e1`.
242
242
  #
243
- # The VPC endpoint you use must include the DataSync service name (for
244
- # example, `com.amazonaws.us-east-2.datasync`).
245
- # @return [String]
243
+ # The VPC service endpoint you use must include the DataSync service
244
+ # name (for example, `com.amazonaws.us-east-2.datasync`).
246
245
  #
247
- # @!attribute [rw] subnet_arns
248
- # Specifies the ARN of the subnet where you want to run your DataSync
249
- # task when using a VPC endpoint. This is the subnet where DataSync
250
- # creates and manages the [network interfaces][1] for your transfer.
251
- # You can only specify one ARN.
252
246
  #
253
247
  #
248
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc
249
+ # @return [String]
254
250
  #
255
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
251
+ # @!attribute [rw] subnet_arns
252
+ # Specifies the ARN of the subnet where your VPC service endpoint is
253
+ # located. You can only specify one ARN.
256
254
  # @return [Array<String>]
257
255
  #
258
256
  # @!attribute [rw] security_group_arns
259
257
  # Specifies the Amazon Resource Name (ARN) of the security group that
260
- # protects your task's [network interfaces][1] when [using a virtual
261
- # private cloud (VPC) endpoint][2]. You can only specify one ARN.
262
- #
263
- #
264
- #
265
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
266
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc
258
+ # allows traffic between your agent and VPC service endpoint. You can
259
+ # only specify one ARN.
267
260
  # @return [Array<String>]
268
261
  #
269
262
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateAgentRequest AWS API Documentation
@@ -393,22 +386,29 @@ module Aws::DataSync
393
386
  # @!attribute [rw] subdirectory
394
387
  # Specifies a mount path for your Amazon EFS file system. This is
395
388
  # where DataSync reads or writes data (depending on if this is a
396
- # source or destination location). By default, DataSync uses the root
397
- # directory, but you can also include subdirectories.
389
+ # source or destination location) on your file system.
398
390
  #
399
- # <note markdown="1"> You must specify a value with forward slashes (for example,
391
+ # By default, DataSync uses the root directory (or [access point][1]
392
+ # if you provide one by using `AccessPointArn`). You can also include
393
+ # subdirectories using forward slashes (for example,
400
394
  # `/path/to/folder`).
401
395
  #
402
- # </note>
396
+ #
397
+ #
398
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
403
399
  # @return [String]
404
400
  #
405
401
  # @!attribute [rw] efs_filesystem_arn
406
- # Specifies the ARN for the Amazon EFS file system.
402
+ # Specifies the ARN for your Amazon EFS file system.
407
403
  # @return [String]
408
404
  #
409
405
  # @!attribute [rw] ec2_config
410
- # Specifies the subnet and security groups DataSync uses to access
411
- # your Amazon EFS file system.
406
+ # Specifies the subnet and security groups DataSync uses to connect to
407
+ # one of your Amazon EFS file system's [mount targets][1].
408
+ #
409
+ #
410
+ #
411
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html
412
412
  # @return [Types::Ec2Config]
413
413
  #
414
414
  # @!attribute [rw] tags
@@ -420,18 +420,31 @@ module Aws::DataSync
420
420
  #
421
421
  # @!attribute [rw] access_point_arn
422
422
  # Specifies the Amazon Resource Name (ARN) of the access point that
423
- # DataSync uses to access the Amazon EFS file system.
423
+ # DataSync uses to mount your Amazon EFS file system.
424
+ #
425
+ # For more information, see [Accessing restricted file systems][1].
426
+ #
427
+ #
428
+ #
429
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam
424
430
  # @return [String]
425
431
  #
426
432
  # @!attribute [rw] file_system_access_role_arn
427
- # Specifies an Identity and Access Management (IAM) role that DataSync
428
- # assumes when mounting the Amazon EFS file system.
433
+ # Specifies an Identity and Access Management (IAM) role that allows
434
+ # DataSync to access your Amazon EFS file system.
435
+ #
436
+ # For information on creating this role, see [Creating a DataSync IAM
437
+ # role for file system access][1].
438
+ #
439
+ #
440
+ #
441
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role
429
442
  # @return [String]
430
443
  #
431
444
  # @!attribute [rw] in_transit_encryption
432
445
  # Specifies whether you want DataSync to use Transport Layer Security
433
- # (TLS) 1.2 encryption when it copies data to or from the Amazon EFS
434
- # file system.
446
+ # (TLS) 1.2 encryption when it transfers data to or from your Amazon
447
+ # EFS file system.
435
448
  #
436
449
  # If you specify an access point using `AccessPointArn` or an IAM role
437
450
  # using `FileSystemAccessRoleArn`, you must set this parameter to
@@ -652,8 +665,13 @@ module Aws::DataSync
652
665
  # @return [String]
653
666
  #
654
667
  # @!attribute [rw] security_group_arns
655
- # Specifies the ARNs of the security groups that provide access to
656
- # your file system's preferred subnet.
668
+ # Specifies the ARNs of the Amazon EC2 security groups that provide
669
+ # access to your file system's preferred subnet.
670
+ #
671
+ # The security groups that you specify must be able to communicate
672
+ # with your file system's security groups. For information about
673
+ # configuring security groups for file system access, see the [
674
+ # *Amazon FSx for Windows File Server User Guide* ][1].
657
675
  #
658
676
  # <note markdown="1"> If you choose a security group that doesn't allow connections from
659
677
  # within itself, do one of the following:
@@ -665,6 +683,10 @@ module Aws::DataSync
665
683
  # mount target's security group.
666
684
  #
667
685
  # </note>
686
+ #
687
+ #
688
+ #
689
+ # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html
668
690
  # @return [Array<String>]
669
691
  #
670
692
  # @!attribute [rw] tags
@@ -818,8 +840,8 @@ module Aws::DataSync
818
840
  # @return [String]
819
841
  #
820
842
  # @!attribute [rw] agent_arns
821
- # The Amazon Resource Names (ARNs) of the agents that are used to
822
- # connect to the HDFS cluster.
843
+ # The Amazon Resource Names (ARNs) of the DataSync agents that can
844
+ # connect to your HDFS cluster.
823
845
  # @return [Array<String>]
824
846
  #
825
847
  # @!attribute [rw] tags
@@ -849,7 +871,7 @@ module Aws::DataSync
849
871
  end
850
872
 
851
873
  # @!attribute [rw] location_arn
852
- # The ARN of the source HDFS cluster location that's created.
874
+ # The ARN of the source HDFS cluster location that you create.
853
875
  # @return [String]
854
876
  #
855
877
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationHdfsResponse AWS API Documentation
@@ -882,14 +904,14 @@ module Aws::DataSync
882
904
  #
883
905
  # @!attribute [rw] on_prem_config
884
906
  # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
885
- # want to connect to your NFS file server.
907
+ # can connect to your NFS file server.
886
908
  #
887
909
  # You can specify more than one agent. For more information, see
888
- # [Using multiple agents for transfers][1].
910
+ # [Using multiple DataSync agents][1].
889
911
  #
890
912
  #
891
913
  #
892
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
914
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents
893
915
  # @return [Types::OnPremConfig]
894
916
  #
895
917
  # @!attribute [rw] mount_options
@@ -972,7 +994,7 @@ module Aws::DataSync
972
994
  #
973
995
  # @!attribute [rw] agent_arns
974
996
  # Specifies the Amazon Resource Names (ARNs) of the DataSync agents
975
- # that can securely connect with your location.
997
+ # that can connect with your object storage system.
976
998
  # @return [Array<String>]
977
999
  #
978
1000
  # @!attribute [rw] tags
@@ -1211,9 +1233,9 @@ module Aws::DataSync
1211
1233
  # @return [String]
1212
1234
  #
1213
1235
  # @!attribute [rw] agent_arns
1214
- # Specifies the DataSync agent (or agents) which you want to connect
1215
- # to your SMB file server. You specify an agent by using its Amazon
1216
- # Resource Name (ARN).
1236
+ # Specifies the DataSync agent (or agents) that can connect to your
1237
+ # SMB file server. You specify an agent by using its Amazon Resource
1238
+ # Name (ARN).
1217
1239
  # @return [Array<String>]
1218
1240
  #
1219
1241
  # @!attribute [rw] mount_options
@@ -1269,6 +1291,10 @@ module Aws::DataSync
1269
1291
  # @!attribute [rw] cloud_watch_log_group_arn
1270
1292
  # Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
1271
1293
  # group for monitoring your task.
1294
+ #
1295
+ # For Enhanced mode tasks, you don't need to specify anything.
1296
+ # DataSync automatically sends logs to a CloudWatch log group named
1297
+ # `/aws/datasync`.
1272
1298
  # @return [String]
1273
1299
  #
1274
1300
  # @!attribute [rw] name
@@ -1308,10 +1334,10 @@ module Aws::DataSync
1308
1334
  # @return [Array<Types::TagListEntry>]
1309
1335
  #
1310
1336
  # @!attribute [rw] includes
1311
- # Specifies include filters define the files, objects, and folders in
1312
- # your source location that you want DataSync to transfer. For more
1313
- # information and examples, see [Specifying what DataSync transfers by
1314
- # using filters][1].
1337
+ # Specifies include filters that define the files, objects, and
1338
+ # folders in your source location that you want DataSync to transfer.
1339
+ # For more information and examples, see [Specifying what DataSync
1340
+ # transfers by using filters][1].
1315
1341
  #
1316
1342
  #
1317
1343
  #
@@ -1352,6 +1378,36 @@ module Aws::DataSync
1352
1378
  # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess
1353
1379
  # @return [Types::TaskReportConfig]
1354
1380
  #
1381
+ # @!attribute [rw] task_mode
1382
+ # Specifies one of the following task modes for your data transfer:
1383
+ #
1384
+ # * `ENHANCED` - Transfer virtually unlimited numbers of objects with
1385
+ # higher performance than Basic mode. Enhanced mode tasks optimize
1386
+ # the data transfer process by listing, preparing, transferring, and
1387
+ # verifying data in parallel. Enhanced mode is currently available
1388
+ # for transfers between Amazon S3 locations.
1389
+ #
1390
+ # <note markdown="1"> To create an Enhanced mode task, the IAM role that you use to call
1391
+ # the `CreateTask` operation must have the
1392
+ # `iam:CreateServiceLinkedRole` permission.
1393
+ #
1394
+ # </note>
1395
+ #
1396
+ # * `BASIC` (default) - Transfer files or objects between Amazon Web
1397
+ # Services storage and all other supported DataSync locations. Basic
1398
+ # mode tasks are subject to [quotas][1] on the number of files,
1399
+ # objects, and directories in a dataset. Basic mode sequentially
1400
+ # prepares, transfers, and verifies data, making it slower than
1401
+ # Enhanced mode for most workloads.
1402
+ #
1403
+ # For more information, see [Understanding task mode differences][2].
1404
+ #
1405
+ #
1406
+ #
1407
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html
1408
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
1409
+ # @return [String]
1410
+ #
1355
1411
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateTaskRequest AWS API Documentation
1356
1412
  #
1357
1413
  class CreateTaskRequest < Struct.new(
@@ -1365,7 +1421,8 @@ module Aws::DataSync
1365
1421
  :tags,
1366
1422
  :includes,
1367
1423
  :manifest_config,
1368
- :task_report_config)
1424
+ :task_report_config,
1425
+ :task_mode)
1369
1426
  SENSITIVE = []
1370
1427
  include Aws::Structure
1371
1428
  end
@@ -1718,8 +1775,12 @@ module Aws::DataSync
1718
1775
  # @return [String]
1719
1776
  #
1720
1777
  # @!attribute [rw] ec2_config
1721
- # The subnet and security groups that DataSync uses to access your
1722
- # Amazon EFS file system.
1778
+ # The subnet and security groups that DataSync uses to connect to one
1779
+ # of your Amazon EFS file system's [mount targets][1].
1780
+ #
1781
+ #
1782
+ #
1783
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html
1723
1784
  # @return [Types::Ec2Config]
1724
1785
  #
1725
1786
  # @!attribute [rw] creation_time
@@ -1729,16 +1790,30 @@ module Aws::DataSync
1729
1790
  # @!attribute [rw] access_point_arn
1730
1791
  # The ARN of the access point that DataSync uses to access the Amazon
1731
1792
  # EFS file system.
1793
+ #
1794
+ # For more information, see [Accessing restricted file systems][1].
1795
+ #
1796
+ #
1797
+ #
1798
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam
1732
1799
  # @return [String]
1733
1800
  #
1734
1801
  # @!attribute [rw] file_system_access_role_arn
1735
- # The Identity and Access Management (IAM) role that DataSync assumes
1736
- # when mounting the Amazon EFS file system.
1802
+ # The Identity and Access Management (IAM) role that allows DataSync
1803
+ # to access your Amazon EFS file system.
1804
+ #
1805
+ # For more information, see [Creating a DataSync IAM role for file
1806
+ # system access][1].
1807
+ #
1808
+ #
1809
+ #
1810
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role
1737
1811
  # @return [String]
1738
1812
  #
1739
1813
  # @!attribute [rw] in_transit_encryption
1740
- # Describes whether DataSync uses Transport Layer Security (TLS)
1741
- # encryption when copying data to or from the Amazon EFS file system.
1814
+ # Indicates whether DataSync uses Transport Layer Security (TLS)
1815
+ # encryption when transferring data to or from the Amazon EFS file
1816
+ # system.
1742
1817
  # @return [String]
1743
1818
  #
1744
1819
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationEfsResponse AWS API Documentation
@@ -1928,8 +2003,16 @@ module Aws::DataSync
1928
2003
  # @return [String]
1929
2004
  #
1930
2005
  # @!attribute [rw] security_group_arns
1931
- # The ARNs of the security groups that are configured for the FSx for
1932
- # Windows File Server file system.
2006
+ # The ARNs of the Amazon EC2 security groups that provide access to
2007
+ # your file system's preferred subnet.
2008
+ #
2009
+ # For information about configuring security groups for file system
2010
+ # access, see the [ *Amazon FSx for Windows File Server User Guide*
2011
+ # ][1].
2012
+ #
2013
+ #
2014
+ #
2015
+ # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html
1933
2016
  # @return [Array<String>]
1934
2017
  #
1935
2018
  # @!attribute [rw] creation_time
@@ -2073,8 +2156,8 @@ module Aws::DataSync
2073
2156
  # @return [String]
2074
2157
  #
2075
2158
  # @!attribute [rw] on_prem_config
2076
- # The DataSync agents that are connecting to a Network File System
2077
- # (NFS) location.
2159
+ # The DataSync agents that can connect to your Network File System
2160
+ # (NFS) file server.
2078
2161
  # @return [Types::OnPremConfig]
2079
2162
  #
2080
2163
  # @!attribute [rw] mount_options
@@ -2624,46 +2707,82 @@ module Aws::DataSync
2624
2707
  # @return [Time]
2625
2708
  #
2626
2709
  # @!attribute [rw] estimated_files_to_transfer
2627
- # The expected number of files, objects, and directories that DataSync
2628
- # will transfer over the network. This value is calculated during the
2629
- # task execution's `PREPARING` phase before the `TRANSFERRING` phase.
2630
- # The calculation is based on comparing the content of the source and
2631
- # destination locations and finding the difference that needs to be
2632
- # transferred.
2710
+ # The number of files, objects, and directories that DataSync expects
2711
+ # to transfer over the network. This value is calculated while
2712
+ # DataSync [prepares][1] the transfer.
2713
+ #
2714
+ # How this gets calculated depends primarily on your task’s [transfer
2715
+ # mode][2] configuration:
2716
+ #
2717
+ # * If `TranserMode` is set to `CHANGED` - The calculation is based on
2718
+ # comparing the content of the source and destination locations and
2719
+ # determining the difference that needs to be transferred. The
2720
+ # difference can include:
2721
+ #
2722
+ # * Anything that's added or modified at the source location.
2723
+ #
2724
+ # * Anything that's in both locations and modified at the
2725
+ # destination after an initial transfer (unless [OverwriteMode][3]
2726
+ # is set to `NEVER`).
2727
+ #
2728
+ # * **(Basic task mode only)** The number of items that DataSync
2729
+ # expects to delete (if [PreserveDeletedFiles][4] is set to
2730
+ # `REMOVE`).
2731
+ #
2732
+ # * If `TranserMode` is set to `ALL` - The calculation is based only
2733
+ # on the items that DataSync finds at the source location.
2734
+ #
2735
+ #
2736
+ #
2737
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
2738
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode
2739
+ # [3]: https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode
2740
+ # [4]: https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles
2633
2741
  # @return [Integer]
2634
2742
  #
2635
2743
  # @!attribute [rw] estimated_bytes_to_transfer
2636
- # The estimated physical number of bytes that will transfer over the
2637
- # network.
2744
+ # The number of logical bytes that DataSync expects to write to the
2745
+ # destination location.
2638
2746
  # @return [Integer]
2639
2747
  #
2640
2748
  # @!attribute [rw] files_transferred
2641
- # The actual number of files, objects, and directories that DataSync
2642
- # transferred over the network. This value is updated periodically
2643
- # during the task execution's `TRANSFERRING` phase when something is
2644
- # read from the source and sent over the network.
2749
+ # The number of files, objects, and directories that DataSync actually
2750
+ # transfers over the network. This value is updated periodically
2751
+ # during your task execution when something is read from the source
2752
+ # and sent over the network.
2645
2753
  #
2646
2754
  # If DataSync fails to transfer something, this value can be less than
2647
2755
  # `EstimatedFilesToTransfer`. In some cases, this value can also be
2648
2756
  # greater than `EstimatedFilesToTransfer`. This element is
2649
2757
  # implementation-specific for some location types, so don't use it as
2650
- # an exact indication of what transferred or to monitor your task
2758
+ # an exact indication of what's transferring or to monitor your task
2651
2759
  # execution.
2652
2760
  # @return [Integer]
2653
2761
  #
2654
2762
  # @!attribute [rw] bytes_written
2655
- # The number of logical bytes written to the destination location.
2763
+ # The number of logical bytes that DataSync actually writes to the
2764
+ # destination location.
2656
2765
  # @return [Integer]
2657
2766
  #
2658
2767
  # @!attribute [rw] bytes_transferred
2659
- # The total number of bytes that are involved in the transfer. For the
2660
- # number of bytes sent over the network, see `BytesCompressed`.
2768
+ # The number of bytes that DataSync sends to the network before
2769
+ # compression (if compression is possible). For the number of bytes
2770
+ # transferred over the network, see [BytesCompressed][1].
2771
+ #
2772
+ #
2773
+ #
2774
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed
2661
2775
  # @return [Integer]
2662
2776
  #
2663
2777
  # @!attribute [rw] bytes_compressed
2664
- # The physical number of bytes transferred over the network after
2665
- # compression was applied. In most cases, this number is less than
2666
- # `BytesTransferred` unless the data isn't compressible.
2778
+ # The number of physical bytes that DataSync transfers over the
2779
+ # network after compression (if compression is possible). This number
2780
+ # is typically less than [BytesTransferred][1] unless the data isn't
2781
+ # compressible.
2782
+ #
2783
+ #
2784
+ #
2785
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred
2667
2786
  # @return [Integer]
2668
2787
  #
2669
2788
  # @!attribute [rw] result
@@ -2681,10 +2800,10 @@ module Aws::DataSync
2681
2800
  # @return [Types::TaskReportConfig]
2682
2801
  #
2683
2802
  # @!attribute [rw] files_deleted
2684
- # The number of files, objects, and directories that DataSync deleted
2685
- # in your destination location. If you don't [configure your task][1]
2686
- # to delete data in the destination that isn't in the source, the
2687
- # value is always `0`.
2803
+ # The number of files, objects, and directories that DataSync actually
2804
+ # deletes in your destination location. If you don't configure your
2805
+ # task to [delete data in the destination that isn't in the
2806
+ # source][1], the value is always `0`.
2688
2807
  #
2689
2808
  #
2690
2809
  #
@@ -2692,12 +2811,12 @@ module Aws::DataSync
2692
2811
  # @return [Integer]
2693
2812
  #
2694
2813
  # @!attribute [rw] files_skipped
2695
- # The number of files, objects, and directories that DataSync skipped
2814
+ # The number of files, objects, and directories that DataSync skips
2696
2815
  # during your transfer.
2697
2816
  # @return [Integer]
2698
2817
  #
2699
2818
  # @!attribute [rw] files_verified
2700
- # The number of files, objects, and directories that DataSync verified
2819
+ # The number of files, objects, and directories that DataSync verifies
2701
2820
  # during your transfer.
2702
2821
  #
2703
2822
  # <note markdown="1"> When you configure your task to [verify only the data that's
@@ -2721,16 +2840,69 @@ module Aws::DataSync
2721
2840
  # @return [Types::ReportResult]
2722
2841
  #
2723
2842
  # @!attribute [rw] estimated_files_to_delete
2724
- # The expected number of files, objects, and directories that DataSync
2725
- # will delete in your destination location. If you don't [configure
2726
- # your task][1] to delete data in the destination that isn't in the
2727
- # source, the value is always `0`.
2843
+ # The number of files, objects, and directories that DataSync expects
2844
+ # to delete in your destination location. If you don't configure your
2845
+ # task to [delete data in the destination that isn't in the
2846
+ # source][1], the value is always `0`.
2728
2847
  #
2729
2848
  #
2730
2849
  #
2731
2850
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html
2732
2851
  # @return [Integer]
2733
2852
  #
2853
+ # @!attribute [rw] task_mode
2854
+ # The task mode that you're using. For more information, see
2855
+ # [Choosing a task mode for your data transfer][1].
2856
+ #
2857
+ #
2858
+ #
2859
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
2860
+ # @return [String]
2861
+ #
2862
+ # @!attribute [rw] files_prepared
2863
+ # The number of objects that DataSync will attempt to transfer after
2864
+ # comparing your source and destination locations.
2865
+ #
2866
+ # <note markdown="1"> Applies only to [Enhanced mode tasks][1].
2867
+ #
2868
+ # </note>
2869
+ #
2870
+ # This counter isn't applicable if you configure your task to
2871
+ # [transfer all data][2]. In that scenario, DataSync copies everything
2872
+ # from the source to the destination without comparing differences
2873
+ # between the locations.
2874
+ #
2875
+ #
2876
+ #
2877
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
2878
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode
2879
+ # @return [Integer]
2880
+ #
2881
+ # @!attribute [rw] files_listed
2882
+ # The number of objects that DataSync finds at your locations.
2883
+ #
2884
+ # <note markdown="1"> Applies only to [Enhanced mode tasks][1].
2885
+ #
2886
+ # </note>
2887
+ #
2888
+ #
2889
+ #
2890
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
2891
+ # @return [Types::TaskExecutionFilesListedDetail]
2892
+ #
2893
+ # @!attribute [rw] files_failed
2894
+ # The number of objects that DataSync fails to prepare, transfer,
2895
+ # verify, and delete during your task execution.
2896
+ #
2897
+ # <note markdown="1"> Applies only to [Enhanced mode tasks][1].
2898
+ #
2899
+ # </note>
2900
+ #
2901
+ #
2902
+ #
2903
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
2904
+ # @return [Types::TaskExecutionFilesFailedDetail]
2905
+ #
2734
2906
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecutionResponse AWS API Documentation
2735
2907
  #
2736
2908
  class DescribeTaskExecutionResponse < Struct.new(
@@ -2753,7 +2925,11 @@ module Aws::DataSync
2753
2925
  :files_skipped,
2754
2926
  :files_verified,
2755
2927
  :report_result,
2756
- :estimated_files_to_delete)
2928
+ :estimated_files_to_delete,
2929
+ :task_mode,
2930
+ :files_prepared,
2931
+ :files_listed,
2932
+ :files_failed)
2757
2933
  SENSITIVE = []
2758
2934
  include Aws::Structure
2759
2935
  end
@@ -2808,12 +2984,12 @@ module Aws::DataSync
2808
2984
  # The Amazon Resource Name (ARN) of an Amazon CloudWatch log group for
2809
2985
  # monitoring your task.
2810
2986
  #
2811
- # For more information, see [Monitoring DataSync with Amazon
2812
- # CloudWatch][1].
2987
+ # For more information, see [Monitoring data transfers with CloudWatch
2988
+ # Logs][1].
2813
2989
  #
2814
2990
  #
2815
2991
  #
2816
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/monitor-datasync.html
2992
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html
2817
2993
  # @return [String]
2818
2994
  #
2819
2995
  # @!attribute [rw] source_network_interface_arns
@@ -2923,6 +3099,15 @@ module Aws::DataSync
2923
3099
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
2924
3100
  # @return [Types::TaskScheduleDetails]
2925
3101
  #
3102
+ # @!attribute [rw] task_mode
3103
+ # The task mode that you're using. For more information, see
3104
+ # [Choosing a task mode for your data transfer][1].
3105
+ #
3106
+ #
3107
+ #
3108
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
3109
+ # @return [String]
3110
+ #
2926
3111
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskResponse AWS API Documentation
2927
3112
  #
2928
3113
  class DescribeTaskResponse < Struct.new(
@@ -2944,7 +3129,8 @@ module Aws::DataSync
2944
3129
  :includes,
2945
3130
  :manifest_config,
2946
3131
  :task_report_config,
2947
- :schedule_details)
3132
+ :schedule_details,
3133
+ :task_mode)
2948
3134
  SENSITIVE = []
2949
3135
  include Aws::Structure
2950
3136
  end
@@ -2995,8 +3181,12 @@ module Aws::DataSync
2995
3181
  include Aws::Structure
2996
3182
  end
2997
3183
 
2998
- # The subnet and security groups that DataSync uses to access your
2999
- # Amazon EFS file system.
3184
+ # The subnet and security groups that DataSync uses to connect to one of
3185
+ # your Amazon EFS file system's [mount targets][1].
3186
+ #
3187
+ #
3188
+ #
3189
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html
3000
3190
  #
3001
3191
  # @!attribute [rw] subnet_arn
3002
3192
  # Specifies the ARN of a subnet where DataSync creates the [network
@@ -4129,12 +4319,19 @@ module Aws::DataSync
4129
4319
  include Aws::Structure
4130
4320
  end
4131
4321
 
4132
- # The DataSync agents that are connecting to a Network File System (NFS)
4133
- # location.
4322
+ # The DataSync agents that can connect to your Network File System (NFS)
4323
+ # file server.
4134
4324
  #
4135
4325
  # @!attribute [rw] agent_arns
4136
- # The Amazon Resource Names (ARNs) of the agents connecting to a
4137
- # transfer location.
4326
+ # The Amazon Resource Names (ARNs) of the DataSync agents that can
4327
+ # connect to your NFS file server.
4328
+ #
4329
+ # You can specify more than one agent. For more information, see
4330
+ # [Using multiple DataSync agents][1].
4331
+ #
4332
+ #
4333
+ #
4334
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents
4138
4335
  # @return [Array<String>]
4139
4336
  #
4140
4337
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/OnPremConfig AWS API Documentation
@@ -4162,39 +4359,50 @@ module Aws::DataSync
4162
4359
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
4163
4360
  #
4164
4361
  # @!attribute [rw] verify_mode
4165
- # Specifies how and when DataSync checks the integrity of your data
4166
- # during a transfer.
4362
+ # Specifies if and how DataSync checks the integrity of your data at
4363
+ # the end of your transfer.
4167
4364
  #
4168
4365
  # * `ONLY_FILES_TRANSFERRED` (recommended) - DataSync calculates the
4169
- # checksum of transferred files and metadata at the source location.
4170
- # At the end of the transfer, DataSync then compares this checksum
4171
- # to the checksum calculated on those files at the destination.
4366
+ # checksum of transferred data (including metadata) at the source
4367
+ # location. At the end of the transfer, DataSync then compares this
4368
+ # checksum to the checksum calculated on that data at the
4369
+ # destination.
4370
+ #
4371
+ # <note markdown="1"> This is the default option for [Enhanced mode tasks][1].
4372
+ #
4373
+ # </note>
4172
4374
  #
4173
4375
  # We recommend this option when transferring to S3 Glacier Flexible
4174
4376
  # Retrieval or S3 Glacier Deep Archive storage classes. For more
4175
4377
  # information, see [Storage class considerations with Amazon S3
4176
- # locations][1].
4378
+ # locations][2].
4177
4379
  #
4178
- # * `POINT_IN_TIME_CONSISTENT` (default) - At the end of the transfer,
4179
- # DataSync scans the entire source and destination to verify that
4180
- # both locations are fully synchronized.
4380
+ # * `POINT_IN_TIME_CONSISTENT` - At the end of the transfer, DataSync
4381
+ # checks the entire source and destination to verify that both
4382
+ # locations are fully synchronized.
4181
4383
  #
4182
- # If you use a [manifest][2], DataSync only scans and verifies
4384
+ # <note markdown="1"> The is the default option for [Basic mode tasks][1] and isn't
4385
+ # currently supported with Enhanced mode tasks.
4386
+ #
4387
+ # </note>
4388
+ #
4389
+ # If you use a [manifest][3], DataSync only scans and verifies
4183
4390
  # what's listed in the manifest.
4184
4391
  #
4185
4392
  # You can't use this option when transferring to S3 Glacier
4186
4393
  # Flexible Retrieval or S3 Glacier Deep Archive storage classes. For
4187
4394
  # more information, see [Storage class considerations with Amazon S3
4188
- # locations][1].
4395
+ # locations][2].
4189
4396
  #
4190
- # * `NONE` - DataSync doesn't run additional verification at the end
4191
- # of the transfer. All data transmissions are still
4192
- # integrity-checked with checksum verification during the transfer.
4397
+ # * `NONE` - DataSync performs data integrity checks only during your
4398
+ # transfer. Unlike other options, there's no additional
4399
+ # verification at the end of your transfer.
4193
4400
  #
4194
4401
  #
4195
4402
  #
4196
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
4197
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html
4403
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
4404
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
4405
+ # [3]: https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html
4198
4406
  # @return [String]
4199
4407
  #
4200
4408
  # @!attribute [rw] overwrite_mode
@@ -4230,7 +4438,7 @@ module Aws::DataSync
4230
4438
  #
4231
4439
  # * `BEST_EFFORT` (default) - DataSync attempts to preserve the
4232
4440
  # original `Atime` attribute on all source files (that is, the
4233
- # version before the `PREPARING` phase of the task execution). This
4441
+ # version before the `PREPARING` steps of the task execution). This
4234
4442
  # option is recommended.
4235
4443
  #
4236
4444
  # * `NONE` - Ignores `Atime`.
@@ -4245,7 +4453,7 @@ module Aws::DataSync
4245
4453
  #
4246
4454
  # @!attribute [rw] mtime
4247
4455
  # Specifies whether to preserve metadata indicating the last time that
4248
- # a file was written to before the `PREPARING` phase of your task
4456
+ # a file was written to before the `PREPARING` step of your task
4249
4457
  # execution. This option is required when you need to run the a task
4250
4458
  # more than once.
4251
4459
  #
@@ -4285,11 +4493,12 @@ module Aws::DataSync
4285
4493
  #
4286
4494
  # * `NONE` - Ignores UID and GID.
4287
4495
  #
4288
- # For more information, see [Metadata copied by DataSync][1].
4496
+ # For more information, see [Understanding how DataSync handles file
4497
+ # and object metadata][1].
4289
4498
  #
4290
4499
  #
4291
4500
  #
4292
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied
4501
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html
4293
4502
  # @return [String]
4294
4503
  #
4295
4504
  # @!attribute [rw] preserve_deleted_files
@@ -4338,7 +4547,8 @@ module Aws::DataSync
4338
4547
  # Specifies which users or groups can access a file for a specific
4339
4548
  # purpose such as reading, writing, or execution of the file.
4340
4549
  #
4341
- # For more information, see [Metadata copied by DataSync][1].
4550
+ # For more information, see [Understanding how DataSync handles file
4551
+ # and object metadata][1].
4342
4552
  #
4343
4553
  # * `PRESERVE` (default) - Preserves POSIX-style permissions, which is
4344
4554
  # recommended.
@@ -4351,13 +4561,21 @@ module Aws::DataSync
4351
4561
  #
4352
4562
  #
4353
4563
  #
4354
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied
4564
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html
4355
4565
  # @return [String]
4356
4566
  #
4357
4567
  # @!attribute [rw] bytes_per_second
4358
4568
  # Limits the bandwidth used by a DataSync task. For example, if you
4359
4569
  # want DataSync to use a maximum of 1 MB, set this value to `1048576`
4360
4570
  # (`=1024*1024`).
4571
+ #
4572
+ # <note markdown="1"> Not applicable to [Enhanced mode tasks][1].
4573
+ #
4574
+ # </note>
4575
+ #
4576
+ #
4577
+ #
4578
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
4361
4579
  # @return [Integer]
4362
4580
  #
4363
4581
  # @!attribute [rw] task_queueing
@@ -4389,14 +4607,15 @@ module Aws::DataSync
4389
4607
  # @return [String]
4390
4608
  #
4391
4609
  # @!attribute [rw] transfer_mode
4392
- # Determines whether DataSync transfers only the data and metadata
4393
- # that differ between the source and the destination location or
4394
- # transfers all the content from the source (without comparing what's
4395
- # in the destination).
4610
+ # Specifies whether DataSync transfers only the data (including
4611
+ # metadata) that differs between locations following an initial copy
4612
+ # or transfers all data every time you run the task. If you're
4613
+ # planning on recurring transfers, you might only want to transfer
4614
+ # what's changed since your previous task execution.
4396
4615
  #
4397
- # * `CHANGED` (default) - DataSync copies only data or metadata that
4398
- # is new or different content from the source location to the
4399
- # destination location.
4616
+ # * `CHANGED` (default) - After your initial full transfer, DataSync
4617
+ # copies only the data and metadata that differs between the source
4618
+ # and destination location.
4400
4619
  #
4401
4620
  # * `ALL` - DataSync copies everything in the source to the
4402
4621
  # destination without comparing differences between the locations.
@@ -4408,8 +4627,8 @@ module Aws::DataSync
4408
4627
  #
4409
4628
  # This value is only used for transfers between SMB and Amazon FSx for
4410
4629
  # Windows File Server locations or between two FSx for Windows File
4411
- # Server locations. For more information, see [how DataSync handles
4412
- # metadata][1].
4630
+ # Server locations. For more information, see [Understanding how
4631
+ # DataSync handles file and object metadata][1].
4413
4632
  #
4414
4633
  # * `OWNER_DACL` (default) - For each copied object, DataSync copies
4415
4634
  # the following metadata:
@@ -4447,7 +4666,7 @@ module Aws::DataSync
4447
4666
  #
4448
4667
  #
4449
4668
  #
4450
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html
4669
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html
4451
4670
  # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
4452
4671
  # [3]: https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions
4453
4672
  # [4]: https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb
@@ -4546,7 +4765,7 @@ module Aws::DataSync
4546
4765
  #
4547
4766
  #
4548
4767
  #
4549
- # [1]: https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-service.html
4768
+ # [1]: https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html
4550
4769
  # @return [String]
4551
4770
  #
4552
4771
  # @!attribute [rw] subnet_arns
@@ -5270,6 +5489,96 @@ module Aws::DataSync
5270
5489
  #
5271
5490
  class TagResourceResponse < Aws::EmptyStructure; end
5272
5491
 
5492
+ # The number of objects that DataSync fails to prepare, transfer,
5493
+ # verify, and delete during your task execution.
5494
+ #
5495
+ # <note markdown="1"> Applies only to [Enhanced mode tasks][1].
5496
+ #
5497
+ # </note>
5498
+ #
5499
+ #
5500
+ #
5501
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
5502
+ #
5503
+ # @!attribute [rw] prepare
5504
+ # The number of objects that DataSync fails to prepare during your
5505
+ # task execution.
5506
+ # @return [Integer]
5507
+ #
5508
+ # @!attribute [rw] transfer
5509
+ # The number of objects that DataSync fails to transfer during your
5510
+ # task execution.
5511
+ # @return [Integer]
5512
+ #
5513
+ # @!attribute [rw] verify
5514
+ # The number of objects that DataSync fails to verify during your task
5515
+ # execution.
5516
+ # @return [Integer]
5517
+ #
5518
+ # @!attribute [rw] delete
5519
+ # The number of objects that DataSync fails to delete during your task
5520
+ # execution.
5521
+ # @return [Integer]
5522
+ #
5523
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskExecutionFilesFailedDetail AWS API Documentation
5524
+ #
5525
+ class TaskExecutionFilesFailedDetail < Struct.new(
5526
+ :prepare,
5527
+ :transfer,
5528
+ :verify,
5529
+ :delete)
5530
+ SENSITIVE = []
5531
+ include Aws::Structure
5532
+ end
5533
+
5534
+ # The number of objects that DataSync finds at your locations.
5535
+ #
5536
+ # <note markdown="1"> Applies only to [Enhanced mode tasks][1].
5537
+ #
5538
+ # </note>
5539
+ #
5540
+ #
5541
+ #
5542
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
5543
+ #
5544
+ # @!attribute [rw] at_source
5545
+ # The number of objects that DataSync finds at your source location.
5546
+ #
5547
+ # * With a [manifest][1], DataSync lists only what's in your manifest
5548
+ # (and not everything at your source location).
5549
+ #
5550
+ # * With an include [filter][2], DataSync lists only what matches the
5551
+ # filter at your source location.
5552
+ #
5553
+ # * With an exclude filter, DataSync lists everything at your source
5554
+ # location before applying the filter.
5555
+ #
5556
+ #
5557
+ #
5558
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html
5559
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html
5560
+ # @return [Integer]
5561
+ #
5562
+ # @!attribute [rw] at_destination_for_delete
5563
+ # The number of objects that DataSync finds at your destination
5564
+ # location. This counter is only applicable if you [configure your
5565
+ # task][1] to delete data in the destination that isn't in the
5566
+ # source.
5567
+ #
5568
+ #
5569
+ #
5570
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling
5571
+ # @return [Integer]
5572
+ #
5573
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskExecutionFilesListedDetail AWS API Documentation
5574
+ #
5575
+ class TaskExecutionFilesListedDetail < Struct.new(
5576
+ :at_source,
5577
+ :at_destination_for_delete)
5578
+ SENSITIVE = []
5579
+ include Aws::Structure
5580
+ end
5581
+
5273
5582
  # Represents a single entry in a list of DataSync task executions
5274
5583
  # that's returned with the [ListTaskExecutions][1] operation.
5275
5584
  #
@@ -5290,60 +5599,118 @@ module Aws::DataSync
5290
5599
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/understand-task-statuses.html#understand-task-execution-statuses
5291
5600
  # @return [String]
5292
5601
  #
5602
+ # @!attribute [rw] task_mode
5603
+ # The task mode that you're using. For more information, see
5604
+ # [Choosing a task mode for your data transfer][1].
5605
+ #
5606
+ #
5607
+ #
5608
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
5609
+ # @return [String]
5610
+ #
5293
5611
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskExecutionListEntry AWS API Documentation
5294
5612
  #
5295
5613
  class TaskExecutionListEntry < Struct.new(
5296
5614
  :task_execution_arn,
5297
- :status)
5615
+ :status,
5616
+ :task_mode)
5298
5617
  SENSITIVE = []
5299
5618
  include Aws::Structure
5300
5619
  end
5301
5620
 
5302
- # Describes the detailed result of a `TaskExecution` operation. This
5303
- # result includes the time in milliseconds spent in each phase, the
5304
- # status of the task execution, and the errors encountered.
5621
+ # Provides detailed information about the result of your DataSync task
5622
+ # execution.
5305
5623
  #
5306
5624
  # @!attribute [rw] prepare_duration
5307
- # The total time in milliseconds that DataSync spent in the PREPARING
5308
- # phase.
5625
+ # The time in milliseconds that your task execution was in the
5626
+ # `PREPARING` step. For more information, see [Task execution
5627
+ # statuses][1].
5628
+ #
5629
+ # For Enhanced mode tasks, the value is always `0`. For more
5630
+ # information, see [How DataSync prepares your data transfer][2].
5631
+ #
5632
+ #
5633
+ #
5634
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
5635
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares
5309
5636
  # @return [Integer]
5310
5637
  #
5311
5638
  # @!attribute [rw] prepare_status
5312
- # The status of the PREPARING phase.
5639
+ # The status of the `PREPARING` step for your task execution. For more
5640
+ # information, see [Task execution statuses][1].
5641
+ #
5642
+ #
5643
+ #
5644
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
5313
5645
  # @return [String]
5314
5646
  #
5315
5647
  # @!attribute [rw] total_duration
5316
- # The total time in milliseconds that DataSync took to transfer the
5317
- # file from the source to the destination location.
5648
+ # The time in milliseconds that your task execution ran.
5318
5649
  # @return [Integer]
5319
5650
  #
5320
5651
  # @!attribute [rw] transfer_duration
5321
- # The total time in milliseconds that DataSync spent in the
5322
- # TRANSFERRING phase.
5652
+ # The time in milliseconds that your task execution was in the
5653
+ # `TRANSFERRING` step. For more information, see [Task execution
5654
+ # statuses][1].
5655
+ #
5656
+ # For Enhanced mode tasks, the value is always `0`. For more
5657
+ # information, see [How DataSync transfers your data][2].
5658
+ #
5659
+ #
5660
+ #
5661
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
5662
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers
5323
5663
  # @return [Integer]
5324
5664
  #
5325
5665
  # @!attribute [rw] transfer_status
5326
- # The status of the TRANSFERRING phase.
5666
+ # The status of the `TRANSFERRING` step for your task execution. For
5667
+ # more information, see [Task execution statuses][1].
5668
+ #
5669
+ #
5670
+ #
5671
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
5327
5672
  # @return [String]
5328
5673
  #
5329
5674
  # @!attribute [rw] verify_duration
5330
- # The total time in milliseconds that DataSync spent in the VERIFYING
5331
- # phase.
5675
+ # The time in milliseconds that your task execution was in the
5676
+ # `VERIFYING` step. For more information, see [Task execution
5677
+ # statuses][1].
5678
+ #
5679
+ # For Enhanced mode tasks, the value is always `0`. For more
5680
+ # information, see [How DataSync verifies your data's integrity][2].
5681
+ #
5682
+ #
5683
+ #
5684
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
5685
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works
5332
5686
  # @return [Integer]
5333
5687
  #
5334
5688
  # @!attribute [rw] verify_status
5335
- # The status of the VERIFYING phase.
5689
+ # The status of the `VERIFYING` step for your task execution. For more
5690
+ # information, see [Task execution statuses][1].
5691
+ #
5692
+ #
5693
+ #
5694
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses
5336
5695
  # @return [String]
5337
5696
  #
5338
5697
  # @!attribute [rw] error_code
5339
- # Errors that DataSync encountered during execution of the task. You
5340
- # can use this error code to help troubleshoot issues.
5698
+ # An error that DataSync encountered during your task execution. You
5699
+ # can use this information to help [troubleshoot issues][1].
5700
+ #
5701
+ #
5702
+ #
5703
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html
5341
5704
  # @return [String]
5342
5705
  #
5343
5706
  # @!attribute [rw] error_detail
5344
- # Detailed description of an error that was encountered during the
5345
- # task execution. You can use this information to help troubleshoot
5346
- # issues.
5707
+ # The detailed description of an error that DataSync encountered
5708
+ # during your task execution. You can use this information to help
5709
+ # [troubleshoot issues][1].
5710
+ #
5711
+ #
5712
+ #
5713
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html
5347
5714
  # @return [String]
5348
5715
  #
5349
5716
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskExecutionResultDetail AWS API Documentation
@@ -5420,12 +5787,22 @@ module Aws::DataSync
5420
5787
  # The name of the task.
5421
5788
  # @return [String]
5422
5789
  #
5790
+ # @!attribute [rw] task_mode
5791
+ # The task mode that you're using. For more information, see
5792
+ # [Choosing a task mode for your data transfer][1].
5793
+ #
5794
+ #
5795
+ #
5796
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html
5797
+ # @return [String]
5798
+ #
5423
5799
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskListEntry AWS API Documentation
5424
5800
  #
5425
5801
  class TaskListEntry < Struct.new(
5426
5802
  :task_arn,
5427
5803
  :status,
5428
- :name)
5804
+ :name,
5805
+ :task_mode)
5429
5806
  SENSITIVE = []
5430
5807
  include Aws::Structure
5431
5808
  end
@@ -5511,13 +5888,26 @@ module Aws::DataSync
5511
5888
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
5512
5889
  #
5513
5890
  # @!attribute [rw] schedule_expression
5514
- # Specifies your task schedule by using a cron expression in UTC time.
5515
- # For information about cron expression syntax, see the [ *Amazon
5516
- # EventBridge User Guide* ][1].
5891
+ # Specifies your task schedule by using a cron or rate expression.
5892
+ #
5893
+ # Use cron expressions for task schedules that run on a specific time
5894
+ # and day. For example, the following cron expression creates a task
5895
+ # schedule that runs at 8 AM on the first Wednesday of every month:
5896
+ #
5897
+ # `cron(0 8 * * 3#1)`
5898
+ #
5899
+ # Use rate expressions for task schedules that run on a regular
5900
+ # interval. For example, the following rate expression creates a task
5901
+ # schedule that runs every 12 hours:
5902
+ #
5903
+ # `rate(12 hours)`
5517
5904
  #
5905
+ # For information about cron and rate expression syntax, see the [
5906
+ # *Amazon EventBridge User Guide* ][1].
5518
5907
  #
5519
5908
  #
5520
- # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html
5909
+ #
5910
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html
5521
5911
  # @return [String]
5522
5912
  #
5523
5913
  # @!attribute [rw] status
@@ -5839,7 +6229,8 @@ module Aws::DataSync
5839
6229
  # @return [String]
5840
6230
  #
5841
6231
  # @!attribute [rw] agent_arns
5842
- # The ARNs of the agents that are used to connect to the HDFS cluster.
6232
+ # The Amazon Resource Names (ARNs) of the DataSync agents that can
6233
+ # connect to your HDFS cluster.
5843
6234
  # @return [Array<String>]
5844
6235
  #
5845
6236
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationHdfsRequest AWS API Documentation
@@ -5885,8 +6276,8 @@ module Aws::DataSync
5885
6276
  # @return [String]
5886
6277
  #
5887
6278
  # @!attribute [rw] on_prem_config
5888
- # The DataSync agents that are connecting to a Network File System
5889
- # (NFS) location.
6279
+ # The DataSync agents that can connect to your Network File System
6280
+ # (NFS) file server.
5890
6281
  # @return [Types::OnPremConfig]
5891
6282
  #
5892
6283
  # @!attribute [rw] mount_options
@@ -5942,7 +6333,7 @@ module Aws::DataSync
5942
6333
  #
5943
6334
  # @!attribute [rw] agent_arns
5944
6335
  # Specifies the Amazon Resource Names (ARNs) of the DataSync agents
5945
- # that can securely connect with your location.
6336
+ # that can connect with your object storage system.
5946
6337
  # @return [Array<String>]
5947
6338
  #
5948
6339
  # @!attribute [rw] server_certificate
@@ -6056,9 +6447,9 @@ module Aws::DataSync
6056
6447
  # @return [String]
6057
6448
  #
6058
6449
  # @!attribute [rw] agent_arns
6059
- # Specifies the DataSync agent (or agents) which you want to connect
6060
- # to your SMB file server. You specify an agent by using its Amazon
6061
- # Resource Name (ARN).
6450
+ # Specifies the DataSync agent (or agents) that can connect to your
6451
+ # SMB file server. You specify an agent by using its Amazon Resource
6452
+ # Name (ARN).
6062
6453
  # @return [Array<String>]
6063
6454
  #
6064
6455
  # @!attribute [rw] mount_options
@@ -6220,6 +6611,18 @@ module Aws::DataSync
6220
6611
  # @!attribute [rw] cloud_watch_log_group_arn
6221
6612
  # Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
6222
6613
  # group for monitoring your task.
6614
+ #
6615
+ # For Enhanced mode tasks, you must use `/aws/datasync` as your log
6616
+ # group name. For example:
6617
+ #
6618
+ # `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`
6619
+ #
6620
+ # For more information, see [Monitoring data transfers with CloudWatch
6621
+ # Logs][1].
6622
+ #
6623
+ #
6624
+ #
6625
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html
6223
6626
  # @return [String]
6224
6627
  #
6225
6628
  # @!attribute [rw] includes