aws-sdk-datasync 1.53.0 → 1.54.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bda7f8add30800b242b5a88e11ff322675531eebe12557ea5778467e40f5dfc5
-  data.tar.gz: 81a85eba21bb83f69233fc6d310886ff787222d3a4267fa677c7115e6742b72c
+  metadata.gz: 97e0f7d566ea02a14f51a0ef17bbde1a4df491462bd89be863fb45a772066f45
+  data.tar.gz: cb9940c9eb487c9d08e31396c65465a29b8716f13dec09632dc3cd9dbe30133f
 SHA512:
-  metadata.gz: f452de2c3cf9e85d440bcb51d86d232f956f0e43ea496e88d9f2ddbfd61e018e0f6bf995e88d48c403dc1cb7ba2316128d8e5605fddee06b4b2f58824cf09999
-  data.tar.gz: 9f07888df256f90b54f78a52f18453811cccb467cee4e2ea1212e07e33c226a132419bbcc547fff32b8a372abeaa9e8b2f75759044a3e3ea45374dac3afeef08
+  metadata.gz: 710aa9e20314d90713fe60ae7205adc285983684635576cdfa79a4aeb770320042451fd243ee5502f038279503981d5069861814e1df5d047e1ac8a29f46f9fe
+  data.tar.gz: bab2c5dfc026220fd8241247ba9d2ea3a88fde9400248b1c07af6823f512052aed16766d62a857e5ae5c6aa9cbcbb680f03a099277c884d9ba59717d19e77b81

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.54.0 (2023-02-14)
+------------------
+
+* Feature - With this launch, we are giving customers the ability to use older SMB protocol versions, enabling them to use DataSync to copy data to and from their legacy storage arrays.
+
 1.53.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.53.0
+1.54.0

data/lib/aws-sdk-datasync/client.rb

@@ -689,12 +689,17 @@ module Aws::DataSync
     #   the same ports.
     #
     # @option params [required, String] :storage_virtual_machine_arn
-    #   Specifies the ARN of the storage virtual machine (SVM) on your file
-    #   system where you're copying data to or from.
+    #   Specifies the ARN of the storage virtual machine (SVM) in your file
+    #   system where you want to copy data to or from.
     #
     # @option params [String] :subdirectory
-    #   Specifies the junction path (also known as a mount point) in the SVM
-    #   volume where you're copying data to or from (for example, `/vol1`).
+    #   Specifies a path to the file share in the SVM where you'll copy your
+    #   data.
+    #
+    #   You can specify a junction path (also known as a mount point), qtree
+    #   path (for NFS file shares), or share name (for SMB file shares). For
+    #   example, your mount path might be `/vol1`, `/vol1/tree1`, or
+    #   `/share1`.
     #
     #   <note markdown="1"> Don't specify a junction path in the SVM's root volume. For more
     #   information, see [Managing FSx for ONTAP storage virtual machines][1]
@@ -727,7 +732,7 @@ module Aws::DataSync
     #       smb: {
     #         domain: "SmbDomain",
     #         mount_options: {
-    #           version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
+    #           version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3, SMB1, SMB2_0
     #         },
     #         password: "SmbPassword", # required
     #         user: "SmbUser", # required
@@ -808,7 +813,7 @@ module Aws::DataSync
     #       smb: {
     #         domain: "SmbDomain",
     #         mount_options: {
-    #           version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
+    #           version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3, SMB1, SMB2_0
     #         },
     #         password: "SmbPassword", # required
     #         user: "SmbUser", # required
@@ -1256,10 +1261,8 @@ module Aws::DataSync
     end
 
     # Creates an endpoint for an Amazon S3 bucket that DataSync can access
-    # for a transfer.
-    #
-    # For more information, see [Create an Amazon S3 location][1] in the
-    # *DataSync User Guide*.
+    # for a transfer. For more information, see [Create an Amazon S3
+    # location][1].
     #
     #
     #
@@ -1349,67 +1352,81 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Defines a file system on a Server Message Block (SMB) server that can
-    # be read from or written to.
+    # Creates an endpoint for a Server Message Block (SMB) file server that
+    # DataSync can access for a transfer. For more information, see
+    # [Creating an SMB location][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html
     #
     # @option params [required, String] :subdirectory
-    #   The subdirectory in the SMB file system that is used to read data from
-    #   the SMB source location or write data to the SMB destination. The SMB
-    #   path should be a path that's exported by the SMB server, or a
-    #   subdirectory of that path. The path should be such that it can be
-    #   mounted by other SMB clients in your network.
+    #   Specifies the name of the share exported by your SMB file server where
+    #   DataSync will read or write data. You can include a subdirectory in
+    #   the share path (for example, `/path/to/subdirectory`). Make sure that
+    #   other SMB clients in your network can also mount this path.
     #
-    #   <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
-    #   `/path/to/folder`.
+    #   To copy all data in the specified subdirectory, DataSync must be able
+    #   to mount the SMB share and access all of its data. For more
+    #   information, see [required permissions][1] for SMB locations.
     #
-    #    </note>
     #
-    #   To transfer all the data in the folder you specified, DataSync needs
-    #   to have permissions to mount the SMB share, as well as to access all
-    #   the data in that share. To ensure this, either ensure that the
-    #   user/password specified belongs to the user who can mount the share,
-    #   and who has the appropriate permissions for all of the files and
-    #   directories that you want DataSync to access, or use credentials of a
-    #   member of the Backup Operators group to mount the share. Doing either
-    #   enables the agent to access the data. For the agent to access
-    #   directories, you must additionally enable all execute access.
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #
     # @option params [required, String] :server_hostname
-    #   The name of the SMB server. This value is the IP address or Domain
-    #   Name Service (DNS) name of the SMB server. An agent that is installed
-    #   on-premises uses this hostname to mount the SMB server in a network.
+    #   Specifies the Domain Name Service (DNS) name or IP address of the SMB
+    #   file server that your DataSync agent will mount.
     #
-    #   <note markdown="1"> This name must either be DNS-compliant or must be an IP version 4
-    #   (IPv4) address.
+    #   <note markdown="1"> You can't specify an IP version 6 (IPv6) address.
     #
     #    </note>
     #
     # @option params [required, String] :user
-    #   The user who can mount the share, has the permissions to access files
-    #   and folders in the SMB share.
+    #   Specifies the user name that can mount your SMB file server and has
+    #   permission to access the files and folders involved in your transfer.
+    #
+    #   For information about choosing a user with the right level of access
+    #   for your transfer, see [required permissions][1] for SMB locations.
     #
-    #   For information about choosing a user name that ensures sufficient
-    #   permissions to files, folders, and metadata, see the [User
-    #   setting](create-smb-location.html#SMBuser) for SMB locations.
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #
     # @option params [String] :domain
-    #   The name of the Windows domain that the SMB server belongs to.
+    #   Specifies the Windows domain name that your SMB file server belongs
+    #   to.
+    #
+    #   For more information, see [required permissions][1] for SMB locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #
     # @option params [required, String] :password
-    #   The password of the user who can mount the share, has the permissions
-    #   to access files and folders in the SMB share.
+    #   Specifies the password of the user who can mount your SMB file server
+    #   and has permission to access the files and folders involved in your
+    #   transfer.
+    #
+    #   For more information, see [required permissions][1] for SMB locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #
     # @option params [required, Array<String>] :agent_arns
-    #   The Amazon Resource Names (ARNs) of agents to use for a Simple Message
-    #   Block (SMB) location.
+    #   Specifies the DataSync agent (or agents) which you want to connect to
+    #   your SMB file server. You specify an agent by using its Amazon
+    #   Resource Name (ARN).
     #
     # @option params [Types::SmbMountOptions] :mount_options
-    #   The mount options used by DataSync to access the SMB server.
+    #   Specifies the version of the SMB protocol that DataSync uses to access
+    #   your SMB file server.
     #
     # @option params [Array<Types::TagListEntry>] :tags
-    #   The key-value pair that represents the tag that you want to add to the
-    #   location. The value can be an empty string. We recommend using tags to
-    #   name your resources.
+    #   Specifies labels that help you categorize, filter, and search for your
+    #   Amazon Web Services resources. We recommend creating at least a name
+    #   tag for your location.
     #
     # @return [Types::CreateLocationSmbResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1425,7 +1442,7 @@ module Aws::DataSync
     #     password: "SmbPassword", # required
     #     agent_arns: ["AgentArn"], # required
     #     mount_options: {
-    #       version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
+    #       version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3, SMB1, SMB2_0
     #     },
     #     tags: [
     #       {
@@ -1653,13 +1670,12 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns metadata such as the name, the network interfaces, and the
-    # status (that is, whether the agent is running or not) for an agent. To
-    # specify which agent to describe, use the Amazon Resource Name (ARN) of
-    # the agent in your request.
+    # Returns metadata about an DataSync agent, such as its name, endpoint
+    # type, and status.
     #
     # @option params [required, String] :agent_arn
-    #   The Amazon Resource Name (ARN) of the agent to describe.
+    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent to
+    #   describe.
     #
     # @return [Types::DescribeAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1817,7 +1833,7 @@ module Aws::DataSync
     #   resp.location_uri #=> String
     #   resp.protocol.nfs.mount_options.version #=> String, one of "AUTOMATIC", "NFS3", "NFS4_0", "NFS4_1"
     #   resp.protocol.smb.domain #=> String
-    #   resp.protocol.smb.mount_options.version #=> String, one of "AUTOMATIC", "SMB2", "SMB3"
+    #   resp.protocol.smb.mount_options.version #=> String, one of "AUTOMATIC", "SMB2", "SMB3", "SMB1", "SMB2_0"
     #   resp.protocol.smb.password #=> String
     #   resp.protocol.smb.user #=> String
     #   resp.security_group_arns #=> Array
@@ -1868,7 +1884,7 @@ module Aws::DataSync
     #   resp.security_group_arns[0] #=> String
     #   resp.protocol.nfs.mount_options.version #=> String, one of "AUTOMATIC", "NFS3", "NFS4_0", "NFS4_1"
     #   resp.protocol.smb.domain #=> String
-    #   resp.protocol.smb.mount_options.version #=> String, one of "AUTOMATIC", "SMB2", "SMB3"
+    #   resp.protocol.smb.mount_options.version #=> String, one of "AUTOMATIC", "SMB2", "SMB3", "SMB1", "SMB2_0"
     #   resp.protocol.smb.password #=> String
     #   resp.protocol.smb.user #=> String
     #   resp.creation_time #=> Time
@@ -2132,7 +2148,7 @@ module Aws::DataSync
     #   resp.agent_arns[0] #=> String
     #   resp.user #=> String
     #   resp.domain #=> String
-    #   resp.mount_options.version #=> String, one of "AUTOMATIC", "SMB2", "SMB3"
+    #   resp.mount_options.version #=> String, one of "AUTOMATIC", "SMB2", "SMB3", "SMB1", "SMB2_0"
     #   resp.creation_time #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationSmb AWS API Documentation
@@ -2300,25 +2316,35 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns a list of agents owned by an Amazon Web Services account in
-    # the Amazon Web Services Region specified in the request. The returned
-    # list is ordered by agent Amazon Resource Name (ARN).
+    # Returns a list of DataSync agents that belong to an Amazon Web
+    # Services account in the Amazon Web Services Region specified in the
+    # request.
     #
-    # By default, this operation returns a maximum of 100 agents. This
-    # operation supports pagination that enables you to optionally reduce
-    # the number of agents returned in a response.
+    # With pagination, you can reduce the number of agents returned in a
+    # response. If you get a truncated list of agents in a response, the
+    # response contains a marker that you can specify in your next request
+    # to fetch the next page of agents.
     #
-    # If you have more agents than are returned in a response (that is, the
-    # response returns only a truncated list of your agents), the response
-    # contains a marker that you can specify in your next request to fetch
-    # the next page of agents.
+    # `ListAgents` is eventually consistent. This means the result of
+    # running the operation might not reflect that you just created or
+    # deleted an agent. For example, if you create an agent with
+    # [CreateAgent][1] and then immediately run `ListAgents`, that agent
+    # might not show up in the list right away. In situations like this, you
+    # can always confirm whether an agent has been created (or deleted) by
+    # using [DescribeAgent][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html
+    # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html
     #
     # @option params [Integer] :max_results
-    #   The maximum number of agents to list.
+    #   Specifies the maximum number of DataSync agents to list in a response.
+    #   By default, a response shows a maximum of 100 agents.
     #
     # @option params [String] :next_token
-    #   An opaque string that indicates the position at which to begin the
-    #   next list of agents.
+    #   Specifies an opaque string that indicates the position to begin the
+    #   next list of results in the response.
     #
     # @return [Types::ListAgentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3037,7 +3063,8 @@ module Aws::DataSync
     #   Block (SMB) location.
     #
     # @option params [Types::SmbMountOptions] :mount_options
-    #   Specifies how DataSync can access a location using the SMB protocol.
+    #   Specifies the version of the Server Message Block (SMB) protocol that
+    #   DataSync uses to access an SMB file server.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3051,7 +3078,7 @@ module Aws::DataSync
     #     password: "SmbPassword",
     #     agent_arns: ["AgentArn"],
     #     mount_options: {
-    #       version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3
+    #       version: "AUTOMATIC", # accepts AUTOMATIC, SMB2, SMB3, SMB1, SMB2_0
     #     },
     #   })
     #
@@ -3242,7 +3269,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.53.0'
+      context[:gem_version] = '1.54.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-datasync/endpoint_parameters.rb

@@ -50,9 +50,6 @@ module Aws::DataSync
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

data/lib/aws-sdk-datasync/endpoint_provider.rb

@@ -14,36 +14,39 @@ module Aws::DataSync
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint)
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://datasync-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://datasync-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://datasync.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://datasync-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://datasync-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://datasync.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://datasync.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://datasync.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

data/lib/aws-sdk-datasync/types.rb

@@ -10,24 +10,28 @@
 module Aws::DataSync
   module Types
 
-    # Represents a single entry in a list of agents. `AgentListEntry`
-    # returns an array that contains a list of agents when the
-    # [ListAgents][1] operation is called.
+    # Represents a single entry in a list (or array) of DataSync agents when
+    # you call the [ListAgents][1] operation.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html
     #
     # @!attribute [rw] agent_arn
-    #   The Amazon Resource Name (ARN) of the agent.
+    #   The Amazon Resource Name (ARN) of a DataSync agent.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the agent.
+    #   The name of an agent.
     #   @return [String]
     #
     # @!attribute [rw] status
-    #   The status of the agent.
+    #   The status of an agent. For more information, see [DataSync agent
+    #   statuses][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/understand-agent-statuses.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/AgentListEntry AWS API Documentation
@@ -303,13 +307,18 @@ module Aws::DataSync
     #   @return [Array<String>]
     #
     # @!attribute [rw] storage_virtual_machine_arn
-    #   Specifies the ARN of the storage virtual machine (SVM) on your file
-    #   system where you're copying data to or from.
+    #   Specifies the ARN of the storage virtual machine (SVM) in your file
+    #   system where you want to copy data to or from.
     #   @return [String]
     #
     # @!attribute [rw] subdirectory
-    #   Specifies the junction path (also known as a mount point) in the SVM
-    #   volume where you're copying data to or from (for example, `/vol1`).
+    #   Specifies a path to the file share in the SVM where you'll copy
+    #   your data.
+    #
+    #   You can specify a junction path (also known as a mount point), qtree
+    #   path (for NFS file shares), or share name (for SMB file shares). For
+    #   example, your mount path might be `/vol1`, `/vol1/tree1`, or
+    #   `/share1`.
     #
     #   <note markdown="1"> Don't specify a junction path in the SVM's root volume. For more
     #   information, see [Managing FSx for ONTAP storage virtual
@@ -900,71 +909,83 @@ module Aws::DataSync
     # CreateLocationSmbRequest
     #
     # @!attribute [rw] subdirectory
-    #   The subdirectory in the SMB file system that is used to read data
-    #   from the SMB source location or write data to the SMB destination.
-    #   The SMB path should be a path that's exported by the SMB server, or
-    #   a subdirectory of that path. The path should be such that it can be
-    #   mounted by other SMB clients in your network.
+    #   Specifies the name of the share exported by your SMB file server
+    #   where DataSync will read or write data. You can include a
+    #   subdirectory in the share path (for example,
+    #   `/path/to/subdirectory`). Make sure that other SMB clients in your
+    #   network can also mount this path.
     #
-    #   <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
-    #   `/path/to/folder`.
+    #   To copy all data in the specified subdirectory, DataSync must be
+    #   able to mount the SMB share and access all of its data. For more
+    #   information, see [required permissions][1] for SMB locations.
     #
-    #    </note>
     #
-    #   To transfer all the data in the folder you specified, DataSync needs
-    #   to have permissions to mount the SMB share, as well as to access all
-    #   the data in that share. To ensure this, either ensure that the
-    #   user/password specified belongs to the user who can mount the share,
-    #   and who has the appropriate permissions for all of the files and
-    #   directories that you want DataSync to access, or use credentials of
-    #   a member of the Backup Operators group to mount the share. Doing
-    #   either enables the agent to access the data. For the agent to access
-    #   directories, you must additionally enable all execute access.
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #   @return [String]
     #
     # @!attribute [rw] server_hostname
-    #   The name of the SMB server. This value is the IP address or Domain
-    #   Name Service (DNS) name of the SMB server. An agent that is
-    #   installed on-premises uses this hostname to mount the SMB server in
-    #   a network.
+    #   Specifies the Domain Name Service (DNS) name or IP address of the
+    #   SMB file server that your DataSync agent will mount.
     #
-    #   <note markdown="1"> This name must either be DNS-compliant or must be an IP version 4
-    #   (IPv4) address.
+    #   <note markdown="1"> You can't specify an IP version 6 (IPv6) address.
     #
     #    </note>
     #   @return [String]
     #
     # @!attribute [rw] user
-    #   The user who can mount the share, has the permissions to access
-    #   files and folders in the SMB share.
+    #   Specifies the user name that can mount your SMB file server and has
+    #   permission to access the files and folders involved in your
+    #   transfer.
     #
-    #   For information about choosing a user name that ensures sufficient
-    #   permissions to files, folders, and metadata, see the [User
-    #   setting](create-smb-location.html#SMBuser) for SMB locations.
+    #   For information about choosing a user with the right level of access
+    #   for your transfer, see [required permissions][1] for SMB locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #   @return [String]
     #
     # @!attribute [rw] domain
-    #   The name of the Windows domain that the SMB server belongs to.
+    #   Specifies the Windows domain name that your SMB file server belongs
+    #   to.
+    #
+    #   For more information, see [required permissions][1] for SMB
+    #   locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #   @return [String]
     #
     # @!attribute [rw] password
-    #   The password of the user who can mount the share, has the
-    #   permissions to access files and folders in the SMB share.
+    #   Specifies the password of the user who can mount your SMB file
+    #   server and has permission to access the files and folders involved
+    #   in your transfer.
+    #
+    #   For more information, see [required permissions][1] for SMB
+    #   locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #   @return [String]
     #
     # @!attribute [rw] agent_arns
-    #   The Amazon Resource Names (ARNs) of agents to use for a Simple
-    #   Message Block (SMB) location.
+    #   Specifies the DataSync agent (or agents) which you want to connect
+    #   to your SMB file server. You specify an agent by using its Amazon
+    #   Resource Name (ARN).
     #   @return [Array<String>]
     #
     # @!attribute [rw] mount_options
-    #   The mount options used by DataSync to access the SMB server.
+    #   Specifies the version of the SMB protocol that DataSync uses to
+    #   access your SMB file server.
     #   @return [Types::SmbMountOptions]
     #
     # @!attribute [rw] tags
-    #   The key-value pair that represents the tag that you want to add to
-    #   the location. The value can be an empty string. We recommend using
-    #   tags to name your resources.
+    #   Specifies labels that help you categorize, filter, and search for
+    #   your Amazon Web Services resources. We recommend creating at least a
+    #   name tag for your location.
     #   @return [Array<Types::TagListEntry>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationSmbRequest AWS API Documentation
@@ -985,8 +1006,7 @@ module Aws::DataSync
     # CreateLocationSmbResponse
     #
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the source SMB file system
-    #   location that is created.
+    #   The ARN of the SMB location that you created.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationSmbResponse AWS API Documentation
@@ -1159,7 +1179,8 @@ module Aws::DataSync
     # DescribeAgent
     #
     # @!attribute [rw] agent_arn
-    #   The Amazon Resource Name (ARN) of the agent to describe.
+    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent to
+    #   describe.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeAgentRequest AWS API Documentation
@@ -1173,7 +1194,7 @@ module Aws::DataSync
     # DescribeAgentResponse
     #
     # @!attribute [rw] agent_arn
-    #   The Amazon Resource Name (ARN) of the agent.
+    #   The ARN of the agent.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -2239,7 +2260,8 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] mount_options
-    #   Specifies how DataSync can access a location using the SMB protocol.
+    #   Specifies the version of the Server Message Block (SMB) protocol
+    #   that DataSync uses to access an SMB file server.
     #   @return [Types::SmbMountOptions]
     #
     # @!attribute [rw] password
@@ -2359,12 +2381,13 @@ module Aws::DataSync
     # ListAgentsRequest
     #
     # @!attribute [rw] max_results
-    #   The maximum number of agents to list.
+    #   Specifies the maximum number of DataSync agents to list in a
+    #   response. By default, a response shows a maximum of 100 agents.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   An opaque string that indicates the position at which to begin the
-    #   next list of agents.
+    #   Specifies an opaque string that indicates the position to begin the
+    #   next list of results in the response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListAgentsRequest AWS API Documentation
@@ -2379,12 +2402,14 @@ module Aws::DataSync
     # ListAgentsResponse
     #
     # @!attribute [rw] agents
-    #   A list of agents in your account.
+    #   A list of DataSync agents in your Amazon Web Services account in the
+    #   Amazon Web Services Region specified in the request. The list is
+    #   ordered by the agents' Amazon Resource Names (ARNs).
     #   @return [Array<Types::AgentListEntry>]
     #
     # @!attribute [rw] next_token
-    #   An opaque string that indicates the position at which to begin
-    #   returning the next list of agents.
+    #   The opaque string that indicates the position to begin the next list
+    #   of results in the response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListAgentsResponse AWS API Documentation
@@ -2775,7 +2800,7 @@ module Aws::DataSync
     #   Some storage classes have specific behaviors that can affect your
     #   Amazon S3 storage cost. For detailed information, see
     #   [Considerations when working with Amazon S3 storage classes in
-    #   DataSync ][1].
+    #   DataSync][1].
     #
     #
     #
@@ -2871,7 +2896,7 @@ module Aws::DataSync
     #   Amazon S3 storage cost. If your task deletes objects, you might
     #   incur minimum storage duration charges for certain storage classes.
     #   For detailed information, see [Considerations when working with
-    #   Amazon S3 storage classes in DataSync ][1].
+    #   Amazon S3 storage classes in DataSync][1].
     #
     #   Default value: `PRESERVE`
     #
@@ -2880,6 +2905,12 @@ module Aws::DataSync
     #   `REMOVE`\: Delete destination files that aren’t present in the
     #   source.
     #
+    #   <note markdown="1"> If you set this parameter to `REMOVE`, you can't set `TransferMode`
+    #   to `ALL`. When you transfer all data, DataSync doesn't scan your
+    #   destination location and doesn't know what to delete.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes
@@ -3137,13 +3168,46 @@ module Aws::DataSync
       include Aws::Structure
     end
 
-    # Specifies how DataSync can access a location using the SMB protocol.
+    # Specifies the version of the Server Message Block (SMB) protocol that
+    # DataSync uses to access an SMB file server.
     #
     # @!attribute [rw] version
-    #   Specifies the SMB version that you want DataSync to use when
-    #   mounting your SMB share. If you don't specify a version, DataSync
-    #   defaults to `AUTOMATIC` and chooses a version based on negotiation
-    #   with the SMB server.
+    #   By default, DataSync automatically chooses an SMB protocol version
+    #   based on negotiation with your SMB file server. You also can
+    #   configure DataSync to use a specific SMB version, but we recommend
+    #   doing this only if DataSync has trouble negotiating with the SMB
+    #   file server automatically.
+    #
+    #   These are the following options for configuring the SMB version:
+    #
+    #   * `AUTOMATIC` (default): DataSync and the SMB file server negotiate
+    #     a protocol version that they mutually support. (DataSync supports
+    #     SMB versions 1.0 and later.)
+    #
+    #     This is the recommended option. If you instead choose a specific
+    #     version that your file server doesn't support, you may get an
+    #     `Operation Not Supported` error.
+    #
+    #   * `SMB3`\: Restricts the protocol negotiation to only SMB version
+    #     3.0.2.
+    #
+    #   * `SMB2`\: Restricts the protocol negotiation to only SMB version
+    #     2.1.
+    #
+    #   * `SMB2_0`\: Restricts the protocol negotiation to only SMB version
+    #     2.0.
+    #
+    #   * `SMB1`\: Restricts the protocol negotiation to only SMB version
+    #     1.0.
+    #
+    #     <note markdown="1"> The `SMB1` option isn't available when [creating an Amazon FSx
+    #     for NetApp ONTAP location][1].
+    #
+    #      </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/SmbMountOptions AWS API Documentation
@@ -3765,7 +3829,8 @@ module Aws::DataSync
     #   @return [Array<String>]
     #
     # @!attribute [rw] mount_options
-    #   Specifies how DataSync can access a location using the SMB protocol.
+    #   Specifies the version of the Server Message Block (SMB) protocol
+    #   that DataSync uses to access an SMB file server.
     #   @return [Types::SmbMountOptions]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationSmbRequest AWS API Documentation

data/lib/aws-sdk-datasync.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.53.0'
+  GEM_VERSION = '1.54.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.53.0
+  version: 1.54.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core