aws-sdk-datasync 1.24.0 → 1.29.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: bd4e4eb52922e40de3ae28c044d2bc79d49441c7b7417850bab6f2bc178b6acc
4
- data.tar.gz: 1adadb23cdfa68167b747d141f75e4e89e3bb3dbb6c3c7918adfc85d0a6ade33
3
+ metadata.gz: 477d29f30c67e3ba76889dfcfd78a185b84b950df12a2c25fbd73b9d3d974f41
4
+ data.tar.gz: 241b2e0d28a1bdccf8b8f17bb9eef4dc737c9413589d12237ecd64cab61d72a1
5
5
  SHA512:
6
- metadata.gz: 980ea1cd0713826eba119a0ac462e5fda8e747ba82f700b401cd5a6f1f33d656c97d358e519722d3e2e500af6723b5a2a153bcc26fba14c16e5ed587207e37f0
7
- data.tar.gz: 5e0a259bef0c5d0910d366f84eb8519f9588aa31b42e58fcbe1778e97d3a4a666b85fdb2348ca80d77272d68b9268c7a0bff2863354b9c35bddaa770ed678cc4
6
+ metadata.gz: 9d516e19ee6693bfebea42cb8c84051e9717570a0eec4a0127f89b8ea4f6d9ec58fb0ed78920f41c86d816025f2f54a79a8c408f2b16b2618d3b9e6511762768
7
+ data.tar.gz: 3eee6c35dc8dadbc3231ea1729ef46059ab4f81aa6d48da798a3b849b7a22ba11eadcaeb05933676e90827483c36024d3420ee558810dc5e8a4b26f7234058e9
@@ -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.24.0'
51
+ GEM_VERSION = '1.29.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.
826
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.
827
843
  #
828
844
  #
829
- # [1]: https://aws.amazon.com/s3/storage-classes/
845
+ #
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
@@ -1653,6 +1682,10 @@ module Aws::DataSync
1653
1682
  # next list of locations.
1654
1683
  #
1655
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`.
1656
1689
  #
1657
1690
  # @return [Types::ListLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1658
1691
  #
@@ -1788,6 +1821,10 @@ module Aws::DataSync
1788
1821
  # next list of tasks.
1789
1822
  #
1790
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.
1791
1828
  #
1792
1829
  # @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1793
1830
  #
@@ -2066,6 +2103,69 @@ module Aws::DataSync
2066
2103
  req.send_request(options)
2067
2104
  end
2068
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
+
2069
2169
  # @!endgroup
2070
2170
 
2071
2171
  # @param params ({})
@@ -2079,7 +2179,7 @@ module Aws::DataSync
2079
2179
  params: params,
2080
2180
  config: config)
2081
2181
  context[:gem_name] = 'aws-sdk-datasync'
2082
- context[:gem_version] = '1.24.0'
2182
+ context[:gem_version] = '1.29.0'
2083
2183
  Seahorse::Client::Request.new(handlers, context)
2084
2184
  end
2085
2185
 
@@ -172,6 +172,8 @@ module Aws::DataSync
172
172
  UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
173
173
  UpdateAgentRequest = Shapes::StructureShape.new(name: 'UpdateAgentRequest')
174
174
  UpdateAgentResponse = Shapes::StructureShape.new(name: 'UpdateAgentResponse')
175
+ UpdateTaskExecutionRequest = Shapes::StructureShape.new(name: 'UpdateTaskExecutionRequest')
176
+ UpdateTaskExecutionResponse = Shapes::StructureShape.new(name: 'UpdateTaskExecutionResponse')
175
177
  UpdateTaskRequest = Shapes::StructureShape.new(name: 'UpdateTaskRequest')
176
178
  UpdateTaskResponse = Shapes::StructureShape.new(name: 'UpdateTaskResponse')
177
179
  VerifyMode = Shapes::StringShape.new(name: 'VerifyMode')
@@ -253,6 +255,7 @@ module Aws::DataSync
253
255
  CreateLocationS3Request.add_member(:s3_bucket_arn, Shapes::ShapeRef.new(shape: S3BucketArn, required: true, location_name: "S3BucketArn"))
254
256
  CreateLocationS3Request.add_member(:s3_storage_class, Shapes::ShapeRef.new(shape: S3StorageClass, location_name: "S3StorageClass"))
255
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"))
256
259
  CreateLocationS3Request.add_member(:tags, Shapes::ShapeRef.new(shape: InputTagList, location_name: "Tags"))
257
260
  CreateLocationS3Request.struct_class = Types::CreateLocationS3Request
258
261
 
@@ -361,6 +364,7 @@ module Aws::DataSync
361
364
  DescribeLocationS3Response.add_member(:location_uri, Shapes::ShapeRef.new(shape: LocationUri, location_name: "LocationUri"))
362
365
  DescribeLocationS3Response.add_member(:s3_storage_class, Shapes::ShapeRef.new(shape: S3StorageClass, location_name: "S3StorageClass"))
363
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"))
364
368
  DescribeLocationS3Response.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
365
369
  DescribeLocationS3Response.struct_class = Types::DescribeLocationS3Response
366
370
 
@@ -603,6 +607,12 @@ module Aws::DataSync
603
607
 
604
608
  UpdateAgentResponse.struct_class = Types::UpdateAgentResponse
605
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
+
606
616
  UpdateTaskRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: TaskArn, required: true, location_name: "TaskArn"))
607
617
  UpdateTaskRequest.add_member(:options, Shapes::ShapeRef.new(shape: Options, location_name: "Options"))
608
618
  UpdateTaskRequest.add_member(:excludes, Shapes::ShapeRef.new(shape: FilterList, location_name: "Excludes"))
@@ -972,6 +982,16 @@ module Aws::DataSync
972
982
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
973
983
  o.errors << Shapes::ShapeRef.new(shape: InternalException)
974
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)
975
995
  end
976
996
 
977
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
@@ -1870,6 +1901,10 @@ module Aws::DataSync
1870
1901
  # @return [String]
1871
1902
  #
1872
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`.
1873
1908
  # @return [Array<Types::LocationFilter>]
1874
1909
  #
1875
1910
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListLocationsRequest AWS API Documentation
@@ -2038,6 +2073,10 @@ module Aws::DataSync
2038
2073
  # @return [String]
2039
2074
  #
2040
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.
2041
2080
  # @return [Array<Types::TaskFilter>]
2042
2081
  #
2043
2082
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListTasksRequest AWS API Documentation
@@ -2070,6 +2109,11 @@ module Aws::DataSync
2070
2109
  include Aws::Structure
2071
2110
  end
2072
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
+ #
2073
2117
  # @note When making an API call, you may pass LocationFilter
2074
2118
  # data as a hash:
2075
2119
  #
@@ -2080,12 +2124,20 @@ module Aws::DataSync
2080
2124
  # }
2081
2125
  #
2082
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`).
2083
2130
  # @return [String]
2084
2131
  #
2085
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.
2086
2135
  # @return [Array<String>]
2087
2136
  #
2088
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.
2089
2141
  # @return [String]
2090
2142
  #
2091
2143
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/LocationFilter AWS API Documentation
@@ -2192,7 +2244,7 @@ module Aws::DataSync
2192
2244
  # }
2193
2245
  #
2194
2246
  # @!attribute [rw] agent_arns
2195
- # ARNs)of the agents to use for an NFS location.
2247
+ # ARNs of the agents to use for an NFS location.
2196
2248
  # @return [Array<String>]
2197
2249
  #
2198
2250
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/OnPremConfig AWS API Documentation
@@ -2414,11 +2466,17 @@ module Aws::DataSync
2414
2466
  # @return [String]
2415
2467
  #
2416
2468
  # @!attribute [rw] transfer_mode
2417
- # TransferMode has two values: CHANGED and ALL. CHANGED performs an
2418
- # "incremental" or "delta sync", it compares file modification
2419
- # time between source and destination to determine which files need to
2420
- # be transferred. ALL skips destination inventory and transfers all
2421
- # 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.
2422
2480
  # @return [String]
2423
2481
  #
2424
2482
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Options AWS API Documentation
@@ -2724,7 +2782,7 @@ module Aws::DataSync
2724
2782
  # @return [Integer]
2725
2783
  #
2726
2784
  # @!attribute [rw] transfer_status
2727
- # The status of the TRANSFERRING Phase.
2785
+ # The status of the TRANSFERRING phase.
2728
2786
  # @return [String]
2729
2787
  #
2730
2788
  # @!attribute [rw] verify_duration
@@ -2733,7 +2791,7 @@ module Aws::DataSync
2733
2791
  # @return [Integer]
2734
2792
  #
2735
2793
  # @!attribute [rw] verify_status
2736
- # The status of the VERIFYING Phase.
2794
+ # The status of the VERIFYING phase.
2737
2795
  # @return [String]
2738
2796
  #
2739
2797
  # @!attribute [rw] error_code
@@ -2763,6 +2821,11 @@ module Aws::DataSync
2763
2821
  include Aws::Structure
2764
2822
  end
2765
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
+ #
2766
2829
  # @note When making an API call, you may pass TaskFilter
2767
2830
  # data as a hash:
2768
2831
  #
@@ -2773,12 +2836,20 @@ module Aws::DataSync
2773
2836
  # }
2774
2837
  #
2775
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`.
2776
2842
  # @return [String]
2777
2843
  #
2778
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.
2779
2847
  # @return [Array<String>]
2780
2848
  #
2781
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.
2782
2853
  # @return [String]
2783
2854
  #
2784
2855
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/TaskFilter AWS API Documentation
@@ -2909,6 +2980,59 @@ module Aws::DataSync
2909
2980
  #
2910
2981
  class UpdateAgentResponse < Aws::EmptyStructure; end
2911
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
+
2912
3036
  # UpdateTaskResponse
2913
3037
  #
2914
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.24.0
4
+ version: 1.29.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-08-18 00:00:00.000000000 Z
11
+ date: 2021-02-02 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.112.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.112.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement