aws-sdk-datasync 1.25.0 → 1.30.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: eb532accb2945091d2cfef7c21759761c2252d73b02d25daa096aa0e0a075414
4
- data.tar.gz: ed34b4f02f56e9f21c73a39aa51302b683e8b6f487371c1954a16a9d5da6e1c2
3
+ metadata.gz: fe62a6ddc4c2f0184551e1a8dfd702abaaa95da6c72471f74922aff30e7c0087
4
+ data.tar.gz: '09a0423e9303c08179949dff174dd7a95e54c82fa08d17ef32276d380eddff14'
5
5
  SHA512:
6
- metadata.gz: 91c4e3289f8f982e27c4755e38adef085727cab4499b955620095d16285499735146e51bd7059f2a5328ac6a4ce4f6e994112de304137cb0d98499bb41fdb190
7
- data.tar.gz: 957eed8f735aa29caea2ba3b4926a12f5047778b0636b628cc0c20d12fe0ef0df59bb27d40b9bc5f31d696d367f7861f3e442284cdfe20d9070c11abc7d50b5c
6
+ metadata.gz: 58ede22647162f3d23bdc5ab5dc0cee8e4b5aa609459da180dea40f3d5e6e8bda1f1456274e051237a716bf411fb362ce7ba9aecfab09aaa4d1de2b60d6572ac
7
+ data.tar.gz: 88963b21e8436689c06eeb135b98579708302db543982b05cf97ba0d706bede88218f0a3aaa9239dac0b69f85b3f995f4388117ec5a0266045866883c2785fe0
@@ -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
 
@@ -47,6 +48,6 @@ require_relative 'aws-sdk-datasync/customizations'
47
48
  # @!group service
48
49
  module Aws::DataSync
49
50
 
50
- GEM_VERSION = '1.25.0'
51
+ GEM_VERSION = '1.30.0'
51
52
 
52
53
  end
@@ -378,7 +378,7 @@ module Aws::DataSync
378
378
  #
379
379
  # You can activate the agent in a VPC (virtual private cloud) or provide
380
380
  # the agent access to a VPC endpoint so you can run tasks without going
381
- # over the public Internet.
381
+ # over the public internet.
382
382
  #
383
383
  # You can use an agent for more than one location. If a task uses
384
384
  # multiple agents, all of them need to have status AVAILABLE for the
@@ -557,20 +557,22 @@ module Aws::DataSync
557
557
  req.send_request(options)
558
558
  end
559
559
 
560
- # Creates an endpoint for an Amazon FSx for Windows file system.
560
+ # Creates an endpoint for an Amazon FSx for Windows File Server file
561
+ # system.
561
562
  #
562
563
  # @option params [String] :subdirectory
563
564
  # A subdirectory in the location’s path. This subdirectory in the Amazon
564
- # FSx for Windows file system is used to read data from the Amazon FSx
565
- # for Windows source location or write data to the FSx for Windows
566
- # destination.
565
+ # FSx for Windows File Server file system is used to read data from the
566
+ # Amazon FSx for Windows File Server source location or write data to
567
+ # the FSx for Windows File Server destination.
567
568
  #
568
569
  # @option params [required, String] :fsx_filesystem_arn
569
- # The Amazon Resource Name (ARN) for the FSx for Windows file system.
570
+ # The Amazon Resource Name (ARN) for the FSx for Windows File Server
571
+ # file system.
570
572
  #
571
573
  # @option params [required, Array<String>] :security_group_arns
572
574
  # The Amazon Resource Names (ARNs) of the security groups that are to
573
- # use to configure the FSx for Windows file system.
575
+ # use to configure the FSx for Windows File Server file system.
574
576
  #
575
577
  # @option params [Array<Types::TagListEntry>] :tags
576
578
  # The key-value pair that represents a tag that you want to add to the
@@ -580,15 +582,15 @@ module Aws::DataSync
580
582
  #
581
583
  # @option params [required, String] :user
582
584
  # The user who has the permissions to access files and folders in the
583
- # FSx for Windows file system.
585
+ # FSx for Windows File Server file system.
584
586
  #
585
587
  # @option params [String] :domain
586
- # The name of the Windows domain that the FSx for Windows server belongs
587
- # to.
588
+ # The name of the Windows domain that the FSx for Windows File Server
589
+ # belongs to.
588
590
  #
589
591
  # @option params [required, String] :password
590
592
  # The password of the user who has the permissions to access files and
591
- # folders in the FSx for Windows file system.
593
+ # folders in the FSx for Windows File Server file system.
592
594
  #
593
595
  # @return [Types::CreateLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
594
596
  #
@@ -634,7 +636,7 @@ module Aws::DataSync
634
636
  # subdirectory of that path. The path should be such that it can be
635
637
  # mounted by other NFS clients in your network.
636
638
  #
637
- # To see all the paths exported by your NFS server. run "`showmount -e
639
+ # To see all the paths exported by your NFS server, run "`showmount -e
638
640
  # nfs-server-name`" from an NFS client that has access to your server.
639
641
  # You can specify any directory that appears in the results, and any
640
642
  # subdirectory of that directory. Ensure that the NFS export is
@@ -731,7 +733,9 @@ module Aws::DataSync
731
733
  req.send_request(options)
732
734
  end
733
735
 
734
- # Creates an endpoint for a self-managed object storage bucket.
736
+ # Creates an endpoint for a self-managed object storage bucket. For more
737
+ # information about self-managed object storage locations, see
738
+ # create-object-location.
735
739
  #
736
740
  # @option params [required, String] :server_hostname
737
741
  # The name of the self-managed object storage server. This value is the
@@ -759,11 +763,15 @@ module Aws::DataSync
759
763
  #
760
764
  # @option params [String] :access_key
761
765
  # Optional. The access key is used if credentials are required to access
762
- # the self-managed object storage server.
766
+ # the self-managed object storage server. If your object storage
767
+ # requires a user name and password to authenticate, use `AccessKey` and
768
+ # `SecretKey` to provide the user name and password, respectively.
763
769
  #
764
770
  # @option params [String] :secret_key
765
771
  # Optional. The secret key is used if credentials are required to access
766
- # the self-managed object storage server.
772
+ # the self-managed object storage server. If your object storage
773
+ # requires a user name and password to authenticate, use `AccessKey` and
774
+ # `SecretKey` to provide the user name and password, respectively.
767
775
  #
768
776
  # @option params [required, Array<String>] :agent_arns
769
777
  # The Amazon Resource Name (ARN) of the agents associated with the
@@ -812,16 +820,9 @@ module Aws::DataSync
812
820
 
813
821
  # Creates an endpoint for an Amazon S3 bucket.
814
822
  #
815
- # For AWS DataSync to access a destination S3 bucket, it needs an AWS
816
- # Identity and Access Management (IAM) role that has the required
817
- # permissions. You can set up the required permissions by creating an
818
- # IAM policy that grants the required permissions and attaching the
819
- # policy to the role. An example of such a policy is shown in the
820
- # examples section.
821
- #
822
823
  # For more information, see
823
- # https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html#create-s3-location
824
- # in the *AWS DataSync User Guide.*
824
+ # https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli
825
+ # in the *AWS DataSync User Guide*.
825
826
  #
826
827
  # @option params [String] :subdirectory
827
828
  # A subdirectory in the Amazon S3 bucket. This subdirectory in Amazon S3
@@ -829,19 +830,22 @@ module Aws::DataSync
829
830
  # S3 destination.
830
831
  #
831
832
  # @option params [required, String] :s3_bucket_arn
832
- # The Amazon Resource Name (ARN) of the Amazon S3 bucket.
833
+ # The ARN of the Amazon S3 bucket. If the bucket is on an AWS Outpost,
834
+ # this must be an access point ARN.
833
835
  #
834
836
  # @option params [String] :s3_storage_class
835
837
  # The Amazon S3 storage class that you want to store your files in when
836
- # this location is used as a task destination. For more information
837
- # about S3 storage classes, see [Amazon S3 Storage Classes][1] in the
838
- # *Amazon Simple Storage Service Developer Guide*. Some storage classes
839
- # have behaviors that can affect your S3 storage cost. For detailed
840
- # information, see using-storage-classes.
838
+ # this location is used as a task destination. For buckets in AWS
839
+ # Regions, the storage class defaults to Standard. For buckets on AWS
840
+ # Outposts, the storage class defaults to AWS S3 Outposts.
841
+ #
842
+ # For more information about S3 storage classes, see [Amazon S3 Storage
843
+ # Classes][1]. Some storage classes have behaviors that can affect your
844
+ # S3 storage cost. For detailed information, see using-storage-classes.
841
845
  #
