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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 97175f1b7b291bcce0c4c72fdefeae767a50a24e43ea30c6a883d7909cdb25b1
4
- data.tar.gz: 21a784d9ddb9992f93b8e3f7e37908cfb5ed4864f52208782f8937130369c06e
3
+ metadata.gz: d4d3df19224bada3e62cfd541fbca79e0ceea9a3092fcdf7c5cd62154bc5351b
4
+ data.tar.gz: 44c175fea85c78b93c93f992760c094f09b703c04912122a4440e2b69a556c10
5
5
  SHA512:
6
- metadata.gz: ef25699e29892e5fb5af2f214066d6b7aaa79395d0941e8a121db756e11258ae3116369e8104405c88173a7fc3dc0218ba0ee37895b18fc12b8a0ba17dbeea3c
7
- data.tar.gz: bb7a28c71f0ace29a56e0b7b49a15e53a3c87f14f96b55de8a0d370101239d0f99541e5e4d156ab2643271479220a966dfe28c49b3fca3f7570847a34dee8af5
6
+ metadata.gz: 48b6ba4f9d5f7a6b8fb5b4140395c1949282f7aaeb2f5169182eba438f9efaa6de9fcb840c2cc27e90f48deda90149a7c0a72e937cb8c4d3a66e3a0f9b491d8b
7
+ data.tar.gz: 285e3c24ab0d1b84b321edc4a967a5fb1dc02b3f3f2e0278be2d7469b6030476238a4d4c7ede3812868a14d4f40a90f46c46cd94e52d442cc0b621bf29aaa5ef
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.92.0 (2024-11-15)
5
+ ------------------
6
+
7
+ * Feature - Doc-only updates and enhancements related to creating DataSync tasks and describing task executions.
8
+
9
+ 1.91.0 (2024-10-30)
10
+ ------------------
11
+
12
+ * Feature - AWS DataSync now supports Enhanced mode tasks. This task mode supports transfer of virtually unlimited numbers of objects with enhanced metrics, more detailed logs, and higher performance than Basic mode. This mode currently supports transfers between Amazon S3 locations.
13
+
4
14
  1.90.0 (2024-10-18)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.90.0
1
+ 1.92.0
@@ -572,38 +572,28 @@ module Aws::DataSync
572
572
  req.send_request(options)
573
573
  end
574
574
 
575
- # Activates an DataSync agent that you've deployed in your storage
575
+ # Activates an DataSync agent that you deploy in your storage
576
576
  # environment. The activation process associates the agent with your
577
577
  # Amazon Web Services account.
578
578
  #
579
- # If you haven't deployed an agent yet, see the following topics to
580
- # learn more:
579
+ # If you haven't deployed an agent yet, see [Do I need a DataSync
580
+ # agent?][1]
581
581
  #
582
- # * [Agent requirements][1]
583
582
  #
584
- # * [Create an agent][2]
585
583
  #
586
- # <note markdown="1"> If you're transferring between Amazon Web Services storage services,
587
- # you don't need a DataSync agent.
588
- #
589
- # </note>
590
- #
591
- #
592
- #
593
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/agent-requirements.html
594
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-agent.html
584
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html
595
585
  #
596
586
  # @option params [required, String] :activation_key
597
587
  # Specifies your DataSync agent's activation key. If you don't have an
598
- # activation key, see [Activate your agent][1].
588
+ # activation key, see [Activating your agent][1].
599
589
  #
600
590
  #
601
591
  #
602
592
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html
603
593
  #
604
594
  # @option params [String] :agent_name
605
- # Specifies a name for your agent. You can see this name in the DataSync
606
- # console.
595
+ # Specifies a name for your agent. We recommend specifying a name that
596
+ # you can remember.
607
597
  #
608
598
  # @option params [Array<Types::TagListEntry>] :tags
609
599
  # Specifies labels that help you categorize, filter, and search for your
@@ -611,32 +601,24 @@ module Aws::DataSync
611
601
  # for your agent.
612
602
  #
