aws-sdk-datasync 1.26.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6df012c3054935f1a7383c858e7d705aedb11e98af086f47ff45db56d9b60507
-  data.tar.gz: 88ff308a72fe61f2913010bfa581685a8cc0a216bf94c39b8d397744dfaea6fb
+  metadata.gz: 84b0365089ed38f2efe9bdc70c63897a9c8a0ee0ebe19ad976ebcc5f24486ce8
+  data.tar.gz: a55fb1baf57d783490606f94b25ab6c81ccf6e72340574a9ffc105234ae2a74f
 SHA512:
-  metadata.gz: 78eb1ad4c9ef06757818c7786ac19961b8902cceec6c61fb6a1a4a2eb04a8d64204246c6b670400aae9d981d0a1e0f766fd9f29dc55c8134073149683710539c
-  data.tar.gz: ad82c81f96476395ecd635be17f1a626d9c98bf977509cd8a79e6d74384f7ae55eea5a7dfe3960df8b84646959fa9aa048bb8836aacacdfec2195c06df815201
+  metadata.gz: fb18148ca66f67b8c91ae46e65507906d23247c42707854d608db90cd88e665854480185403f12f5b3878c46c3b2412a93ee608092291cd3863a84f1fcb2fbd6
+  data.tar.gz: b8be0d5359613cfd1f80663ae9b6727c23bd4bd1e53a0c79d9b9d828555221ec0a30004bf4bcbd52b76a35bd65f2d54a94b18b29ee76dfa7d3e3de468f7672d6

data/CHANGELOG.md

