aws-sdk-datasync 1.23.0 → 1.28.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 5dfe3480fcc84e9fb360b73d86d3f197140c54d60851af268d06661e00d6d350
4
- data.tar.gz: d7806728d52a7dcac0bd483724d8c2526c504f5097c9bf0b8254d4adf90c57ba
3
+ metadata.gz: d4aa366df197fce94f0c5f363e85ef61631b06fa386f25fd009e952116907ade
4
+ data.tar.gz: 89abf22f756f4d969aeaade954b00d05db4bd57598a434c39a20d4ace4166181
5
5
  SHA512:
6
- metadata.gz: b7fbb33bddda6ee646f99f0935346e94b758db38704a16ac1955157553224a63f4001c4e178d107953ea9f33f1e50a32ee90e9a2be82a43f4275d2a48d175188
7
- data.tar.gz: e9eaba232fcb2e36e8ca1dc883eb9b1705da61bd83ebcc7050ab6f56a7d7492a69ab556d757ae530d4ee1c098907a837ad8b5d501cee71d6967897253448e62a
6
+ metadata.gz: 991548c048af831cbef90ea3dc158a3e04c2a5124a0688377fe26007608afa7c7c3f691861dfe30ff15c6afea289e55b2062ea29f0cb3cd767f5d547ae226895
7
+ data.tar.gz: 58d823bbcbabaaacc59e06668e317d06baec14e2a5fbff4b4d77ad3c564140a91fa6ec7bccff697a82a230dff8e2f90399cc998f2509d8b8bccaf33fa8a1da60
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  require 'aws-sdk-core'
11
12
  require 'aws-sigv4'
12
13
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-datasync/customizations'
44
45
  #
45
46
  # See {Errors} for more information.
46
47
  #
47
- # @service
48
+ # @!group service
48
49
  module Aws::DataSync
49
50
 
50
- GEM_VERSION = '1.23.0'
51
+ GEM_VERSION = '1.28.0'
51
52
 
52
53
  end
@@ -85,13 +85,28 @@ module Aws::DataSync
85
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
86
86
  # credentials.
87
87
  #
88
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
89
+ # shared file, such as `~/.aws/config`.
90
+ #
91
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
92
+ #
93
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
94
+ # assume a role after providing credentials via the web.
95
+ #
96
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
97
+ # access token generated from `aws login`.
98
+ #
99
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
100
+ # process that outputs to stdout.
101
+ #
88
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
89
103
  # from an EC2 IMDS on an EC2 instance.
90
104
  #
91
- # * `Aws::SharedCredentials` - Used for loading credentials from a
92
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
93
107
  #
94
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
95
110
  #
96
111
  # When `:credentials` are not configured directly, the following
97
112
  # locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::DataSync
101
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
102
117
  # * `~/.aws/credentials`
103
118
  # * `~/.aws/config`
104
- # * EC2 IMDS instance profile - When used by default, the timeouts are
105
- # very aggressive. Construct and pass an instance of
106
- # `Aws::InstanceProfileCredentails` to enable retries and extended
107
- # timeouts.
119
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
+ # are very aggressive. Construct and pass an instance of
121
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
+ # enable retries and extended timeouts.
108
123
  #
109
124
  # @option options [required, String] :region
110
125
  # The AWS region to connect to. The configured `:region` is
@@ -363,7 +378,7 @@ module Aws::DataSync
363
378
  #
364
379
  # You can activate the agent in a VPC (virtual private cloud) or provide
365
380
  # the agent access to a VPC endpoint so you can run tasks without going
366
- # over the public Internet.
381
+ # over the public internet.
367
382
  #
368
383
  # You can use an agent for more than one location. If a task uses
369
384
  # multiple agents, all of them need to have status AVAILABLE for the
@@ -619,7 +634,7 @@ module Aws::DataSync
619
634
  # subdirectory of that path. The path should be such that it can be
620
635
  # mounted by other NFS clients in your network.
621
636
  #
622
- # To see all the paths exported by your NFS server. run "`showmount -e
637
+ # To see all the paths exported by your NFS server, run "`showmount -e
623
638
  # nfs-server-name`" from an NFS client that has access to your server.
624
639
  # You can specify any directory that appears in the results, and any
625
640
  # subdirectory of that directory. Ensure that the NFS export is
@@ -716,7 +731,9 @@ module Aws::DataSync
716
731
  req.send_request(options)
717
732
  end
718
733
 
719
- # Creates an endpoint for a self-managed object storage bucket.
734
+ # Creates an endpoint for a self-managed object storage bucket. For more
735
+ # information about self-managed object storage locations, see
736
+ # create-object-location.
720
737
  #
721
738
  # @option params [required, String] :server_hostname
722
739
  # The name of the self-managed object storage server. This value is the
@@ -744,11 +761,15 @@ module Aws::DataSync
744
761
  #
745
762
  # @option params [String] :access_key
746
763
  # Optional. The access key is used if credentials are required to access
747
- # the self-managed object storage server.
764
+ # the self-managed object storage server. If your object storage
765
+ # requires a user name and password to authenticate, use `AccessKey` and
766
+ # `SecretKey` to provide the user name and password, respectively.
748
767
  #
749
768
  # @option params [String] :secret_key
750
769
  # Optional. The secret key is used if credentials are required to access
751
- # the self-managed object storage server.
770
+ # the self-managed object storage server. If your object storage
771
+ # requires a user name and password to authenticate, use `AccessKey` and
772
+ # `SecretKey` to provide the user name and password, respectively.
752
773
  #
753
774
  # @option params [required, Array<String>] :agent_arns
754
775
  # The Amazon Resource Name (ARN) of the agents associated with the
@@ -797,16 +818,9 @@ module Aws::DataSync
797
818
 
798
819
  # Creates an endpoint for an Amazon S3 bucket.
799
820
  #
800
- # For AWS DataSync to access a destination S3 bucket, it needs an AWS
801
- # Identity and Access Management (IAM) role that has the required
802
- # permissions. You can set up the required permissions by creating an
803
- # IAM policy that grants the required permissions and attaching the
804
- # policy to the role. An example of such a policy is shown in the
805
- # examples section.
806
- #
807
821
  # For more information, see
808
- # https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html#create-s3-location
809
- # in the *AWS DataSync User Guide.*
822
+ # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
823
+ # in the *AWS DataSync User Guide*.
810
824
  #
811
825
  # @option params [String] :subdirectory
812
826
  # A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -814,19 +828,22 @@ module Aws::DataSync
