aws-sdk-datasync 1.67.0 → 1.68.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99bd220f4b18457447917bd4508d22d96b3a1262b6e18e53c2819623fa2d256f
-  data.tar.gz: 0ac541cab0ff268f96f0442d7dd7e62c5556f0f9e2223d3b70df7a3c04b06dfd
+  metadata.gz: b7e22c7f83246705a4b652bf20f2db9b8a452dd4dfb5527257f8f8afe334f21d
+  data.tar.gz: cac1fbe160b3890c2f86647ac112aef0281b15f2789e81060f3eb39b1d086994
 SHA512:
-  metadata.gz: 0402540e2ba8143647e2e828ffe079dbdd9937dfbbca55c60239e6869d7b607fb2a13657ec357ef6874f712d5e5efe17c136a66ad3a177132f45f4f77a335ab7
-  data.tar.gz: 6c52f8e65fdad0ee829593540b9d1f5a2edb66804d28d3cb45c2e3cd746d46159620d38d0b5cb6d7caf40b8a9047c677f148941bfd8f199125678b546752e6fe
+  metadata.gz: c888e01400413b54a2ff3aba2625a49cb89c2e0f69de5f973e573ec2cd02af6fa0abedb47c7e3f8f8537efc88f3de068375019bae575765af016553d6ebe5359
+  data.tar.gz: 873f95c59b8fdd6b444f6a0fa193ed71b4103e1e0267ff38439861c8c29073d3c31eb9649ef57e695855ac80cbbbf443e8df4f2557482c7d909e9ae7848e812d

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.68.0 (2023-10-30)
+------------------
+
+* Feature - Platform version changes to support AL1 deprecation initiative.
+
 1.67.0 (2023-09-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.67.0
+1.68.0

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

@@ -857,12 +857,14 @@ module Aws::DataSync
     end
 
     # Creates an endpoint for an Amazon FSx for NetApp ONTAP file system
-    # that DataSync can access for a transfer. For more information, see
-    # [Creating a location for FSx for ONTAP][1].
+    # that DataSync can use for a data transfer.
+    #
+    # Before you begin, make sure that you understand how DataSync [accesses
+    # an FSx for ONTAP file system][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access
     #
     # @option params [required, Types::FsxProtocol] :protocol
     #   Specifies the data transfer protocol that DataSync uses to access your
@@ -1037,7 +1039,14 @@ module Aws::DataSync
     end
 
     # Creates an endpoint for an Amazon FSx for Windows File Server file
-    # system.
+    # system that DataSync can use for a data transfer.
+    #
+    # Before you begin, make sure that you understand how DataSync [accesses
+    # an FSx for Windows File Server][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access
     #
     # @option params [String] :subdirectory
     #   Specifies a mount path for your file system using forward slashes.
@@ -1072,8 +1081,9 @@ module Aws::DataSync
     #   Specifies the user who has the permissions to access files, folders,
     #   and metadata in your file system.
     #
-    #   For information about choosing a user with sufficient permissions, see
-    #   [Required permissions][1].
+    #   For information about choosing a user with the right level of access
+    #   for your transfer, see [required permissions][1] for FSx for Windows
+    #   File Server locations.
     #
     #
     #
@@ -1083,10 +1093,27 @@ module Aws::DataSync
     #   Specifies the name of the Windows domain that the FSx for Windows File
     #   Server belongs to.
     #
+    #   If you have multiple domains in your environment, configuring this
+    #   parameter makes sure that DataSync connects to the right file server.
+    #
+    #   For more information, see [required permissions][1] for FSx for
+    #   Windows File Server locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions
+    #
     # @option params [required, String] :password
     #   Specifies the password of the user who has the permissions to access
     #   files and folders in the file system.
     #
+    #   For more information, see [required permissions][1] for FSx for
+    #   Windows File Server locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions
+    #
     # @return [Types::CreateLocationFsxWindowsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateLocationFsxWindowsResponse#location_arn #location_arn} => String
@@ -1597,6 +1624,9 @@ module Aws::DataSync
     #   Specifies the Windows domain name that your SMB file server belongs
     #   to.
     #
+    #   If you have multiple domains in your environment, configuring this
+    #   parameter makes sure that DataSync connects to the right file server.
+    #
     #   For more information, see [required permissions][1] for SMB locations.
     #
     #
@@ -1836,11 +1866,18 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Deletes an agent. To specify which agent to delete, use the Amazon
-    # Resource Name (ARN) of the agent in your request. The operation
-    # disassociates the agent from your Amazon Web Services account.
-    # However, it doesn't delete the agent virtual machine (VM) from your
-    # on-premises environment.
+    # Removes an DataSync agent resource from your Amazon Web Services
+    # account.
+    #
+    # Keep in mind that this operation (which can't be undone) doesn't
+    # remove the agent's virtual machine (VM) or Amazon EC2 instance from
+    # your storage environment. For next steps, you can delete the VM or
+    # instance from your storage environment or reuse it to [activate a new
+    # agent][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html
     #
     # @option params [required, String] :agent_arn
     #   The Amazon Resource Name (ARN) of the agent to delete. Use the
@@ -1909,12 +1946,12 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Returns metadata about an DataSync agent, such as its name, endpoint
-    # type, and status.
+    # Returns information about an DataSync agent, such as its name, service
+    # endpoint type, and status.
     #
     # @option params [required, String] :agent_arn
-    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent to
-    #   describe.
+    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent that
+    #   you want information about.
     #
     # @return [Types::DescribeAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1925,6 +1962,7 @@ module Aws::DataSync
     #   * {Types::DescribeAgentResponse#creation_time #creation_time} => Time
     #   * {Types::DescribeAgentResponse#endpoint_type #endpoint_type} => String
     #   * {Types::DescribeAgentResponse#private_link_config #private_link_config} => Types::PrivateLinkConfig
+    #   * {Types::DescribeAgentResponse#platform #platform} => Types::Platform
     #
     # @example Request syntax with placeholder values
     #
@@ -1946,6 +1984,7 @@ module Aws::DataSync
     #   resp.private_link_config.subnet_arns[0] #=> String
     #   resp.private_link_config.security_group_arns #=> Array
     #   resp.private_link_config.security_group_arns[0] #=> String
+    #   resp.platform.version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeAgent AWS API Documentation
     #
@@ -3054,6 +3093,7 @@ module Aws::DataSync
     #   resp.agents[0].agent_arn #=> String
     #   resp.agents[0].name #=> String
     #   resp.agents[0].status #=> String, one of "ONLINE", "OFFLINE"
+    #   resp.agents[0].platform.version #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListAgents AWS API Documentation
@@ -3673,7 +3713,7 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Updates the name of an agent.
+    # Updates the name of an DataSync agent.
     #
     # @option params [required, String] :agent_arn
     #   The Amazon Resource Name (ARN) of the agent to update.
@@ -4031,58 +4071,65 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Updates some of the parameters of a previously created location for
-    # Server Message Block (SMB) file system access. For information about
-    # creating an SMB location, see [Creating a location for SMB][1].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html
+    # Updates some of the parameters of a Server Message Block (SMB) file
+    # server location that you can use for DataSync transfers.
     #
     # @option params [required, String] :location_arn
-    #   The Amazon Resource Name (ARN) of the SMB location to update.
+    #   Specifies the ARN of the SMB location that you want to update.
     #
     # @option params [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.
+    #
+    #   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 markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
-    #   `/path/to/folder`.
     #
-    #    </note>
     #
-    #   To transfer all the data in the folder that you specified, DataSync
-    #   must have permissions to mount the SMB share and to access all the
-    #   data in that share. To ensure this, do either of the following:
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
+    #
+    # @option params [String] :user
+    #   Specifies the user name that can mount your SMB file server and has
+    #   permission to access the files and folders involved in your transfer.
     #
-    #   * 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.
+    #   For information about choosing a user with the right level of access
+    #   for your transfer, see [required permissions][1] for SMB locations.
     #
-    #   * Use credentials of a member of the Backup Operators group to mount
-    #     the share.
     #
-    #   Doing either of these options enables the agent to access the data.
-    #   For the agent to access directories, you must also enable all execute
-    #   access.
     #
-    # @option params [String] :user
-    #   The user who can mount the share has the permissions to access files
-    #   and folders in the SMB share.
+    #   [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.
+    #
+    #   If you have multiple domains in your environment, configuring this
+    #   parameter makes sure that DataSync connects to the right file server.
+    #
+    #   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 [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 [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
     #   Specifies the version of the Server Message Block (SMB) protocol that
@@ -4369,7 +4416,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.67.0'
+      context[:gem_version] = '1.68.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -21,6 +21,7 @@ module Aws::DataSync
     AgentList = Shapes::ListShape.new(name: 'AgentList')
     AgentListEntry = Shapes::StructureShape.new(name: 'AgentListEntry')
     AgentStatus = Shapes::StringShape.new(name: 'AgentStatus')
+    AgentVersion = Shapes::StringShape.new(name: 'AgentVersion')
     Atime = Shapes::StringShape.new(name: 'Atime')
     AzureAccessTier = Shapes::StringShape.new(name: 'AzureAccessTier')
     AzureBlobAuthenticationType = Shapes::StringShape.new(name: 'AzureBlobAuthenticationType')
@@ -228,6 +229,7 @@ module Aws::DataSync
     PLSecurityGroupArnList = Shapes::ListShape.new(name: 'PLSecurityGroupArnList')
     PLSubnetArnList = Shapes::ListShape.new(name: 'PLSubnetArnList')
     PhaseStatus = Shapes::StringShape.new(name: 'PhaseStatus')
+    Platform = Shapes::StructureShape.new(name: 'Platform')
     PosixPermissions = Shapes::StringShape.new(name: 'PosixPermissions')
     PreserveDeletedFiles = Shapes::StringShape.new(name: 'PreserveDeletedFiles')
     PreserveDevices = Shapes::StringShape.new(name: 'PreserveDevices')
@@ -356,6 +358,7 @@ module Aws::DataSync
     AgentListEntry.add_member(:agent_arn, Shapes::ShapeRef.new(shape: AgentArn, location_name: "AgentArn"))
     AgentListEntry.add_member(:name, Shapes::ShapeRef.new(shape: TagValue, location_name: "Name"))
     AgentListEntry.add_member(:status, Shapes::ShapeRef.new(shape: AgentStatus, location_name: "Status"))
+    AgentListEntry.add_member(:platform, Shapes::ShapeRef.new(shape: Platform, location_name: "Platform"))
     AgentListEntry.struct_class = Types::AgentListEntry
 
     AzureBlobSasConfiguration.add_member(:token, Shapes::ShapeRef.new(shape: AzureBlobSasToken, required: true, location_name: "Token"))
@@ -560,6 +563,7 @@ module Aws::DataSync
     DescribeAgentResponse.add_member(:creation_time, Shapes::ShapeRef.new(shape: Time, location_name: "CreationTime"))
     DescribeAgentResponse.add_member(:endpoint_type, Shapes::ShapeRef.new(shape: EndpointType, location_name: "EndpointType"))
     DescribeAgentResponse.add_member(:private_link_config, Shapes::ShapeRef.new(shape: PrivateLinkConfig, location_name: "PrivateLinkConfig"))
+    DescribeAgentResponse.add_member(:platform, Shapes::ShapeRef.new(shape: Platform, location_name: "Platform"))
     DescribeAgentResponse.struct_class = Types::DescribeAgentResponse
 
     DescribeDiscoveryJobRequest.add_member(:discovery_job_arn, Shapes::ShapeRef.new(shape: DiscoveryJobArn, required: true, location_name: "DiscoveryJobArn"))
@@ -1044,6 +1048,9 @@ module Aws::DataSync
 
     PLSubnetArnList.member = Shapes::ShapeRef.new(shape: Ec2SubnetArn)
 
+    Platform.add_member(:version, Shapes::ShapeRef.new(shape: AgentVersion, location_name: "Version"))
+    Platform.struct_class = Types::Platform
+
     PrivateLinkConfig.add_member(:vpc_endpoint_id, Shapes::ShapeRef.new(shape: VpcEndpointId, location_name: "VpcEndpointId"))
     PrivateLinkConfig.add_member(:private_link_endpoint, Shapes::ShapeRef.new(shape: Endpoint, location_name: "PrivateLinkEndpoint"))
     PrivateLinkConfig.add_member(:subnet_arns, Shapes::ShapeRef.new(shape: PLSubnetArnList, location_name: "SubnetArns"))

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

@@ -32,7 +32,7 @@ module Aws::DataSync
             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"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               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"

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

@@ -104,20 +104,33 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] status
-    #   The status of an agent. For more information, see [DataSync agent
-    #   statuses][1].
+    #   The status of an agent.
     #
+    #   * If the status is `ONLINE`, the agent is configured properly and
+    #     ready to use.
     #
+    #   * If the status is `OFFLINE`, the agent has been out of contact with
+    #     DataSync for five minutes or longer. This can happen for a few
+    #     reasons. For more information, see [What do I do if my agent is
+    #     offline?][1]
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/understand-agent-statuses.html
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline
     #   @return [String]
     #
+    # @!attribute [rw] platform
+    #   The platform-related details about the agent, such as the version
+    #   number.
+    #   @return [Types::Platform]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/AgentListEntry AWS API Documentation
     #
     class AgentListEntry < Struct.new(
       :agent_arn,
       :name,
-      :status)
+      :status,
+      :platform)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -664,8 +677,9 @@ module Aws::DataSync
     #   Specifies the user who has the permissions to access files, folders,
     #   and metadata in your file system.
     #
-    #   For information about choosing a user with sufficient permissions,
-    #   see [Required permissions][1].
+    #   For information about choosing a user with the right level of access
+    #   for your transfer, see [required permissions][1] for FSx for Windows
+    #   File Server locations.
     #
     #
     #
@@ -675,11 +689,29 @@ module Aws::DataSync
     # @!attribute [rw] domain
     #   Specifies the name of the Windows domain that the FSx for Windows
     #   File Server belongs to.
+    #
+    #   If you have multiple domains in your environment, configuring this
+    #   parameter makes sure that DataSync connects to the right file
+    #   server.
+    #
+    #   For more information, see [required permissions][1] for FSx for
+    #   Windows File Server locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions
     #   @return [String]
     #
     # @!attribute [rw] password
     #   Specifies the password of the user who has the permissions to access
     #   files and folders in the file system.
+    #
+    #   For more information, see [required permissions][1] for FSx for
+    #   Windows File Server locations.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/CreateLocationFsxWindowsRequest AWS API Documentation
@@ -1143,6 +1175,10 @@ module Aws::DataSync
     #   Specifies the Windows domain name that your SMB file server belongs
     #   to.
     #
+    #   If you have multiple domains in your environment, configuring this
+    #   parameter makes sure that DataSync connects to the right file
+    #   server.
+    #
     #   For more information, see [required permissions][1] for SMB
     #   locations.
     #
@@ -1409,8 +1445,8 @@ module Aws::DataSync
     # DescribeAgent
     #
     # @!attribute [rw] agent_arn
-    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent to
-    #   describe.
+    #   Specifies the Amazon Resource Name (ARN) of the DataSync agent that
+    #   you want information about.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeAgentRequest AWS API Documentation
@@ -1432,34 +1468,56 @@ module Aws::DataSync
     #   @return [String]
     #
     # @!attribute [rw] status
-    #   The status of the agent. If the status is ONLINE, then the agent is
-    #   configured properly and is available to use. The Running status is
-    #   the normal running status for an agent. If the status is OFFLINE,
-    #   the agent's VM is turned off or the agent is in an unhealthy state.
-    #   When the issue that caused the unhealthy state is resolved, the
-    #   agent returns to ONLINE status.
+    #   The status of the agent.
+    #
+    #   * If the status is `ONLINE`, the agent is configured properly and
+    #     ready to use.
+    #
+    #   * If the status is `OFFLINE`, the agent has been out of contact with
+    #     DataSync for five minutes or longer. This can happen for a few
+    #     reasons. For more information, see [What do I do if my agent is
+    #     offline?][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline
     #   @return [String]
     #
     # @!attribute [rw] last_connection_time
-    #   The time that the agent last connected to DataSync.
+    #   The last time that the agent was communicating with the DataSync
+    #   service.
     #   @return [Time]
     #
     # @!attribute [rw] creation_time
-    #   The time that the agent was activated (that is, created in your
-    #   account).
+    #   The time that the agent was [activated][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html
     #   @return [Time]
     #
     # @!attribute [rw] endpoint_type
-    #   The type of endpoint that your agent is connected to. If the
-    #   endpoint is a VPC endpoint, the agent is not accessible over the
-    #   public internet.
+    #   The type of [service endpoint][1] that your agent is connected to.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html
     #   @return [String]
     #
     # @!attribute [rw] private_link_config
-    #   The subnet and the security group that DataSync used to access a VPC
-    #   endpoint.
+    #   The network configuration that the agent uses when connecting to a
+    #   [VPC service endpoint][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc
     #   @return [Types::PrivateLinkConfig]
     #
+    # @!attribute [rw] platform
+    #   The platform-related details about the agent, such as the version
+    #   number.
+    #   @return [Types::Platform]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeAgentResponse AWS API Documentation
     #
     class DescribeAgentResponse < Struct.new(
@@ -1469,7 +1527,8 @@ module Aws::DataSync
       :last_connection_time,
       :creation_time,
       :endpoint_type,
-      :private_link_config)
+      :private_link_config,
+      :platform)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2587,6 +2646,16 @@ module Aws::DataSync
     # @!attribute [rw] files_verified
     #   The number of files, objects, and directories that DataSync verified
     #   during your transfer.
+    #
+    #   <note markdown="1"> When you configure your task to [verify only the data that's
+    #   transferred][1], DataSync doesn't verify directories in some
+    #   situations or files that fail to transfer.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html
     #   @return [Integer]
     #
     # @!attribute [rw] report_result
@@ -2595,7 +2664,7 @@ module Aws::DataSync
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #   @return [Types::ReportResult]
     #
     # @!attribute [rw] estimated_files_to_delete
@@ -2768,7 +2837,7 @@ module Aws::DataSync
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #   @return [Types::TaskReportConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskResponse AWS API Documentation
@@ -4322,9 +4391,39 @@ module Aws::DataSync
       include Aws::Structure
     end
 
+    # The platform-related details about the DataSync agent, such as the
+    # version number.
+    #
+    # @!attribute [rw] version
+    #   The version of the DataSync agent.
+    #
+    #   Beginning December 7, 2023, we will discontinue version 1 DataSync
+    #   agents. Check the DataSync console to see if you have affected
+    #   agents. If you do, [replace][1] those agents before then to avoid
+    #   data transfer or storage discovery disruptions. If you need more
+    #   help, contact [Amazon Web Services Support][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html
+    #   [2]: https://aws.amazon.com/contact-us/
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Platform AWS API Documentation
+    #
+    class Platform < Struct.new(
+      :version)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Specifies how your DataSync agent connects to Amazon Web Services
-    # using a virtual private cloud (VPC) service endpoint. An agent that
-    # uses a VPC endpoint isn't accessible over the public internet.
+    # using a [virtual private cloud (VPC) service endpoint][1]. An agent
+    # that uses a VPC endpoint isn't accessible over the public internet.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc
     #
     # @!attribute [rw] vpc_endpoint_id
     #   Specifies the ID of the VPC endpoint that your agent connects to.
@@ -4444,7 +4543,7 @@ module Aws::DataSync
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #
     # @!attribute [rw] s3
     #   Specifies the Amazon S3 bucket where DataSync uploads your task
@@ -4464,7 +4563,7 @@ module Aws::DataSync
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #
     # @!attribute [rw] subdirectory
     #   Specifies a bucket prefix for your report.
@@ -4483,7 +4582,7 @@ module Aws::DataSync
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    #   [1]: https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ReportDestinationS3 AWS API Documentation
@@ -4501,7 +4600,7 @@ module Aws::DataSync
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #
     # @!attribute [rw] report_level
     #   Specifies whether your task report includes errors only or successes
@@ -4532,7 +4631,7 @@ module Aws::DataSync
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #
     # @!attribute [rw] transferred
     #   Specifies the level of reporting for the files, objects, and
@@ -4577,7 +4676,7 @@ module Aws::DataSync
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #
     # @!attribute [rw] status
     #   Indicates whether DataSync is still working on your report, created
@@ -5111,7 +5210,7 @@ module Aws::DataSync
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html
+    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html
     #
     # @!attribute [rw] destination
     #   Specifies the Amazon S3 bucket where DataSync uploads your task
@@ -5119,7 +5218,7 @@ module Aws::DataSync
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html#task-report-access
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access
     #   @return [Types::ReportDestination]
     #
     # @!attribute [rw] output_type
@@ -5578,54 +5677,71 @@ module Aws::DataSync
     class UpdateLocationObjectStorageResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] location_arn
-    #   The Amazon Resource Name (ARN) of the SMB location to update.
+    #   Specifies the ARN of the SMB location that you want to update.
     #   @return [String]
     #
     # @!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.
-    #
-    #   <note markdown="1"> `Subdirectory` must be specified with forward slashes. For example,
-    #   `/path/to/folder`.
-    #
-    #    </note>
+    #   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.
     #
-    #   To transfer all the data in the folder that you specified, DataSync
-    #   must have permissions to mount the SMB share and to access all the
-    #   data in that share. To ensure this, do either of the following:
+    #   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.
     #
-    #   * 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.
     #
-    #   * Use credentials of a member of the Backup Operators group to mount
-    #     the share.
     #
-    #   Doing either of these options enables the agent to access the data.
-    #   For the agent to access directories, you must also enable all
-    #   execute access.
+    #   [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions
     #   @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 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.
+    #
+    #   If you have multiple domains in your environment, configuring this
+    #   parameter makes sure that DataSync connects to the right file
+    #   server.
+    #
+    #   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

data/lib/aws-sdk-datasync.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.67.0
+  version: 1.68.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-27 00:00:00.000000000 Z
+date: 2023-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core