613
603
  # @option params [String] :vpc_endpoint_id
614
- # Specifies the ID of the VPC endpoint that you want your agent to
615
- # connect to. For example, a VPC endpoint ID looks like
616
- # `vpce-01234d5aff67890e1`.
604
+ # Specifies the ID of the [VPC service endpoint][1] that you're using.
605
+ # For example, a VPC endpoint ID looks like `vpce-01234d5aff67890e1`.
617
606
  #
618
- # The VPC endpoint you use must include the DataSync service name (for
619
- # example, `com.amazonaws.us-east-2.datasync`).
607
+ # The VPC service endpoint you use must include the DataSync service
608
+ # name (for example, `com.amazonaws.us-east-2.datasync`).
620
609
  #
621
- # @option params [Array<String>] :subnet_arns
622
- # Specifies the ARN of the subnet where you want to run your DataSync
623
- # task when using a VPC endpoint. This is the subnet where DataSync
624
- # creates and manages the [network interfaces][1] for your transfer. You
625
- # can only specify one ARN.
626
610
  #
627
611
  #
612
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc
628
613
  #
629
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
614
+ # @option params [Array<String>] :subnet_arns
615
+ # Specifies the ARN of the subnet where your VPC service endpoint is
616
+ # located. You can only specify one ARN.
630
617
  #
631
618
  # @option params [Array<String>] :security_group_arns
632
619
  # Specifies the Amazon Resource Name (ARN) of the security group that
633
- # protects your task's [network interfaces][1] when [using a virtual
634
- # private cloud (VPC) endpoint][2]. You can only specify one ARN.
635
- #
636
- #
637
- #
638
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces
639
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc
620
+ # allows traffic between your agent and VPC service endpoint. You can
621
+ # only specify one ARN.
640
622
  #
641
623
  # @return [Types::CreateAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
642
624
  #
@@ -790,20 +772,26 @@ module Aws::DataSync
790
772
  # @option params [String] :subdirectory
791
773
  # Specifies a mount path for your Amazon EFS file system. This is where
792
774
  # DataSync reads or writes data (depending on if this is a source or
793
- # destination location). By default, DataSync uses the root directory,
794
- # but you can also include subdirectories.
775
+ # destination location) on your file system.
795
776
  #
796
- # <note markdown="1"> You must specify a value with forward slashes (for example,
797
- # `/path/to/folder`).
777
+ # By default, DataSync uses the root directory (or [access point][1] if
778
+ # you provide one by using `AccessPointArn`). You can also include
779
+ # subdirectories using forward slashes (for example, `/path/to/folder`).
798
780
  #
799
- # </note>
781
+ #
782
+ #
783
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html
800
784
  #
801
785
  # @option params [required, String] :efs_filesystem_arn
802
- # Specifies the ARN for the Amazon EFS file system.
786
+ # Specifies the ARN for your Amazon EFS file system.
803
787
  #
804
788
  # @option params [required, Types::Ec2Config] :ec2_config
805
- # Specifies the subnet and security groups DataSync uses to access your
806
- # Amazon EFS file system.
789
+ # Specifies the subnet and security groups DataSync uses to connect to
790
+ # one of your Amazon EFS file system's [mount targets][1].
791
+ #
792
+ #
793
+ #
794
+ # [1]: https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html
807
795
  #
808
796
  # @option params [Array<Types::TagListEntry>] :tags
809
797
  # Specifies the key-value pair that represents a tag that you want to
@@ -813,15 +801,28 @@ module Aws::DataSync
813
801
  #
814
802
  # @option params [String] :access_point_arn
815
803
  # Specifies the Amazon Resource Name (ARN) of the access point that
816
- # DataSync uses to access the Amazon EFS file system.
804
+ # DataSync uses to mount your Amazon EFS file system.
805
+ #
806
+ # For more information, see [Accessing restricted file systems][1].
807
+ #
808
+ #
809
+ #
810
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam
817
811
  #
818
812
  # @option params [String] :file_system_access_role_arn
819
- # Specifies an Identity and Access Management (IAM) role that DataSync
820
- # assumes when mounting the Amazon EFS file system.
813
+ # Specifies an Identity and Access Management (IAM) role that allows
814
+ # DataSync to access your Amazon EFS file system.
815
+ #
816
+ # For information on creating this role, see [Creating a DataSync IAM
817
+ # role for file system access][1].
818
+ #
819
+ #
820
+ #
821
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role
821
822
  #
822
823
  # @option params [String] :in_transit_encryption
823
824
  # Specifies whether you want DataSync to use Transport Layer Security
824
- # (TLS) 1.2 encryption when it copies data to or from the Amazon EFS
825
+ # (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS
825
826
  # file system.
826
827
  #
827
828
  # If you specify an access point using `AccessPointArn` or an IAM role
@@ -1132,8 +1133,13 @@ module Aws::DataSync
1132
1133
  # Server file system.
1133
1134
  #
1134
1135
  # @option params [required, Array<String>] :security_group_arns
1135
- # Specifies the ARNs of the security groups that provide access to your
1136
- # file system's preferred subnet.
1136
+ # Specifies the ARNs of the Amazon EC2 security groups that provide
1137
+ # access to your file system's preferred subnet.
1138
+ #
1139
+ # The security groups that you specify must be able to communicate with
1140
+ # your file system's security groups. For information about configuring
1141
+ # security groups for file system access, see the [ *Amazon FSx for
1142
+ # Windows File Server User Guide* ][1].
1137
1143
  #
1138
1144
  # <note markdown="1"> If you choose a security group that doesn't allow connections from
1139
1145
  # within itself, do one of the following:
@@ -1146,6 +1152,10 @@ module Aws::DataSync
1146
1152
  #
1147
1153
  # </note>
1148
1154
  #
1155
+ #
1156
+ #
1157
+ # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html
1158
+ #
1149
1159
  # @option params [Array<Types::TagListEntry>] :tags
1150
1160
  # Specifies labels that help you categorize, filter, and search for your
1151
1161
  # Amazon Web Services resources. We recommend creating at least a name
@@ -1299,8 +1309,8 @@ module Aws::DataSync
1299
1309
  # </note>
1300
1310
  #
1301
1311
  # @option params [required, Array<String>] :agent_arns
1302
- # The Amazon Resource Names (ARNs) of the agents that are used to
1303
- # connect to the HDFS cluster.
1312
+ # The Amazon Resource Names (ARNs) of the DataSync agents that can
1313
+ # connect to your HDFS cluster.
1304
1314
  #
1305
1315
  # @option params [Array<Types::TagListEntry>] :tags
1306
1316
  # The key-value pair that represents the tag that you want to add to the
@@ -1391,14 +1401,14 @@ module Aws::DataSync
1391
1401
  #
1392
1402
  # @option params [required, Types::OnPremConfig] :on_prem_config
1393
1403
  # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
1394
- # want to connect to your NFS file server.
1404
+ # can connect to your NFS file server.
1395
1405
  #
1396
1406
  # You can specify more than one agent. For more information, see [Using
1397
- # multiple agents for transfers][1].
1407
+ # multiple DataSync agents][1].
1398
1408
  #
1399
1409
  #
1400
1410
  #
1401
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
1411
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents
1402
1412
  #
1403
1413
  # @option params [Types::NfsMountOptions] :mount_options
1404
1414
  # Specifies the options that DataSync can use to mount your NFS file
@@ -1489,7 +1499,7 @@ module Aws::DataSync
1489
1499
  #
1490
1500
  # @option params [required, Array<String>] :agent_arns
1491
1501
  # Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
1492
- # can securely connect with your location.
1502
+ # can connect with your object storage system.
1493
1503
  #
1494
1504
  # @option params [Array<Types::TagListEntry>] :tags
1495
1505
  # Specifies the key-value pair that represents a tag that you want to
@@ -1745,9 +1755,9 @@ module Aws::DataSync
1745
1755
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
1746
1756
  #
1747
1757
  # @option params [required, Array<String>] :agent_arns
1748
- # Specifies the DataSync agent (or agents) which you want to connect to
1749
- # your SMB file server. You specify an agent by using its Amazon
1750
- # Resource Name (ARN).
1758
+ # Specifies the DataSync agent (or agents) that can connect to your SMB
1759
+ # file server. You specify an agent by using its Amazon Resource Name
1760
+ # (ARN).
1751
1761
  #
1752
1762
  # @option params [Types::SmbMountOptions] :mount_options
1753
1763
  # Specifies the version of the SMB protocol that DataSync uses to access
@@ -1820,6 +1830,10 @@ module Aws::DataSync
1820
1830
  # Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
1821
1831
  # group for monitoring your task.
1822
1832
  #
1833
+ # For Enhanced mode tasks, you don't need to specify anything. DataSync
1834
+ # automatically sends logs to a CloudWatch log group named
1835
+ # `/aws/datasync`.
1836
+ #
1823
1837
  # @option params [String] :name
1824
1838
  # Specifies the name of your task.
1825
1839
  #
@@ -1852,8 +1866,8 @@ module Aws::DataSync
1852
1866
  # for your DataSync resources.
1853
1867
  #
1854
1868
  # @option params [Array<Types::FilterRule>] :includes
1855
- # Specifies include filters define the files, objects, and folders in
1856
- # your source location that you want DataSync to transfer. For more
1869
+ # Specifies include filters that define the files, objects, and folders
1870
+ # in your source location that you want DataSync to transfer. For more
1857
1871
  # information and examples, see [Specifying what DataSync transfers by
1858
1872
  # using filters][1].
1859
1873
  #
@@ -1891,6 +1905,35 @@ module Aws::DataSync
1891
1905
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
1892
1906
  # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess
1893
1907
  #
1908
+ # @option params [String] :task_mode
1909
+ # Specifies one of the following task modes for your data transfer:
1910
+ #
1911
+ # * `ENHANCED` - Transfer virtually unlimited numbers of objects with
1912
+ # higher performance than Basic mode. Enhanced mode tasks optimize the
1913
+ # data transfer process by listing, preparing, transferring, and
1914
+ # verifying data in parallel. Enhanced mode is currently available for
1915
+ # transfers between Amazon S3 locations.
1916
+ #
1917
+ # <note markdown="1"> To create an Enhanced mode task, the IAM role that you use to call
1918
+ # the `CreateTask` operation must have the
1919
+ # `iam:CreateServiceLinkedRole` permission.
1920
+ #
1921
+ # </note>
1922
+ #
1923
+ # * `BASIC` (default) - Transfer files or objects between Amazon Web
1924
+ # Services storage and all other supported DataSync locations. Basic
1925
+ # mode tasks are subject to [quotas][1] on the number of files,
1926
+ # objects, and directories in a dataset. Basic mode sequentially
1927
+ # prepares, transfers, and verifies data, making it slower than
1928
+ # Enhanced mode for most workloads.
1929
+ #
1930
+ # For more information, see [Understanding task mode differences][2].
1931
+ #
1932
+ #
1933
+ #
1934
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html
1935
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
1936
+ #
1894
1937
  # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1895
1938
  #
1896
1939
  # * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1979,6 +2022,7 @@ module Aws::DataSync
1979
2022
  # },
1980
2023
  # },
1981
2024
  # },
2025
+ # task_mode: "BASIC", # accepts BASIC, ENHANCED
1982
2026
  # })
1983
2027
  #
1984
2028
  # @example Response structure
@@ -2960,6 +3004,7 @@ module Aws::DataSync
2960
3004
  # * {Types::DescribeTaskResponse#manifest_config #manifest_config} => Types::ManifestConfig
2961
3005
  # * {Types::DescribeTaskResponse#task_report_config #task_report_config} => Types::TaskReportConfig
2962
3006
  # * {Types::DescribeTaskResponse#schedule_details #schedule_details} => Types::TaskScheduleDetails
3007
+ # * {Types::DescribeTaskResponse#task_mode #task_mode} => String
2963
3008
  #
2964
3009
  # @example Request syntax with placeholder values
2965
3010
  #
@@ -3025,6 +3070,7 @@ module Aws::DataSync
3025
3070
  # resp.schedule_details.status_update_time #=> Time
3026
3071
  # resp.schedule_details.disabled_reason #=> String
3027
3072
  # resp.schedule_details.disabled_by #=> String, one of "USER", "SERVICE"
3073
+ # resp.task_mode #=> String, one of "BASIC", "ENHANCED"
3028
3074
  #
3029
3075
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
3030
3076
  #
@@ -3036,8 +3082,20 @@ module Aws::DataSync
3036
3082
  end
3037
3083
 
3038
3084
  # Provides information about an execution of your DataSync task. You can
3039
- # use this operation to help monitor the progress of an ongoing transfer
3040
- # or check the results of the transfer.
3085
+ # use this operation to help monitor the progress of an ongoing data
3086
+ # transfer or check the results of the transfer.
3087
+ #
3088
+ # <note markdown="1"> Some `DescribeTaskExecution` response elements are only relevant to a
3089
+ # specific task mode. For information, see [Understanding task mode
3090
+ # differences][1] and [Understanding data transfer performance
3091
+ # counters][2].
3092
+ #
3093
+ # </note>
3094
+ #
3095
+ #
3096
+ #
3097
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences
3098
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html
3041
3099
  #
3042
3100
  # @option params [required, String] :task_execution_arn
3043
3101
  # Specifies the Amazon Resource Name (ARN) of the task execution that
@@ -3065,6 +3123,10 @@ module Aws::DataSync
3065
3123
  # * {Types::DescribeTaskExecutionResponse#files_verified #files_verified} => Integer
3066
3124
  # * {Types::DescribeTaskExecutionResponse#report_result #report_result} => Types::ReportResult
3067
3125
  # * {Types::DescribeTaskExecutionResponse#estimated_files_to_delete #estimated_files_to_delete} => Integer
3126
+ # * {Types::DescribeTaskExecutionResponse#task_mode #task_mode} => String
3127
+ # * {Types::DescribeTaskExecutionResponse#files_prepared #files_prepared} => Integer
3128
+ # * {Types::DescribeTaskExecutionResponse#files_listed #files_listed} => Types::TaskExecutionFilesListedDetail
3129
+ # * {Types::DescribeTaskExecutionResponse#files_failed #files_failed} => Types::TaskExecutionFilesFailedDetail
3068
3130
  #
3069
3131
  # @example Request syntax with placeholder values
3070
3132
  #
@@ -3136,6 +3198,14 @@ module Aws::DataSync
3136
3198
  # resp.report_result.error_code #=> String
3137
3199
  # resp.report_result.error_detail #=> String
3138
3200
  # resp.estimated_files_to_delete #=> Integer
3201
+ # resp.task_mode #=> String, one of "BASIC", "ENHANCED"
3202
+ # resp.files_prepared #=> Integer
3203
+ # resp.files_listed.at_source #=> Integer
3204
+ # resp.files_listed.at_destination_for_delete #=> Integer
3205
+ # resp.files_failed.prepare #=> Integer
3206
+ # resp.files_failed.transfer #=> Integer
3207
+ # resp.files_failed.verify #=> Integer
3208
+ # resp.files_failed.delete #=> Integer
3139
3209
  #
3140
3210
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
3141
3211
  #
@@ -3474,6 +3544,7 @@ module Aws::DataSync
3474
3544
  # resp.task_executions #=> Array
3475
3545
  # resp.task_executions[0].task_execution_arn #=> String
3476
3546
  # resp.task_executions[0].status #=> String, one of "QUEUED", "CANCELLING", "LAUNCHING", "PREPARING", "TRANSFERRING", "VERIFYING", "SUCCESS", "ERROR"
3547
+ # resp.task_executions[0].task_mode #=> String, one of "BASIC", "ENHANCED"
3477
3548
  # resp.next_token #=> String
3478
3549
  #
3479
3550
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTaskExecutions AWS API Documentation
@@ -3527,6 +3598,7 @@ module Aws::DataSync
3527
3598
  # resp.tasks[0].task_arn #=> String
3528
3599
  # resp.tasks[0].status #=> String, one of "AVAILABLE", "CREATING", "QUEUED", "RUNNING", "UNAVAILABLE"
3529
3600
  # resp.tasks[0].name #=> String
3601
+ # resp.tasks[0].task_mode #=> String, one of "BASIC", "ENHANCED"
3530
3602
  # resp.next_token #=> String
3531
3603
  #
3532
3604
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasks AWS API Documentation
@@ -3631,8 +3703,8 @@ module Aws::DataSync
3631
3703
  # Starts an DataSync transfer task. For each task, you can only run one
3632
3704
  # task execution at a time.
3633
3705
  #
3634
- # There are several phases to a task execution. For more information,
3635
- # see [Task execution statuses][1].
3706
+ # There are several steps to a task execution. For more information, see
3707
+ # [Task execution statuses][1].
3636
3708
  #
3637
3709
  # If you're planning to transfer data to or from an Amazon S3 location,
3638
3710
  # review [how DataSync can affect your S3 request charges][2] and the
@@ -4100,7 +4172,8 @@ module Aws::DataSync
4100
4172
  # encoding for you. Otherwise, provide the base64-encoded text.
4101
4173
  #
4102
4174
  # @option params [Array<String>] :agent_arns
4103
- # The ARNs of the agents that are used to connect to the HDFS cluster.
4175
+ # The Amazon Resource Names (ARNs) of the DataSync agents that can
4176
+ # connect to your HDFS cluster.
4104
4177
  #
4105
4178
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4106
4179
  #
@@ -4166,8 +4239,8 @@ module Aws::DataSync
4166
4239
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs
4167
4240
  #
4168
4241
  # @option params [Types::OnPremConfig] :on_prem_config
4169
- # The DataSync agents that are connecting to a Network File System (NFS)
4170
- # location.
4242
+ # The DataSync agents that can connect to your Network File System (NFS)
4243
+ # file server.
4171
4244
  #
4172
4245
  # @option params [Types::NfsMountOptions] :mount_options
4173
4246
  # Specifies how DataSync can access a location using the NFS protocol.
@@ -4227,7 +4300,7 @@ module Aws::DataSync
4227
4300
  #
4228
4301
  # @option params [Array<String>] :agent_arns
4229
4302
  # Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
4230
- # can securely connect with your location.
4303
+ # can connect with your object storage system.
4231
4304
  #
4232
4305
  # @option params [String, StringIO, File] :server_certificate
4233
4306
  # Specifies a certificate chain for DataSync to authenticate with your
@@ -4337,9 +4410,9 @@ module Aws::DataSync
4337
4410
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
4338
4411
  #
4339
4412
  # @option params [Array<String>] :agent_arns
4340
- # Specifies the DataSync agent (or agents) which you want to connect to
4341
- # your SMB file server. You specify an agent by using its Amazon
4342
- # Resource Name (ARN).
4413
+ # Specifies the DataSync agent (or agents) that can connect to your SMB
4414
+ # file server. You specify an agent by using its Amazon Resource Name
4415
+ # (ARN).
4343
4416
  #
4344
4417
  # @option params [Types::SmbMountOptions] :mount_options
4345
4418
  # Specifies the version of the Server Message Block (SMB) protocol that
@@ -4473,6 +4546,18 @@ module Aws::DataSync
4473
4546
  # Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log
4474
4547
  # group for monitoring your task.
4475
4548
  #
4549
+ # For Enhanced mode tasks, you must use `/aws/datasync` as your log
4550
+ # group name. For example:
4551
+ #
4552
+ # `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`
4553
+ #
4554
+ # For more information, see [Monitoring data transfers with CloudWatch
4555
+ # Logs][1].
4556
+ #
4557
+ #
4558
+ #
4559
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html
4560
+ #
4476
4561
  # @option params [Array<Types::FilterRule>] :includes
4477
4562
  # Specifies include filters define the files, objects, and folders in
4478
4563
  # your source location that you want DataSync to transfer. For more
@@ -4689,7 +4774,7 @@ module Aws::DataSync
4689
4774
  tracer: tracer
4690
4775
  )
4691
4776
  context[:gem_name] = 'aws-sdk-datasync'
4692
- context[:gem_version] = '1.90.0'
4777
+ context[:gem_version] = '1.92.0'
4693
4778
  Seahorse::Client::Request.new(handlers, context)
4694
4779
  end
4695
4780
 
@@ -303,6 +303,8 @@ module Aws::DataSync
303
303
  TaggableResourceArn = Shapes::StringShape.new(name: 'TaggableResourceArn')
304
304
  TaskArn = Shapes::StringShape.new(name: 'TaskArn')
305
305
  TaskExecutionArn = Shapes::StringShape.new(name: 'TaskExecutionArn')
306
+ TaskExecutionFilesFailedDetail = Shapes::StructureShape.new(name: 'TaskExecutionFilesFailedDetail')
307
+ TaskExecutionFilesListedDetail = Shapes::StructureShape.new(name: 'TaskExecutionFilesListedDetail')
306
308
  TaskExecutionList = Shapes::ListShape.new(name: 'TaskExecutionList')
307
309
  TaskExecutionListEntry = Shapes::StructureShape.new(name: 'TaskExecutionListEntry')
308
310
  TaskExecutionResultDetail = Shapes::StructureShape.new(name: 'TaskExecutionResultDetail')
@@ -312,6 +314,7 @@ module Aws::DataSync
312
314
  TaskFilters = Shapes::ListShape.new(name: 'TaskFilters')
313
315
  TaskList = Shapes::ListShape.new(name: 'TaskList')
314
316
  TaskListEntry = Shapes::StructureShape.new(name: 'TaskListEntry')
317
+ TaskMode = Shapes::StringShape.new(name: 'TaskMode')
315
318
  TaskQueueing = Shapes::StringShape.new(name: 'TaskQueueing')
316
319
  TaskReportConfig = Shapes::StructureShape.new(name: 'TaskReportConfig')
317
320
  TaskSchedule = Shapes::StructureShape.new(name: 'TaskSchedule')
@@ -541,6 +544,7 @@ module Aws::DataSync
541
544
  CreateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
542
545
  CreateTaskRequest.add_member(:manifest_config, Shapes::ShapeRef.new(shape: ManifestConfig, location_name: "ManifestConfig"))
543
546
  CreateTaskRequest.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
547
+ CreateTaskRequest.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
544
548
  CreateTaskRequest.struct_class = Types::CreateTaskRequest
545
549
 
546
550
  CreateTaskResponse.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
@@ -781,6 +785,10 @@ module Aws::DataSync
781
785
  DescribeTaskExecutionResponse.add_member(:files_verified, Shapes::ShapeRef.new(shape: long, location_name: "FilesVerified"))
782
786
  DescribeTaskExecutionResponse.add_member(:report_result, Shapes::ShapeRef.new(shape: ReportResult, location_name: "ReportResult"))
783
787
  DescribeTaskExecutionResponse.add_member(:estimated_files_to_delete, Shapes::ShapeRef.new(shape: long, location_name: "EstimatedFilesToDelete"))
788
+ DescribeTaskExecutionResponse.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
789
+ DescribeTaskExecutionResponse.add_member(:files_prepared, Shapes::ShapeRef.new(shape: long, location_name: "FilesPrepared"))
790
+ DescribeTaskExecutionResponse.add_member(:files_listed, Shapes::ShapeRef.new(shape: TaskExecutionFilesListedDetail, location_name: "FilesListed"))
791
+ DescribeTaskExecutionResponse.add_member(:files_failed, Shapes::ShapeRef.new(shape: TaskExecutionFilesFailedDetail, location_name: "FilesFailed"))
784
792
  DescribeTaskExecutionResponse.struct_class = Types::DescribeTaskExecutionResponse
785
793
 
786
794
  DescribeTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
@@ -805,6 +813,7 @@ module Aws::DataSync
805
813
  DescribeTaskResponse.add_member(:manifest_config, Shapes::ShapeRef.new(shape: ManifestConfig, location_name: "ManifestConfig"))
806
814
  DescribeTaskResponse.add_member(:task_report_config, Shapes::ShapeRef.new(shape: TaskReportConfig, location_name: "TaskReportConfig"))
807
815
  DescribeTaskResponse.add_member(:schedule_details, Shapes::ShapeRef.new(shape: TaskScheduleDetails, location_name: "ScheduleDetails"))
816
+ DescribeTaskResponse.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
808
817
  DescribeTaskResponse.struct_class = Types::DescribeTaskResponse
809
818
 
810
819
  DestinationNetworkInterfaceArns.member = Shapes::ShapeRef.new(shape: NetworkInterfaceArn)
@@ -1196,10 +1205,21 @@ module Aws::DataSync
1196
1205
 
1197
1206
  TagResourceResponse.struct_class = Types::TagResourceResponse
1198
1207
 
1208
+ TaskExecutionFilesFailedDetail.add_member(:prepare, Shapes::ShapeRef.new(shape: long, location_name: "Prepare"))
1209
+ TaskExecutionFilesFailedDetail.add_member(:transfer, Shapes::ShapeRef.new(shape: long, location_name: "Transfer"))
1210
+ TaskExecutionFilesFailedDetail.add_member(:verify, Shapes::ShapeRef.new(shape: long, location_name: "Verify"))
1211
+ TaskExecutionFilesFailedDetail.add_member(:delete, Shapes::ShapeRef.new(shape: long, location_name: "Delete"))
1212
+ TaskExecutionFilesFailedDetail.struct_class = Types::TaskExecutionFilesFailedDetail
1213
+
1214
+ TaskExecutionFilesListedDetail.add_member(:at_source, Shapes::ShapeRef.new(shape: long, location_name: "AtSource"))
1215
+ TaskExecutionFilesListedDetail.add_member(:at_destination_for_delete, Shapes::ShapeRef.new(shape: long, location_name: "AtDestinationForDelete"))
1216
+ TaskExecutionFilesListedDetail.struct_class = Types::TaskExecutionFilesListedDetail
1217
+
1199
1218
  TaskExecutionList.member = Shapes::ShapeRef.new(shape: TaskExecutionListEntry)
1200
1219
 
1201
1220
  TaskExecutionListEntry.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, location_name: "TaskExecutionArn"))
1202
1221
  TaskExecutionListEntry.add_member(:status, Shapes::ShapeRef.new(shape: TaskExecutionStatus, location_name: "Status"))
1222
+ TaskExecutionListEntry.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
1203
1223
  TaskExecutionListEntry.struct_class = Types::TaskExecutionListEntry
1204
1224
 
1205
1225
  TaskExecutionResultDetail.add_member(:prepare_duration, Shapes::ShapeRef.new(shape: Duration, location_name: "PrepareDuration"))
@@ -1225,6 +1245,7 @@ module Aws::DataSync
1225
1245
  TaskListEntry.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
1226
1246
  TaskListEntry.add_member(:status, Shapes::ShapeRef.new(shape: TaskStatus, location_name: "Status"))
1227
1247
  TaskListEntry.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
1248
+ TaskListEntry.add_member(:task_mode, Shapes::ShapeRef.new(shape: TaskMode, location_name: "TaskMode"))
1228
1249
  TaskListEntry.struct_class = Types::TaskListEntry
1229
1250
 
1230
1251
  TaskReportConfig.add_member(:destination, Shapes::ShapeRef.new(shape: ReportDestination, location_name: "Destination"))