814
828
  # S3 destination.
815
829
  #
816
830
  # @option params [required, String] :s3_bucket_arn
817
- # The Amazon Resource Name (ARN) of the Amazon S3 bucket.
831
+ # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
832
+ # this must be an access point ARN.
818
833
  #
819
834
  # @option params [String] :s3_storage_class
820
835
  # The Amazon S3 storage class that you want to store your files in when
821
- # this location is used as a task destination. For more information
822
- # about S3 storage classes, see [Amazon S3 Storage Classes][1] in the
823
- # *Amazon Simple Storage Service Developer Guide*. Some storage classes
824
- # have behaviors that can affect your S3 storage cost. For detailed
825
- # information, see using-storage-classes.
836
+ # this location is used as a task destination. For buckets in AWS
837
+ # Regions, the storage class defaults to Standard. For buckets on AWS
838
+ # Outposts, the storage class defaults to AWS S3 Outposts.
839
+ #
840
+ # For more information about S3 storage classes, see [Amazon S3 Storage
841
+ # Classes][1]. Some storage classes have behaviors that can affect your
842
+ # S3 storage cost. For detailed information, see using-storage-classes.
826
843
  #
827
844
  #
828
845
  #
829
- # [1]: https://aws.amazon.com/s3/storage-classes/
846
+ # [1]: http://aws.amazon.com/s3/storage-classes/
830
847
  #
831
848
  # @option params [required, Types::S3Config] :s3_config
832
849
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
@@ -835,6 +852,12 @@ module Aws::DataSync
835
852
  # For detailed information about using such a role, see Creating a
836
853
  # Location for Amazon S3 in the *AWS DataSync User Guide*.
837
854
  #
855
+ # @option params [Array<String>] :agent_arns
856
+ # If you are using DataSync on an AWS Outpost, specify the Amazon
857
+ # Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
858
+ # For more information about launching a DataSync agent on an AWS
859
+ # Outpost, see outposts-agent.
860
+ #
838
861
  # @option params [Array<Types::TagListEntry>] :tags
839
862
  # The key-value pair that represents the tag that you want to add to the
840
863
  # location. The value can be an empty string. We recommend using tags to
@@ -849,10 +872,11 @@ module Aws::DataSync
849
872
  # resp = client.create_location_s3({
850
873
  # subdirectory: "S3Subdirectory",
851
874
  # s3_bucket_arn: "S3BucketArn", # required
852
- # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
875
+ # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
853
876
  # s3_config: { # required
854
877
  # bucket_access_role_arn: "IamRoleArn", # required
855
878
  # },
879
+ # agent_arns: ["AgentArn"],
856
880
  # tags: [
857
881
  # {
858
882
  # key: "TagKey", # required
@@ -986,7 +1010,7 @@ module Aws::DataSync
986
1010
  # minutes, it means that your agent might be having trouble mounting the
987
1011
  # source NFS file system. Check the task's ErrorCode and ErrorDetail.
988
1012
  # Mount issues are often caused by either a misconfigured firewall or a
989
- # mistyped NFS server host name.
1013
+ # mistyped NFS server hostname.
990
1014
  #
991
1015
  # @option params [required, String] :source_location_arn
992
1016
  # The Amazon Resource Name (ARN) of the source location for the task.
@@ -1017,7 +1041,7 @@ module Aws::DataSync
1017
1041
  # A list of filter rules that determines which files to exclude from a
1018
1042
  # task. The list should contain a single filter string that consists of
1019
1043
  # the patterns to exclude. The patterns are delimited by "\|" (that
1020
- # is, a pipe), for example, `"/folder1|/folder2"`
1044
+ # is, a pipe), for example, `"/folder1|/folder2"`.
1021
1045
  #
1022
1046
  # @option params [Types::TaskSchedule] :schedule
1023
1047
  # Specifies a schedule used to periodically transfer files from a source
@@ -1320,6 +1344,8 @@ module Aws::DataSync
1320
1344
  end
1321
1345
 
1322
1346
  # Returns metadata about a self-managed object storage server location.
1347
+ # For more information about self-managed object storage locations, see
1348
+ # create-object-location.
1323
1349
  #
1324
1350
  # @option params [required, String] :location_arn
1325
1351
  # The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1374,6 +1400,7 @@ module Aws::DataSync
1374
1400
  # * {Types::DescribeLocationS3Response#location_uri #location_uri} => String
1375
1401
  # * {Types::DescribeLocationS3Response#s3_storage_class #s3_storage_class} => String
1376
1402
  # * {Types::DescribeLocationS3Response#s3_config #s3_config} => Types::S3Config
1403
+ # * {Types::DescribeLocationS3Response#agent_arns #agent_arns} => Array&lt;String&gt;
1377
1404
  # * {Types::DescribeLocationS3Response#creation_time #creation_time} => Time
1378
1405
  #
1379
1406
  # @example Request syntax with placeholder values
@@ -1386,8 +1413,10 @@ module Aws::DataSync
1386
1413
  #
1387
1414
  # resp.location_arn #=> String
1388
1415
  # resp.location_uri #=> String
1389
- # resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE"
1416
+ # resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
1390
1417
  # resp.s3_config.bucket_access_role_arn #=> String
1418
+ # resp.agent_arns #=> Array
1419
+ # resp.agent_arns[0] #=> String
1391
1420
  # resp.creation_time #=> Time
1392
1421
  #
1393
1422
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationS3 AWS API Documentation
@@ -1652,6 +1681,12 @@ module Aws::DataSync
1652
1681
  # An opaque string that indicates the position at which to begin the
1653
1682
  # next list of locations.
1654
1683
  #
1684
+ # @option params [Array<Types::LocationFilter>] :filters
1685
+ # You can use API filters to narrow down the list of resources returned
1686
+ # by `ListLocations`. For example, to retrieve all tasks on a specific
1687
+ # source location, you can use `ListLocations` with filter name
1688
+ # `LocationType S3` and `Operator Equals`.
1689
+ #
1655
1690
  # @return [Types::ListLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1656
1691
  #
1657
1692
  # * {Types::ListLocationsResponse#locations #locations} => Array&lt;Types::LocationListEntry&gt;
@@ -1664,6 +1699,13 @@ module Aws::DataSync
1664
1699
  # resp = client.list_locations({
1665
1700
  # max_results: 1,
1666
1701
  # next_token: "NextToken",
