aws-sdk-datasync 1.34.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b331391474559adaadb77b8dddcb3255529aa339116e154b55bcb0730c356756
-  data.tar.gz: c5957602896450ac9cbd4f121e331c3dfd1f648eec067d05d6e4e2bfb33dd1c5
+  metadata.gz: 52bb9433850f9f998989a9e482c46e314dc4a0906459c85166533e80bbcf0961
+  data.tar.gz: 38d900eb7fff4c58a0a615f2421fa019fb7d9e9132517e0d740f8a7c39b58815
 SHA512:
-  metadata.gz: 9887ec8ee0339ac41636fe8051109dd8a8d4cfe9c71223c21fdf01f42af16b4fc216470aa3f17c7223ec5c623d32cd5c31e2258cb42b74637b62764b897370e8
-  data.tar.gz: 0b2d7c5643bd72d4523f396cf6514a7c182c67e5879fb6cc7fe209d0c006d1bca99329a7153a61094ec3a3880bfbb034ebabdb65fd9262002d0e602b2ac80a58
+  metadata.gz: b5219a8bf2d78110b2c35809696bc37da55ad7e1c4c3d9f2a3f12b8e734065375f23e1818f94164ff13e712a1350036bb3c2d4136192b5804a2f4027a037f4d9
+  data.tar.gz: 66866314a79aafce49696d41869dcef5a43c9f86a7855fedac06cfd516e2273d133925881bafbf62fced99b21726a7f48c4917f17da60a03b195972ef25023e8

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.34.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
@@ -487,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,
@@ -658,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
@@ -674,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.
@@ -690,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.
     #
     #
     #
@@ -832,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
@@ -842,14 +847,15 @@ 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
@@ -862,17 +868,18 @@ module Aws::DataSync
     #   [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 [Deploy your DataSync agent on AWS Outposts][1].
+    #   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].
     #
     #
     #
@@ -1025,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].
     #
     #
     #
@@ -1046,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
@@ -1090,6 +1101,12 @@ module Aws::DataSync
     #   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
@@ -1132,6 +1149,12 @@ module Aws::DataSync
     #         value: "TagValue",
     #       },
     #     ],
+    #     includes: [
+    #       {
+    #         filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #         value: "FilterValue",
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1149,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}.
     #
@@ -1175,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.
@@ -1535,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
     #
@@ -1576,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
     #
@@ -1661,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
@@ -1917,7 +1944,7 @@ 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.
@@ -1944,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
@@ -1974,6 +2007,12 @@ module Aws::DataSync
     #         value: "FilterValue",
     #       },
     #     ],
+    #     excludes: [
+    #       {
+    #         filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #         value: "FilterValue",
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -1989,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.
@@ -2020,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.
@@ -2104,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
@@ -2342,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
@@ -2375,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
@@ -2467,7 +2518,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -290,6 +290,7 @@ module Aws::DataSync
     CreateTaskRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
     CreateTaskRequest.add_member(:schedule, Shapes::ShapeRef.new(shape: TaskSchedule, location_name: "Schedule"))
     CreateTaskRequest.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
+    CreateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
     CreateTaskRequest.struct_class = Types::CreateTaskRequest
 
     CreateTaskResponse.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
@@ -422,6 +423,7 @@ module Aws::DataSync
     DescribeTaskResponse.add_member(:error_code, Shapes::ShapeRef.new(shape: string, location_name: "ErrorCode"))
     DescribeTaskResponse.add_member(:error_detail, Shapes::ShapeRef.new(shape: string, location_name: "ErrorDetail"))
     DescribeTaskResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
+    DescribeTaskResponse.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
     DescribeTaskResponse.struct_class = Types::DescribeTaskResponse
 
     DestinationNetworkInterfaceArns.member = Shapes::ShapeRef.new(shape: NetworkInterfaceArn)
@@ -552,6 +554,7 @@ module Aws::DataSync
     StartTaskExecutionRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
     StartTaskExecutionRequest.add_member(:override_options, Shapes::ShapeRef.new(shape: Options, location_name: "OverrideOptions"))
     StartTaskExecutionRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
+    StartTaskExecutionRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
     StartTaskExecutionRequest.struct_class = Types::StartTaskExecutionRequest
 
     StartTaskExecutionResponse.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, location_name: "TaskExecutionArn"))
@@ -657,6 +660,7 @@ module Aws::DataSync
     UpdateTaskRequest.add_member(:schedule, Shapes::ShapeRef.new(shape: TaskSchedule, location_name: "Schedule"))
     UpdateTaskRequest.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
     UpdateTaskRequest.add_member(:cloud_watch_log_group_arn, Shapes::ShapeRef.new(shape: LogGroupArn, location_name: "CloudWatchLogGroupArn"))
+    UpdateTaskRequest.add_member(:includes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Includes"))
     UpdateTaskRequest.struct_class = Types::UpdateTaskRequest
 
     UpdateTaskResponse.struct_class = Types::UpdateTaskResponse

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

@@ -88,7 +88,7 @@ module Aws::DataSync
     #   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 DataSync console.
+    #   the DataSync console.
     #
     #   The redirect URL returned in the response provides you the
     #   activation key for your agent in the query string parameter
@@ -97,8 +97,8 @@ module Aws::DataSync
     #   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.*
     #   @return [String]
     #
     # @!attribute [rw] agent_name
@@ -169,8 +169,8 @@ module Aws::DataSync
     #
     # @!attribute [rw] agent_arn
     #   The Amazon Resource Name (ARN) of the agent. Use the `ListAgents`
-    #   operation to return a list of agents for your account and AWS
-    #   Region.
+    #   operation to return a list of agents for your account and Amazon Web
+    #   Services Region.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateAgentResponse AWS API Documentation
@@ -204,7 +204,7 @@ module Aws::DataSync
     # @!attribute [rw] 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
+    #   write data to the EFS destination. By default, DataSync uses the
     #   root directory.
     #
     #   <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
@@ -406,8 +406,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
@@ -424,8 +424,8 @@ module Aws::DataSync
     #   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.
@@ -441,8 +441,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.
     #
     #
     #
@@ -623,15 +623,16 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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.
     #   @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 buckets in AWS
-    #   Regions, the storage class defaults to Standard. For buckets on AWS
-    #   Outposts, the storage class defaults to AWS S3 Outposts.
+    #   when 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
@@ -646,18 +647,19 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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*.
     #   @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 [Deploy your DataSync agent on AWS Outposts][1].
+    #   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].
     #
     #
     #
@@ -860,6 +862,12 @@ module Aws::DataSync
     #             value: "TagValue",
     #           },
     #         ],
+    #         includes: [
+    #           {
+    #             filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #             value: "FilterValue",
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] source_location_arn
@@ -867,8 +875,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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.
     #   @return [String]
     #
     # @!attribute [rw] cloud_watch_log_group_arn
@@ -920,6 +928,13 @@ module Aws::DataSync
     #   the resource. The value can be an empty string.
     #   @return [Array<Types::TagListEntry>]
     #
+    # @!attribute [rw] 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 [Array<Types::FilterRule>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateTaskRequest AWS API Documentation
     #
     class CreateTaskRequest < Struct.new(
@@ -930,7 +945,8 @@ module Aws::DataSync
       :options,
       :excludes,
       :schedule,
-      :tags)
+      :tags,
+      :includes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -961,7 +977,7 @@ module Aws::DataSync
     # @!attribute [rw] 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.
+    #   and Amazon Web Services Region.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DeleteAgentRequest AWS API Documentation
@@ -1399,18 +1415,19 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] 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*.
     #   @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
-    #   [Deploy your DataSync agent on AWS Outposts][1].
+    #   If you are using DataSync on an Amazon Web Services Outpost, the
+    #   Amazon Resource Name (ARNs) of the EC2 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].
     #
     #
     #
@@ -1541,7 +1558,7 @@ module Aws::DataSync
     #   The status of the task execution.
     #
     #   For detailed information about task execution statuses, see
-    #   Understanding Task Statuses in the *AWS DataSync User Guide.*
+    #   Understanding Task Statuses in the *DataSync User Guide.*
     #   @return [String]
     #
     # @!attribute [rw] options
@@ -1609,8 +1626,8 @@ module Aws::DataSync
     #   @return [Integer]
     #
     # @!attribute [rw] bytes_written
-    #   The number of logical bytes written to the destination AWS storage
-    #   resource.
+    #   The number of logical bytes written to the destination Amazon Web
+    #   Services storage resource.
     #   @return [Integer]
     #
     # @!attribute [rw] bytes_transferred
@@ -1671,7 +1688,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 *DataSync User Guide*.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -1689,8 +1706,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] destination_location_arn
-    #   The Amazon Resource Name (ARN) of the AWS storage resource's
-    #   location.
+    #   The Amazon Resource Name (ARN) of the Amazon Web Services storage
+    #   resource's location.
     #   @return [String]
     #
     # @!attribute [rw] cloud_watch_log_group_arn
@@ -1740,8 +1757,8 @@ module Aws::DataSync
     #   @return [Types::TaskSchedule]
     #
     # @!attribute [rw] error_code
-    #   Errors that AWS DataSync encountered during execution of the task.
-    #   You can use this error code to help troubleshoot issues.
+    #   Errors that DataSync encountered during execution of the task. You
+    #   can use this error code to help troubleshoot issues.
     #   @return [String]
     #
     # @!attribute [rw] error_detail
@@ -1754,6 +1771,13 @@ module Aws::DataSync
     #   The time that the task was created.
     #   @return [Time]
     #
+    # @!attribute [rw] 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 [Array<Types::FilterRule>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskResponse AWS API Documentation
     #
     class DescribeTaskResponse < Struct.new(
@@ -1771,7 +1795,8 @@ module Aws::DataSync
       :schedule,
       :error_code,
       :error_detail,
-      :creation_time)
+      :creation_time,
+      :includes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1821,7 +1846,7 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] filter_type
-    #   The type of filter rule to apply. AWS DataSync only supports the
+    #   The type of filter rule to apply. DataSync only supports the
     #   SIMPLE\_PATTERN rule type.
     #   @return [String]
     #
@@ -1840,8 +1865,7 @@ module Aws::DataSync
       include Aws::Structure
     end
 
-    # This exception is thrown when an error occurs in the AWS DataSync
-    # service.
+    # This exception is thrown when an error occurs in the DataSync service.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -2389,8 +2413,8 @@ module Aws::DataSync
     #
     #   Some storage classes have specific behaviors that can affect your S3
     #   storage cost. For detailed information, see [Considerations when
-    #   working with Amazon S3 storage classes in DataSync ][1] in the *AWS
-    #   DataSync User Guide*.
+    #   working with Amazon S3 storage classes in DataSync ][1] in the
+    #   *DataSync User Guide*.
     #
     #
     #
@@ -2403,7 +2427,7 @@ module Aws::DataSync
     #   to BEST\_EFFORT, DataSync attempts to preserve the original `Atime`
     #   attribute on all source files (that is, the version before the
     #   PREPARING phase). However, `Atime`'s behavior is not fully standard
-    #   across platforms, so AWS DataSync can only do this on a best-effort
+    #   across platforms, so DataSync can only do this on a best-effort
     #   basis.
     #
     #   Default value: BEST\_EFFORT.
@@ -2483,7 +2507,7 @@ module Aws::DataSync
     #   affect your storage cost. If your task deletes objects, you might
     #   incur minimum storage duration charges for certain storage classes.
     #   For detailed information, see [Considerations when working with
-    #   Amazon S3 storage classes in DataSync ][1] in the *AWS DataSync User
+    #   Amazon S3 storage classes in DataSync ][1] in the *DataSync User
     #   Guide*.
     #
     #   Default value: PRESERVE.
@@ -2498,15 +2522,14 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] preserve_devices
-    #   A value that determines whether AWS DataSync should preserve the
+    #   A value that determines whether DataSync should preserve the
     #   metadata of block and character devices in the source file system,
     #   and re-create the files with that device name and metadata on the
     #   destination. DataSync does not copy the contents of such devices,
     #   only the name and metadata.
     #
-    #   <note markdown="1"> AWS DataSync can't sync the actual contents of such devices,
-    #   because they are nonterminal and don't return an end-of-file (EOF)
-    #   marker.
+    #   <note markdown="1"> DataSync can't sync the actual contents of such devices, because
+    #   they are nonterminal and don't return an end-of-file (EOF) marker.
     #
     #    </note>
     #
@@ -2531,7 +2554,7 @@ module Aws::DataSync
     #
     #   NONE: Ignore permissions.
     #
-    #   <note markdown="1"> AWS DataSync can preserve extant permissions of a source location.
+    #   <note markdown="1"> DataSync can preserve extant permissions of a source location.
     #
     #    </note>
     #
@@ -2541,8 +2564,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] bytes_per_second
-    #   A value that limits the bandwidth used by AWS DataSync. For example,
-    #   if you want AWS DataSync to use a maximum of 1 MB, set this value to
+    #   A value that limits the bandwidth used by DataSync. For example, if
+    #   you want DataSync to use a maximum of 1 MB, set this value to
     #   `1048576` (`=1024*1024`).
     #   @return [Integer]
     #
@@ -2702,11 +2725,11 @@ module Aws::DataSync
       include Aws::Structure
     end
 
-    # 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*.
     #
     # @note When making an API call, you may pass S3Config
     #   data as a hash:
@@ -2786,6 +2809,12 @@ module Aws::DataSync
     #             value: "FilterValue",
     #           },
     #         ],
+    #         excludes: [
+    #           {
+    #             filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #             value: "FilterValue",
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] task_arn
@@ -2817,12 +2846,20 @@ module Aws::DataSync
     #   by "\|" (that is, a pipe). For example: `"/folder1|/folder2"`
     #   @return [Array<Types::FilterRule>]
     #
+    # @!attribute [rw] 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 [Array<Types::FilterRule>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartTaskExecutionRequest AWS API Documentation
     #
     class StartTaskExecutionRequest < Struct.new(
       :task_arn,
       :override_options,
-      :includes)
+      :includes,
+      :excludes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2859,11 +2896,11 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] key
-    #   The key for an AWS resource tag.
+    #   The key for an Amazon Web Services resource tag.
     #   @return [String]
     #
     # @!attribute [rw] value
-    #   The value for an AWS resource tag.
+    #   The value for an Amazon Web Services resource tag.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TagListEntry AWS API Documentation
@@ -2942,8 +2979,8 @@ module Aws::DataSync
     # status of the task execution, and the errors encountered.
     #
     # @!attribute [rw] prepare_duration
-    #   The total time in milliseconds that AWS DataSync spent in the
-    #   PREPARING phase.
+    #   The total time in milliseconds that DataSync spent in the PREPARING
+    #   phase.
     #   @return [Integer]
     #
     # @!attribute [rw] prepare_status
@@ -2951,12 +2988,12 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] total_duration
-    #   The total time in milliseconds that AWS DataSync took to transfer
-    #   the file from the source to the destination location.
+    #   The total time in milliseconds that DataSync took to transfer the
+    #   file from the source to the destination location.
     #   @return [Integer]
     #
     # @!attribute [rw] transfer_duration
-    #   The total time in milliseconds that AWS DataSync spent in the
+    #   The total time in milliseconds that DataSync spent in the
     #   TRANSFERRING phase.
     #   @return [Integer]
     #
@@ -2965,8 +3002,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] verify_duration
-    #   The total time in milliseconds that AWS DataSync spent in the
-    #   VERIFYING phase.
+    #   The total time in milliseconds that DataSync spent in the VERIFYING
+    #   phase.
     #   @return [Integer]
     #
     # @!attribute [rw] verify_status
@@ -2974,8 +3011,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] error_code
-    #   Errors that AWS DataSync encountered during execution of the task.
-    #   You can use this error code to help troubleshoot issues.
+    #   Errors that DataSync encountered during execution of the task. You
+    #   can use this error code to help troubleshoot issues.
     #   @return [String]
     #
     # @!attribute [rw] error_detail
@@ -3092,8 +3129,8 @@ module Aws::DataSync
     #       }
     #
     # @!attribute [rw] schedule_expression
-    #   A cron expression that specifies when AWS DataSync initiates a
-    #   scheduled transfer from a source to a destination location.
+    #   A cron expression that specifies when DataSync initiates a scheduled
+    #   transfer from a source to a destination location.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskSchedule AWS API Documentation
@@ -3206,8 +3243,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
@@ -3499,6 +3536,12 @@ module Aws::DataSync
     #         },
     #         name: "TagValue",
     #         cloud_watch_log_group_arn: "LogGroupArn",
+    #         includes: [
+    #           {
+    #             filter_type: "SIMPLE_PATTERN", # accepts SIMPLE_PATTERN
+    #             value: "FilterValue",
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] task_arn
@@ -3553,6 +3596,13 @@ module Aws::DataSync
     #   CloudWatch LogGroup.
     #   @return [String]
     #
+    # @!attribute [rw] 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 [Array<Types::FilterRule>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskRequest AWS API Documentation
     #
     class UpdateTaskRequest < Struct.new(
@@ -3561,7 +3611,8 @@ module Aws::DataSync
       :excludes,
       :schedule,
       :name,
-      :cloud_watch_log_group_arn)
+      :cloud_watch_log_group_arn,
+      :includes)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-datasync.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.34.0
+  version: 1.35.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-30 00:00:00.000000000 Z
+date: 2021-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core