aws-sdk-datasync 1.26.0 → 1.31.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: 6df012c3054935f1a7383c858e7d705aedb11e98af086f47ff45db56d9b60507
4
- data.tar.gz: 88ff308a72fe61f2913010bfa581685a8cc0a216bf94c39b8d397744dfaea6fb
3
+ metadata.gz: 84b0365089ed38f2efe9bdc70c63897a9c8a0ee0ebe19ad976ebcc5f24486ce8
4
+ data.tar.gz: a55fb1baf57d783490606f94b25ab6c81ccf6e72340574a9ffc105234ae2a74f
5
5
  SHA512:
6
- metadata.gz: 78eb1ad4c9ef06757818c7786ac19961b8902cceec6c61fb6a1a4a2eb04a8d64204246c6b670400aae9d981d0a1e0f766fd9f29dc55c8134073149683710539c
7
- data.tar.gz: ad82c81f96476395ecd635be17f1a626d9c98bf977509cd8a79e6d74384f7ae55eea5a7dfe3960df8b84646959fa9aa048bb8836aacacdfec2195c06df815201
6
+ metadata.gz: fb18148ca66f67b8c91ae46e65507906d23247c42707854d608db90cd88e665854480185403f12f5b3878c46c3b2412a93ee608092291cd3863a84f1fcb2fbd6
7
+ data.tar.gz: b8be0d5359613cfd1f80663ae9b6727c23bd4bd1e53a0c79d9b9d828555221ec0a30004bf4bcbd52b76a35bd65f2d54a94b18b29ee76dfa7d3e3de468f7672d6
data/CHANGELOG.md ADDED
@@ -0,0 +1,168 @@
1
+ Unreleased Changes
2
+ ------------------
3
+
4
+ 1.31.0 (2021-03-10)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.30.0 (2021-03-02)
10
+ ------------------
11
+
12
+ * Feature - Additional API Support to update NFS/SMB/ObjectStorage locations
13
+
14
+ 1.29.0 (2021-02-02)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.28.0 (2020-11-09)
20
+ ------------------
21
+
22
+ * Feature - DataSync now enables customers to adjust the network bandwidth used by a running AWS DataSync task.
23
+
24
+ 1.27.0 (2020-09-30)
25
+ ------------------
26
+
27
+ * Feature - This release enables customers to create s3 location for S3 bucket's located on an AWS Outpost.
28
+
29
+ 1.26.0 (2020-09-15)
30
+ ------------------
31
+
32
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
33
+
34
+ 1.25.0 (2020-08-25)
35
+ ------------------
36
+
37
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
38
+
39
+ 1.24.0 (2020-08-18)
40
+ ------------------
41
+
42
+ * Feature - DataSync support for filters as input arguments to the ListTasks and ListLocations API calls.
43
+
44
+ 1.23.0 (2020-07-27)
45
+ ------------------
46
+
47
+ * Feature - Today AWS DataSync releases support for self-managed object storage Locations and the new TransferMode Option.
48
+
49
+ 1.22.0 (2020-06-23)
50
+ ------------------
51
+
52
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
53
+
54
+ 1.21.1 (2020-06-11)
55
+ ------------------
56
+
57
+ * Issue - Republish previous version with correct dependency on `aws-sdk-core`.
58
+
59
+ 1.21.0 (2020-06-10)
60
+ ------------------
61
+
62
+ * Issue - This version has been yanked. (#2327).
63
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
64
+
65
+ 1.20.0 (2020-05-28)
66
+ ------------------
67
+
68
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
69
+
70
+ 1.19.0 (2020-05-07)
71
+ ------------------
72
+
73
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
74
+
75
+ 1.18.0 (2020-03-09)
76
+ ------------------
77
+
78
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
79
+
80
+ 1.17.0 (2020-01-24)
81
+ ------------------
82
+
83
+ * Feature - AWS DataSync now supports FSx for Windows File Server Locations
84
+
85
+ 1.16.0 (2019-11-20)
86
+ ------------------
87
+
88
+ * Feature - Update to configure task to run periodically on a schedule
89
+
90
+ 1.15.0 (2019-10-23)
91
+ ------------------
92
+
93
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
94
+
95
+ 1.14.0 (2019-10-08)
96
+ ------------------
97
+
98
+ * Feature - Add Sync options to enable/disable TaskQueueing
99
+
100
+ 1.13.0 (2019-09-24)
101
+ ------------------
102
+
103
+ * Feature - Added S3StorageClass, OverwriteMode sync option, and ONLY_FILES_TRANSFERRED setting for the VerifyMode sync option.
104
+
105
+ 1.12.0 (2019-08-22)
106
+ ------------------
107
+
108
+ * Feature - This release adds support for SMB location type.
109
+
110
+ 1.11.0 (2019-08-05)
111
+ ------------------
112
+
113
+ * Feature - Support VPC endpoints.
114
+
115
+ 1.10.0 (2019-07-25)
116
+ ------------------
117
+
118
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
119
+
120
+ 1.9.0 (2019-07-01)
121
+ ------------------
122
+
123
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
124
+
125
+ 1.8.0 (2019-06-17)
126
+ ------------------
127
+
128
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
129
+
130
+ 1.7.0 (2019-05-21)
131
+ ------------------
132
+
133
+ * Feature - API update.
134
+
135
+ 1.6.0 (2019-05-15)
136
+ ------------------
137
+
138
+ * Feature - API update.
139
+
140
+ 1.5.0 (2019-05-14)
141
+ ------------------
142
+
143
+ * Feature - API update.
144
+
145
+ 1.4.0 (2019-05-13)
146
+ ------------------
147
+
148
+ * Feature - API update.
149
+
150
+ 1.3.0 (2019-03-21)
151
+ ------------------
152
+
153
+ * Feature - API update.
154
+
155
+ 1.2.0 (2019-03-18)
156
+ ------------------
157
+
158
+ * Feature - API update.
159
+
160
+ 1.1.0 (2019-03-14)
161
+ ------------------
162
+
163
+ * Feature - API update.
164
+
165
+ 1.0.0 (2018-11-26)
166
+ ------------------
167
+
168
+ * 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.31.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.26.0'
51
+ GEM_VERSION = '1.31.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
 
@@ -378,7 +378,7 @@ module Aws::DataSync
378
378
  #
379
379
  # You can activate the agent in a VPC (virtual private cloud) or provide
380
380
  # the agent access to a VPC endpoint so you can run tasks without going
381
- # over the public Internet.
381
+ # over the public internet.
382
382
  #
383
383
  # You can use an agent for more than one location. If a task uses
384
384
  # multiple agents, all of them need to have status AVAILABLE for the
@@ -557,20 +557,22 @@ module Aws::DataSync
557
557
  req.send_request(options)
558
558
  end
559
559
 
560
- # Creates an endpoint for an Amazon FSx for Windows file system.
560
+ # Creates an endpoint for an Amazon FSx for Windows File Server file
561
+ # system.
561
562
  #
562
563
  # @option params [String] :subdirectory
563
564
  # 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.
565
+ # FSx for Windows File Server file system is used to read data from the
566
+ # Amazon FSx for Windows File Server source location or write data to
567
+ # the FSx for Windows File Server destination.
567
568
  #
568
569
  # @option params [required, String] :fsx_filesystem_arn
569
- # The Amazon Resource Name (ARN) for the FSx for Windows file system.
570
+ # The Amazon Resource Name (ARN) for the FSx for Windows File Server
571
+ # file system.
570
572
  #
571
573
  # @option params [required, Array<String>] :security_group_arns
572
574
  # The Amazon Resource Names (ARNs) of the security groups that are to
573
- # use to configure the FSx for Windows file system.
575
+ # use to configure the FSx for Windows File Server file system.
574
576
  #
575
577
  # @option params [Array<Types::TagListEntry>] :tags
576
578
  # The key-value pair that represents a tag that you want to add to the
@@ -580,15 +582,15 @@ module Aws::DataSync
580
582
  #
581
583
  # @option params [required, String] :user
582
584
  # The user who has the permissions to access files and folders in the
583
- # FSx for Windows file system.
585
+ # FSx for Windows File Server file system.
584
586
  #
585
587
  # @option params [String] :domain
586
- # The name of the Windows domain that the FSx for Windows server belongs
587
- # to.
588
+ # The name of the Windows domain that the FSx for Windows File Server
589
+ # belongs to.
588
590
  #
589
591
  # @option params [required, String] :password
590
592
  # The password of the user who has the permissions to access files and
591
- # folders in the FSx for Windows file system.
593
+ # folders in the FSx for Windows File Server file system.
592
594
  #
593
595
  # @return [Types::CreateLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
594
596
  #
@@ -634,7 +636,7 @@ module Aws::DataSync
634
636
  # subdirectory of that path. The path should be such that it can be
635
637
  # mounted by other NFS clients in your network.
636
638
  #
637
- # To see all the paths exported by your NFS server. run "`showmount -e
639
+ # To see all the paths exported by your NFS server, run "`showmount -e
638
640
  # nfs-server-name`" from an NFS client that has access to your server.
639
641
  # You can specify any directory that appears in the results, and any
640
642
  # subdirectory of that directory. Ensure that the NFS export is
@@ -731,7 +733,9 @@ module Aws::DataSync
731
733
  req.send_request(options)
732
734
  end
733
735
 
734
- # Creates an endpoint for a self-managed object storage bucket.
736
+ # Creates an endpoint for a self-managed object storage bucket. For more
737
+ # information about self-managed object storage locations, see
738
+ # create-object-location.
735
739
  #
736
740
  # @option params [required, String] :server_hostname
737
741
  # The name of the self-managed object storage server. This value is the
@@ -759,11 +763,15 @@ module Aws::DataSync
759
763
  #
760
764
  # @option params [String] :access_key
761
765
  # Optional. The access key is used if credentials are required to access
762
- # the self-managed object storage server.
766
+ # the self-managed object storage server. If your object storage
767
+ # requires a user name and password to authenticate, use `AccessKey` and
768
+ # `SecretKey` to provide the user name and password, respectively.
763
769
  #
764
770
  # @option params [String] :secret_key
765
771
  # Optional. The secret key is used if credentials are required to access
766
- # the self-managed object storage server.
772
+ # the self-managed object storage server. If your object storage
773
+ # requires a user name and password to authenticate, use `AccessKey` and
774
+ # `SecretKey` to provide the user name and password, respectively.
767
775
  #
768
776
  # @option params [required, Array<String>] :agent_arns
769
777
  # The Amazon Resource Name (ARN) of the agents associated with the
@@ -812,16 +820,9 @@ module Aws::DataSync
812
820
 
813
821
  # Creates an endpoint for an Amazon S3 bucket.
814
822
  #
815
- # For AWS DataSync to access a destination S3 bucket, it needs an AWS
816
- # Identity and Access Management (IAM) role that has the required
817
- # permissions. You can set up the required permissions by creating an
818
- # IAM policy that grants the required permissions and attaching the
819
- # policy to the role. An example of such a policy is shown in the
820
- # examples section.
821
- #
822
823
  # For more information, see
823
- # https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html#create-s3-location
824
- # in the *AWS DataSync User Guide.*
824
+ # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
825
+ # in the *AWS DataSync User Guide*.
825
826
  #
826
827
  # @option params [String] :subdirectory
827
828
  # A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -829,19 +830,22 @@ module Aws::DataSync
829
830
  # S3 destination.
830
831
  #
831
832
  # @option params [required, String] :s3_bucket_arn
832
- # The Amazon Resource Name (ARN) of the Amazon S3 bucket.
833
+ # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
834
+ # this must be an access point ARN.
833
835
  #
834
836
  # @option params [String] :s3_storage_class
835
837
  # The Amazon S3 storage class that you want to store your files in when
836
- # this location is used as a task destination. For more information
837
- # about S3 storage classes, see [Amazon S3 Storage Classes][1] in the
838
- # *Amazon Simple Storage Service Developer Guide*. Some storage classes
839
- # have behaviors that can affect your S3 storage cost. For detailed
840
- # information, see using-storage-classes.
838
+ # this location is used as a task destination. For buckets in AWS
839
+ # Regions, the storage class defaults to Standard. For buckets on AWS
840
+ # Outposts, the storage class defaults to AWS S3 Outposts.
841
+ #
842
+ # For more information about S3 storage classes, see [Amazon S3 Storage
843
+ # Classes][1]. Some storage classes have behaviors that can affect your
844
+ # S3 storage cost. For detailed information, see using-storage-classes.
841
845
  #
842
846
  #
843
847
  #
844
- # [1]: https://aws.amazon.com/s3/storage-classes/
848
+ # [1]: http://aws.amazon.com/s3/storage-classes/
845
849
  #
846
850
  # @option params [required, Types::S3Config] :s3_config
847
851
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
@@ -850,6 +854,12 @@ module Aws::DataSync
850
854
  # For detailed information about using such a role, see Creating a
851
855
  # Location for Amazon S3 in the *AWS DataSync User Guide*.
852
856
  #
857
+ # @option params [Array<String>] :agent_arns
858
+ # If you are using DataSync on an AWS Outpost, specify the Amazon
859
+ # Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
860
+ # For more information about launching a DataSync agent on an AWS
861
+ # Outpost, see outposts-agent.
862
+ #
853
863
  # @option params [Array<Types::TagListEntry>] :tags
854
864
  # The key-value pair that represents the tag that you want to add to the
855
865
  # location. The value can be an empty string. We recommend using tags to
@@ -864,10 +874,11 @@ module Aws::DataSync
864
874
  # resp = client.create_location_s3({
865
875
  # subdirectory: "S3Subdirectory",
866
876
  # s3_bucket_arn: "S3BucketArn", # required
867
- # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
877
+ # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
868
878
  # s3_config: { # required
869
879
  # bucket_access_role_arn: "IamRoleArn", # required
870
880
  # },
881
+ # agent_arns: ["AgentArn"],
871
882
  # tags: [
872
883
  # {
873
884
  # key: "TagKey", # required
@@ -984,24 +995,30 @@ module Aws::DataSync
984
995
  req.send_request(options)
985
996
  end
986
997
 
987
- # Creates a task. A task is a set of two locations (source and
988
- # destination) and a set of Options that you use to control the behavior
989
- # of a task. If you don't specify Options when you create a task, AWS
990
- # DataSync populates them with service defaults.
991
- #
992
- # When you create a task, it first enters the CREATING state. During
993
- # CREATING AWS DataSync attempts to mount the on-premises Network File
994
- # System (NFS) location. The task transitions to the AVAILABLE state
995
- # without waiting for the AWS location to become mounted. If required,
996
- # AWS DataSync mounts the AWS location before each task execution.
997
- #
998
- # If an agent that is associated with a source (NFS) location goes
999
- # offline, the task transitions to the UNAVAILABLE status. If the status
1000
- # of the task remains in the CREATING status for more than a few
1001
- # minutes, it means that your agent might be having trouble mounting the
1002
- # source NFS file system. Check the task's ErrorCode and ErrorDetail.
1003
- # Mount issues are often caused by either a misconfigured firewall or a
1004
- # mistyped NFS server host name.
998
+ # Creates a task.
999
+ #
1000
+ # A task includes a source location and a destination location, and a
1001
+ # configuration that specifies how data is transferred. A task always
1002
+ # transfers data from the source location to the destination location.
1003
+ # The configuration specifies options such as task scheduling, bandwidth
1004
+ # limits, etc. A task is the complete definition of a data transfer.
1005
+ #
1006
+ # When you create a task that transfers data between AWS services in
1007
+ # different AWS Regions, one of the two locations that you specify must
1008
+ # reside in the Region where DataSync is being used. The other location
1009
+ # must be specified in a different Region.
1010
+ #
1011
+ # You can transfer data between commercial AWS Regions except for China,
1012
+ # or between AWS GovCloud (US-East and US-West) Regions.
1013
+ #
1014
+ # When you use DataSync to copy files or objects between AWS Regions,
1015
+ # you pay for data transfer between Regions. This is billed as data
1016
+ # transfer OUT from your source Region to your destination Region. For
1017
+ # more information, see [Data Transfer pricing][1].
1018
+ #
1019
+ #
1020
+ #
1021
+ # [1]: http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer
1005
1022
  #
1006
1023
  # @option params [required, String] :source_location_arn
1007
1024
  # The Amazon Resource Name (ARN) of the source location for the task.
@@ -1032,7 +1049,7 @@ module Aws::DataSync
1032
1049
  # A list of filter rules that determines which files to exclude from a
1033
1050
  # task. The list should contain a single filter string that consists of
1034
1051
  # the patterns to exclude. The patterns are delimited by "\|" (that
1035
- # is, a pipe), for example, `"/folder1|/folder2"`
1052
+ # is, a pipe), for example, `"/folder1|/folder2"`.
1036
1053
  #
1037
1054
  # @option params [Types::TaskSchedule] :schedule
1038
1055
  # Specifies a schedule used to periodically transfer files from a source
@@ -1257,11 +1274,11 @@ module Aws::DataSync
1257
1274
  end
1258
1275
 
1259
1276
  # Returns metadata, such as the path information about an Amazon FSx for
1260
- # Windows location.
1277
+ # Windows File Server location.
1261
1278
  #
1262
1279
  # @option params [required, String] :location_arn
1263
- # The Amazon Resource Name (ARN) of the FSx for Windows location to
1264
- # describe.
1280
+ # The Amazon Resource Name (ARN) of the FSx for Windows File Server
1281
+ # location to describe.
1265
1282
  #
1266
1283
  # @return [Types::DescribeLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1267
1284
  #
@@ -1335,6 +1352,8 @@ module Aws::DataSync
1335
1352
  end
1336
1353
 
1337
1354
  # Returns metadata about a self-managed object storage server location.
1355
+ # For more information about self-managed object storage locations, see
1356
+ # create-object-location.
1338
1357
  #
1339
1358
  # @option params [required, String] :location_arn
1340
1359
  # The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1389,6 +1408,7 @@ module Aws::DataSync
1389
1408
  # * {Types::DescribeLocationS3Response#location_uri #location_uri} => String
1390
1409
  # * {Types::DescribeLocationS3Response#s3_storage_class #s3_storage_class} => String
1391
1410
  # * {Types::DescribeLocationS3Response#s3_config #s3_config} => Types::S3Config
1411
+ # * {Types::DescribeLocationS3Response#agent_arns #agent_arns} => Array&lt;String&gt;
1392
1412
  # * {Types::DescribeLocationS3Response#creation_time #creation_time} => Time
1393
1413
  #
1394
1414
  # @example Request syntax with placeholder values
@@ -1401,8 +1421,10 @@ module Aws::DataSync
1401
1421
  #
1402
1422
  # resp.location_arn #=> String
1403
1423
  # resp.location_uri #=> String
1404
- # resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE"
1424
+ # resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
1405
1425
  # resp.s3_config.bucket_access_role_arn #=> String
1426
+ # resp.agent_arns #=> Array
1427
+ # resp.agent_arns[0] #=> String
1406
1428
  # resp.creation_time #=> Time
1407
1429
  #
1408
1430
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationS3 AWS API Documentation
@@ -1668,6 +1690,10 @@ module Aws::DataSync
1668
1690
  # next list of locations.
1669
1691
  #
1670
1692
  # @option params [Array<Types::LocationFilter>] :filters
1693
+ # You can use API filters to narrow down the list of resources returned
1694
+ # by `ListLocations`. For example, to retrieve all tasks on a specific
1695
+ # source location, you can use `ListLocations` with filter name
1696
+ # `LocationType S3` and `Operator Equals`.
1671
1697
  #
1672
1698
  # @return [Types::ListLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1673
1699
  #
@@ -1803,6 +1829,10 @@ module Aws::DataSync
1803
1829
  # next list of tasks.
1804
1830
  #
1805
1831
  # @option params [Array<Types::TaskFilter>] :filters
1832
+ # You can use API filters to narrow down the list of resources returned
1833
+ # by `ListTasks`. For example, to retrieve all tasks on a specific
1834
+ # source location, you can use `ListTasks` with filter name `LocationId`
1835
+ # and `Operator Equals` with the ARN for the location.
1806
1836
  #
1807
1837
  # @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1808
1838
  #
@@ -2000,6 +2030,217 @@ module Aws::DataSync
2000
2030
  req.send_request(options)
2001
2031
  end
2002
2032
 
2033
+ # Updates some of the parameters of a previously created location for
2034
+ # Network File System (NFS) access. For information about creating an
2035
+ # NFS location, see create-nfs-location.
2036
+ #
2037
+ # @option params [required, String] :location_arn
2038
+ # The Amazon Resource Name (ARN) of the NFS location to update.
2039
+ #
2040
+ # @option params [String] :subdirectory
2041
+ # The subdirectory in the NFS file system that is used to read data from
2042
+ # the NFS source location or write data to the NFS destination. The NFS
2043
+ # path should be a path that's exported by the NFS server, or a
2044
+ # subdirectory of that path. The path should be such that it can be
2045
+ # mounted by other NFS clients in your network.
2046
+ #
2047
+ # To see all the paths exported by your NFS server, run "`showmount -e
2048
+ # nfs-server-name`" from an NFS client that has access to your server.
2049
+ # You can specify any directory that appears in the results, and any
2050
+ # subdirectory of that directory. Ensure that the NFS export is
2051
+ # accessible without Kerberos authentication.
2052
+ #
2053
+ # To transfer all the data in the folder that you specified, DataSync
2054
+ # must have permissions to read all the data. To ensure this, either
2055
+ # configure the NFS export with `no_root_squash`, or ensure that the
2056
+ # files you want DataSync to access have permissions that allow read
2057
+ # access for all users. Doing either option enables the agent to read
2058
+ # the files. For the agent to access directories, you must additionally
2059
+ # enable all execute access.
2060
+ #
2061
+ # If you are copying data to or from your AWS Snowcone device, see [NFS
2062
+ # Server on AWS Snowcone][1] for more information.
2063
+ #
2064
+ # For information about NFS export configuration, see 18.7. The
2065
+ # /etc/exports Configuration File in the Red Hat Enterprise Linux
2066
+ # documentation.
2067
+ #
2068
+ #
2069
+ #
2070
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
2071
+ #
2072
+ # @option params [Types::OnPremConfig] :on_prem_config
2073
+ # A list of Amazon Resource Names (ARNs) of agents to use for a Network
2074
+ # File System (NFS) location.
2075
+ #
2076
+ # @option params [Types::NfsMountOptions] :mount_options
2077
+ # Represents the mount options that are available for DataSync to access
2078
+ # an NFS location.
2079
+ #
2080
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2081
+ #
2082
+ # @example Request syntax with placeholder values
2083
+ #
2084
+ # resp = client.update_location_nfs({
2085
+ # location_arn: "LocationArn", # required
2086
+ # subdirectory: "NfsSubdirectory",
2087
+ # on_prem_config: {
2088
+ # agent_arns: ["AgentArn"], # required
2089
+ # },
2090
+ # mount_options: {
2091
+ # version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
2092
+ # },
2093
+ # })
2094
+ #
2095
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationNfs AWS API Documentation
2096
+ #
2097
+ # @overload update_location_nfs(params = {})
2098
+ # @param [Hash] params ({})
2099
+ def update_location_nfs(params = {}, options = {})
2100
+ req = build_request(:update_location_nfs, params)
2101
+ req.send_request(options)
2102
+ end
2103
+
2104
+ # Updates some of the parameters of a previously created location for
2105
+ # self-managed object storage server access. For information about
2106
+ # creating a self-managed object storage location, see
2107
+ # create-object-location.
2108
+ #
2109
+ # @option params [required, String] :location_arn
2110
+ # The Amazon Resource Name (ARN) of the self-managed object storage
2111
+ # server location to be updated.
2112
+ #
2113
+ # @option params [Integer] :server_port
2114
+ # The port that your self-managed object storage server accepts inbound
2115
+ # network traffic on. The server port is set by default to TCP 80 (HTTP)
2116
+ # or TCP 443 (HTTPS). You can specify a custom port if your self-managed
2117
+ # object storage server requires one.
2118
+ #
2119
+ # @option params [String] :server_protocol
2120
+ # The protocol that the object storage server uses to communicate. Valid
2121
+ # values are `HTTP` or `HTTPS`.
2122
+ #
2123
+ # @option params [String] :subdirectory
2124
+ # The subdirectory in the self-managed object storage server that is
2125
+ # used to read data from.
2126
+ #
2127
+ # @option params [String] :access_key
2128
+ # Optional. The access key is used if credentials are required to access
2129
+ # the self-managed object storage server. If your object storage
2130
+ # requires a user name and password to authenticate, use `AccessKey` and
2131
+ # `SecretKey` to provide the user name and password, respectively.
2132
+ #
2133
+ # @option params [String] :secret_key
2134
+ # Optional. The secret key is used if credentials are required to access
2135
+ # the self-managed object storage server. If your object storage
2136
+ # requires a user name and password to authenticate, use `AccessKey` and
2137
+ # `SecretKey` to provide the user name and password, respectively.
2138
+ #
2139
+ # @option params [Array<String>] :agent_arns
2140
+ # The Amazon Resource Name (ARN) of the agents associated with the
2141
+ # self-managed object storage server location.
2142
+ #
2143
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2144
+ #
2145
+ # @example Request syntax with placeholder values
2146
+ #
2147
+ # resp = client.update_location_object_storage({
2148
+ # location_arn: "LocationArn", # required
2149
+ # server_port: 1,
2150
+ # server_protocol: "HTTPS", # accepts HTTPS, HTTP
2151
+ # subdirectory: "S3Subdirectory",
2152
+ # access_key: "ObjectStorageAccessKey",
2153
+ # secret_key: "ObjectStorageSecretKey",
2154
+ # agent_arns: ["AgentArn"],
2155
+ # })
2156
+ #
2157
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorage AWS API Documentation
2158
+ #
2159
+ # @overload update_location_object_storage(params = {})
2160
+ # @param [Hash] params ({})
2161
+ def update_location_object_storage(params = {}, options = {})
2162
+ req = build_request(:update_location_object_storage, params)
2163
+ req.send_request(options)
2164
+ end
2165
+
2166
+ # Updates some of the parameters of a previously created location for
2167
+ # Server Message Block (SMB) file system access. For information about
2168
+ # creating an SMB location, see create-smb-location.
2169
+ #
2170
+ # @option params [required, String] :location_arn
2171
+ # The Amazon Resource Name (ARN) of the SMB location to update.
2172
+ #
2173
+ # @option params [String] :subdirectory
2174
+ # The subdirectory in the SMB file system that is used to read data from
2175
+ # the SMB source location or write data to the SMB destination. The SMB
2176
+ # path should be a path that's exported by the SMB server, or a
2177
+ # subdirectory of that path. The path should be such that it can be
2178
+ # mounted by other SMB clients in your network.
2179
+ #
2180
+ # <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
2181
+ # `/path/to/folder`.
2182
+ #
2183
+ # </note>
2184
+ #
2185
+ # To transfer all the data in the folder that you specified, DataSync
2186
+ # must have permissions to mount the SMB share and to access all the
2187
+ # data in that share. To ensure this, do either of the following:
2188
+ #
2189
+ # * Ensure that the user/password specified belongs to the user who can
2190
+ # mount the share and who has the appropriate permissions for all of
2191
+ # the files and directories that you want DataSync to access.
2192
+ #
2193
+ # * Use credentials of a member of the Backup Operators group to mount
2194
+ # the share.
2195
+ #
2196
+ # Doing either of these options enables the agent to access the data.
2197
+ # For the agent to access directories, you must also enable all execute
2198
+ # access.
2199
+ #
2200
+ # @option params [String] :user
2201
+ # The user who can mount the share has the permissions to access files
2202
+ # and folders in the SMB share.
2203
+ #
2204
+ # @option params [String] :domain
2205
+ # The name of the Windows domain that the SMB server belongs to.
2206
+ #
2207
+ # @option params [String] :password
2208
+ # The password of the user who can mount the share has the permissions
2209
+ # to access files and folders in the SMB share.
2210
+ #
2211
+ # @option params [Array<String>] :agent_arns
2212
+ # The Amazon Resource Names (ARNs) of agents to use for a Simple Message
2213
+ # Block (SMB) location.
2214
+ #
2215
+ # @option params [Types::SmbMountOptions] :mount_options
2216
+ # Represents the mount options that are available for DataSync to access
2217
+ # an SMB location.
2218
+ #
2219
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2220
+ #
2221
+ # @example Request syntax with placeholder values
2222
+ #
2223
+ # resp = client.update_location_smb({
2224
+ # location_arn: "LocationArn", # required
2225
+ # subdirectory: "SmbSubdirectory",
2226
+ # user: "SmbUser",
2227
+ # domain: "SmbDomain",
2228
+ # password: "SmbPassword",
2229
+ # agent_arns: ["AgentArn"],
2230
+ # mount_options: {
2231
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
2232
+ # },
2233
+ # })
2234
+ #
2235
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationSmb AWS API Documentation
2236
+ #
2237
+ # @overload update_location_smb(params = {})
2238
+ # @param [Hash] params ({})
2239
+ def update_location_smb(params = {}, options = {})
2240
+ req = build_request(:update_location_smb, params)
2241
+ req.send_request(options)
2242
+ end
2243
+
2003
2244
  # Updates the metadata associated with a task.
2004
2245
  #
2005
2246
  # @option params [required, String] :task_arn
@@ -2081,6 +2322,69 @@ module Aws::DataSync
2081
2322
  req.send_request(options)
2082
2323
  end
2083
2324
 
2325
+ # Updates execution of a task.
2326
+ #
2327
+ # You can modify bandwidth throttling for a task execution that is
2328
+ # running or queued. For more information, see [Adjusting Bandwidth
2329
+ # Throttling for a Task Execution][1].
2330
+ #
2331
+ # <note markdown="1"> The only `Option` that can be modified by `UpdateTaskExecution` is `
2332
+ # BytesPerSecond `.
2333
+ #
2334
+ # </note>
2335
+ #
2336
+ #
2337
+ #
2338
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#adjust-bandwidth-throttling
2339
+ #
2340
+ # @option params [required, String] :task_execution_arn
2341
+ # The Amazon Resource Name (ARN) of the specific task execution that is
2342
+ # being updated.
2343
+ #
2344
+ # @option params [required, Types::Options] :options
2345
+ # Represents the options that are available to control the behavior of a
2346
+ # StartTaskExecution operation. Behavior includes preserving metadata
2347
+ # such as user ID (UID), group ID (GID), and file permissions, and also
2348
+ # overwriting files in the destination, data integrity verification, and
2349
+ # so on.
2350
+ #
2351
+ # A task has a set of default options associated with it. If you don't
2352
+ # specify an option in StartTaskExecution, the default value is used.
2353
+ # You can override the defaults options on each task execution by
2354
+ # specifying an overriding `Options` value to StartTaskExecution.
2355
+ #
2356
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2357
+ #
2358
+ # @example Request syntax with placeholder values
2359
+ #
2360
+ # resp = client.update_task_execution({
2361
+ # task_execution_arn: "TaskExecutionArn", # required
2362
+ # options: { # required
2363
+ # verify_mode: "POINT_IN_TIME_CONSISTENT", # accepts POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
2364
+ # overwrite_mode: "ALWAYS", # accepts ALWAYS, NEVER
2365
+ # atime: "NONE", # accepts NONE, BEST_EFFORT
2366
+ # mtime: "NONE", # accepts NONE, PRESERVE
2367
+ # uid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2368
+ # gid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2369
+ # preserve_deleted_files: "PRESERVE", # accepts PRESERVE, REMOVE
2370
+ # preserve_devices: "NONE", # accepts NONE, PRESERVE
2371
+ # posix_permissions: "NONE", # accepts NONE, PRESERVE
2372
+ # bytes_per_second: 1,
2373
+ # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2374
+ # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2375
+ # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2376
+ # },
2377
+ # })
2378
+ #
2379
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecution AWS API Documentation
2380
+ #
2381
+ # @overload update_task_execution(params = {})
2382
+ # @param [Hash] params ({})
2383
+ def update_task_execution(params = {}, options = {})
2384
+ req = build_request(:update_task_execution, params)
2385
+ req.send_request(options)
2386
+ end
2387
+
2084
2388
  # @!endgroup
2085
2389
 
2086
2390
  # @param params ({})
@@ -2094,7 +2398,7 @@ module Aws::DataSync
2094
2398
  params: params,
2095
2399
  config: config)
2096
2400
  context[:gem_name] = 'aws-sdk-datasync'
2097
- context[:gem_version] = '1.26.0'
2401
+ context[:gem_version] = '1.31.0'
2098
2402
  Seahorse::Client::Request.new(handlers, context)
2099
2403
  end
2100
2404