aws-sdk-datasync 1.27.0 → 1.32.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: d83ad5e535baadd8965d0eaf704dde8dbf8d490a3975931d88511e911c54607d
4
- data.tar.gz: cfb2aade0386045aa2853da19936b0cb2ea1fcff3266f28606c2012231ac685c
3
+ metadata.gz: a876e971bbff3e239ce2522e6ea0449608e99128338aa37858ab727ae1f318d3
4
+ data.tar.gz: 8cb71d699fed74462cf4d1a090f14ac6d6645d708cb59b7c5c41479e9832f8a6
5
5
  SHA512:
6
- metadata.gz: 909505ea91fa56eadc9be3ff804b0594885bc6977947390db5f914715f86763d6d4e7fdb9d7fa8fc555ad9f0dd7fdc87a2bc8c78f17e3eff9846f8abf382b0b9
7
- data.tar.gz: 1d925b2989e6cd09833adf79d4cc2d39ef725e93ae563c2d482fe9d57cbd313ba6959e0adbe92d0ec2ecf43173a6048ad6aefe550a7d6a9c1db39fa507d7ec1b
6
+ metadata.gz: 6629b874ca844f8dd501c7b8c92aa94074a0d68c01ed699e9fbda58137930ac237e38ec1828625788ce9a828ae682a62a76d80af3a4b96e06324848805fbe678
7
+ data.tar.gz: 2c24817d16af88dc63fd7c4e326b44176106beffdf56f0af3bb93abc5a8ebc18d0872faf15ccc931f58de19e1707d1ec66067347ecc49c37dcae0fd30dea2722
data/CHANGELOG.md ADDED
@@ -0,0 +1,173 @@
1
+ Unreleased Changes
2
+ ------------------
3
+
4
+ 1.32.0 (2021-05-28)
5
+ ------------------
6
+
7
+ * Feature - Added SecurityDescriptorCopyFlags option that allows for control of which components of SMB security descriptors are copied from source to destination objects.
8
+
9
+ 1.31.0 (2021-03-10)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.30.0 (2021-03-02)
15
+ ------------------
16
+
17
+ * Feature - Additional API Support to update NFS/SMB/ObjectStorage locations
18
+
19
+ 1.29.0 (2021-02-02)
20
+ ------------------
21
+
22
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
23
+
24
+ 1.28.0 (2020-11-09)
25
+ ------------------
26
+
27
+ * Feature - DataSync now enables customers to adjust the network bandwidth used by a running AWS DataSync task.
28
+
29
+ 1.27.0 (2020-09-30)
30
+ ------------------
31
+
32
+ * Feature - This release enables customers to create s3 location for S3 bucket's located on an AWS Outpost.
33
+
34
+ 1.26.0 (2020-09-15)
35
+ ------------------
36
+
37
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
38
+
39
+ 1.25.0 (2020-08-25)
40
+ ------------------
41
+
42
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
43
+
44
+ 1.24.0 (2020-08-18)
45
+ ------------------
46
+
47
+ * Feature - DataSync support for filters as input arguments to the ListTasks and ListLocations API calls.
48
+
49
+ 1.23.0 (2020-07-27)
50
+ ------------------
51
+
52
+ * Feature - Today AWS DataSync releases support for self-managed object storage Locations and the new TransferMode Option.
53
+
54
+ 1.22.0 (2020-06-23)
55
+ ------------------
56
+
57
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
58
+
59
+ 1.21.1 (2020-06-11)
60
+ ------------------
61
+
62
+ * Issue - Republish previous version with correct dependency on `aws-sdk-core`.
63
+
64
+ 1.21.0 (2020-06-10)
65
+ ------------------
66
+
67
+ * Issue - This version has been yanked. (#2327).
68
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
69
+
70
+ 1.20.0 (2020-05-28)
71
+ ------------------
72
+
73
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
74
+
75
+ 1.19.0 (2020-05-07)
76
+ ------------------
77
+
78
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
79
+
80
+ 1.18.0 (2020-03-09)
81
+ ------------------
82
+
83
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
84
+
85
+ 1.17.0 (2020-01-24)
86
+ ------------------
87
+
88
+ * Feature - AWS DataSync now supports FSx for Windows File Server Locations
89
+
90
+ 1.16.0 (2019-11-20)
91
+ ------------------
92
+
93
+ * Feature - Update to configure task to run periodically on a schedule
94
+
95
+ 1.15.0 (2019-10-23)
96
+ ------------------
97
+
98
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
99
+
100
+ 1.14.0 (2019-10-08)
101
+ ------------------
102
+
103
+ * Feature - Add Sync options to enable/disable TaskQueueing
104
+
105
+ 1.13.0 (2019-09-24)
106
+ ------------------
107
+
108
+ * Feature - Added S3StorageClass, OverwriteMode sync option, and ONLY_FILES_TRANSFERRED setting for the VerifyMode sync option.
109
+
110
+ 1.12.0 (2019-08-22)
111
+ ------------------
112
+
113
+ * Feature - This release adds support for SMB location type.
114
+
115
+ 1.11.0 (2019-08-05)
116
+ ------------------
117
+
118
+ * Feature - Support VPC endpoints.
119
+
120
+ 1.10.0 (2019-07-25)
121
+ ------------------
122
+
123
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
124
+
125
+ 1.9.0 (2019-07-01)
126
+ ------------------
127
+
128
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
129
+
130
+ 1.8.0 (2019-06-17)
131
+ ------------------
132
+
133
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
134
+
135
+ 1.7.0 (2019-05-21)
136
+ ------------------
137
+
138
+ * Feature - API update.
139
+
140
+ 1.6.0 (2019-05-15)
141
+ ------------------
142
+
143
+ * Feature - API update.
144
+
145
+ 1.5.0 (2019-05-14)
146
+ ------------------
147
+
148
+ * Feature - API update.
149
+
150
+ 1.4.0 (2019-05-13)
151
+ ------------------
152
+
153
+ * Feature - API update.
154
+
155
+ 1.3.0 (2019-03-21)
156
+ ------------------
157
+
158
+ * Feature - API update.
159
+
160
+ 1.2.0 (2019-03-18)
161
+ ------------------
162
+
163
+ * Feature - API update.
164
+
165
+ 1.1.0 (2019-03-14)
166
+ ------------------
167
+
168
+ * Feature - API update.
169
+
170
+ 1.0.0 (2018-11-26)
171
+ ------------------
172
+
173
+ * Feature - Initial release of `aws-sdk-datasync`.
data/LICENSE.txt ADDED
@@ -0,0 +1,202 @@
1
+
2
+ Apache License
3
+ Version 2.0, January 2004
4
+ http://www.apache.org/licenses/
5
+
6
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7
+
8
+ 1. Definitions.
9
+
10
+ "License" shall mean the terms and conditions for use, reproduction,
11
+ and distribution as defined by Sections 1 through 9 of this document.
12
+
13
+ "Licensor" shall mean the copyright owner or entity authorized by
14
+ the copyright owner that is granting the License.
15
+
16
+ "Legal Entity" shall mean the union of the acting entity and all
17
+ other entities that control, are controlled by, or are under common
18
+ control with that entity. For the purposes of this definition,
19
+ "control" means (i) the power, direct or indirect, to cause the
20
+ direction or management of such entity, whether by contract or
21
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
22
+ outstanding shares, or (iii) beneficial ownership of such entity.
23
+
24
+ "You" (or "Your") shall mean an individual or Legal Entity
25
+ exercising permissions granted by this License.
26
+
27
+ "Source" form shall mean the preferred form for making modifications,
28
+ including but not limited to software source code, documentation
29
+ source, and configuration files.
30
+
31
+ "Object" form shall mean any form resulting from mechanical
32
+ transformation or translation of a Source form, including but
33
+ not limited to compiled object code, generated documentation,
34
+ and conversions to other media types.
35
+
36
+ "Work" shall mean the work of authorship, whether in Source or
37
+ Object form, made available under the License, as indicated by a
38
+ copyright notice that is included in or attached to the work
39
+ (an example is provided in the Appendix below).
40
+
41
+ "Derivative Works" shall mean any work, whether in Source or Object
42
+ form, that is based on (or derived from) the Work and for which the
43
+ editorial revisions, annotations, elaborations, or other modifications
44
+ represent, as a whole, an original work of authorship. For the purposes
45
+ of this License, Derivative Works shall not include works that remain
46
+ separable from, or merely link (or bind by name) to the interfaces of,
47
+ the Work and Derivative Works thereof.
48
+
49
+ "Contribution" shall mean any work of authorship, including
50
+ the original version of the Work and any modifications or additions
51
+ to that Work or Derivative Works thereof, that is intentionally
52
+ submitted to Licensor for inclusion in the Work by the copyright owner
53
+ or by an individual or Legal Entity authorized to submit on behalf of
54
+ the copyright owner. For the purposes of this definition, "submitted"
55
+ means any form of electronic, verbal, or written communication sent
56
+ to the Licensor or its representatives, including but not limited to
57
+ communication on electronic mailing lists, source code control systems,
58
+ and issue tracking systems that are managed by, or on behalf of, the
59
+ Licensor for the purpose of discussing and improving the Work, but
60
+ excluding communication that is conspicuously marked or otherwise
61
+ designated in writing by the copyright owner as "Not a Contribution."
62
+
63
+ "Contributor" shall mean Licensor and any individual or Legal Entity
64
+ on behalf of whom a Contribution has been received by Licensor and
65
+ subsequently incorporated within the Work.
66
+
67
+ 2. Grant of Copyright License. Subject to the terms and conditions of
68
+ this License, each Contributor hereby grants to You a perpetual,
69
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70
+ copyright license to reproduce, prepare Derivative Works of,
71
+ publicly display, publicly perform, sublicense, and distribute the
72
+ Work and such Derivative Works in Source or Object form.
73
+
74
+ 3. Grant of Patent License. Subject to the terms and conditions of
75
+ this License, each Contributor hereby grants to You a perpetual,
76
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77
+ (except as stated in this section) patent license to make, have made,
78
+ use, offer to sell, sell, import, and otherwise transfer the Work,
79
+ where such license applies only to those patent claims licensable
80
+ by such Contributor that are necessarily infringed by their
81
+ Contribution(s) alone or by combination of their Contribution(s)
82
+ with the Work to which such Contribution(s) was submitted. If You
83
+ institute patent litigation against any entity (including a
84
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
85
+ or a Contribution incorporated within the Work constitutes direct
86
+ or contributory patent infringement, then any patent licenses
87
+ granted to You under this License for that Work shall terminate
88
+ as of the date such litigation is filed.
89
+
90
+ 4. Redistribution. You may reproduce and distribute copies of the
91
+ Work or Derivative Works thereof in any medium, with or without
92
+ modifications, and in Source or Object form, provided that You
93
+ meet the following conditions:
94
+
95
+ (a) You must give any other recipients of the Work or
96
+ Derivative Works a copy of this License; and
97
+
98
+ (b) You must cause any modified files to carry prominent notices
99
+ stating that You changed the files; and
100
+
101
+ (c) You must retain, in the Source form of any Derivative Works
102
+ that You distribute, all copyright, patent, trademark, and
103
+ attribution notices from the Source form of the Work,
104
+ excluding those notices that do not pertain to any part of
105
+ the Derivative Works; and
106
+
107
+ (d) If the Work includes a "NOTICE" text file as part of its
108
+ distribution, then any Derivative Works that You distribute must
109
+ include a readable copy of the attribution notices contained
110
+ within such NOTICE file, excluding those notices that do not
111
+ pertain to any part of the Derivative Works, in at least one
112
+ of the following places: within a NOTICE text file distributed
113
+ as part of the Derivative Works; within the Source form or
114
+ documentation, if provided along with the Derivative Works; or,
115
+ within a display generated by the Derivative Works, if and
116
+ wherever such third-party notices normally appear. The contents
117
+ of the NOTICE file are for informational purposes only and
118
+ do not modify the License. You may add Your own attribution
119
+ notices within Derivative Works that You distribute, alongside
120
+ or as an addendum to the NOTICE text from the Work, provided
121
+ that such additional attribution notices cannot be construed
122
+ as modifying the License.
123
+
124
+ You may add Your own copyright statement to Your modifications and
125
+ may provide additional or different license terms and conditions
126
+ for use, reproduction, or distribution of Your modifications, or
127
+ for any such Derivative Works as a whole, provided Your use,
128
+ reproduction, and distribution of the Work otherwise complies with
129
+ the conditions stated in this License.
130
+
131
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
132
+ any Contribution intentionally submitted for inclusion in the Work
133
+ by You to the Licensor shall be under the terms and conditions of
134
+ this License, without any additional terms or conditions.
135
+ Notwithstanding the above, nothing herein shall supersede or modify
136
+ the terms of any separate license agreement you may have executed
137
+ with Licensor regarding such Contributions.
138
+
139
+ 6. Trademarks. This License does not grant permission to use the trade
140
+ names, trademarks, service marks, or product names of the Licensor,
141
+ except as required for reasonable and customary use in describing the
142
+ origin of the Work and reproducing the content of the NOTICE file.
143
+
144
+ 7. Disclaimer of Warranty. Unless required by applicable law or
145
+ agreed to in writing, Licensor provides the Work (and each
146
+ Contributor provides its Contributions) on an "AS IS" BASIS,
147
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148
+ implied, including, without limitation, any warranties or conditions
149
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150
+ PARTICULAR PURPOSE. You are solely responsible for determining the
151
+ appropriateness of using or redistributing the Work and assume any
152
+ risks associated with Your exercise of permissions under this License.
153
+
154
+ 8. Limitation of Liability. In no event and under no legal theory,
155
+ whether in tort (including negligence), contract, or otherwise,
156
+ unless required by applicable law (such as deliberate and grossly
157
+ negligent acts) or agreed to in writing, shall any Contributor be
158
+ liable to You for damages, including any direct, indirect, special,
159
+ incidental, or consequential damages of any character arising as a
160
+ result of this License or out of the use or inability to use the
161
+ Work (including but not limited to damages for loss of goodwill,
162
+ work stoppage, computer failure or malfunction, or any and all
163
+ other commercial damages or losses), even if such Contributor
164
+ has been advised of the possibility of such damages.
165
+
166
+ 9. Accepting Warranty or Additional Liability. While redistributing
167
+ the Work or Derivative Works thereof, You may choose to offer,
168
+ and charge a fee for, acceptance of support, warranty, indemnity,
169
+ or other liability obligations and/or rights consistent with this
170
+ License. However, in accepting such obligations, You may act only
171
+ on Your own behalf and on Your sole responsibility, not on behalf
172
+ of any other Contributor, and only if You agree to indemnify,
173
+ defend, and hold each Contributor harmless for any liability
174
+ incurred by, or claims asserted against, such Contributor by reason
175
+ of your accepting any such warranty or additional liability.
176
+
177
+ END OF TERMS AND CONDITIONS
178
+
179
+ APPENDIX: How to apply the Apache License to your work.
180
+
181
+ To apply the Apache License to your work, attach the following
182
+ boilerplate notice, with the fields enclosed by brackets "[]"
183
+ replaced with your own identifying information. (Don't include
184
+ the brackets!) The text should be enclosed in the appropriate
185
+ comment syntax for the file format. We also recommend that a
186
+ file or class name and description of purpose be included on the
187
+ same "printed page" as the copyright notice for easier
188
+ identification within third-party archives.
189
+
190
+ Copyright [yyyy] [name of copyright owner]
191
+
192
+ Licensed under the Apache License, Version 2.0 (the "License");
193
+ you may not use this file except in compliance with the License.
194
+ You may obtain a copy of the License at
195
+
196
+ http://www.apache.org/licenses/LICENSE-2.0
197
+
198
+ Unless required by applicable law or agreed to in writing, software
199
+ distributed under the License is distributed on an "AS IS" BASIS,
200
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201
+ See the License for the specific language governing permissions and
202
+ limitations under the License.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.32.0
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-datasync/customizations'
48
48
  # @!group service
49
49
  module Aws::DataSync
50
50
 
51
- GEM_VERSION = '1.27.0'
51
+ GEM_VERSION = '1.32.0'
52
52
 
53
53
  end
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -443,7 +443,11 @@ module Aws::DataSync
443
443
  #
444
444
  # @option params [Array<String>] :security_group_arns
445
445
  # The ARNs of the security groups used to protect your data transfer
446
- # task subnets. See CreateAgentRequest$SubnetArns.
446
+ # task subnets. See [SecurityGroupArns][1].
447
+ #
448
+ #
449
+ #
450
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_Ec2Config.html#DataSync-Type-Ec2Config-SecurityGroupArns
447
451
  #
448
452
  # @return [Types::CreateAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
449
453
  #
@@ -557,20 +561,22 @@ module Aws::DataSync
557
561
  req.send_request(options)
558
562
  end
559
563
 
560
- # Creates an endpoint for an Amazon FSx for Windows file system.
564
+ # Creates an endpoint for an Amazon FSx for Windows File Server file
565
+ # system.
561
566
  #
562
567
  # @option params [String] :subdirectory
563
568
  # A subdirectory in the location’s path. This subdirectory in the Amazon
564
- # FSx for Windows file system is used to read data from the Amazon FSx
565
- # for Windows source location or write data to the FSx for Windows
566
- # destination.
569
+ # FSx for Windows File Server file system is used to read data from the
570
+ # Amazon FSx for Windows File Server source location or write data to
571
+ # the FSx for Windows File Server destination.
567
572
  #
568
573
  # @option params [required, String] :fsx_filesystem_arn
569
- # The Amazon Resource Name (ARN) for the FSx for Windows file system.
574
+ # The Amazon Resource Name (ARN) for the FSx for Windows File Server
575
+ # file system.
570
576
  #
571
577
  # @option params [required, Array<String>] :security_group_arns
572
578
  # The Amazon Resource Names (ARNs) of the security groups that are to
573
- # use to configure the FSx for Windows file system.
579
+ # use to configure the FSx for Windows File Server file system.
574
580
  #
575
581
  # @option params [Array<Types::TagListEntry>] :tags
576
582
  # The key-value pair that represents a tag that you want to add to the
@@ -580,15 +586,19 @@ module Aws::DataSync
580
586
  #
581
587
  # @option params [required, String] :user
582
588
  # The user who has the permissions to access files and folders in the
583
- # FSx for Windows file system.
589
+ # FSx for Windows File Server file system.
590
+ #
591
+ # For information about choosing a user name that ensures sufficient
592
+ # permissions to files, folders, and metadata, see
593
+ # [user](create-fsx-location.html#FSxWuser).
584
594
  #
585
595
  # @option params [String] :domain
586
- # The name of the Windows domain that the FSx for Windows server belongs
587
- # to.
596
+ # The name of the Windows domain that the FSx for Windows File Server
597
+ # belongs to.
588
598
  #
589
599
  # @option params [required, String] :password
590
600
  # The password of the user who has the permissions to access files and
591
- # folders in the FSx for Windows file system.
601
+ # folders in the FSx for Windows File Server file system.
592
602
  #
593
603
  # @return [Types::CreateLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
594
604
  #
@@ -634,7 +644,7 @@ module Aws::DataSync
634
644
  # subdirectory of that path. The path should be such that it can be
635
645
  # mounted by other NFS clients in your network.
636
646
  #
637
- # To see all the paths exported by your NFS server. run "`showmount -e
647
+ # To see all the paths exported by your NFS server, run "`showmount -e
638
648
  # nfs-server-name`" from an NFS client that has access to your server.
639
649
  # You can specify any directory that appears in the results, and any
640
650
  # subdirectory of that directory. Ensure that the NFS export is
@@ -732,8 +742,12 @@ module Aws::DataSync
732
742
  end
733
743
 
734
744
  # Creates an endpoint for a self-managed object storage bucket. For more
735
- # information about self-managed object storage locations, see
736
- # create-object-location.
745
+ # information about self-managed object storage locations, see [Creating
746
+ # a location for object storage][1].
747
+ #
748
+ #
749
+ #
750
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
737
751
  #
738
752
  # @option params [required, String] :server_hostname
739
753
  # The name of the self-managed object storage server. This value is the
@@ -828,8 +842,8 @@ module Aws::DataSync
828
842
  # S3 destination.
829
843
  #
830
844
  # @option params [required, String] :s3_bucket_arn
831
- # The Amazon Resource Name (ARN) of the Amazon S3 bucket. If the bucket
832
- # is on an AWS Outpost, this must be an access point ARN.
845
+ # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
846
+ # this must be an access point ARN.
833
847
  #
834
848
  # @option params [String] :s3_storage_class
835
849
  # The Amazon S3 storage class that you want to store your files in when
@@ -838,13 +852,14 @@ module Aws::DataSync
838
852
  # Outposts, the storage class defaults to AWS S3 Outposts.
839
853
  #
840
854
  # For more information about S3 storage classes, see [Amazon S3 Storage
841
- # Classes][1] in the *Amazon Simple Storage Service Developer Guide*.
842
- # Some storage classes have behaviors that can affect your S3 storage
843
- # cost. For detailed information, see using-storage-classes.
855
+ # Classes][1]. Some storage classes have behaviors that can affect your
856
+ # S3 storage cost. For detailed information, see [Considerations when
857
+ # working with S3 storage classes in DataSync][2].
844
858
  #
845
859
  #
846
860
  #
847
- # [1]: https://aws.amazon.com/s3/storage-classes/
861
+ # [1]: http://aws.amazon.com/s3/storage-classes/
862
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
848
863
  #
849
864
  # @option params [required, Types::S3Config] :s3_config
850
865
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
@@ -855,9 +870,13 @@ module Aws::DataSync
855
870
  #
856
871
  # @option params [Array<String>] :agent_arns
857
872
  # If you are using DataSync on an AWS Outpost, specify the Amazon
858
- # Resource Names (ARNs) of the DataSync agents deployed on your AWS
859
- # Outpost. For more information about launching a DataSync agent on an
860
- # Amazon Outpost, see outposts-agent.
873
+ # Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
874
+ # For more information about launching a DataSync agent on an AWS
875
+ # Outpost, see [Deploy your DataSync agent on AWS Outposts][1].
876
+ #
877
+ #
878
+ #
879
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent
861
880
  #
862
881
  # @option params [Array<Types::TagListEntry>] :tags
863
882
  # The key-value pair that represents the tag that you want to add to the
@@ -938,6 +957,10 @@ module Aws::DataSync
938
957
  # The user who can mount the share, has the permissions to access files
939
958
  # and folders in the SMB share.
940
959
  #
960
+ # For information about choosing a user name that ensures sufficient
961
+ # permissions to files, folders, and metadata, see
962
+ # [user](create-smb-location.html#SMBuser).
963
+ #
941
964
  # @option params [String] :domain
942
965
  # The name of the Windows domain that the SMB server belongs to.
943
966
  #
@@ -994,24 +1017,30 @@ module Aws::DataSync
994
1017
  req.send_request(options)
995
1018
  end
996
1019
 
997
- # Creates a task. A task is a set of two locations (source and
998
- # destination) and a set of Options that you use to control the behavior
999
- # of a task. If you don't specify Options when you create a task, AWS
1000
- # DataSync populates them with service defaults.
1001
- #
1002
- # When you create a task, it first enters the CREATING state. During
1003
- # CREATING AWS DataSync attempts to mount the on-premises Network File
1004
- # System (NFS) location. The task transitions to the AVAILABLE state
1005
- # without waiting for the AWS location to become mounted. If required,
1006
- # AWS DataSync mounts the AWS location before each task execution.
1007
- #
1008
- # If an agent that is associated with a source (NFS) location goes
1009
- # offline, the task transitions to the UNAVAILABLE status. If the status
1010
- # of the task remains in the CREATING status for more than a few
1011
- # minutes, it means that your agent might be having trouble mounting the
1012
- # source NFS file system. Check the task's ErrorCode and ErrorDetail.
1013
- # Mount issues are often caused by either a misconfigured firewall or a
1014
- # mistyped NFS server hostname.
1020
+ # Creates a task.
1021
+ #
1022
+ # A task includes a source location and a destination location, and a
1023
+ # configuration that specifies how data is transferred. A task always
1024
+ # transfers data from the source location to the destination location.
1025
+ # The configuration specifies options such as task scheduling, bandwidth
1026
+ # limits, etc. A task is the complete definition of a data transfer.
1027
+ #
1028
+ # When you create a task that transfers data between AWS services in
1029
+ # different AWS Regions, one of the two locations that you specify must
1030
+ # reside in the Region where DataSync is being used. The other location
1031
+ # must be specified in a different Region.
1032
+ #
1033
+ # You can transfer data between commercial AWS Regions except for China,
1034
+ # or between AWS GovCloud (US-East and US-West) Regions.
1035
+ #
1036
+ # When you use DataSync to copy files or objects between AWS Regions,
1037
+ # you pay for data transfer between Regions. This is billed as data
1038
+ # transfer OUT from your source Region to your destination Region. For
1039
+ # more information, see [Data Transfer pricing][1].
1040
+ #
1041
+ #
1042
+ #
1043
+ # [1]: http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer
1015
1044
  #
1016
1045
  # @option params [required, String] :source_location_arn
1017
1046
  # The Amazon Resource Name (ARN) of the source location for the task.
@@ -1036,18 +1065,26 @@ module Aws::DataSync
1036
1065
  #
1037
1066
  # For each individual task execution, you can override these options by
1038
1067
  # specifying the `OverrideOptions` before starting the task execution.
1039
- # For more information, see the operation.
1068
+ # For more information, see the [StartTaskExecution][1] operation.
1069
+ #
1070
+ #
1071
+ #
1072
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
1040
1073
  #
1041
1074
  # @option params [Array<Types::FilterRule>] :excludes
1042
1075
  # A list of filter rules that determines which files to exclude from a
1043
1076
  # task. The list should contain a single filter string that consists of
1044
1077
  # the patterns to exclude. The patterns are delimited by "\|" (that
1045
- # is, a pipe), for example, `"/folder1|/folder2"`
1078
+ # is, a pipe), for example, `"/folder1|/folder2"`.
1046
1079
  #
1047
1080
  # @option params [Types::TaskSchedule] :schedule
1048
1081
  # Specifies a schedule used to periodically transfer files from a source
1049
1082
  # to a destination location. The schedule should be specified in UTC
1050
- # time. For more information, see task-scheduling.
1083
+ # time. For more information, see [Scheduling your task][1].
1084
+ #
1085
+ #
1086
+ #
1087
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
1051
1088
  #
1052
1089
  # @option params [Array<Types::TagListEntry>] :tags
1053
1090
  # The key-value pair that represents the tag that you want to add to the
@@ -1078,6 +1115,7 @@ module Aws::DataSync
1078
1115
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
1079
1116
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
1080
1117
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
1118
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
1081
1119
  # },
1082
1120
  # excludes: [
1083
1121
  # {
@@ -1267,11 +1305,11 @@ module Aws::DataSync
1267
1305
  end
1268
1306
 
1269
1307
  # Returns metadata, such as the path information about an Amazon FSx for
1270
- # Windows location.
1308
+ # Windows File Server location.
1271
1309
  #
1272
1310
  # @option params [required, String] :location_arn
1273
- # The Amazon Resource Name (ARN) of the FSx for Windows location to
1274
- # describe.
1311
+ # The Amazon Resource Name (ARN) of the FSx for Windows File Server
1312
+ # location to describe.
1275
1313
  #
1276
1314
  # @return [Types::DescribeLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1277
1315
  #
@@ -1346,7 +1384,11 @@ module Aws::DataSync
1346
1384
 
1347
1385
  # Returns metadata about a self-managed object storage server location.
1348
1386
  # For more information about self-managed object storage locations, see
1349
- # create-object-location.
1387
+ # [Creating a location for object storage][1].
1388
+ #
1389
+ #
1390
+ #
1391
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
1350
1392
  #
1351
1393
  # @option params [required, String] :location_arn
1352
1394
  # The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1526,6 +1568,7 @@ module Aws::DataSync
1526
1568
  # resp.options.task_queueing #=> String, one of "ENABLED", "DISABLED"
1527
1569
  # resp.options.log_level #=> String, one of "OFF", "BASIC", "TRANSFER"
1528
1570
  # resp.options.transfer_mode #=> String, one of "CHANGED", "ALL"
1571
+ # resp.options.security_descriptor_copy_flags #=> String, one of "NONE", "OWNER_DACL", "OWNER_DACL_SACL"
1529
1572
  # resp.excludes #=> Array
1530
1573
  # resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
1531
1574
  # resp.excludes[0].value #=> String
@@ -1586,6 +1629,7 @@ module Aws::DataSync
1586
1629
  # resp.options.task_queueing #=> String, one of "ENABLED", "DISABLED"
1587
1630
  # resp.options.log_level #=> String, one of "OFF", "BASIC", "TRANSFER"
1588
1631
  # resp.options.transfer_mode #=> String, one of "CHANGED", "ALL"
1632
+ # resp.options.security_descriptor_copy_flags #=> String, one of "NONE", "OWNER_DACL", "OWNER_DACL_SACL"
1589
1633
  # resp.excludes #=> Array
1590
1634
  # resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
1591
1635
  # resp.excludes[0].value #=> String
@@ -1880,15 +1924,19 @@ module Aws::DataSync
1880
1924
  #
1881
1925
  # @option params [Types::Options] :override_options
1882
1926
  # Represents the options that are available to control the behavior of a
1883
- # StartTaskExecution operation. Behavior includes preserving metadata
1884
- # such as user ID (UID), group ID (GID), and file permissions, and also
1885
- # overwriting files in the destination, data integrity verification, and
1886
- # so on.
1927
+ # [StartTaskExecution][1] operation. Behavior includes preserving
1928
+ # metadata such as user ID (UID), group ID (GID), and file permissions,
1929
+ # and also overwriting files in the destination, data integrity
1930
+ # verification, and so on.
1887
1931
  #
1888
1932
  # A task has a set of default options associated with it. If you don't
1889
- # specify an option in StartTaskExecution, the default value is used.
1890
- # You can override the defaults options on each task execution by
1891
- # specifying an overriding `Options` value to StartTaskExecution.
1933
+ # specify an option in [StartTaskExecution][1], the default value is
1934
+ # used. You can override the defaults options on each task execution by
1935
+ # specifying an overriding `Options` value to [StartTaskExecution][1].
1936
+ #
1937
+ #
1938
+ #
1939
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
1892
1940
  #
1893
1941
  # @option params [Array<Types::FilterRule>] :includes
1894
1942
  # A list of filter rules that determines which files to include when
@@ -1918,6 +1966,7 @@ module Aws::DataSync
1918
1966
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
1919
1967
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
1920
1968
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
1969
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
1921
1970
  # },
1922
1971
  # includes: [
1923
1972
  # {
@@ -2023,6 +2072,229 @@ module Aws::DataSync
2023
2072
  req.send_request(options)
2024
2073
  end
2025
2074
 
2075
+ # Updates some of the parameters of a previously created location for
2076
+ # Network File System (NFS) access. For information about creating an
2077
+ # NFS location, see [Creating a location for NFS][1].
2078
+ #
2079
+ #
2080
+ #
2081
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
2082
+ #
2083
+ # @option params [required, String] :location_arn
2084
+ # The Amazon Resource Name (ARN) of the NFS location to update.
2085
+ #
2086
+ # @option params [String] :subdirectory
2087
+ # The subdirectory in the NFS file system that is used to read data from
2088
+ # the NFS source location or write data to the NFS destination. The NFS
2089
+ # path should be a path that's exported by the NFS server, or a
2090
+ # subdirectory of that path. The path should be such that it can be
2091
+ # mounted by other NFS clients in your network.
2092
+ #
2093
+ # To see all the paths exported by your NFS server, run "`showmount -e
2094
+ # nfs-server-name`" from an NFS client that has access to your server.
2095
+ # You can specify any directory that appears in the results, and any
2096
+ # subdirectory of that directory. Ensure that the NFS export is
2097
+ # accessible without Kerberos authentication.
2098
+ #
2099
+ # To transfer all the data in the folder that you specified, DataSync
2100
+ # must have permissions to read all the data. To ensure this, either
2101
+ # configure the NFS export with `no_root_squash`, or ensure that the
2102
+ # files you want DataSync to access have permissions that allow read
2103
+ # access for all users. Doing either option enables the agent to read
2104
+ # the files. For the agent to access directories, you must additionally
2105
+ # enable all execute access.
2106
+ #
2107
+ # If you are copying data to or from your AWS Snowcone device, see [NFS
2108
+ # Server on AWS Snowcone][1] for more information.
2109
+ #
2110
+ # For information about NFS export configuration, see 18.7. The
2111
+ # /etc/exports Configuration File in the Red Hat Enterprise Linux
2112
+ # documentation.
2113
+ #
2114
+ #
2115
+ #
2116
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
2117
+ #
2118
+ # @option params [Types::OnPremConfig] :on_prem_config
2119
+ # A list of Amazon Resource Names (ARNs) of agents to use for a Network
2120
+ # File System (NFS) location.
2121
+ #
2122
+ # @option params [Types::NfsMountOptions] :mount_options
2123
+ # Represents the mount options that are available for DataSync to access
2124
+ # an NFS location.
2125
+ #
2126
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2127
+ #
2128
+ # @example Request syntax with placeholder values
2129
+ #
2130
+ # resp = client.update_location_nfs({
2131
+ # location_arn: "LocationArn", # required
2132
+ # subdirectory: "NfsSubdirectory",
2133
+ # on_prem_config: {
2134
+ # agent_arns: ["AgentArn"], # required
2135
+ # },
2136
+ # mount_options: {
2137
+ # version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
2138
+ # },
2139
+ # })
2140
+ #
2141
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationNfs AWS API Documentation
2142
+ #
2143
+ # @overload update_location_nfs(params = {})
2144
+ # @param [Hash] params ({})
2145
+ def update_location_nfs(params = {}, options = {})
2146
+ req = build_request(:update_location_nfs, params)
2147
+ req.send_request(options)
2148
+ end
2149
+
2150
+ # Updates some of the parameters of a previously created location for
2151
+ # self-managed object storage server access. For information about
2152
+ # creating a self-managed object storage location, see [Creating a
2153
+ # location for object storage][1].
2154
+ #
2155
+ #
2156
+ #
2157
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
2158
+ #
2159
+ # @option params [required, String] :location_arn
2160
+ # The Amazon Resource Name (ARN) of the self-managed object storage
2161
+ # server location to be updated.
2162
+ #
2163
+ # @option params [Integer] :server_port
2164
+ # The port that your self-managed object storage server accepts inbound
2165
+ # network traffic on. The server port is set by default to TCP 80 (HTTP)
2166
+ # or TCP 443 (HTTPS). You can specify a custom port if your self-managed
2167
+ # object storage server requires one.
2168
+ #
2169
+ # @option params [String] :server_protocol
2170
+ # The protocol that the object storage server uses to communicate. Valid
2171
+ # values are `HTTP` or `HTTPS`.
2172
+ #
2173
+ # @option params [String] :subdirectory
2174
+ # The subdirectory in the self-managed object storage server that is
2175
+ # used to read data from.
2176
+ #
2177
+ # @option params [String] :access_key
2178
+ # Optional. The access key is used if credentials are required to access
2179
+ # the self-managed object storage server. If your object storage
2180
+ # requires a user name and password to authenticate, use `AccessKey` and
2181
+ # `SecretKey` to provide the user name and password, respectively.
2182
+ #
2183
+ # @option params [String] :secret_key
2184
+ # Optional. The secret key is used if credentials are required to access
2185
+ # the self-managed object storage server. If your object storage
2186
+ # requires a user name and password to authenticate, use `AccessKey` and
2187
+ # `SecretKey` to provide the user name and password, respectively.
2188
+ #
2189
+ # @option params [Array<String>] :agent_arns
2190
+ # The Amazon Resource Name (ARN) of the agents associated with the
2191
+ # self-managed object storage server location.
2192
+ #
2193
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2194
+ #
2195
+ # @example Request syntax with placeholder values
2196
+ #
2197
+ # resp = client.update_location_object_storage({
2198
+ # location_arn: "LocationArn", # required
2199
+ # server_port: 1,
2200
+ # server_protocol: "HTTPS", # accepts HTTPS, HTTP
2201
+ # subdirectory: "S3Subdirectory",
2202
+ # access_key: "ObjectStorageAccessKey",
2203
+ # secret_key: "ObjectStorageSecretKey",
2204
+ # agent_arns: ["AgentArn"],
2205
+ # })
2206
+ #
2207
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorage AWS API Documentation
2208
+ #
2209
+ # @overload update_location_object_storage(params = {})
2210
+ # @param [Hash] params ({})
2211
+ def update_location_object_storage(params = {}, options = {})
2212
+ req = build_request(:update_location_object_storage, params)
2213
+ req.send_request(options)
2214
+ end
2215
+
2216
+ # Updates some of the parameters of a previously created location for
2217
+ # Server Message Block (SMB) file system access. For information about
2218
+ # creating an SMB location, see [Creating a location for SMB][1].
2219
+ #
2220
+ #
2221
+ #
2222
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html
2223
+ #
2224
+ # @option params [required, String] :location_arn
2225
+ # The Amazon Resource Name (ARN) of the SMB location to update.
2226
+ #
2227
+ # @option params [String] :subdirectory
2228
+ # The subdirectory in the SMB file system that is used to read data from
2229
+ # the SMB source location or write data to the SMB destination. The SMB
2230
+ # path should be a path that's exported by the SMB server, or a
2231
+ # subdirectory of that path. The path should be such that it can be
2232
+ # mounted by other SMB clients in your network.
2233
+ #
2234
+ # <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
2235
+ # `/path/to/folder`.
2236
+ #
2237
+ # </note>
2238
+ #
2239
+ # To transfer all the data in the folder that you specified, DataSync
2240
+ # must have permissions to mount the SMB share and to access all the
2241
+ # data in that share. To ensure this, do either of the following:
2242
+ #
2243
+ # * Ensure that the user/password specified belongs to the user who can
2244
+ # mount the share and who has the appropriate permissions for all of
2245
+ # the files and directories that you want DataSync to access.
2246
+ #
2247
+ # * Use credentials of a member of the Backup Operators group to mount
2248
+ # the share.
2249
+ #
2250
+ # Doing either of these options enables the agent to access the data.
2251
+ # For the agent to access directories, you must also enable all execute
2252
+ # access.
2253
+ #
2254
+ # @option params [String] :user
2255
+ # The user who can mount the share has the permissions to access files
2256
+ # and folders in the SMB share.
2257
+ #
2258
+ # @option params [String] :domain
2259
+ # The name of the Windows domain that the SMB server belongs to.
2260
+ #
2261
+ # @option params [String] :password
2262
+ # The password of the user who can mount the share has the permissions
2263
+ # to access files and folders in the SMB share.
2264
+ #
2265
+ # @option params [Array<String>] :agent_arns
2266
+ # The Amazon Resource Names (ARNs) of agents to use for a Simple Message
2267
+ # Block (SMB) location.
2268
+ #
2269
+ # @option params [Types::SmbMountOptions] :mount_options
2270
+ # Represents the mount options that are available for DataSync to access
2271
+ # an SMB location.
2272
+ #
2273
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2274
+ #
2275
+ # @example Request syntax with placeholder values
2276
+ #
2277
+ # resp = client.update_location_smb({
2278
+ # location_arn: "LocationArn", # required
2279
+ # subdirectory: "SmbSubdirectory",
2280
+ # user: "SmbUser",
2281
+ # domain: "SmbDomain",
2282
+ # password: "SmbPassword",
2283
+ # agent_arns: ["AgentArn"],
2284
+ # mount_options: {
2285
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
2286
+ # },
2287
+ # })
2288
+ #
2289
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationSmb AWS API Documentation
2290
+ #
2291
+ # @overload update_location_smb(params = {})
2292
+ # @param [Hash] params ({})
2293
+ def update_location_smb(params = {}, options = {})
2294
+ req = build_request(:update_location_smb, params)
2295
+ req.send_request(options)
2296
+ end
2297
+
2026
2298
  # Updates the metadata associated with a task.
2027
2299
  #
2028
2300
  # @option params [required, String] :task_arn
@@ -2031,15 +2303,19 @@ module Aws::DataSync
2031
2303
  #
2032
2304
  # @option params [Types::Options] :options
2033
2305
  # Represents the options that are available to control the behavior of a
2034
- # StartTaskExecution operation. Behavior includes preserving metadata
2035
- # such as user ID (UID), group ID (GID), and file permissions, and also
2036
- # overwriting files in the destination, data integrity verification, and
2037
- # so on.
2306
+ # [StartTaskExecution][1] operation. Behavior includes preserving
2307
+ # metadata such as user ID (UID), group ID (GID), and file permissions,
2308
+ # and also overwriting files in the destination, data integrity
2309
+ # verification, and so on.
2038
2310
  #
2039
2311
  # A task has a set of default options associated with it. If you don't
2040
- # specify an option in StartTaskExecution, the default value is used.
2041
- # You can override the defaults options on each task execution by
2042
- # specifying an overriding `Options` value to StartTaskExecution.
2312
+ # specify an option in [StartTaskExecution][1], the default value is
2313
+ # used. You can override the defaults options on each task execution by
2314
+ # specifying an overriding `Options` value to [StartTaskExecution][1].
2315
+ #
2316
+ #
2317
+ #
2318
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
2043
2319
  #
2044
2320
  # @option params [Array<Types::FilterRule>] :excludes
2045
2321
  # A list of filter rules that determines which files to exclude from a
@@ -2052,7 +2328,12 @@ module Aws::DataSync
2052
2328
  # to a destination location. You can configure your task to execute
2053
2329
  # hourly, daily, weekly or on specific days of the week. You control
2054
2330
  # when in the day or hour you want the task to execute. The time you
2055
- # specify is UTC time. For more information, see task-scheduling.
2331
+ # specify is UTC time. For more information, see [Scheduling your
2332
+ # task][1].
2333
+ #
2334
+ #
2335
+ #
2336
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
2056
2337
  #
2057
2338
  # @option params [String] :name
2058
2339
  # The name of the task to update.
@@ -2081,6 +2362,7 @@ module Aws::DataSync
2081
2362
  # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2082
2363
  # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2083
2364
  # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2365
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
2084
2366
  # },
2085
2367
  # excludes: [
2086
2368
  # {
@@ -2104,6 +2386,74 @@ module Aws::DataSync
2104
2386
  req.send_request(options)
2105
2387
  end
2106
2388
 
2389
+ # Updates execution of a task.
2390
+ #
2391
+ # You can modify bandwidth throttling for a task execution that is
2392
+ # running or queued. For more information, see [Adjusting Bandwidth
2393
+ # Throttling for a Task Execution][1].
2394
+ #
2395
+ # <note markdown="1"> The only `Option` that can be modified by `UpdateTaskExecution` is `
2396
+ # BytesPerSecond `.
2397
+ #
2398
+ # </note>
2399
+ #
2400
+ #
2401
+ #
2402
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#adjust-bandwidth-throttling
2403
+ #
2404
+ # @option params [required, String] :task_execution_arn
2405
+ # The Amazon Resource Name (ARN) of the specific task execution that is
2406
+ # being updated.
2407
+ #
2408
+ # @option params [required, Types::Options] :options
2409
+ # Represents the options that are available to control the behavior of a
2410
+ # [StartTaskExecution][1] operation. Behavior includes preserving
2411
+ # metadata such as user ID (UID), group ID (GID), and file permissions,
2412
+ # and also overwriting files in the destination, data integrity
2413
+ # verification, and so on.
2414
+ #
2415
+ # A task has a set of default options associated with it. If you don't
2416
+ # specify an option in [StartTaskExecution][1], the default value is
2417
+ # used. You can override the defaults options on each task execution by
2418
+ # specifying an overriding `Options` value to [StartTaskExecution][1].
2419
+ #
2420
+ #
2421
+ #
2422
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
2423
+ #
2424
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2425
+ #
2426
+ # @example Request syntax with placeholder values
2427
+ #
2428
+ # resp = client.update_task_execution({
2429
+ # task_execution_arn: "TaskExecutionArn", # required
2430
+ # options: { # required
2431
+ # verify_mode: "POINT_IN_TIME_CONSISTENT", # accepts POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
2432
+ # overwrite_mode: "ALWAYS", # accepts ALWAYS, NEVER
2433
+ # atime: "NONE", # accepts NONE, BEST_EFFORT
2434
+ # mtime: "NONE", # accepts NONE, PRESERVE
2435
+ # uid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2436
+ # gid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2437
+ # preserve_deleted_files: "PRESERVE", # accepts PRESERVE, REMOVE
2438
+ # preserve_devices: "NONE", # accepts NONE, PRESERVE
2439
+ # posix_permissions: "NONE", # accepts NONE, PRESERVE
2440
+ # bytes_per_second: 1,
2441
+ # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2442
+ # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2443
+ # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2444
+ # security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
2445
+ # },
2446
+ # })
2447
+ #
2448
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecution AWS API Documentation
2449
+ #
2450
+ # @overload update_task_execution(params = {})
2451
+ # @param [Hash] params ({})
2452
+ def update_task_execution(params = {}, options = {})
2453
+ req = build_request(:update_task_execution, params)
2454
+ req.send_request(options)
2455
+ end
2456
+
2107
2457
  # @!endgroup
2108
2458
 
2109
2459
  # @param params ({})
@@ -2117,7 +2467,7 @@ module Aws::DataSync
2117
2467
  params: params,
2118
2468
  config: config)
2119
2469
  context[:gem_name] = 'aws-sdk-datasync'
2120
- context[:gem_version] = '1.27.0'
2470
+ context[:gem_version] = '1.32.0'
2121
2471
  Seahorse::Client::Request.new(handlers, context)
2122
2472
  end
2123
2473