@@ -0,0 +1,168 @@
+Unreleased Changes
+------------------
+
+1.31.0 (2021-03-10)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.30.0 (2021-03-02)
+------------------
+
+* Feature - Additional API Support to update NFS/SMB/ObjectStorage locations
+
+1.29.0 (2021-02-02)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.28.0 (2020-11-09)
+------------------
+
+* Feature - DataSync now enables customers to adjust the network bandwidth used by a running AWS DataSync task.
+
+1.27.0 (2020-09-30)
+------------------
+
+* Feature - This release enables customers to create s3 location for S3 bucket's located on an AWS Outpost.
+
+1.26.0 (2020-09-15)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.25.0 (2020-08-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.24.0 (2020-08-18)
+------------------
+
+* Feature - DataSync support for filters as input arguments to the ListTasks and ListLocations API calls.
+
+1.23.0 (2020-07-27)
+------------------
+
+* Feature - Today AWS DataSync releases support for self-managed object storage Locations and the new TransferMode Option.
+
+1.22.0 (2020-06-23)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.21.1 (2020-06-11)
+------------------
+
+* Issue - Republish previous version with correct dependency on `aws-sdk-core`.
+
+1.21.0 (2020-06-10)
+------------------
+
+* Issue - This version has been yanked. (#2327).
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.20.0 (2020-05-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.19.0 (2020-05-07)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.18.0 (2020-03-09)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.17.0 (2020-01-24)
+------------------
+
+* Feature - AWS DataSync now supports FSx for Windows File Server Locations
+
+1.16.0 (2019-11-20)
+------------------
+
+* Feature - Update to configure task to run periodically on a schedule
+
+1.15.0 (2019-10-23)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.14.0 (2019-10-08)
+------------------
+
+* Feature - Add Sync options to enable/disable TaskQueueing
+
+1.13.0 (2019-09-24)
+------------------
+
+* Feature - Added S3StorageClass, OverwriteMode sync option, and ONLY_FILES_TRANSFERRED setting for the VerifyMode sync option.
+
+1.12.0 (2019-08-22)
+------------------
+
+* Feature - This release adds support for SMB location type.
+
+1.11.0 (2019-08-05)
+------------------
+
+* Feature - Support VPC endpoints.
+
+1.10.0 (2019-07-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.9.0 (2019-07-01)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.8.0 (2019-06-17)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.7.0 (2019-05-21)
+------------------
+
+* Feature - API update.
+
+1.6.0 (2019-05-15)
+------------------
+
+* Feature - API update.
+
+1.5.0 (2019-05-14)
+------------------
+
+* Feature - API update.
+
+1.4.0 (2019-05-13)
+------------------
+
+* Feature - API update.
+
+1.3.0 (2019-03-21)
+------------------
+
+* Feature - API update.
+
+1.2.0 (2019-03-18)
+------------------
+
+* Feature - API update.
+
+1.1.0 (2019-03-14)
+------------------
+
+* Feature - API update.
+
+1.0.0 (2018-11-26)
+------------------
+
+* Feature - Initial release of `aws-sdk-datasync`.

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/VERSION

@@ -0,0 +1 @@
+1.31.0

data/lib/aws-sdk-datasync.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.26.0'
+  GEM_VERSION = '1.31.0'
 
 end

data/lib/aws-sdk-datasync/client.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -378,7 +378,7 @@ module Aws::DataSync
     #
     # You can activate the agent in a VPC (virtual private cloud) or provide
     # the agent access to a VPC endpoint so you can run tasks without going
-    # over the public Internet.
+    # over the public internet.
     #
     # You can use an agent for more than one location. If a task uses
     # multiple agents, all of them need to have status AVAILABLE for the
@@ -557,20 +557,22 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates an endpoint for an Amazon FSx for Windows file system.
+    # Creates an endpoint for an Amazon FSx for Windows File Server file
+    # system.
     #
     # @option params [String] :subdirectory
     #   A subdirectory in the location’s path. This subdirectory in the Amazon
-    #   FSx for Windows file system is used to read data from the Amazon FSx
-    #   for Windows source location or write data to the FSx for Windows
-    #   destination.
+    #   FSx for Windows File Server file system is used to read data from the
+    #   Amazon FSx for Windows File Server source location or write data to
+    #   the FSx for Windows File Server destination.
     #
     # @option params [required, String] :fsx_filesystem_arn
-    #   The Amazon Resource Name (ARN) for the FSx for Windows file system.
+    #   The Amazon Resource Name (ARN) for the FSx for Windows File Server
+    #   file system.
     #
     # @option params [required, Array<String>] :security_group_arns
     #   The Amazon Resource Names (ARNs) of the security groups that are to
-    #   use to configure the FSx for Windows file system.
+    #   use to configure the FSx for Windows File Server file system.
     #
     # @option params [Array<Types::TagListEntry>] :tags
     #   The key-value pair that represents a tag that you want to add to the
@@ -580,15 +582,15 @@ module Aws::DataSync
     #
     # @option params [required, String] :user
     #   The user who has the permissions to access files and folders in the
-    #   FSx for Windows file system.
+    #   FSx for Windows File Server file system.
     #
     # @option params [String] :domain
-    #   The name of the Windows domain that the FSx for Windows server belongs
-    #   to.
+    #   The name of the Windows domain that the FSx for Windows File Server
+    #   belongs to.
     #
     # @option params [required, String] :password
     #   The password of the user who has the permissions to access files and
-    #   folders in the FSx for Windows file system.
+    #   folders in the FSx for Windows File Server file system.
     #
     # @return [Types::CreateLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -634,7 +636,7 @@ module Aws::DataSync
     #   subdirectory of that path. The path should be such that it can be
     #   mounted by other NFS clients in your network.
     #
-    #   To see all the paths exported by your NFS server. run "`showmount -e
+    #   To see all the paths exported by your NFS server, run "`showmount -e
     #   nfs-server-name`" from an NFS client that has access to your server.
     #   You can specify any directory that appears in the results, and any
     #   subdirectory of that directory. Ensure that the NFS export is
@@ -731,7 +733,9 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates an endpoint for a self-managed object storage bucket.
+    # Creates an endpoint for a self-managed object storage bucket. For more
+    # information about self-managed object storage locations, see
+    # create-object-location.
     #
     # @option params [required, String] :server_hostname
     #   The name of the self-managed object storage server. This value is the
@@ -759,11 +763,15 @@ module Aws::DataSync
     #
     # @option params [String] :access_key
     #   Optional. The access key is used if credentials are required to access
-    #   the self-managed object storage server.
+    #   the self-managed object storage server. If your object storage
+    #   requires a user name and password to authenticate, use `AccessKey` and
+    #   `SecretKey` to provide the user name and password, respectively.
     #
     # @option params [String] :secret_key
     #   Optional. The secret key is used if credentials are required to access
-    #   the self-managed object storage server.
+    #   the self-managed object storage server. If your object storage
+    #   requires a user name and password to authenticate, use `AccessKey` and
+    #   `SecretKey` to provide the user name and password, respectively.
     #
     # @option params [required, Array<String>] :agent_arns
     #   The Amazon Resource Name (ARN) of the agents associated with the
@@ -812,16 +820,9 @@ module Aws::DataSync
 
     # Creates an endpoint for an Amazon S3 bucket.
     #
-    # For AWS DataSync to access a destination S3 bucket, it needs an AWS
-    # Identity and Access Management (IAM) role that has the required
-    # permissions. You can set up the required permissions by creating an
-    # IAM policy that grants the required permissions and attaching the
-    # policy to the role. An example of such a policy is shown in the
-    # examples section.
-    #
     # For more information, see
-    # https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html#create-s3-location
-    # in the *AWS DataSync User Guide.*
+    # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
+    # in the *AWS DataSync User Guide*.
     #
     # @option params [String] :subdirectory
     #   A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -829,19 +830,22 @@ module Aws::DataSync
     #   S3 destination.
     #
     # @option params [required, String] :s3_bucket_arn
-    #   The Amazon Resource Name (ARN) of the Amazon S3 bucket.
+    #   The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
+    #   this must be an access point ARN.
     #
     # @option params [String] :s3_storage_class
     #   The Amazon S3 storage class that you want to store your files in when
-    #   this location is used as a task destination. For more information
-    #   about S3 storage classes, see [Amazon S3 Storage Classes][1] in the
-    #   *Amazon Simple Storage Service Developer Guide*. Some storage classes
-    #   have behaviors that can affect your S3 storage cost. For detailed
-    #   information, see using-storage-classes.
+    #   this location is used as a task destination. For buckets in AWS
+    #   Regions, the storage class defaults to Standard. For buckets on AWS
+    #   Outposts, the storage class defaults to AWS S3 Outposts.
+    #
+    #   For more information about S3 storage classes, see [Amazon S3 Storage
+    #   Classes][1]. Some storage classes have behaviors that can affect your
+    #   S3 storage cost. For detailed information, see using-storage-classes.
     #
     #
     #
-    #   [1]: https://aws.amazon.com/s3/storage-classes/
+    #   [1]: http://aws.amazon.com/s3/storage-classes/
     #
     # @option params [required, Types::S3Config] :s3_config
     #   The Amazon Resource Name (ARN) of the AWS Identity and Access
@@ -850,6 +854,12 @@ module Aws::DataSync
     #   For detailed information about using such a role, see Creating a
     #   Location for Amazon S3 in the *AWS DataSync User Guide*.
     #
+    # @option params [Array<String>] :agent_arns
+    #   If you are using DataSync on an AWS Outpost, specify the Amazon
+    #   Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
+    #   For more information about launching a DataSync agent on an AWS
+    #   Outpost, see outposts-agent.
+    #
     # @option params [Array<Types::TagListEntry>] :tags
     #   The key-value pair that represents the tag that you want to add to the
     #   location. The value can be an empty string. We recommend using tags to
@@ -864,10 +874,11 @@ module Aws::DataSync
     #   resp = client.create_location_s3({
     #     subdirectory: "S3Subdirectory",
     #     s3_bucket_arn: "S3BucketArn", # required
-    #     s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
+    #     s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
     #     s3_config: { # required
     #       bucket_access_role_arn: "IamRoleArn", # required
     #     },
+    #     agent_arns: ["AgentArn"],
     #     tags: [
     #       {
     #         key: "TagKey", # required
@@ -984,24 +995,30 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Creates a task. A task is a set of two locations (source and
-    # destination) and a set of Options that you use to control the behavior
-    # of a task. If you don't specify Options when you create a task, AWS
-    # DataSync populates them with service defaults.
-    #
-    # When you create a task, it first enters the CREATING state. During
-    # CREATING AWS DataSync attempts to mount the on-premises Network File
-    # System (NFS) location. The task transitions to the AVAILABLE state
-    # without waiting for the AWS location to become mounted. If required,
-    # AWS DataSync mounts the AWS location before each task execution.
-    #
-    # If an agent that is associated with a source (NFS) location goes
-    # offline, the task transitions to the UNAVAILABLE status. If the status
-    # of the task remains in the CREATING status for more than a few
-    # minutes, it means that your agent might be having trouble mounting the
-    # source NFS file system. Check the task's ErrorCode and ErrorDetail.
-    # Mount issues are often caused by either a misconfigured firewall or a
-    # mistyped NFS server host name.
+    # Creates a task.
+    #
+    # A task includes a source location and a destination location, and a
+    # configuration that specifies how data is transferred. A task always
+    # transfers data from the source location to the destination location.
+    # The configuration specifies options such as task scheduling, bandwidth
+    # limits, etc. A task is the complete definition of a data transfer.
+    #
+    # When you create a task that transfers data between AWS services in
+    # different AWS Regions, one of the two locations that you specify must
+    # reside in the Region where DataSync is being used. The other location
+    # must be specified in a different Region.
+    #
+    # You can transfer data between commercial AWS Regions except for China,
+    # or between AWS GovCloud (US-East and US-West) Regions.
+    #
+    # When you use DataSync to copy files or objects between AWS Regions,
+    # you pay for data transfer between Regions. This is billed as data
+    # transfer OUT from your source Region to your destination Region. For
+    # more information, see [Data Transfer pricing][1].
+    #
+    #
+    #
+    # [1]: http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer
     #
     # @option params [required, String] :source_location_arn
     #   The Amazon Resource Name (ARN) of the source location for the task.
@@ -1032,7 +1049,7 @@ module Aws::DataSync
     #   A list of filter rules that determines which files to exclude from a
     #   task. The list should contain a single filter string that consists of
     #   the patterns to exclude. The patterns are delimited by "\|" (that
-    #   is, a pipe), for example, `"/folder1|/folder2"`
+    #   is, a pipe), for example, `"/folder1|/folder2"`.
     #
     # @option params [Types::TaskSchedule] :schedule
     #   Specifies a schedule used to periodically transfer files from a source
@@ -1257,11 +1274,11 @@ module Aws::DataSync
     end
 
     # Returns metadata, such as the path information about an Amazon FSx for
-    # Windows location.
+    # Windows File Server location.
     #
     # @option params [required, String] :location_arn
-    #   The Amazon Resource Name (ARN) of the FSx for Windows location to
-    #   describe.
+    #   The Amazon Resource Name (ARN) of the FSx for Windows File Server
+    #   location to describe.
     #
     # @return [Types::DescribeLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1335,6 +1352,8 @@ module Aws::DataSync
     end
 
     # Returns metadata about a self-managed object storage server location.
+    # For more information about self-managed object storage locations, see
+    # create-object-location.
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1389,6 +1408,7 @@ module Aws::DataSync
     #   * {Types::DescribeLocationS3Response#location_uri #location_uri} => String
     #   * {Types::DescribeLocationS3Response#s3_storage_class #s3_storage_class} => String
     #   * {Types::DescribeLocationS3Response#s3_config #s3_config} => Types::S3Config
+    #   * {Types::DescribeLocationS3Response#agent_arns #agent_arns} => Array&lt;String&gt;
     #   * {Types::DescribeLocationS3Response#creation_time #creation_time} => Time
     #
     # @example Request syntax with placeholder values
@@ -1401,8 +1421,10 @@ module Aws::DataSync
     #
     #   resp.location_arn #=> String
     #   resp.location_uri #=> String
-    #   resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE"
+    #   resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
     #   resp.s3_config.bucket_access_role_arn #=> String
+    #   resp.agent_arns #=> Array
+    #   resp.agent_arns[0] #=> String
     #   resp.creation_time #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationS3 AWS API Documentation
@@ -1668,6 +1690,10 @@ module Aws::DataSync
     #   next list of locations.
     #
     # @option params [Array<Types::LocationFilter>] :filters
+    #   You can use API filters to narrow down the list of resources returned
+    #   by `ListLocations`. For example, to retrieve all tasks on a specific
+    #   source location, you can use `ListLocations` with filter name
+    #   `LocationType S3` and `Operator Equals`.
     #
     # @return [Types::ListLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1803,6 +1829,10 @@ module Aws::DataSync
     #   next list of tasks.
     #
     # @option params [Array<Types::TaskFilter>] :filters
+    #   You can use API filters to narrow down the list of resources returned
+    #   by `ListTasks`. For example, to retrieve all tasks on a specific
+    #   source location, you can use `ListTasks` with filter name `LocationId`
+    #   and `Operator Equals` with the ARN for the location.
     #
     # @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2000,6 +2030,217 @@ module Aws::DataSync
       req.send_request(options)
     end
 
+    # Updates some of the parameters of a previously created location for
+    # Network File System (NFS) access. For information about creating an
+    # NFS location, see create-nfs-location.
+    #
+    # @option params [required, String] :location_arn
+    #   The Amazon Resource Name (ARN) of the NFS location to update.
+    #
+    # @option params [String] :subdirectory
+    #   The subdirectory in the NFS file system that is used to read data from
+    #   the NFS source location or write data to the NFS destination. The NFS
+    #   path should be a path that's exported by the NFS server, or a
+    #   subdirectory of that path. The path should be such that it can be
+    #   mounted by other NFS clients in your network.
+    #
+    #   To see all the paths exported by your NFS server, run "`showmount -e
+    #   nfs-server-name`" from an NFS client that has access to your server.
+    #   You can specify any directory that appears in the results, and any
+    #   subdirectory of that directory. Ensure that the NFS export is
+    #   accessible without Kerberos authentication.
+    #
+    #   To transfer all the data in the folder that you specified, DataSync
+    #   must have permissions to read all the data. To ensure this, either
+    #   configure the NFS export with `no_root_squash`, or ensure that the
+    #   files you want DataSync to access have permissions that allow read
+    #   access for all users. Doing either option enables the agent to read
+    #   the files. For the agent to access directories, you must additionally
+    #   enable all execute access.
+    #
+    #   If you are copying data to or from your AWS Snowcone device, see [NFS
+    #   Server on AWS Snowcone][1] for more information.
+    #
+    #   For information about NFS export configuration, see 18.7. The
+    #   /etc/exports Configuration File in the Red Hat Enterprise Linux
+    #   documentation.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
+    #
+    # @option params [Types::OnPremConfig] :on_prem_config
+    #   A list of Amazon Resource Names (ARNs) of agents to use for a Network
+    #   File System (NFS) location.
+    #
+    # @option params [Types::NfsMountOptions] :mount_options
+    #   Represents the mount options that are available for DataSync to access
+    #   an NFS location.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_location_nfs({
+    #     location_arn: "LocationArn", # required
+    #     subdirectory: "NfsSubdirectory",
+    #     on_prem_config: {
+    #       agent_arns: ["AgentArn"], # required
+    #     },
+    #     mount_options: {
+    #       version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationNfs AWS API Documentation
+    #
+    # @overload update_location_nfs(params = {})
+    # @param [Hash] params ({})
+    def update_location_nfs(params = {}, options = {})
+      req = build_request(:update_location_nfs, params)
+      req.send_request(options)
+    end
+
+    # Updates some of the parameters of a previously created location for
+    # self-managed object storage server access. For information about
+    # creating a self-managed object storage location, see
+    # create-object-location.
+    #
+    # @option params [required, String] :location_arn
+    #   The Amazon Resource Name (ARN) of the self-managed object storage
+    #   server location to be updated.
+    #
+    # @option params [Integer] :server_port
+    #   The port that your self-managed object storage server accepts inbound
+    #   network traffic on. The server port is set by default to TCP 80 (HTTP)
+    #   or TCP 443 (HTTPS). You can specify a custom port if your self-managed
+    #   object storage server requires one.
+    #
+    # @option params [String] :server_protocol
+    #   The protocol that the object storage server uses to communicate. Valid
+    #   values are `HTTP` or `HTTPS`.
+    #
+    # @option params [String] :subdirectory
+    #   The subdirectory in the self-managed object storage server that is
+    #   used to read data from.
+    #
+    # @option params [String] :access_key
+    #   Optional. The access key is used if credentials are required to access
+    #   the self-managed object storage server. If your object storage
+    #   requires a user name and password to authenticate, use `AccessKey` and
+    #   `SecretKey` to provide the user name and password, respectively.
+    #
+    # @option params [String] :secret_key
+    #   Optional. The secret key is used if credentials are required to access
+    #   the self-managed object storage server. If your object storage
+    #   requires a user name and password to authenticate, use `AccessKey` and
+    #   `SecretKey` to provide the user name and password, respectively.
+    #
+    # @option params [Array<String>] :agent_arns
+    #   The Amazon Resource Name (ARN) of the agents associated with the
+    #   self-managed object storage server location.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_location_object_storage({
+    #     location_arn: "LocationArn", # required
+    #     server_port: 1,
+    #     server_protocol: "HTTPS", # accepts HTTPS, HTTP
+    #     subdirectory: "S3Subdirectory",
+    #     access_key: "ObjectStorageAccessKey",
+    #     secret_key: "ObjectStorageSecretKey",
+    #     agent_arns: ["AgentArn"],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorage AWS API Documentation
+    #
+    # @overload update_location_object_storage(params = {})
+    # @param [Hash] params ({})
+    def update_location_object_storage(params = {}, options = {})
+      req = build_request(:update_location_object_storage, params)
+      req.send_request(options)
+    end
+
+    # Updates some of the parameters of a previously created location for
+    # Server Message Block (SMB) file system access. For information about
+    # creating an SMB location, see create-smb-location.
+    #
+    # @option params [required, String] :location_arn
+    #   The Amazon Resource Name (ARN) of the SMB location to update.
+    #
+    # @option params [String] :subdirectory
+    #   The subdirectory in the SMB file system that is used to read data from
+    #   the SMB source location or write data to the SMB destination. The SMB
+    #   path should be a path that's exported by the SMB server, or a
+    #   subdirectory of that path. The path should be such that it can be
+    #   mounted by other SMB clients in your network.
+    #
+    #   <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
+    #   `/path/to/folder`.
+    #
+    #    </note>
+    #
+    #   To transfer all the data in the folder that you specified, DataSync
+    #   must have permissions to mount the SMB share and to access all the
+    #   data in that share. To ensure this, do either of the following:
+    #
+    #   * Ensure that the user/password specified belongs to the user who can
+    #     mount the share and who has the appropriate permissions for all of
+    #     the files and directories that you want DataSync to access.
+    #
+    #   * Use credentials of a member of the Backup Operators group to mount
+    #     the share.
+    #
+    #   Doing either of these options enables the agent to access the data.
+    #   For the agent to access directories, you must also enable all execute
+    #   access.
+    #
+    # @option params [String] :user
+    #   The user who can mount the share has the permissions to access files
+    #   and folders in the SMB share.
+    #
+    # @option params [String] :domain
+    #   The name of the Windows domain that the SMB server belongs to.
+    #
+    # @option params [String] :password
+    #   The password of the user who can mount the share has the permissions
+    #   to access files and folders in the SMB share.
+    #
+    # @option params [Array<String>] :agent_arns
+    #   The Amazon Resource Names (ARNs) of agents to use for a Simple Message
+    #   Block (SMB) location.
+    #
+    # @option params [Types::SmbMountOptions] :mount_options
+    #   Represents the mount options that are available for DataSync to access
+    #   an SMB location.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_location_smb({
+    #     location_arn: "LocationArn", # required
+    #     subdirectory: "SmbSubdirectory",
+    #     user: "SmbUser",
+    #     domain: "SmbDomain",
+    #     password: "SmbPassword",
+    #     agent_arns: ["AgentArn"],
+    #     mount_options: {
+    #       version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationSmb AWS API Documentation
+    #
+    # @overload update_location_smb(params = {})
+    # @param [Hash] params ({})
+    def update_location_smb(params = {}, options = {})
+      req = build_request(:update_location_smb, params)
+      req.send_request(options)
+    end
+
     # Updates the metadata associated with a task.
     #
     # @option params [required, String] :task_arn
@@ -2081,6 +2322,69 @@ module Aws::DataSync
       req.send_request(options)
     end
 
+    # Updates execution of a task.
+    #
+    # You can modify bandwidth throttling for a task execution that is
+    # running or queued. For more information, see [Adjusting Bandwidth
+    # Throttling for a Task Execution][1].
+    #
+    # <note markdown="1"> The only `Option` that can be modified by `UpdateTaskExecution` is `
+    # BytesPerSecond `.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#adjust-bandwidth-throttling
+    #
+    # @option params [required, String] :task_execution_arn
+    #   The Amazon Resource Name (ARN) of the specific task execution that is
+    #   being updated.
+    #
+    # @option params [required, Types::Options] :options
+    #   Represents the options that are available to control the behavior of a
+    #   StartTaskExecution operation. Behavior includes preserving metadata
+    #   such as user ID (UID), group ID (GID), and file permissions, and also
+    #   overwriting files in the destination, data integrity verification, and
+    #   so on.
+    #
+    #   A task has a set of default options associated with it. If you don't
+    #   specify an option in StartTaskExecution, the default value is used.
+    #   You can override the defaults options on each task execution by
+    #   specifying an overriding `Options` value to StartTaskExecution.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_task_execution({
+    #     task_execution_arn: "TaskExecutionArn", # required
+    #     options: { # required
+    #       verify_mode: "POINT_IN_TIME_CONSISTENT", # accepts POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
+    #       overwrite_mode: "ALWAYS", # accepts ALWAYS, NEVER
+    #       atime: "NONE", # accepts NONE, BEST_EFFORT
+    #       mtime: "NONE", # accepts NONE, PRESERVE
+    #       uid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
+    #       gid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
+    #       preserve_deleted_files: "PRESERVE", # accepts PRESERVE, REMOVE
+    #       preserve_devices: "NONE", # accepts NONE, PRESERVE
+    #       posix_permissions: "NONE", # accepts NONE, PRESERVE
+    #       bytes_per_second: 1,
+    #       task_queueing: "ENABLED", # accepts ENABLED, DISABLED
+    #       log_level: "OFF", # accepts OFF, BASIC, TRANSFER
+    #       transfer_mode: "CHANGED", # accepts CHANGED, ALL
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecution AWS API Documentation
+    #
+    # @overload update_task_execution(params = {})
+    # @param [Hash] params ({})
+    def update_task_execution(params = {}, options = {})
+      req = build_request(:update_task_execution, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2094,7 +2398,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.26.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end