aws-sdk-datasync 1.31.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84b0365089ed38f2efe9bdc70c63897a9c8a0ee0ebe19ad976ebcc5f24486ce8
-  data.tar.gz: a55fb1baf57d783490606f94b25ab6c81ccf6e72340574a9ffc105234ae2a74f
+  metadata.gz: 52bb9433850f9f998989a9e482c46e314dc4a0906459c85166533e80bbcf0961
+  data.tar.gz: 38d900eb7fff4c58a0a615f2421fa019fb7d9e9132517e0d740f8a7c39b58815
 SHA512:
-  metadata.gz: fb18148ca66f67b8c91ae46e65507906d23247c42707854d608db90cd88e665854480185403f12f5b3878c46c3b2412a93ee608092291cd3863a84f1fcb2fbd6
-  data.tar.gz: b8be0d5359613cfd1f80663ae9b6727c23bd4bd1e53a0c79d9b9d828555221ec0a30004bf4bcbd52b76a35bd65f2d54a94b18b29ee76dfa7d3e3de468f7672d6
+  metadata.gz: b5219a8bf2d78110b2c35809696bc37da55ad7e1c4c3d9f2a3f12b8e734065375f23e1818f94164ff13e712a1350036bb3c2d4136192b5804a2f4027a037f4d9
+  data.tar.gz: 66866314a79aafce49696d41869dcef5a43c9f86a7855fedac06cfd516e2273d133925881bafbf62fced99b21726a7f48c4917f17da60a03b195972ef25023e8

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.35.0 (2021-08-25)
+------------------
+
+* Feature - Added include filters to CreateTask and UpdateTask, and added exclude filters to StartTaskExecution, giving customers more granular control over how DataSync transfers files, folders, and objects.
+
+1.34.0 (2021-07-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.33.0 (2021-07-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.32.0 (2021-05-28)
+------------------
+
+* Feature - Added SecurityDescriptorCopyFlags option that allows for control of which components of SMB security descriptors are copied from source to destination objects.
+
 1.31.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.31.0
+1.35.0

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

@@ -346,8 +346,8 @@ module Aws::DataSync
     # you allow the task execution to complete, file content on the
     # destination is complete and consistent. This applies to other
     # unexpected failures that interrupt a task execution. In all of these
-    # cases, AWS DataSync successfully complete the transfer when you start
-    # the next task execution.
+    # cases, DataSync successfully complete the transfer when you start the
+    # next task execution.
     #
     # @option params [required, String] :task_execution_arn
     #   The Amazon Resource Name (ARN) of the task execution to cancel.
@@ -369,12 +369,13 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Activates an AWS DataSync agent that you have deployed on your host.
-    # The activation process associates your agent with your account. In the
-    # activation process, you specify information such as the AWS Region
-    # that you want to activate the agent in. You activate the agent in the
-    # AWS Region where your target locations (in Amazon S3 or Amazon EFS)
-    # reside. Your tasks are created in this AWS Region.
+    # Activates an DataSync agent that you have deployed on your host. The
+    # activation process associates your agent with your account. In the
+    # activation process, you specify information such as the Amazon Web
+    # Services Region that you want to activate the agent in. You activate
+    # the agent in the Amazon Web Services Region where your target
+    # locations (in Amazon S3 or Amazon EFS) reside. Your tasks are created
+    # in this Amazon Web Services Region.
     #
     # 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
@@ -385,13 +386,14 @@ module Aws::DataSync
     # task to run. If you use multiple agents for a source location, the
     # status of all the agents must be AVAILABLE for the task to run.
     #
-    # Agents are automatically updated by AWS on a regular basis, using a
-    # mechanism that ensures minimal interruption to your tasks.
+    # Agents are automatically updated by Amazon Web Services on a regular
+    # basis, using a mechanism that ensures minimal interruption to your
+    # tasks.
     #
     # @option params [required, String] :activation_key
     #   Your agent activation key. You can get the activation key either by
     #   sending an HTTP GET request with redirects that enable you to get the
-    #   agent IP address (port 80). Alternatively, you can get it from the AWS
+    #   agent IP address (port 80). Alternatively, you can get it from the
     #   DataSync console.
     #
     #   The redirect URL returned in the response provides you the activation
@@ -400,8 +402,8 @@ module Aws::DataSync
     #   are merely defaults. The arguments you pass to this API call determine
     #   the actual configuration of your agent.
     #
-    #   For more information, see Activating an Agent in the *AWS DataSync
-    #   User Guide.*
+    #   For more information, see Activating an Agent in the *DataSync User
+    #   Guide.*
     #
     # @option params [String] :agent_name
     #   The name you configured for your agent. This value is a text reference
@@ -443,7 +445,11 @@ module Aws::DataSync
     #
     # @option params [Array<String>] :security_group_arns
     #   The ARNs of the security groups used to protect your data transfer
-    #   task subnets. See CreateAgentRequest$SubnetArns.
+    #   task subnets. See [SecurityGroupArns][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_Ec2Config.html#DataSync-Type-Ec2Config-SecurityGroupArns
     #
     # @return [Types::CreateAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -483,7 +489,7 @@ module Aws::DataSync
     # @option params [String] :subdirectory
     #   A subdirectory in the location’s path. This subdirectory in the EFS
     #   file system is used to read data from the EFS source location or write
-    #   data to the EFS destination. By default, AWS DataSync uses the root
+    #   data to the EFS destination. By default, DataSync uses the root
     #   directory.
     #
     #   <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
@@ -584,6 +590,10 @@ module Aws::DataSync
     #   The user who has the permissions to access files and folders in the
     #   FSx for Windows File Server file system.
     #
+    #   For information about choosing a user name that ensures sufficient
+    #   permissions to files, folders, and metadata, see
+    #   [user](create-fsx-location.html#FSxWuser).
+    #
     # @option params [String] :domain
     #   The name of the Windows domain that the FSx for Windows File Server
     #   belongs to.
@@ -650,8 +660,8 @@ module Aws::DataSync
     #   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.
+    #   If you are copying data to or from your Snowcone device, see [NFS
+    #   Server on 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
@@ -666,8 +676,8 @@ module Aws::DataSync
     #   Name Service (DNS) name of the NFS server. An agent that is installed
     #   on-premises uses this host name to mount the NFS server in a network.
     #
-    #   If you are copying data to or from your AWS Snowcone device, see [NFS
-    #   Server on AWS Snowcone][1] for more information.
+    #   If you are copying data to or from your Snowcone device, see [NFS
+    #   Server on Snowcone][1] for more information.
     #
     #   <note markdown="1"> This name must either be DNS-compliant or must be an IP version 4
     #   (IPv4) address.
@@ -682,8 +692,8 @@ module Aws::DataSync
     #   Contains a list of Amazon Resource Names (ARNs) of agents that are
     #   used to connect to an NFS server.
     #
-    #   If you are copying data to or from your AWS Snowcone device, see [NFS
-    #   Server on AWS Snowcone][1] for more information.
+    #   If you are copying data to or from your Snowcone device, see [NFS
+    #   Server on Snowcone][1] for more information.
     #
     #
     #
@@ -734,8 +744,12 @@ module Aws::DataSync
     end
 
     # Creates an endpoint for a self-managed object storage bucket. For more
-    # information about self-managed object storage locations, see
-    # create-object-location.
+    # information about self-managed object storage locations, see [Creating
+    # a location for object storage][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
     #
     # @option params [required, String] :server_hostname
     #   The name of the self-managed object storage server. This value is the
@@ -820,9 +834,12 @@ module Aws::DataSync
 
     # Creates an endpoint for an Amazon S3 bucket.
     #
-    # For more information, see
-    # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
-    # in the *AWS DataSync User Guide*.
+    # For more information, see [Create an Amazon S3 location][1] in the
+    # *DataSync User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
     #
     # @option params [String] :subdirectory
     #   A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -830,35 +847,43 @@ module Aws::DataSync
     #   S3 destination.
     #
     # @option params [required, String] :s3_bucket_arn
-    #   The 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 Amazon Web
+    #   Services 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 buckets in AWS
-    #   Regions, the storage class defaults to Standard. For buckets on AWS
-    #   Outposts, the storage class defaults to AWS S3 Outposts.
+    #   this location is used as a task destination. For buckets in Amazon Web
+    #   Services Regions, the storage class defaults to Standard. For buckets
+    #   on Outposts, the storage class defaults to Amazon Web Services 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.
+    #   S3 storage cost. For detailed information, see [Considerations when
+    #   working with S3 storage classes in DataSync][2].
     #
     #
     #
     #   [1]: http://aws.amazon.com/s3/storage-classes/
+    #   [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
     #
     # @option params [required, Types::S3Config] :s3_config
-    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
-    #   Management (IAM) role that is used to access an Amazon S3 bucket.
+    #   The Amazon Resource Name (ARN) of the Identity and Access Management
+    #   (IAM) role that is used to access an Amazon S3 bucket.
     #
     #   For detailed information about using such a role, see Creating a
-    #   Location for Amazon S3 in the *AWS DataSync User Guide*.
+    #   Location for Amazon S3 in the *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.
+    #   If you are using DataSync on an Amazon Web Services 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 Amazon Web Services Outpost, see [Deploy your DataSync agent on
+    #   Outposts][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent
     #
     # @option params [Array<Types::TagListEntry>] :tags
     #   The key-value pair that represents the tag that you want to add to the
@@ -939,6 +964,10 @@ module Aws::DataSync
     #   The user who can mount the share, has the permissions to access files
     #   and folders in the SMB share.
     #
+    #   For information about choosing a user name that ensures sufficient
+    #   permissions to files, folders, and metadata, see
+    #   [user](create-smb-location.html#SMBuser).
+    #
     # @option params [String] :domain
     #   The name of the Windows domain that the SMB server belongs to.
     #
@@ -1003,18 +1032,21 @@ module Aws::DataSync
     # 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.
+    # When you create a task that transfers data between Amazon Web Services
+    # services in different Amazon Web Services 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.
+    # You can transfer data between commercial Amazon Web Services Regions
+    # except for China, or between Amazon Web Services GovCloud (US)
+    # 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].
+    # When you use DataSync to copy files or objects between Amazon Web
+    # Services 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].
     #
     #
     #
@@ -1024,7 +1056,8 @@ module Aws::DataSync
     #   The Amazon Resource Name (ARN) of the source location for the task.
     #
     # @option params [required, String] :destination_location_arn
-    #   The Amazon Resource Name (ARN) of an AWS storage resource's location.
+    #   The Amazon Resource Name (ARN) of an Amazon Web Services storage
+    #   resource's location.
     #
     # @option params [String] :cloud_watch_log_group_arn
     #   The Amazon Resource Name (ARN) of the Amazon CloudWatch log group that
@@ -1043,7 +1076,11 @@ module Aws::DataSync
     #
     #   For each individual task execution, you can override these options by
     #   specifying the `OverrideOptions` before starting the task execution.
-    #   For more information, see the operation.
+    #   For more information, see the [StartTaskExecution][1] operation.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
     #
     # @option params [Array<Types::FilterRule>] :excludes
     #   A list of filter rules that determines which files to exclude from a
@@ -1054,12 +1091,22 @@ module Aws::DataSync
     # @option params [Types::TaskSchedule] :schedule
     #   Specifies a schedule used to periodically transfer files from a source
     #   to a destination location. The schedule should be specified in UTC
-    #   time. For more information, see task-scheduling.
+    #   time. For more information, see [Scheduling your task][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
     #
     # @option params [Array<Types::TagListEntry>] :tags
     #   The key-value pair that represents the tag that you want to add to the
     #   resource. The value can be an empty string.
     #
+    # @option params [Array<Types::FilterRule>] :includes
+    #   A list of filter rules that determines which files to include when
+    #   running a task. The pattern should contain a single filter string that
+    #   consists of the patterns to include. The patterns are delimited by
+    #   "\|" (that is, a pipe). For example: `"/folder1|/folder2`"
+    #
     # @return [Types::CreateTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTaskResponse#task_arn #task_arn} => String
@@ -1085,6 +1132,7 @@ module Aws::DataSync
     #       task_queueing: "ENABLED", # accepts ENABLED, DISABLED
     #       log_level: "OFF", # accepts OFF, BASIC, TRANSFER
     #       transfer_mode: "CHANGED", # accepts CHANGED, ALL
+    #       security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
     #     },
     #     excludes: [
     #       {
@@ -1101,6 +1149,12 @@ module Aws::DataSync
     #         value: "TagValue",
     #       },
     #     ],
+    #     includes: [
+    #       {
+    #         filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #         value: "FilterValue",
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1118,14 +1172,14 @@ module Aws::DataSync
 
     # Deletes an agent. To specify which agent to delete, use the Amazon
     # Resource Name (ARN) of the agent in your request. The operation
-    # disassociates the agent from your AWS account. However, it doesn't
-    # delete the agent virtual machine (VM) from your on-premises
-    # environment.
+    # disassociates the agent from your Amazon Web Services account.
+    # However, it doesn't delete the agent virtual machine (VM) from your
+    # on-premises environment.
     #
     # @option params [required, String] :agent_arn
     #   The Amazon Resource Name (ARN) of the agent to delete. Use the
     #   `ListAgents` operation to return a list of agents for your account and
-    #   AWS Region.
+    #   Amazon Web Services Region.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1144,7 +1198,7 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Deletes the configuration of a location used by AWS DataSync.
+    # Deletes the configuration of a location used by DataSync.
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the location to delete.
@@ -1353,7 +1407,11 @@ module Aws::DataSync
 
     # Returns metadata about a self-managed object storage server location.
     # For more information about self-managed object storage locations, see
-    # create-object-location.
+    # [Creating a location for object storage][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1500,6 +1558,7 @@ module Aws::DataSync
     #   * {Types::DescribeTaskResponse#error_code #error_code} => String
     #   * {Types::DescribeTaskResponse#error_detail #error_detail} => String
     #   * {Types::DescribeTaskResponse#creation_time #creation_time} => Time
+    #   * {Types::DescribeTaskResponse#includes #includes} => Array&lt;Types::FilterRule&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -1533,6 +1592,7 @@ module Aws::DataSync
     #   resp.options.task_queueing #=> String, one of "ENABLED", "DISABLED"
     #   resp.options.log_level #=> String, one of "OFF", "BASIC", "TRANSFER"
     #   resp.options.transfer_mode #=> String, one of "CHANGED", "ALL"
+    #   resp.options.security_descriptor_copy_flags #=> String, one of "NONE", "OWNER_DACL", "OWNER_DACL_SACL"
     #   resp.excludes #=> Array
     #   resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
     #   resp.excludes[0].value #=> String
@@ -1540,6 +1600,9 @@ module Aws::DataSync
     #   resp.error_code #=> String
     #   resp.error_detail #=> String
     #   resp.creation_time #=> Time
+    #   resp.includes #=> Array
+    #   resp.includes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
+    #   resp.includes[0].value #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTask AWS API Documentation
     #
@@ -1593,6 +1656,7 @@ module Aws::DataSync
     #   resp.options.task_queueing #=> String, one of "ENABLED", "DISABLED"
     #   resp.options.log_level #=> String, one of "OFF", "BASIC", "TRANSFER"
     #   resp.options.transfer_mode #=> String, one of "CHANGED", "ALL"
+    #   resp.options.security_descriptor_copy_flags #=> String, one of "NONE", "OWNER_DACL", "OWNER_DACL_SACL"
     #   resp.excludes #=> Array
     #   resp.excludes[0].filter_type #=> String, one of "SIMPLE_PATTERN"
     #   resp.excludes[0].value #=> String
@@ -1624,9 +1688,9 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns a list of agents owned by an AWS account in the AWS Region
-    # specified in the request. The returned list is ordered by agent Amazon
-    # Resource Name (ARN).
+    # Returns a list of agents owned by an Amazon Web Services account in
+    # the Amazon Web Services Region specified in the request. The returned
+    # list is ordered by agent Amazon Resource Name (ARN).
     #
     # By default, this operation returns a maximum of 100 agents. This
     # operation supports pagination that enables you to optionally reduce
@@ -1880,22 +1944,26 @@ module Aws::DataSync
     # PREPARING \| TRANSFERRING \| VERIFYING \| SUCCESS/FAILURE.
     #
     # For detailed information, see the Task Execution section in the
-    # Components and Terminology topic in the *AWS DataSync User Guide*.
+    # Components and Terminology topic in the *DataSync User Guide*.
     #
     # @option params [required, String] :task_arn
     #   The Amazon Resource Name (ARN) of the task to start.
     #
     # @option params [Types::Options] :override_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.
+    #   [StartTaskExecution][1] 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.
+    #   specify an option in [StartTaskExecution][1], the default value is
+    #   used. You can override the defaults options on each task execution by
+    #   specifying an overriding `Options` value to [StartTaskExecution][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
     #
     # @option params [Array<Types::FilterRule>] :includes
     #   A list of filter rules that determines which files to include when
@@ -1903,6 +1971,12 @@ module Aws::DataSync
     #   consists of the patterns to include. The patterns are delimited by
     #   "\|" (that is, a pipe). For example: `"/folder1|/folder2"`
     #
+    # @option params [Array<Types::FilterRule>] :excludes
+    #   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"`.
+    #
     # @return [Types::StartTaskExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartTaskExecutionResponse#task_execution_arn #task_execution_arn} => String
@@ -1925,6 +1999,7 @@ module Aws::DataSync
     #       task_queueing: "ENABLED", # accepts ENABLED, DISABLED
     #       log_level: "OFF", # accepts OFF, BASIC, TRANSFER
     #       transfer_mode: "CHANGED", # accepts CHANGED, ALL
+    #       security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
     #     },
     #     includes: [
     #       {
@@ -1932,6 +2007,12 @@ module Aws::DataSync
     #         value: "FilterValue",
     #       },
     #     ],
+    #     excludes: [
+    #       {
+    #         filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #         value: "FilterValue",
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1947,7 +2028,7 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Applies a key-value pair to an AWS resource.
+    # Applies a key-value pair to an Amazon Web Services resource.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the resource to apply the tag to.
@@ -1978,7 +2059,7 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Removes a tag from an AWS resource.
+    # Removes a tag from an Amazon Web Services resource.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the resource to remove the tag from.
@@ -2032,7 +2113,11 @@ module Aws::DataSync
 
     # 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.
+    # NFS location, see [Creating a location for NFS][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the NFS location to update.
@@ -2058,8 +2143,8 @@ module Aws::DataSync
     #   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.
+    #   If you are copying data to or from your Snowcone device, see [NFS
+    #   Server on 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
@@ -2103,8 +2188,12 @@ module Aws::DataSync
 
     # 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.
+    # creating a self-managed object storage location, see [Creating a
+    # location for object storage][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the self-managed object storage
@@ -2165,7 +2254,11 @@ module Aws::DataSync
 
     # 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.
+    # creating an SMB location, see [Creating a location for SMB][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html
     #
     # @option params [required, String] :location_arn
     #   The Amazon Resource Name (ARN) of the SMB location to update.
@@ -2249,15 +2342,19 @@ module Aws::DataSync
     #
     # @option params [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.
+    #   [StartTaskExecution][1] 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.
+    #   specify an option in [StartTaskExecution][1], the default value is
+    #   used. You can override the defaults options on each task execution by
+    #   specifying an overriding `Options` value to [StartTaskExecution][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
     #
     # @option params [Array<Types::FilterRule>] :excludes
     #   A list of filter rules that determines which files to exclude from a
@@ -2270,7 +2367,12 @@ module Aws::DataSync
     #   to a destination location. You can configure your task to execute
     #   hourly, daily, weekly or on specific days of the week. You control
     #   when in the day or hour you want the task to execute. The time you
-    #   specify is UTC time. For more information, see task-scheduling.
+    #   specify is UTC time. For more information, see [Scheduling your
+    #   task][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html
     #
     # @option params [String] :name
     #   The name of the task to update.
@@ -2279,6 +2381,12 @@ module Aws::DataSync
     #   The Amazon Resource Name (ARN) of the resource name of the CloudWatch
     #   LogGroup.
     #
+    # @option params [Array<Types::FilterRule>] :includes
+    #   A list of filter rules that determines which files to include when
+    #   running a task. The pattern should contain a single filter string that
+    #   consists of the patterns to include. The patterns are delimited by
+    #   "\|" (that is, a pipe). For example: `"/folder1|/folder2`"
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -2299,6 +2407,7 @@ module Aws::DataSync
     #       task_queueing: "ENABLED", # accepts ENABLED, DISABLED
     #       log_level: "OFF", # accepts OFF, BASIC, TRANSFER
     #       transfer_mode: "CHANGED", # accepts CHANGED, ALL
+    #       security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
     #     },
     #     excludes: [
     #       {
@@ -2311,6 +2420,12 @@ module Aws::DataSync
     #     },
     #     name: "TagValue",
     #     cloud_watch_log_group_arn: "LogGroupArn",
+    #     includes: [
+    #       {
+    #         filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #         value: "FilterValue",
+    #       },
+    #     ],
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTask AWS API Documentation
@@ -2343,15 +2458,19 @@ module Aws::DataSync
     #
     # @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.
+    #   [StartTaskExecution][1] 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.
+    #   specify an option in [StartTaskExecution][1], the default value is
+    #   used. You can override the defaults options on each task execution by
+    #   specifying an overriding `Options` value to [StartTaskExecution][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2373,6 +2492,7 @@ module Aws::DataSync
     #       task_queueing: "ENABLED", # accepts ENABLED, DISABLED
     #       log_level: "OFF", # accepts OFF, BASIC, TRANSFER
     #       transfer_mode: "CHANGED", # accepts CHANGED, ALL
+    #       security_descriptor_copy_flags: "NONE", # accepts NONE, OWNER_DACL, OWNER_DACL_SACL
     #     },
     #   })
     #
@@ -2398,7 +2518,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.31.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end