aws-sdk-datasync 1.23.0 → 1.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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