842
846
  #
843
847
  #
844
- # [1]: https://aws.amazon.com/s3/storage-classes/
848
+ # [1]: http://aws.amazon.com/s3/storage-classes/
845
849
  #
846
850
  # @option params [required, Types::S3Config] :s3_config
847
851
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
@@ -850,6 +854,12 @@ module Aws::DataSync
850
854
  # For detailed information about using such a role, see Creating a
851
855
  # Location for Amazon S3 in the *AWS DataSync User Guide*.
852
856
  #
857
+ # @option params [Array<String>] :agent_arns
858
+ # If you are using DataSync on an AWS Outpost, specify the Amazon
859
+ # Resource Names (ARNs) of the DataSync agents deployed on your Outpost.
860
+ # For more information about launching a DataSync agent on an AWS
861
+ # Outpost, see outposts-agent.
862
+ #
853
863
  # @option params [Array<Types::TagListEntry>] :tags
854
864
  # The key-value pair that represents the tag that you want to add to the
855
865
  # location. The value can be an empty string. We recommend using tags to
@@ -864,10 +874,11 @@ module Aws::DataSync
864
874
  # resp = client.create_location_s3({
865
875
  # subdirectory: "S3Subdirectory",
866
876
  # s3_bucket_arn: "S3BucketArn", # required
867
- # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
877
+ # s3_storage_class: "STANDARD", # accepts STANDARD, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
868
878
  # s3_config: { # required
869
879
  # bucket_access_role_arn: "IamRoleArn", # required
870
880
  # },
881
+ # agent_arns: ["AgentArn"],
871
882
  # tags: [
872
883
  # {
873
884
  # key: "TagKey", # required
@@ -984,24 +995,30 @@ module Aws::DataSync
984
995
  req.send_request(options)
985
996
  end
986
997
 
987
- # Creates a task. A task is a set of two locations (source and
988
- # destination) and a set of Options that you use to control the behavior
989
- # of a task. If you don't specify Options when you create a task, AWS
990
- # DataSync populates them with service defaults.
991
- #
992
- # When you create a task, it first enters the CREATING state. During
993
- # CREATING AWS DataSync attempts to mount the on-premises Network File
994
- # System (NFS) location. The task transitions to the AVAILABLE state
995
- # without waiting for the AWS location to become mounted. If required,
996
- # AWS DataSync mounts the AWS location before each task execution.
997
- #
998
- # If an agent that is associated with a source (NFS) location goes
999
- # offline, the task transitions to the UNAVAILABLE status. If the status
1000
- # of the task remains in the CREATING status for more than a few
1001
- # minutes, it means that your agent might be having trouble mounting the
1002
- # source NFS file system. Check the task's ErrorCode and ErrorDetail.
1003
- # Mount issues are often caused by either a misconfigured firewall or a
1004
- # mistyped NFS server host name.
998
+ # Creates a task.
999
+ #
1000
+ # A task includes a source location and a destination location, and a
1001
+ # configuration that specifies how data is transferred. A task always
1002
+ # transfers data from the source location to the destination location.
1003
+ # The configuration specifies options such as task scheduling, bandwidth
1004
+ # limits, etc. A task is the complete definition of a data transfer.
1005
+ #
1006
+ # When you create a task that transfers data between AWS services in
1007
+ # different AWS Regions, one of the two locations that you specify must
1008
+ # reside in the Region where DataSync is being used. The other location
1009
+ # must be specified in a different Region.
1010
+ #
1011
+ # You can transfer data between commercial AWS Regions except for China,
1012
+ # or between AWS GovCloud (US-East and US-West) Regions.
1013
+ #
1014
+ # When you use DataSync to copy files or objects between AWS Regions,
1015
+ # you pay for data transfer between Regions. This is billed as data
1016
+ # transfer OUT from your source Region to your destination Region. For
1017
+ # more information, see [Data Transfer pricing][1].
1018
+ #
1019
+ #
1020
+ #
1021
+ # [1]: http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer
1005
1022
  #
1006
1023
  # @option params [required, String] :source_location_arn
1007
1024
  # The Amazon Resource Name (ARN) of the source location for the task.
@@ -1032,7 +1049,7 @@ module Aws::DataSync
1032
1049
  # A list of filter rules that determines which files to exclude from a
1033
1050
  # task. The list should contain a single filter string that consists of
1034
1051
  # the patterns to exclude. The patterns are delimited by "\|" (that
1035
- # is, a pipe), for example, `"/folder1|/folder2"`
1052
+ # is, a pipe), for example, `"/folder1|/folder2"`.
1036
1053
  #
1037
1054
  # @option params [Types::TaskSchedule] :schedule
1038
1055
  # Specifies a schedule used to periodically transfer files from a source
@@ -1257,11 +1274,11 @@ module Aws::DataSync
1257
1274
  end
1258
1275
 
1259
1276
  # Returns metadata, such as the path information about an Amazon FSx for
1260
- # Windows location.
1277
+ # Windows File Server location.
1261
1278
  #
1262
1279
  # @option params [required, String] :location_arn
1263
- # The Amazon Resource Name (ARN) of the FSx for Windows location to
1264
- # describe.
1280
+ # The Amazon Resource Name (ARN) of the FSx for Windows File Server
1281
+ # location to describe.
1265
1282
  #
1266
1283
  # @return [Types::DescribeLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1267
1284
  #
@@ -1335,6 +1352,8 @@ module Aws::DataSync
1335
1352
  end
1336
1353
 
1337
1354
  # Returns metadata about a self-managed object storage server location.
1355
+ # For more information about self-managed object storage locations, see
1356
+ # create-object-location.
1338
1357
  #
1339
1358
  # @option params [required, String] :location_arn
1340
1359
  # The Amazon Resource Name (ARN) of the self-managed object storage
@@ -1389,6 +1408,7 @@ module Aws::DataSync
1389
1408
  # * {Types::DescribeLocationS3Response#location_uri #location_uri} => String
1390
1409
  # * {Types::DescribeLocationS3Response#s3_storage_class #s3_storage_class} => String
1391
1410
  # * {Types::DescribeLocationS3Response#s3_config #s3_config} => Types::S3Config
1411
+ # * {Types::DescribeLocationS3Response#agent_arns #agent_arns} => Array&lt;String&gt;
1392
1412
  # * {Types::DescribeLocationS3Response#creation_time #creation_time} => Time
1393
1413
  #
1394
1414
  # @example Request syntax with placeholder values
@@ -1401,8 +1421,10 @@ module Aws::DataSync
1401
1421
  #
1402
1422
  # resp.location_arn #=> String
1403
1423
  # resp.location_uri #=> String
1404
- # resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE"
1424
+ # resp.s3_storage_class #=> String, one of "STANDARD", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
1405
1425
  # resp.s3_config.bucket_access_role_arn #=> String
1426
+ # resp.agent_arns #=> Array
1427
+ # resp.agent_arns[0] #=> String
1406
1428
  # resp.creation_time #=> Time
1407
1429
  #
1408
1430
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationS3 AWS API Documentation
@@ -1668,6 +1690,10 @@ module Aws::DataSync
1668
1690
  # next list of locations.
1669
1691
  #
1670
1692
  # @option params [Array<Types::LocationFilter>] :filters
1693
+ # You can use API filters to narrow down the list of resources returned
1694
+ # by `ListLocations`. For example, to retrieve all tasks on a specific
1695
+ # source location, you can use `ListLocations` with filter name
1696
+ # `LocationType S3` and `Operator Equals`.
1671
1697
  #
1672
1698
  # @return [Types::ListLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1673
1699
  #
@@ -1803,6 +1829,10 @@ module Aws::DataSync
1803
1829
  # next list of tasks.
1804
1830
  #
1805
1831
  # @option params [Array<Types::TaskFilter>] :filters
1832
+ # You can use API filters to narrow down the list of resources returned
1833
+ # by `ListTasks`. For example, to retrieve all tasks on a specific
1834
+ # source location, you can use `ListTasks` with filter name `LocationId`
1835
+ # and `Operator Equals` with the ARN for the location.
1806
1836
  #
1807
1837
  # @return [Types::ListTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1808
1838
  #
@@ -2000,6 +2030,217 @@ module Aws::DataSync
2000
2030
  req.send_request(options)
2001
2031
  end
2002
2032
 
2033
+ # Updates some of the parameters of a previously created location for
2034
+ # Network File System (NFS) access. For information about creating an
2035
+ # NFS location, see create-nfs-location.
2036
+ #
2037
+ # @option params [required, String] :location_arn
2038
+ # The Amazon Resource Name (ARN) of the NFS location to update.
2039
+ #
2040
+ # @option params [String] :subdirectory
2041
+ # The subdirectory in the NFS file system that is used to read data from
2042
+ # the NFS source location or write data to the NFS destination. The NFS
2043
+ # path should be a path that's exported by the NFS server, or a
2044
+ # subdirectory of that path. The path should be such that it can be
2045
+ # mounted by other NFS clients in your network.
2046
+ #
2047
+ # To see all the paths exported by your NFS server, run "`showmount -e
2048
+ # nfs-server-name`" from an NFS client that has access to your server.
2049
+ # You can specify any directory that appears in the results, and any
2050
+ # subdirectory of that directory. Ensure that the NFS export is
2051
+ # accessible without Kerberos authentication.
2052
+ #
2053
+ # To transfer all the data in the folder that you specified, DataSync
2054
+ # must have permissions to read all the data. To ensure this, either
2055
+ # configure the NFS export with `no_root_squash`, or ensure that the
2056
+ # files you want DataSync to access have permissions that allow read
2057
+ # access for all users. Doing either option enables the agent to read
2058
+ # the files. For the agent to access directories, you must additionally
2059
+ # enable all execute access.
2060
+ #
2061
+ # If you are copying data to or from your AWS Snowcone device, see [NFS
2062
+ # Server on AWS Snowcone][1] for more information.
2063
+ #
2064
+ # For information about NFS export configuration, see 18.7. The
2065
+ # /etc/exports Configuration File in the Red Hat Enterprise Linux
2066
+ # documentation.
2067
+ #
2068
+ #
2069
+ #
2070
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#nfs-on-snowcone
2071
+ #
2072
+ # @option params [Types::OnPremConfig] :on_prem_config
2073
+ # A list of Amazon Resource Names (ARNs) of agents to use for a Network
2074
+ # File System (NFS) location.
2075
+ #
2076
+ # @option params [Types::NfsMountOptions] :mount_options
2077
+ # Represents the mount options that are available for DataSync to access
2078
+ # an NFS location.
2079
+ #
2080
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2081
+ #
2082
+ # @example Request syntax with placeholder values
2083
+ #
2084
+ # resp = client.update_location_nfs({
2085
+ # location_arn: "LocationArn", # required
2086
+ # subdirectory: "NfsSubdirectory",
2087
+ # on_prem_config: {
2088
+ # agent_arns: ["AgentArn"], # required
2089
+ # },
2090
+ # mount_options: {
2091
+ # version: "AUTOMATIC", # accepts AUTOMATIC, NFS3, NFS4_0, NFS4_1
2092
+ # },
2093
+ # })
2094
+ #
2095
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationNfs AWS API Documentation
2096
+ #
2097
+ # @overload update_location_nfs(params = {})
2098
+ # @param [Hash] params ({})
2099
+ def update_location_nfs(params = {}, options = {})
2100
+ req = build_request(:update_location_nfs, params)
2101
+ req.send_request(options)
2102
+ end
2103
+
2104
+ # Updates some of the parameters of a previously created location for
2105
+ # self-managed object storage server access. For information about
2106
+ # creating a self-managed object storage location, see
2107
+ # create-object-location.
2108
+ #
2109
+ # @option params [required, String] :location_arn
2110
+ # The Amazon Resource Name (ARN) of the self-managed object storage
2111
+ # server location to be updated.
2112
+ #
2113
+ # @option params [Integer] :server_port
2114
+ # The port that your self-managed object storage server accepts inbound
2115
+ # network traffic on. The server port is set by default to TCP 80 (HTTP)
2116
+ # or TCP 443 (HTTPS). You can specify a custom port if your self-managed
2117
+ # object storage server requires one.
2118
+ #
2119
+ # @option params [String] :server_protocol
2120
+ # The protocol that the object storage server uses to communicate. Valid
2121
+ # values are `HTTP` or `HTTPS`.
2122
+ #
2123
+ # @option params [String] :subdirectory
2124
+ # The subdirectory in the self-managed object storage server that is
2125
+ # used to read data from.
2126
+ #
2127
+ # @option params [String] :access_key
2128
+ # Optional. The access key is used if credentials are required to access
2129
+ # the self-managed object storage server. If your object storage
2130
+ # requires a user name and password to authenticate, use `AccessKey` and
2131
+ # `SecretKey` to provide the user name and password, respectively.
2132
+ #
2133
+ # @option params [String] :secret_key
2134
+ # Optional. The secret key is used if credentials are required to access
2135
+ # the self-managed object storage server. If your object storage
2136
+ # requires a user name and password to authenticate, use `AccessKey` and
2137
+ # `SecretKey` to provide the user name and password, respectively.
2138
+ #
2139
+ # @option params [Array<String>] :agent_arns
2140
+ # The Amazon Resource Name (ARN) of the agents associated with the
2141
+ # self-managed object storage server location.
2142
+ #
2143
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2144
+ #
2145
+ # @example Request syntax with placeholder values
2146
+ #
2147
+ # resp = client.update_location_object_storage({
2148
+ # location_arn: "LocationArn", # required
2149
+ # server_port: 1,
2150
+ # server_protocol: "HTTPS", # accepts HTTPS, HTTP
2151
+ # subdirectory: "S3Subdirectory",
2152
+ # access_key: "ObjectStorageAccessKey",
2153
+ # secret_key: "ObjectStorageSecretKey",
2154
+ # agent_arns: ["AgentArn"],
2155
+ # })
2156
+ #
2157
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorage AWS API Documentation
2158
+ #
2159
+ # @overload update_location_object_storage(params = {})
2160
+ # @param [Hash] params ({})
2161
+ def update_location_object_storage(params = {}, options = {})
2162
+ req = build_request(:update_location_object_storage, params)
2163
+ req.send_request(options)
2164
+ end
2165
+
2166
+ # Updates some of the parameters of a previously created location for
2167
+ # Server Message Block (SMB) file system access. For information about
2168
+ # creating an SMB location, see create-smb-location.
2169
+ #
2170
+ # @option params [required, String] :location_arn
2171
+ # The Amazon Resource Name (ARN) of the SMB location to update.
2172
+ #
2173
+ # @option params [String] :subdirectory
2174
+ # The subdirectory in the SMB file system that is used to read data from
2175
+ # the SMB source location or write data to the SMB destination. The SMB
2176
+ # path should be a path that's exported by the SMB server, or a
2177
+ # subdirectory of that path. The path should be such that it can be
2178
+ # mounted by other SMB clients in your network.
2179
+ #
2180
+ # <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
2181
+ # `/path/to/folder`.
2182
+ #
2183
+ # </note>
2184
+ #
2185
+ # To transfer all the data in the folder that you specified, DataSync
2186
+ # must have permissions to mount the SMB share and to access all the
2187
+ # data in that share. To ensure this, do either of the following:
2188
+ #
2189
+ # * Ensure that the user/password specified belongs to the user who can
2190
+ # mount the share and who has the appropriate permissions for all of
2191
+ # the files and directories that you want DataSync to access.
2192
+ #
2193
+ # * Use credentials of a member of the Backup Operators group to mount
2194
+ # the share.
2195
+ #
2196
+ # Doing either of these options enables the agent to access the data.
2197
+ # For the agent to access directories, you must also enable all execute
2198
+ # access.
2199
+ #
2200
+ # @option params [String] :user
2201
+ # The user who can mount the share has the permissions to access files
2202
+ # and folders in the SMB share.
2203
+ #
2204
+ # @option params [String] :domain
2205
+ # The name of the Windows domain that the SMB server belongs to.
2206
+ #
2207
+ # @option params [String] :password
2208
+ # The password of the user who can mount the share has the permissions
2209
+ # to access files and folders in the SMB share.
2210
+ #
2211
+ # @option params [Array<String>] :agent_arns
2212
+ # The Amazon Resource Names (ARNs) of agents to use for a Simple Message
2213
+ # Block (SMB) location.
2214
+ #
2215
+ # @option params [Types::SmbMountOptions] :mount_options
2216
+ # Represents the mount options that are available for DataSync to access
2217
+ # an SMB location.
2218
+ #
2219
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2220
+ #
2221
+ # @example Request syntax with placeholder values
2222
+ #
2223
+ # resp = client.update_location_smb({
2224
+ # location_arn: "LocationArn", # required
2225
+ # subdirectory: "SmbSubdirectory",
2226
+ # user: "SmbUser",
2227
+ # domain: "SmbDomain",
2228
+ # password: "SmbPassword",
2229
+ # agent_arns: ["AgentArn"],
2230
+ # mount_options: {
2231
+ # version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
2232
+ # },
2233
+ # })
2234
+ #
2235
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationSmb AWS API Documentation
2236
+ #
2237
+ # @overload update_location_smb(params = {})
2238
+ # @param [Hash] params ({})
2239
+ def update_location_smb(params = {}, options = {})
2240
+ req = build_request(:update_location_smb, params)
2241
+ req.send_request(options)
2242
+ end
2243
+
2003
2244
  # Updates the metadata associated with a task.
2004
2245
  #
2005
2246
  # @option params [required, String] :task_arn
@@ -2081,6 +2322,69 @@ module Aws::DataSync
2081
2322
  req.send_request(options)
2082
2323
  end
2083
2324
 
2325
+ # Updates execution of a task.
2326
+ #
2327
+ # You can modify bandwidth throttling for a task execution that is
2328
+ # running or queued. For more information, see [Adjusting Bandwidth
2329
+ # Throttling for a Task Execution][1].
2330
+ #
2331
+ # <note markdown="1"> The only `Option` that can be modified by `UpdateTaskExecution` is `
2332
+ # BytesPerSecond `.
2333
+ #
2334
+ # </note>
2335
+ #
2336
+ #
2337
+ #
2338
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#adjust-bandwidth-throttling
2339
+ #
2340
+ # @option params [required, String] :task_execution_arn
2341
+ # The Amazon Resource Name (ARN) of the specific task execution that is
2342
+ # being updated.
2343
+ #
2344
+ # @option params [required, Types::Options] :options
2345
+ # Represents the options that are available to control the behavior of a
2346
+ # StartTaskExecution operation. Behavior includes preserving metadata
2347
+ # such as user ID (UID), group ID (GID), and file permissions, and also
2348
+ # overwriting files in the destination, data integrity verification, and
2349
+ # so on.
2350
+ #
2351
+ # A task has a set of default options associated with it. If you don't
2352
+ # specify an option in StartTaskExecution, the default value is used.
2353
+ # You can override the defaults options on each task execution by
2354
+ # specifying an overriding `Options` value to StartTaskExecution.
2355
+ #
2356
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2357
+ #
2358
+ # @example Request syntax with placeholder values
2359
+ #
2360
+ # resp = client.update_task_execution({
2361
+ # task_execution_arn: "TaskExecutionArn", # required
2362
+ # options: { # required
2363
+ # verify_mode: "POINT_IN_TIME_CONSISTENT", # accepts POINT_IN_TIME_CONSISTENT, ONLY_FILES_TRANSFERRED, NONE
2364
+ # overwrite_mode: "ALWAYS", # accepts ALWAYS, NEVER
2365
+ # atime: "NONE", # accepts NONE, BEST_EFFORT
2366
+ # mtime: "NONE", # accepts NONE, PRESERVE
2367
+ # uid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2368
+ # gid: "NONE", # accepts NONE, INT_VALUE, NAME, BOTH
2369
+ # preserve_deleted_files: "PRESERVE", # accepts PRESERVE, REMOVE
2370
+ # preserve_devices: "NONE", # accepts NONE, PRESERVE
2371
+ # posix_permissions: "NONE", # accepts NONE, PRESERVE
2372
+ # bytes_per_second: 1,
2373
+ # task_queueing: "ENABLED", # accepts ENABLED, DISABLED
2374
+ # log_level: "OFF", # accepts OFF, BASIC, TRANSFER
2375
+ # transfer_mode: "CHANGED", # accepts CHANGED, ALL
2376
+ # },
2377
+ # })
2378
+ #
2379
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateTaskExecution AWS API Documentation
2380
+ #
2381
+ # @overload update_task_execution(params = {})
2382
+ # @param [Hash] params ({})
2383
+ def update_task_execution(params = {}, options = {})
2384
+ req = build_request(:update_task_execution, params)
2385
+ req.send_request(options)
2386
+ end
2387
+
2084
2388
  # @!endgroup
2085
2389
 
2086
2390
  # @param params ({})
@@ -2094,7 +2398,7 @@ module Aws::DataSync
2094
2398
  params: params,
2095
2399
  config: config)
2096
2400
  context[:gem_name] = 'aws-sdk-datasync'
2097
- context[:gem_version] = '1.25.0'
2401
+ context[:gem_version] = '1.30.0'
2098
2402
  Seahorse::Client::Request.new(handlers, context)
2099
2403
  end
2100
2404