1702
+ # filters: [
1703
+ # {
1704
+ # name: "LocationUri", # required, accepts LocationUri, LocationType, CreationTime
1705
+ # values: ["FilterAttributeValue"], # required
1706
+ # operator: "Equals", # required, accepts Equals, NotEquals, In, LessThanOrEqual, LessThan, GreaterThanOrEqual, GreaterThan, Contains, NotContains, BeginsWith
1707
+ # },
1708
+ # ],
1667
1709
  # })
1668
1710
  #
1669
1711
  # @example Response structure
@@ -1778,6 +1820,12 @@ module Aws::DataSync
1778
1820
  # An opaque string that indicates the position at which to begin the
1779
1821
  # next list of tasks.
1780
1822
  #
1823
+ # @option params [Array<Types::TaskFilter>] :filters
1824
+ # You can use API filters to narrow down the list of resources returned
1825
+ # by `ListTasks`. For example, to retrieve all tasks on a specific
1826
+ # source location, you can use `ListTasks` with filter name `LocationId`
1827
+ # and `Operator Equals` with the ARN for the location.
1828
+ #
1781
1829
  # @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1782
1830
  #
1783
1831
  # * {Types::ListTasksResponse#tasks #tasks} => Array&lt;Types::TaskListEntry&gt;
@@ -1790,6 +1838,13 @@ module Aws::DataSync
1790
1838
  # resp = client.list_tasks({
1791
1839
  # max_results: 1,
1792
1840
  # next_token: "NextToken",
1841
+ # filters: [
1842
+ # {
1843
+ # name: "LocationId", # required, accepts LocationId, CreationTime
1844
+ # values: ["FilterAttributeValue"], # required
1845
+ # operator: "Equals", # required, accepts Equals, NotEquals, In, LessThanOrEqual, LessThan, GreaterThanOrEqual, GreaterThan, Contains, NotContains, BeginsWith
1846
+ # },
1847
+ # ],
1793
1848
  # })
1794
1849
  #
1795
1850
  # @example Response structure
@@ -2048,6 +2103,69 @@ module Aws::DataSync
2048
2103
  req.send_request(options)
2049
2104
  end
2050
2105
 
2106
+ # Updates execution of a task.
2107
+ #
2108
+ # You can modify bandwidth throttling for a task execution that is
2109
+ # running or queued. For more information, see [Adjusting Bandwidth
2110
+ # Throttling for a Task Execution][1].
2111
+ #
2112
+ # <note markdown="1"> The only `Option` that can be modified by `UpdateTaskExecution` is `
2113
+ # BytesPerSecond `.
2114
+ #
2115
+ # </note>
2116
+ #
2117
+ #
2118
+ #
2119
+ # [1]: https://docs.aws.amazon.com/datasync/latest/working-with-task-executions.html#adjust-bandwidth-throttling
2120
+ #
2121
+ # @option params [required, String] :task_execution_arn
2122
+ # The Amazon Resource Name (ARN) of the specific task execution that is
2123
+ # being updated.
2124
+ #
2125
+ # @option params [required, Types::Options] :options
2126
+ # Represents the options that are available to control the behavior of a
2127
+ # StartTaskExecution operation. Behavior includes preserving metadata
2128
+ # such as user ID (UID), group ID (GID), and file permissions, and also
2129
+ # overwriting files in the destination, data integrity verification, and
2130
+ # so on.
2131
+ #
2132
+ # A task has a set of default options associated with it. If you don't
2133
+ # specify an option in StartTaskExecution, the default value is used.
2134
+ # You can override the defaults options on each task execution by
2135
+ # specifying an overriding `Options` value to StartTaskExecution.
2136
+ #
2137
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2138
+ #
2139
+ # @example Request syntax with placeholder values
2140
+ #
2141
+ # resp = client.update_task_execution({
2142
+ # task_execution_arn: "TaskExecutionArn", # required
2143
+ # options: { # required
2144
+ # verify_mode: "POINT_IN_TIME_CONSISTENT", # accepts POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
2145
+ # overwrite_mode: "ALWAYS", # accepts ALWAYS, NEVER
2146
+ # atime: "NONE", # accepts NONE, BEST_EFFORT
2147
+ # mtime: "NONE", # accepts NONE, PRESERVE
2148
+ # uid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2149
+ # gid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2150
+ # preserve_deleted_files: "PRESERVE", # accepts PRESERVE, REMOVE
2151
+ # preserve_devices: "NONE", # accepts NONE, PRESERVE
2152
+ # posix_permissions: "NONE", # accepts NONE, PRESERVE
2153
+ # bytes_per_second: 1,
2154
+ # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2155
+ # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2156
+ # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2157
+ # },
2158
+ # })
2159
+ #
2160
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecution AWS API Documentation
2161
+ #
2162
+ # @overload update_task_execution(params = {})
2163
+ # @param [Hash] params ({})
2164
+ def update_task_execution(params = {}, options = {})
2165
+ req = build_request(:update_task_execution, params)
2166
+ req.send_request(options)
2167
+ end
2168
+
2051
2169
  # @!endgroup
2052
2170
 
2053
2171
  # @param params ({})
@@ -2061,7 +2179,7 @@ module Aws::DataSync
2061
2179
  params: params,
2062
2180
  config: config)
2063
2181
  context[:gem_name] = 'aws-sdk-datasync'
2064
- context[:gem_version] = '1.23.0'
2182
+ context[:gem_version] = '1.28.0'
2065
2183
  Seahorse::Client::Request.new(handlers, context)
2066
2184
  end
2067
2185
 
@@ -73,10 +73,12 @@ module Aws::DataSync
73
73
  EfsSubdirectory = Shapes::StringShape.new(name: 'EfsSubdirectory')
74
74
  Endpoint = Shapes::StringShape.new(name: 'Endpoint')
75
75
  EndpointType = Shapes::StringShape.new(name: 'EndpointType')
76
+ FilterAttributeValue = Shapes::StringShape.new(name: 'FilterAttributeValue')
76
77
  FilterList = Shapes::ListShape.new(name: 'FilterList')
77
78
  FilterRule = Shapes::StructureShape.new(name: 'FilterRule')
78
79
  FilterType = Shapes::StringShape.new(name: 'FilterType')
79
80
  FilterValue = Shapes::StringShape.new(name: 'FilterValue')
81
+ FilterValues = Shapes::ListShape.new(name: 'FilterValues')
80
82
  FsxFilesystemArn = Shapes::StringShape.new(name: 'FsxFilesystemArn')
81
83
  FsxWindowsSubdirectory = Shapes::StringShape.new(name: 'FsxWindowsSubdirectory')
82
84
  Gid = Shapes::StringShape.new(name: 'Gid')
@@ -95,6 +97,9 @@ module Aws::DataSync
95
97
  ListTasksRequest = Shapes::StructureShape.new(name: 'ListTasksRequest')
96
98
  ListTasksResponse = Shapes::StructureShape.new(name: 'ListTasksResponse')
97
99
  LocationArn = Shapes::StringShape.new(name: 'LocationArn')
100
+ LocationFilter = Shapes::StructureShape.new(name: 'LocationFilter')
101
+ LocationFilterName = Shapes::StringShape.new(name: 'LocationFilterName')
102
+ LocationFilters = Shapes::ListShape.new(name: 'LocationFilters')
98
103
  LocationList = Shapes::ListShape.new(name: 'LocationList')
99
104
  LocationListEntry = Shapes::StructureShape.new(name: 'LocationListEntry')
100
105
  LocationUri = Shapes::StringShape.new(name: 'LocationUri')
@@ -113,6 +118,7 @@ module Aws::DataSync
113
118
  ObjectStorageServerPort = Shapes::IntegerShape.new(name: 'ObjectStorageServerPort')
114
119
  ObjectStorageServerProtocol = Shapes::StringShape.new(name: 'ObjectStorageServerProtocol')
115
120
  OnPremConfig = Shapes::StructureShape.new(name: 'OnPremConfig')
121
+ Operator = Shapes::StringShape.new(name: 'Operator')
116
122
  Options = Shapes::StructureShape.new(name: 'Options')
117
123
  OutputTagList = Shapes::ListShape.new(name: 'OutputTagList')
118
124
  OverwriteMode = Shapes::StringShape.new(name: 'OverwriteMode')
@@ -151,6 +157,9 @@ module Aws::DataSync
151
157
  TaskExecutionListEntry = Shapes::StructureShape.new(name: 'TaskExecutionListEntry')
152
158
  TaskExecutionResultDetail = Shapes::StructureShape.new(name: 'TaskExecutionResultDetail')
153
159
  TaskExecutionStatus = Shapes::StringShape.new(name: 'TaskExecutionStatus')
160
+ TaskFilter = Shapes::StructureShape.new(name: 'TaskFilter')
161
+ TaskFilterName = Shapes::StringShape.new(name: 'TaskFilterName')
162
+ TaskFilters = Shapes::ListShape.new(name: 'TaskFilters')
154
163
  TaskList = Shapes::ListShape.new(name: 'TaskList')
155
164
  TaskListEntry = Shapes::StructureShape.new(name: 'TaskListEntry')
156
165
  TaskQueueing = Shapes::StringShape.new(name: 'TaskQueueing')
@@ -163,6 +172,8 @@ module Aws::DataSync
163
172
  UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
164
173
  UpdateAgentRequest = Shapes::StructureShape.new(name: 'UpdateAgentRequest')
165
174
  UpdateAgentResponse = Shapes::StructureShape.new(name: 'UpdateAgentResponse')
175
+ UpdateTaskExecutionRequest = Shapes::StructureShape.new(name: 'UpdateTaskExecutionRequest')
176
+ UpdateTaskExecutionResponse = Shapes::StructureShape.new(name: 'UpdateTaskExecutionResponse')
166
177
  UpdateTaskRequest = Shapes::StructureShape.new(name: 'UpdateTaskRequest')
167
178
  UpdateTaskResponse = Shapes::StructureShape.new(name: 'UpdateTaskResponse')
168
179
  VerifyMode = Shapes::StringShape.new(name: 'VerifyMode')
@@ -244,6 +255,7 @@ module Aws::DataSync
244
255
  CreateLocationS3Request.add_member(:s3_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "S3BucketArn"))
245
256
  CreateLocationS3Request.add_member(:s3_storage_class, Shapes::ShapeRef.new(shape: S3StorageClass, location_name: "S3StorageClass"))
246
257
  CreateLocationS3Request.add_member(:s3_config, Shapes::ShapeRef.new(shape: S3Config, required: true, location_name: "S3Config"))
258
+ CreateLocationS3Request.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, location_name: "AgentArns"))
247
259
  CreateLocationS3Request.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
248
260
  CreateLocationS3Request.struct_class = Types::CreateLocationS3Request
249
261
 
@@ -352,6 +364,7 @@ module Aws::DataSync
352
364
  DescribeLocationS3Response.add_member(:location_uri, Shapes::ShapeRef.new(shape: LocationUri, location_name: "LocationUri"))
353
365
  DescribeLocationS3Response.add_member(:s3_storage_class, Shapes::ShapeRef.new(shape: S3StorageClass, location_name: "S3StorageClass"))
354
366
  DescribeLocationS3Response.add_member(:s3_config, Shapes::ShapeRef.new(shape: S3Config, location_name: "S3Config"))
367
+ DescribeLocationS3Response.add_member(:agent_arns, Shapes::ShapeRef.new(shape: AgentArnList, location_name: "AgentArns"))
355
368
  DescribeLocationS3Response.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
356
369
  DescribeLocationS3Response.struct_class = Types::DescribeLocationS3Response
357
370
 
@@ -418,6 +431,8 @@ module Aws::DataSync
418
431
  FilterRule.add_member(:value, Shapes::ShapeRef.new(shape: FilterValue, location_name: "Value"))
419
432
  FilterRule.struct_class = Types::FilterRule
420
433
 
434
+ FilterValues.member = Shapes::ShapeRef.new(shape: FilterAttributeValue)
435
+
421
436
  InputTagList.member = Shapes::ShapeRef.new(shape: TagListEntry)
422
437
 
423
438
  InternalException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
@@ -438,6 +453,7 @@ module Aws::DataSync
438
453
 
439
454
  ListLocationsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
440
455
  ListLocationsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
456
+ ListLocationsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: LocationFilters, location_name: "Filters"))
441
457
  ListLocationsRequest.struct_class = Types::ListLocationsRequest
442
458
 
443
459
  ListLocationsResponse.add_member(:locations, Shapes::ShapeRef.new(shape: LocationList, location_name: "Locations"))
@@ -464,12 +480,20 @@ module Aws::DataSync
464
480
 
465
481
  ListTasksRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
466
482
  ListTasksRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
483
+ ListTasksRequest.add_member(:filters, Shapes::ShapeRef.new(shape: TaskFilters, location_name: "Filters"))
467
484
  ListTasksRequest.struct_class = Types::ListTasksRequest
468
485
 
469
486
  ListTasksResponse.add_member(:tasks, Shapes::ShapeRef.new(shape: TaskList, location_name: "Tasks"))
470
487
  ListTasksResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
471
488
  ListTasksResponse.struct_class = Types::ListTasksResponse
472
489
 
490
+ LocationFilter.add_member(:name, Shapes::ShapeRef.new(shape: LocationFilterName, required: true, location_name: "Name"))
491
+ LocationFilter.add_member(:values, Shapes::ShapeRef.new(shape: FilterValues, required: true, location_name: "Values"))
492
+ LocationFilter.add_member(:operator, Shapes::ShapeRef.new(shape: Operator, required: true, location_name: "Operator"))
493
+ LocationFilter.struct_class = Types::LocationFilter
494
+
495
+ LocationFilters.member = Shapes::ShapeRef.new(shape: LocationFilter)
496
+
473
497
  LocationList.member = Shapes::ShapeRef.new(shape: LocationListEntry)
474
498
 
475
499
  LocationListEntry.add_member(:location_arn, Shapes::ShapeRef.new(shape: LocationArn, location_name: "LocationArn"))
@@ -554,6 +578,13 @@ module Aws::DataSync
554
578
  TaskExecutionResultDetail.add_member(:error_detail, Shapes::ShapeRef.new(shape: string, location_name: "ErrorDetail"))
555
579
  TaskExecutionResultDetail.struct_class = Types::TaskExecutionResultDetail
556
580
 
581
+ TaskFilter.add_member(:name, Shapes::ShapeRef.new(shape: TaskFilterName, required: true, location_name: "Name"))
582
+ TaskFilter.add_member(:values, Shapes::ShapeRef.new(shape: FilterValues, required: true, location_name: "Values"))
583
+ TaskFilter.add_member(:operator, Shapes::ShapeRef.new(shape: Operator, required: true, location_name: "Operator"))
584
+ TaskFilter.struct_class = Types::TaskFilter
585
+
586
+ TaskFilters.member = Shapes::ShapeRef.new(shape: TaskFilter)
587
+
557
588
  TaskList.member = Shapes::ShapeRef.new(shape: TaskListEntry)
558
589
 
559
590
  TaskListEntry.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, location_name: "TaskArn"))
@@ -576,6 +607,12 @@ module Aws::DataSync
576
607
 
577
608
  UpdateAgentResponse.struct_class = Types::UpdateAgentResponse
578
609
 
610
+ UpdateTaskExecutionRequest.add_member(:task_execution_arn, Shapes::ShapeRef.new(shape: TaskExecutionArn, required: true, location_name: "TaskExecutionArn"))
611
+ UpdateTaskExecutionRequest.add_member(:options, Shapes::ShapeRef.new(shape: Options, required: true, location_name: "Options"))
612
+ UpdateTaskExecutionRequest.struct_class = Types::UpdateTaskExecutionRequest
613
+
614
+ UpdateTaskExecutionResponse.struct_class = Types::UpdateTaskExecutionResponse
615
+
579
616
  UpdateTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
580
617
  UpdateTaskRequest.add_member(:options, Shapes::ShapeRef.new(shape: Options, location_name: "Options"))
581
618
  UpdateTaskRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
@@ -945,6 +982,16 @@ module Aws::DataSync
945
982
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
946
983
  o.errors << Shapes::ShapeRef.new(shape: InternalException)
947
984
  end)
985
+
986
+ api.add_operation(:update_task_execution, Seahorse::Model::Operation.new.tap do |o|
987
+ o.name = "UpdateTaskExecution"
988
+ o.http_method = "POST"
989
+ o.http_request_uri = "/"
990
+ o.input = Shapes::ShapeRef.new(shape: UpdateTaskExecutionRequest)
991
+ o.output = Shapes::ShapeRef.new(shape: UpdateTaskExecutionResponse)
992
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
993
+ o.errors << Shapes::ShapeRef.new(shape: InternalException)
994
+ end)
948
995
  end
949
996
 
950
997
  end
@@ -379,7 +379,7 @@ module Aws::DataSync
379
379
  # a subdirectory of that path. The path should be such that it can be
380
380
  # mounted by other NFS clients in your network.
381
381
  #
382
- # To see all the paths exported by your NFS server. run "`showmount
382
+ # To see all the paths exported by your NFS server, run "`showmount
383
383
  # -e nfs-server-name`" from an NFS client that has access to your
384
384
  # server. You can specify any directory that appears in the results,
385
385
  # and any subdirectory of that directory. Ensure that the NFS export
@@ -526,12 +526,18 @@ module Aws::DataSync
526
526
  #
527
527
  # @!attribute [rw] access_key
528
528
  # Optional. The access key is used if credentials are required to
529
- # access the self-managed object storage server.
529
+ # access the self-managed object storage server. If your object
530
+ # storage requires a user name and password to authenticate, use
531
+ # `AccessKey` and `SecretKey` to provide the user name and password,
532
+ # respectively.
530
533
  # @return [String]
531
534
  #
532
535
  # @!attribute [rw] secret_key
533
536
  # Optional. The secret key is used if credentials are required to
534
- # access the self-managed object storage server.
537
+ # access the self-managed object storage server. If your object
538
+ # storage requires a user name and password to authenticate, use
539
+ # `AccessKey` and `SecretKey` to provide the user name and password,
540
+ # respectively.
535
541
  # @return [String]
536
542
  #
537
543
  # @!attribute [rw] agent_arns
@@ -584,10 +590,11 @@ module Aws::DataSync
584
590
  # {
585
591
  # subdirectory: "S3Subdirectory",
586
592
  # s3_bucket_arn: "S3BucketArn", # required
587
- # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
593
+ # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
588
594
  # s3_config: { # required
589
595
  # bucket_access_role_arn: "IamRoleArn", # required
590
596
  # },
597
+ # agent_arns: ["AgentArn"],
591
598
  # tags: [
592
599
  # {
593
600
  # key: "TagKey", # required
@@ -603,20 +610,24 @@ module Aws::DataSync
603
610
  # @return [String]
604
611
  #
605
612
  # @!attribute [rw] s3_bucket_arn
606
- # The Amazon Resource Name (ARN) of the Amazon S3 bucket.
613
+ # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
614
+ # this must be an access point ARN.
607
615
  # @return [String]
608
616
  #
609
617
  # @!attribute [rw] s3_storage_class
610
618
  # The Amazon S3 storage class that you want to store your files in
611
- # when this location is used as a task destination. For more
612
- # information about S3 storage classes, see [Amazon S3 Storage
613
- # Classes][1] in the *Amazon Simple Storage Service Developer Guide*.
614
- # Some storage classes have behaviors that can affect your S3 storage
615
- # cost. For detailed information, see using-storage-classes.
619
+ # when this location is used as a task destination. For buckets in AWS
620
+ # Regions, the storage class defaults to Standard. For buckets on AWS
621
+ # Outposts, the storage class defaults to AWS S3 Outposts.
616
622
  #
623
+ # For more information about S3 storage classes, see [Amazon S3
624
+ # Storage Classes][1]. Some storage classes have behaviors that can
625
+ # affect your S3 storage cost. For detailed information, see
626
+ # using-storage-classes.
617
627
  #
618
628
  #
619
- # [1]: https://aws.amazon.com/s3/storage-classes/
629
+ #
630
+ # [1]: http://aws.amazon.com/s3/storage-classes/
620
631
  # @return [String]
621
632
  #
622
633
  # @!attribute [rw] s3_config
@@ -627,6 +638,13 @@ module Aws::DataSync
627
638
  # Location for Amazon S3 in the *AWS DataSync User Guide*.
628
639
  # @return [Types::S3Config]
629
640
  #
641
+ # @!attribute [rw] agent_arns
642
+ # If you are using DataSync on an AWS Outpost, specify the Amazon
643
+ # Resource Names (ARNs) of the DataSync agents deployed on your
644
+ # Outpost. For more information about launching a DataSync agent on an
645
+ # AWS Outpost, see outposts-agent.
646
+ # @return [Array<String>]
647
+ #
630
648
  # @!attribute [rw] tags
631
649
  # The key-value pair that represents the tag that you want to add to
632
650
  # the location. The value can be an empty string. We recommend using
@@ -640,6 +658,7 @@ module Aws::DataSync
640
658
  :s3_bucket_arn,
641
659
  :s3_storage_class,
642
660
  :s3_config,
661
+ :agent_arns,
643
662
  :tags)
644
663
  SENSITIVE = []
645
664
  include Aws::Structure
@@ -854,7 +873,7 @@ module Aws::DataSync
854
873
  # A list of filter rules that determines which files to exclude from a
855
874
  # task. The list should contain a single filter string that consists
856
875
  # of the patterns to exclude. The patterns are delimited by "\|"
857
- # (that is, a pipe), for example, `"/folder1|/folder2"`
876
+ # (that is, a pipe), for example, `"/folder1|/folder2"`.
858
877
  # @return [Array<Types::FilterRule>]
859
878
  #
860
879
  # @!attribute [rw] schedule
@@ -1257,7 +1276,10 @@ module Aws::DataSync
1257
1276
  #
1258
1277
  # @!attribute [rw] access_key
1259
1278
  # Optional. The access key is used if credentials are required to
1260
- # access the self-managed object storage server.
1279
+ # access the self-managed object storage server. If your object
1280
+ # storage requires a user name and password to authenticate, use
1281
+ # `AccessKey` and `SecretKey` to provide the user name and password,
1282
+ # respectively.
1261
1283
  # @return [String]
1262
1284
  #
1263
1285
  # @!attribute [rw] server_port
@@ -1320,7 +1342,8 @@ module Aws::DataSync
1320
1342
  # DescribeLocationS3Response
1321
1343
  #
1322
1344
  # @!attribute [rw] location_arn
1323
- # The Amazon Resource Name (ARN) of the Amazon S3 bucket location.
1345
+ # The Amazon Resource Name (ARN) of the Amazon S3 bucket or access
1346
+ # point.
1324
1347
  # @return [String]
1325
1348
  #
1326
1349
  # @!attribute [rw] location_uri
@@ -1331,13 +1354,13 @@ module Aws::DataSync
1331
1354
  # The Amazon S3 storage class that you chose to store your files in
1332
1355
  # when this location is used as a task destination. For more
1333
1356
  # information about S3 storage classes, see [Amazon S3 Storage
1334
- # Classes][1] in the *Amazon Simple Storage Service Developer Guide*.
1335
- # Some storage classes have behaviors that can affect your S3 storage
1336
- # cost. For detailed information, see using-storage-classes.
1357
+ # Classes][1]. Some storage classes have behaviors that can affect
1358
+ # your S3 storage cost. For detailed information, see
1359
+ # using-storage-classes.
1337
1360
  #
1338
1361
  #
1339
1362
  #
1340
- # [1]: https://aws.amazon.com/s3/storage-classes/
1363
+ # [1]: http://aws.amazon.com/s3/storage-classes/
1341
1364
  # @return [String]
1342
1365
  #
1343
1366
  # @!attribute [rw] s3_config
@@ -1348,6 +1371,13 @@ module Aws::DataSync
1348
1371
  # Location for Amazon S3 in the *AWS DataSync User Guide*.
1349
1372
  # @return [Types::S3Config]
1350
1373
  #
1374
+ # @!attribute [rw] agent_arns
1375
+ # If you are using DataSync on an AWS Outpost, the Amazon Resource
1376
+ # Name (ARNs) of the EC2 agents deployed on your Outpost. For more
1377
+ # information about launching a DataSync agent on an AWS Outpost, see
1378
+ # outposts-agent.
1379
+ # @return [Array<String>]
1380
+ #
1351
1381
  # @!attribute [rw] creation_time
1352
1382
  # The time that the Amazon S3 bucket location was created.
1353
1383
  # @return [Time]
@@ -1359,6 +1389,7 @@ module Aws::DataSync
1359
1389
  :location_uri,
1360
1390
  :s3_storage_class,
1361
1391
  :s3_config,
1392
+ :agent_arns,
1362
1393
  :creation_time)
1363
1394
  SENSITIVE = []
1364
1395
  include Aws::Structure
@@ -1596,7 +1627,7 @@ module Aws::DataSync
1596
1627
  # The status of the task that was described.
1597
1628
  #
1598
1629
  # For detailed information about task execution statuses, see
1599
- # Understanding Task Statuses in the *AWS DataSync User Guide.*
1630
+ # Understanding Task Statuses in the *AWS DataSync User Guide*.
1600
1631
  # @return [String]
1601
1632
  #
1602
1633
  # @!attribute [rw] name
@@ -1851,6 +1882,13 @@ module Aws::DataSync
1851
1882
  # {
1852
1883
  # max_results: 1,
1853
1884
  # next_token: "NextToken",
1885
+ # filters: [
1886
+ # {
1887
+ # name: "LocationUri", # required, accepts LocationUri, LocationType, CreationTime
1888
+ # values: ["FilterAttributeValue"], # required
1889
+ # operator: "Equals", # required, accepts Equals, NotEquals, In, LessThanOrEqual, LessThan, GreaterThanOrEqual, GreaterThan, Contains, NotContains, BeginsWith
1890
+ # },
1891
+ # ],
1854
1892
  # }
1855
1893
  #
1856
1894
  # @!attribute [rw] max_results
@@ -1862,11 +1900,19 @@ module Aws::DataSync
1862
1900
  # next list of locations.
1863
1901
  # @return [String]
1864
1902
  #
1903
+ # @!attribute [rw] filters
1904
+ # You can use API filters to narrow down the list of resources
1905
+ # returned by `ListLocations`. For example, to retrieve all tasks on a
1906
+ # specific source location, you can use `ListLocations` with filter
1907
+ # name `LocationType S3` and `Operator Equals`.
1908
+ # @return [Array<Types::LocationFilter>]
1909
+ #
1865
1910
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListLocationsRequest AWS API Documentation
1866
1911
  #
1867
1912
  class ListLocationsRequest < Struct.new(
1868
1913
  :max_results,
1869
- :next_token)
1914
+ :next_token,
1915
+ :filters)
1870
1916
  SENSITIVE = []
1871
1917
  include Aws::Structure
1872
1918
  end
@@ -2008,6 +2054,13 @@ module Aws::DataSync
2008
2054
  # {
2009
2055
  # max_results: 1,
2010
2056
  # next_token: "NextToken",
2057
+ # filters: [
2058
+ # {
2059
+ # name: "LocationId", # required, accepts LocationId, CreationTime
2060
+ # values: ["FilterAttributeValue"], # required
2061
+ # operator: "Equals", # required, accepts Equals, NotEquals, In, LessThanOrEqual, LessThan, GreaterThanOrEqual, GreaterThan, Contains, NotContains, BeginsWith
2062
+ # },
2063
+ # ],
2011
2064
  # }
2012
2065
  #
2013
2066
  # @!attribute [rw] max_results
@@ -2019,11 +2072,19 @@ module Aws::DataSync
2019
2072
  # next list of tasks.
2020
2073
  # @return [String]
2021
2074
  #
2075
+ # @!attribute [rw] filters
2076
+ # You can use API filters to narrow down the list of resources
2077
+ # returned by `ListTasks`. For example, to retrieve all tasks on a
2078
+ # specific source location, you can use `ListTasks` with filter name
2079
+ # `LocationId` and `Operator Equals` with the ARN for the location.
2080
+ # @return [Array<Types::TaskFilter>]
2081
+ #
2022
2082
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasksRequest AWS API Documentation
2023
2083
  #
2024
2084
  class ListTasksRequest < Struct.new(
2025
2085
  :max_results,
2026
- :next_token)
2086
+ :next_token,
2087
+ :filters)
2027
2088
  SENSITIVE = []
2028
2089
  include Aws::Structure
2029
2090
  end
@@ -2048,6 +2109,47 @@ module Aws::DataSync
2048
2109
  include Aws::Structure
2049
2110
  end
2050
2111
 
2112
+ # You can use API filters to narrow down the list of resources returned
2113
+ # by `ListLocations`. For example, to retrieve all your Amazon S3
2114
+ # locations, you can use `ListLocations` with filter name `LocationType
2115
+ # S3` and `Operator Equals`.
2116
+ #
2117
+ # @note When making an API call, you may pass LocationFilter
2118
+ # data as a hash:
2119
+ #
2120
+ # {
2121
+ # name: "LocationUri", # required, accepts LocationUri, LocationType, CreationTime
2122
+ # values: ["FilterAttributeValue"], # required
2123
+ # operator: "Equals", # required, accepts Equals, NotEquals, In, LessThanOrEqual, LessThan, GreaterThanOrEqual, GreaterThan, Contains, NotContains, BeginsWith
2124
+ # }
2125
+ #
2126
+ # @!attribute [rw] name
2127
+ # The name of the filter being used. Each API call supports a list of
2128
+ # filters that are available for it (for example, `LocationType` for
2129
+ # `ListLocations`).
2130
+ # @return [String]
2131
+ #
2132
+ # @!attribute [rw] values
2133
+ # The values that you want to filter for. For example, you might want
2134
+ # to display only Amazon S3 locations.
2135
+ # @return [Array<String>]
2136
+ #
2137
+ # @!attribute [rw] operator
2138
+ # The operator that is used to compare filter values (for example,
2139
+ # `Equals` or `Contains`). For more about API filtering operators, see
2140
+ # query-resources.
2141
+ # @return [String]
2142
+ #
2143
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/LocationFilter AWS API Documentation
2144
+ #
2145
+ class LocationFilter < Struct.new(
2146
+ :name,
2147
+ :values,
2148
+ :operator)
2149
+ SENSITIVE = []
2150
+ include Aws::Structure
2151
+ end
2152
+
2051
2153
  # Represents a single entry in a list of locations. `LocationListEntry`
2052
2154
  # returns an array that contains a list of locations when the
2053
2155
  # ListLocations operation is called.
@@ -2142,7 +2244,7 @@ module Aws::DataSync
2142
2244
  # }
2143
2245
  #
2144
2246
  # @!attribute [rw] agent_arns
2145
- # ARNs)of the agents to use for an NFS location.
2247
+ # ARNs of the agents to use for an NFS location.
2146
2248
  # @return [Array<String>]
2147
2249
  #
2148
2250
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/OnPremConfig AWS API Documentation
@@ -2364,11 +2466,17 @@ module Aws::DataSync
2364
2466
  # @return [String]
2365
2467
  #
2366
2468
  # @!attribute [rw] transfer_mode
2367
- # TransferMode has two values: CHANGED and ALL. CHANGED performs an
2368
- # "incremental" or "delta sync", it compares file modification
2369
- # time between source and destination to determine which files need to
2370
- # be transferred. ALL skips destination inventory and transfers all
2371
- # files discovered on the source.
2469
+ # A value that determines whether DataSync transfers only the data and
2470
+ # metadata that differ between the source and the destination
2471
+ # location, or whether DataSync transfers all the content from the
2472
+ # source, without comparing to the destination location.
2473
+ #
2474
+ # CHANGED: DataSync copies only data or metadata that is new or
2475
+ # different content from the source location to the destination
2476
+ # location.
2477
+ #
2478
+ # ALL: DataSync copies all source location content to the destination,
2479
+ # without comparing to existing content on the destination.
2372
2480
  # @return [String]
2373
2481
  #
2374
2482
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Options AWS API Documentation
@@ -2674,7 +2782,7 @@ module Aws::DataSync
2674
2782
  # @return [Integer]
2675
2783
  #
2676
2784
  # @!attribute [rw] transfer_status
2677
- # The status of the TRANSFERRING Phase.
2785
+ # The status of the TRANSFERRING phase.
2678
2786
  # @return [String]
2679
2787
  #
2680
2788
  # @!attribute [rw] verify_duration
@@ -2683,7 +2791,7 @@ module Aws::DataSync
2683
2791
  # @return [Integer]
2684
2792
  #
2685
2793
  # @!attribute [rw] verify_status
2686
- # The status of the VERIFYING Phase.
2794
+ # The status of the VERIFYING phase.
2687
2795
  # @return [String]
2688
2796
  #
2689
2797
  # @!attribute [rw] error_code
@@ -2713,6 +2821,47 @@ module Aws::DataSync
2713
2821
  include Aws::Structure
2714
2822
  end
2715
2823
 
2824
+ # You can use API filters to narrow down the list of resources returned
2825
+ # by `ListTasks`. For example, to retrieve all tasks on a source
2826
+ # location, you can use `ListTasks` with filter name `LocationId` and
2827
+ # `Operator Equals` with the ARN for the location.
2828
+ #
2829
+ # @note When making an API call, you may pass TaskFilter
2830
+ # data as a hash:
2831
+ #
2832
+ # {
2833
+ # name: "LocationId", # required, accepts LocationId, CreationTime
2834
+ # values: ["FilterAttributeValue"], # required
2835
+ # operator: "Equals", # required, accepts Equals, NotEquals, In, LessThanOrEqual, LessThan, GreaterThanOrEqual, GreaterThan, Contains, NotContains, BeginsWith
2836
+ # }
2837
+ #
2838
+ # @!attribute [rw] name
2839
+ # The name of the filter being used. Each API call supports a list of
2840
+ # filters that are available for it. For example, `LocationId` for
2841
+ # `ListTasks`.
2842
+ # @return [String]
2843
+ #
2844
+ # @!attribute [rw] values
2845
+ # The values that you want to filter for. For example, you might want
2846
+ # to display only tasks for a specific destination location.
2847
+ # @return [Array<String>]
2848
+ #
2849
+ # @!attribute [rw] operator
2850
+ # The operator that is used to compare filter values (for example,
2851
+ # `Equals` or `Contains`). For more about API filtering operators, see
2852
+ # query-resources.
2853
+ # @return [String]
2854
+ #
2855
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskFilter AWS API Documentation
2856
+ #
2857
+ class TaskFilter < Struct.new(
2858
+ :name,
2859
+ :values,
2860
+ :operator)
2861
+ SENSITIVE = []
2862
+ include Aws::Structure
2863
+ end
2864
+
2716
2865
  # Represents a single entry in a list of tasks. `TaskListEntry` returns
2717
2866
  # an array that contains a list of tasks when the ListTasks operation is
2718
2867
  # called. A task includes the source and destination file systems to
@@ -2831,6 +2980,59 @@ module Aws::DataSync
2831
2980
  #
2832
2981
  class UpdateAgentResponse < Aws::EmptyStructure; end
2833
2982
 
2983
+ # @note When making an API call, you may pass UpdateTaskExecutionRequest
2984
+ # data as a hash:
2985
+ #
2986
+ # {
2987
+ # task_execution_arn: "TaskExecutionArn", # required
2988
+ # options: { # required
2989
+ # verify_mode: "POINT_IN_TIME_CONSISTENT", # accepts POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
2990
+ # overwrite_mode: "ALWAYS", # accepts ALWAYS, NEVER
2991
+ # atime: "NONE", # accepts NONE, BEST_EFFORT
2992
+ # mtime: "NONE", # accepts NONE, PRESERVE
2993
+ # uid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2994
+ # gid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2995
+ # preserve_deleted_files: "PRESERVE", # accepts PRESERVE, REMOVE
2996
+ # preserve_devices: "NONE", # accepts NONE, PRESERVE
2997
+ # posix_permissions: "NONE", # accepts NONE, PRESERVE
2998
+ # bytes_per_second: 1,
2999
+ # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
3000
+ # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
3001
+ # transfer_mode: "CHANGED", # accepts CHANGED, ALL
3002
+ # },
3003
+ # }
3004
+ #
3005
+ # @!attribute [rw] task_execution_arn
3006
+ # The Amazon Resource Name (ARN) of the specific task execution that
3007
+ # is being updated.
3008
+ # @return [String]
3009
+ #
3010
+ # @!attribute [rw] options
3011
+ # Represents the options that are available to control the behavior of
3012
+ # a StartTaskExecution operation. Behavior includes preserving
3013
+ # metadata such as user ID (UID), group ID (GID), and file
3014
+ # permissions, and also overwriting files in the destination, data
3015
+ # integrity verification, and so on.
3016
+ #
3017
+ # A task has a set of default options associated with it. If you
3018
+ # don't specify an option in StartTaskExecution, the default value is
3019
+ # used. You can override the defaults options on each task execution
3020
+ # by specifying an overriding `Options` value to StartTaskExecution.
3021
+ # @return [Types::Options]
3022
+ #
3023
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecutionRequest AWS API Documentation
3024
+ #
3025
+ class UpdateTaskExecutionRequest < Struct.new(
3026
+ :task_execution_arn,
3027
+ :options)
3028
+ SENSITIVE = []
3029
+ include Aws::Structure
3030
+ end
3031
+
3032
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecutionResponse AWS API Documentation
3033
+ #
3034
+ class UpdateTaskExecutionResponse < Aws::EmptyStructure; end
3035
+
2834
3036
  # UpdateTaskResponse
2835
3037
  #
2836
3038
  # @note When making an API call, you may pass UpdateTaskRequest
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-datasync
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.23.0
4
+ version: 1.28.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-07-27 00:00:00.000000000 Z
11
+ date: 2020-11-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.99.0
22
+ version: 3.109.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.99.0
32
+ version: 3.109.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement