aws-sdk-datasync 1.24.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd4e4eb52922e40de3ae28c044d2bc79d49441c7b7417850bab6f2bc178b6acc
-  data.tar.gz: 1adadb23cdfa68167b747d141f75e4e89e3bb3dbb6c3c7918adfc85d0a6ade33
+  metadata.gz: 477d29f30c67e3ba76889dfcfd78a185b84b950df12a2c25fbd73b9d3d974f41
+  data.tar.gz: 241b2e0d28a1bdccf8b8f17bb9eef4dc737c9413589d12237ecd64cab61d72a1
 SHA512:
-  metadata.gz: 980ea1cd0713826eba119a0ac462e5fda8e747ba82f700b401cd5a6f1f33d656c97d358e519722d3e2e500af6723b5a2a153bcc26fba14c16e5ed587207e37f0
-  data.tar.gz: 5e0a259bef0c5d0910d366f84eb8519f9588aa31b42e58fcbe1778e97d3a4a666b85fdb2348ca80d77272d68b9268c7a0bff2863354b9c35bddaa770ed678cc4
+  metadata.gz: 9d516e19ee6693bfebea42cb8c84051e9717570a0eec4a0127f89b8ea4f6d9ec58fb0ed78920f41c86d816025f2f54a79a8c408f2b16b2618d3b9e6511762768
+  data.tar.gz: 3eee6c35dc8dadbc3231ea1729ef46059ab4f81aa6d48da798a3b849b7a22ba11eadcaeb05933676e90827483c36024d3420ee558810dc5e8a4b26f7234058e9

data/lib/aws-sdk-datasync.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-datasync/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.29.0'
 
 end

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

@@ -85,13 +85,28 @@ module Aws::DataSync
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::DataSync
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -363,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
@@ -619,7 +634,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
@@ -716,7 +731,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
@@ -744,11 +761,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
@@ -797,16 +818,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
@@ -814,19 +828,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
@@ -835,6 +852,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
@@ -849,10 +872,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
@@ -986,7 +1010,7 @@ module Aws::DataSync
     # 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.
+    # mistyped NFS server hostname.
     #
     # @option params [required, String] :source_location_arn
     #   The Amazon Resource Name (ARN) of the source location for the task.
@@ -1017,7 +1041,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
@@ -1320,6 +1344,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
@@ -1374,6 +1400,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
@@ -1386,8 +1413,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
@@ -1653,6 +1682,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:
     #
@@ -1788,6 +1821,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:
     #
@@ -2066,6 +2103,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/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 ({})
@@ -2079,7 +2179,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -172,6 +172,8 @@ module Aws::DataSync
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateAgentRequest = Shapes::StructureShape.new(name: 'UpdateAgentRequest')
     UpdateAgentResponse = Shapes::StructureShape.new(name: 'UpdateAgentResponse')
+    UpdateTaskExecutionRequest = Shapes::StructureShape.new(name: 'UpdateTaskExecutionRequest')
+    UpdateTaskExecutionResponse = Shapes::StructureShape.new(name: 'UpdateTaskExecutionResponse')
     UpdateTaskRequest = Shapes::StructureShape.new(name: 'UpdateTaskRequest')
     UpdateTaskResponse = Shapes::StructureShape.new(name: 'UpdateTaskResponse')
     VerifyMode = Shapes::StringShape.new(name: 'VerifyMode')
@@ -253,6 +255,7 @@ module Aws::DataSync
     CreateLocationS3Request.add_member(:s3_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "S3BucketArn"))
     CreateLocationS3Request.add_member(:s3_storage_class, Shapes::ShapeRef.new(shape: S3StorageClass, location_name: "S3StorageClass"))
     CreateLocationS3Request.add_member(:s3_config, Shapes::ShapeRef.new(shape: S3Config, required: true, location_name: "S3Config"))
+    CreateLocationS3Request.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, location_name: "AgentArns"))
     CreateLocationS3Request.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
     CreateLocationS3Request.struct_class = Types::CreateLocationS3Request
 
@@ -361,6 +364,7 @@ module Aws::DataSync
     DescribeLocationS3Response.add_member(:location_uri, Shapes::ShapeRef.new(shape: LocationUri, location_name: "LocationUri"))
     DescribeLocationS3Response.add_member(:s3_storage_class, Shapes::ShapeRef.new(shape: S3StorageClass, location_name: "S3StorageClass"))
     DescribeLocationS3Response.add_member(:s3_config, Shapes::ShapeRef.new(shape: S3Config, location_name: "S3Config"))
+    DescribeLocationS3Response.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, location_name: "AgentArns"))
     DescribeLocationS3Response.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
     DescribeLocationS3Response.struct_class = Types::DescribeLocationS3Response
 
@@ -603,6 +607,12 @@ module Aws::DataSync
 
     UpdateAgentResponse.struct_class = Types::UpdateAgentResponse
 
+    UpdateTaskExecutionRequest.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, required: true, location_name: "TaskExecutionArn"))
+    UpdateTaskExecutionRequest.add_member(:options, Shapes::ShapeRef.new(shape: Options, required: true, location_name: "Options"))
+    UpdateTaskExecutionRequest.struct_class = Types::UpdateTaskExecutionRequest
+
+    UpdateTaskExecutionResponse.struct_class = Types::UpdateTaskExecutionResponse
+
     UpdateTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
     UpdateTaskRequest.add_member(:options, Shapes::ShapeRef.new(shape: Options, location_name: "Options"))
     UpdateTaskRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
@@ -972,6 +982,16 @@ module Aws::DataSync
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: InternalException)
       end)
+
+      api.add_operation(:update_task_execution, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateTaskExecution"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: UpdateTaskExecutionRequest)
+        o.output = Shapes::ShapeRef.new(shape: UpdateTaskExecutionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalException)
+      end)
     end
 
   end

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

@@ -379,7 +379,7 @@ module Aws::DataSync
     #   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
+    #   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
@@ -526,12 +526,18 @@ module Aws::DataSync
     #
     # @!attribute [rw] access_key
     #   Optional. The access key is used if credentials are required to
-    #   access the self-managed object storage server.
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] secret_key
     #   Optional. The secret key is used if credentials are required to
-    #   access the self-managed object storage server.
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] agent_arns
@@ -584,10 +590,11 @@ module Aws::DataSync
     #       {
     #         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
@@ -603,20 +610,24 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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.
     #   @return [String]
     #
     # @!attribute [rw] 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.
+    #   when 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/
     #   @return [String]
     #
     # @!attribute [rw] s3_config
@@ -627,6 +638,13 @@ module Aws::DataSync
     #   Location for Amazon S3 in the *AWS DataSync User Guide*.
     #   @return [Types::S3Config]
     #
+    # @!attribute [rw] 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.
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] 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
@@ -640,6 +658,7 @@ module Aws::DataSync
       :s3_bucket_arn,
       :s3_storage_class,
       :s3_config,
+      :agent_arns,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -854,7 +873,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"`
+    #   (that is, a pipe), for example, `"/folder1|/folder2"`.
     #   @return [Array<Types::FilterRule>]
     #
     # @!attribute [rw] schedule
@@ -1257,7 +1276,10 @@ module Aws::DataSync
     #
     # @!attribute [rw] access_key
     #   Optional. The access key is used if credentials are required to
-    #   access the self-managed object storage server.
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] server_port
@@ -1320,7 +1342,8 @@ module Aws::DataSync
     # DescribeLocationS3Response
     #
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the Amazon S3 bucket location.
+    #   The Amazon Resource Name (ARN) of the Amazon S3 bucket or access
+    #   point.
     #   @return [String]
     #
     # @!attribute [rw] location_uri
@@ -1331,13 +1354,13 @@ module Aws::DataSync
     #   The Amazon S3 storage class that you chose 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.
+    #   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/
     #   @return [String]
     #
     # @!attribute [rw] s3_config
@@ -1348,6 +1371,13 @@ module Aws::DataSync
     #   Location for Amazon S3 in the *AWS DataSync User Guide*.
     #   @return [Types::S3Config]
     #
+    # @!attribute [rw] agent_arns
+    #   If you are using DataSync on an AWS Outpost, the Amazon Resource
+    #   Name (ARNs) of the EC2 agents deployed on your Outpost. For more
+    #   information about launching a DataSync agent on an AWS Outpost, see
+    #   outposts-agent.
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] creation_time
     #   The time that the Amazon S3 bucket location was created.
     #   @return [Time]
@@ -1359,6 +1389,7 @@ module Aws::DataSync
       :location_uri,
       :s3_storage_class,
       :s3_config,
+      :agent_arns,
       :creation_time)
       SENSITIVE = []
       include Aws::Structure
@@ -1596,7 +1627,7 @@ module Aws::DataSync
     #   The status of the task that was described.
     #
     #   For detailed information about task execution statuses, see
-    #   Understanding Task Statuses in the *AWS DataSync User Guide.*
+    #   Understanding Task Statuses in the *AWS DataSync User Guide*.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -1870,6 +1901,10 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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 [Array<Types::LocationFilter>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListLocationsRequest AWS API Documentation
@@ -2038,6 +2073,10 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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 [Array<Types::TaskFilter>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasksRequest AWS API Documentation
@@ -2070,6 +2109,11 @@ module Aws::DataSync
       include Aws::Structure
     end
 
+    # You can use API filters to narrow down the list of resources returned
+    # by `ListLocations`. For example, to retrieve all your Amazon S3
+    # locations, you can use `ListLocations` with filter name `LocationType
+    # S3` and `Operator Equals`.
+    #
     # @note When making an API call, you may pass LocationFilter
     #   data as a hash:
     #
@@ -2080,12 +2124,20 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] name
+    #   The name of the filter being used. Each API call supports a list of
+    #   filters that are available for it (for example, `LocationType` for
+    #   `ListLocations`).
     #   @return [String]
     #
     # @!attribute [rw] values
+    #   The values that you want to filter for. For example, you might want
+    #   to display only Amazon S3 locations.
     #   @return [Array<String>]
     #
     # @!attribute [rw] operator
+    #   The operator that is used to compare filter values (for example,
+    #   `Equals` or `Contains`). For more about API filtering operators, see
+    #   query-resources.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/LocationFilter AWS API Documentation
@@ -2192,7 +2244,7 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] agent_arns
-    #   ARNs)of the agents to use for an NFS location.
+    #   ARNs of the agents to use for an NFS location.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/OnPremConfig AWS API Documentation
@@ -2414,11 +2466,17 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] transfer_mode
-    #   TransferMode has two values: CHANGED and ALL. CHANGED performs an
-    #   "incremental" or "delta sync", it compares file modification
-    #   time between source and destination to determine which files need to
-    #   be transferred. ALL skips destination inventory and transfers all
-    #   files discovered on the source.
+    #   A value that determines whether DataSync transfers only the data and
+    #   metadata that differ between the source and the destination
+    #   location, or whether DataSync transfers all the content from the
+    #   source, without comparing to the destination location.
+    #
+    #   CHANGED: DataSync copies only data or metadata that is new or
+    #   different content from the source location to the destination
+    #   location.
+    #
+    #   ALL: DataSync copies all source location content to the destination,
+    #   without comparing to existing content on the destination.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Options AWS API Documentation
@@ -2724,7 +2782,7 @@ module Aws::DataSync
     #   @return [Integer]
     #
     # @!attribute [rw] transfer_status
-    #   The status of the TRANSFERRING Phase.
+    #   The status of the TRANSFERRING phase.
     #   @return [String]
     #
     # @!attribute [rw] verify_duration
@@ -2733,7 +2791,7 @@ module Aws::DataSync
     #   @return [Integer]
     #
     # @!attribute [rw] verify_status
-    #   The status of the VERIFYING Phase.
+    #   The status of the VERIFYING phase.
     #   @return [String]
     #
     # @!attribute [rw] error_code
@@ -2763,6 +2821,11 @@ module Aws::DataSync
       include Aws::Structure
     end
 
+    # You can use API filters to narrow down the list of resources returned
+    # by `ListTasks`. For example, to retrieve all tasks on a source
+    # location, you can use `ListTasks` with filter name `LocationId` and
+    # `Operator Equals` with the ARN for the location.
+    #
     # @note When making an API call, you may pass TaskFilter
     #   data as a hash:
     #
@@ -2773,12 +2836,20 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] name
+    #   The name of the filter being used. Each API call supports a list of
+    #   filters that are available for it. For example, `LocationId` for
+    #   `ListTasks`.
     #   @return [String]
     #
     # @!attribute [rw] values
+    #   The values that you want to filter for. For example, you might want
+    #   to display only tasks for a specific destination location.
     #   @return [Array<String>]
     #
     # @!attribute [rw] operator
+    #   The operator that is used to compare filter values (for example,
+    #   `Equals` or `Contains`). For more about API filtering operators, see
+    #   query-resources.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskFilter AWS API Documentation
@@ -2909,6 +2980,59 @@ module Aws::DataSync
     #
     class UpdateAgentResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass UpdateTaskExecutionRequest
+    #   data as a hash:
+    #
+    #       {
+    #         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
+    #         },
+    #       }
+    #
+    # @!attribute [rw] task_execution_arn
+    #   The Amazon Resource Name (ARN) of the specific task execution that
+    #   is being updated.
+    #   @return [String]
+    #
+    # @!attribute [rw] 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 [Types::Options]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecutionRequest AWS API Documentation
+    #
+    class UpdateTaskExecutionRequest < Struct.new(
+      :task_execution_arn,
+      :options)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecutionResponse AWS API Documentation
+    #
+    class UpdateTaskExecutionResponse < Aws::EmptyStructure; end
+
     # UpdateTaskResponse
     #
     # @note When making an API call, you may pass UpdateTaskRequest

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.29.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-18 00:00:00.000000000 Z
+date: 2021-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.112.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.112.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement