aws-sdk-datasync 1.25.0 → 1.30.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: 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