aws-sdk-datasync 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d83ad5e535baadd8965d0eaf704dde8dbf8d490a3975931d88511e911c54607d
-  data.tar.gz: cfb2aade0386045aa2853da19936b0cb2ea1fcff3266f28606c2012231ac685c
+  metadata.gz: d4aa366df197fce94f0c5f363e85ef61631b06fa386f25fd009e952116907ade
+  data.tar.gz: 89abf22f756f4d969aeaade954b00d05db4bd57598a434c39a20d4ace4166181
 SHA512:
-  metadata.gz: 909505ea91fa56eadc9be3ff804b0594885bc6977947390db5f914715f86763d6d4e7fdb9d7fa8fc555ad9f0dd7fdc87a2bc8c78f17e3eff9846f8abf382b0b9
-  data.tar.gz: 1d925b2989e6cd09833adf79d4cc2d39ef725e93ae563c2d482fe9d57cbd313ba6959e0adbe92d0ec2ecf43173a6048ad6aefe550a7d6a9c1db39fa507d7ec1b
+  metadata.gz: 991548c048af831cbef90ea3dc158a3e04c2a5124a0688377fe26007608afa7c7c3f691861dfe30ff15c6afea289e55b2062ea29f0cb3cd767f5d547ae226895
+  data.tar.gz: 58d823bbcbabaaacc59e06668e317d06baec14e2a5fbff4b4d77ad3c564140a91fa6ec7bccff697a82a230dff8e2f90399cc998f2509d8b8bccaf33fa8a1da60

data/lib/aws-sdk-datasync.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.27.0'
+  GEM_VERSION = '1.28.0'
 
 end

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

@@ -634,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
@@ -828,8 +828,8 @@ module Aws::DataSync
     #   S3 destination.
     #
     # @option params [required, String] :s3_bucket_arn
-    #   The Amazon Resource Name (ARN) of the Amazon S3 bucket. If the bucket
-    #   is on an AWS Outpost, this must be an access point ARN.
+    #   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
@@ -838,13 +838,12 @@ module Aws::DataSync
     #   Outposts, the storage class defaults to AWS S3 Outposts.
     #
     #   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/
     #
     # @option params [required, Types::S3Config] :s3_config
     #   The Amazon Resource Name (ARN) of the AWS Identity and Access
@@ -855,9 +854,9 @@ module Aws::DataSync
     #
     # @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 AWS
-    #   Outpost. For more information about launching a DataSync agent on an
-    #   Amazon Outpost, see outposts-agent.
+    #   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
@@ -1042,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
@@ -2104,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 ({})
@@ -2117,7 +2179,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.28.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')
@@ -605,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"))
@@ -974,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
@@ -610,8 +610,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] s3_bucket_arn
-    #   The Amazon Resource Name (ARN) of the Amazon S3 bucket. If the
-    #   bucket is on an AWS Outpost, this must be an access point ARN.
+    #   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
@@ -621,13 +621,13 @@ module Aws::DataSync
     #   Outposts, the storage class defaults to AWS S3 Outposts.
     #
     #   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.
+    #   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
@@ -640,9 +640,9 @@ module Aws::DataSync
     #
     # @!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 AWS
+    #   Resource Names (ARNs) of the DataSync agents deployed on your
     #   Outpost. For more information about launching a DataSync agent on an
-    #   Amazon Outpost, see outposts-agent.
+    #   AWS Outpost, see outposts-agent.
     #   @return [Array<String>]
     #
     # @!attribute [rw] tags
@@ -873,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
@@ -1354,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
@@ -1372,10 +1372,10 @@ module Aws::DataSync
     #   @return [Types::S3Config]
     #
     # @!attribute [rw] agent_arns
-    #   If you are using DataSync on an Amazon Outpost, the Amazon Resource
-    #   Name (ARNs) of the EC2 agents deployed on your AWS Outpost. For more
-    #   information about launching a DataSync agent on an Amazon Outpost,
-    #   see outposts-agent.
+    #   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
@@ -1627,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
@@ -2782,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
@@ -2791,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
@@ -2980,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.27.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-30 00:00:00.000000000 Z
+date: 2020-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core