@aws-sdk/client-datasync 3.437.0 → 3.439.0

package/dist-cjs/endpoint/endpointResolver.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultEndpointResolver = void 0;
-const util_endpoints_1 = require("@aws-sdk/util-endpoints");
+const util_endpoints_1 = require("@smithy/util-endpoints");
 const ruleset_1 = require("./ruleset");
 const defaultEndpointResolver = (endpointParams, context = {}) => {
     return (0, util_endpoints_1.resolveEndpoint)(ruleset_1.ruleSet, {

package/dist-cjs/index.js

@@ -7,5 +7,6 @@ tslib_1.__exportStar(require("./DataSync"), exports);
 tslib_1.__exportStar(require("./commands"), exports);
 tslib_1.__exportStar(require("./pagination"), exports);
 tslib_1.__exportStar(require("./models"), exports);
+require("@aws-sdk/util-endpoints");
 var DataSyncServiceException_1 = require("./models/DataSyncServiceException");
 Object.defineProperty(exports, "DataSyncServiceException", { enumerable: true, get: function () { return DataSyncServiceException_1.DataSyncServiceException; } });

package/dist-cjs/protocols/Aws_json1_1.js

@@ -2795,6 +2795,7 @@ const de_DescribeAgentResponse = (output, context) => {
         EndpointType: smithy_client_1.expectString,
         LastConnectionTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(_))),
         Name: smithy_client_1.expectString,
+        Platform: smithy_client_1._json,
         PrivateLinkConfig: smithy_client_1._json,
         Status: smithy_client_1.expectString,
     });

package/dist-es/endpoint/endpointResolver.js

@@ -1,4 +1,4 @@
-import { resolveEndpoint } from "@aws-sdk/util-endpoints";
+import { resolveEndpoint } from "@smithy/util-endpoints";
 import { ruleSet } from "./ruleset";
 export const defaultEndpointResolver = (endpointParams, context = {}) => {
     return resolveEndpoint(ruleSet, {

package/dist-es/index.js

@@ -3,4 +3,5 @@ export * from "./DataSync";
 export * from "./commands";
 export * from "./pagination";
 export * from "./models";
+import "@aws-sdk/util-endpoints";
 export { DataSyncServiceException } from "./models/DataSyncServiceException";

package/dist-es/protocols/Aws_json1_1.js

@@ -2670,6 +2670,7 @@ const de_DescribeAgentResponse = (output, context) => {
         EndpointType: __expectString,
         LastConnectionTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         Name: __expectString,
+        Platform: _json,
         PrivateLinkConfig: _json,
         Status: __expectString,
     });

package/dist-types/commands/CreateLocationFsxOntapCommand.d.ts

@@ -23,7 +23,9 @@ export interface CreateLocationFsxOntapCommandOutput extends CreateLocationFsxOn
 }
 /**
  * @public
- * <p>Creates an endpoint for an Amazon FSx for NetApp ONTAP file system that DataSync can access for a transfer. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html">Creating a location for FSx for ONTAP</a>.</p>
+ * <p>Creates an endpoint for an Amazon FSx for NetApp ONTAP file system that DataSync can use for a data transfer.</p>
+ *          <p>Before you begin, make sure that you understand how DataSync
+ *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access">accesses an FSx for ONTAP file system</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateLocationFsxWindowsCommand.d.ts

@@ -23,7 +23,8 @@ export interface CreateLocationFsxWindowsCommandOutput extends CreateLocationFsx
 }
 /**
  * @public
- * <p>Creates an endpoint for an Amazon FSx for Windows File Server file system.</p>
+ * <p>Creates an endpoint for an Amazon FSx for Windows File Server file system that DataSync can use for a data transfer.</p>
+ *          <p>Before you begin, make sure that you understand how DataSync <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access">accesses an FSx for Windows File Server</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteAgentCommand.d.ts

@@ -23,9 +23,11 @@ export interface DeleteAgentCommandOutput extends DeleteAgentResponse, __Metadat
 }
 /**
  * @public
- * <p>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.</p>
+ * <p>Removes an DataSync agent resource from your Amazon Web Services account.</p>
+ *          <p>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 <a href="https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html">activate a new
+ *         agent</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DescribeAgentCommand.d.ts

@@ -23,7 +23,7 @@ export interface DescribeAgentCommandOutput extends DescribeAgentResponse, __Met
 }
 /**
  * @public
- * <p>Returns metadata about an DataSync agent, such as its name, endpoint
+ * <p>Returns information about an DataSync agent, such as its name, service endpoint
  *       type, and status.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -53,6 +53,9 @@ export interface DescribeAgentCommandOutput extends DescribeAgentResponse, __Met
  * //       "STRING_VALUE",
  * //     ],
  * //   },
+ * //   Platform: { // Platform
+ * //     Version: "STRING_VALUE",
+ * //   },
  * // };
  *
  * ```

package/dist-types/commands/ListAgentsCommand.d.ts

@@ -52,6 +52,9 @@ export interface ListAgentsCommandOutput extends ListAgentsResponse, __MetadataB
  * //       AgentArn: "STRING_VALUE",
  * //       Name: "STRING_VALUE",
  * //       Status: "ONLINE" || "OFFLINE",
+ * //       Platform: { // Platform
+ * //         Version: "STRING_VALUE",
+ * //       },
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",

package/dist-types/commands/UpdateAgentCommand.d.ts

@@ -23,7 +23,7 @@ export interface UpdateAgentCommandOutput extends UpdateAgentResponse, __Metadat
 }
 /**
  * @public
- * <p>Updates the name of an agent.</p>
+ * <p>Updates the name of an DataSync agent.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateLocationSmbCommand.d.ts

@@ -23,9 +23,8 @@ export interface UpdateLocationSmbCommandOutput extends UpdateLocationSmbRespons
 }
 /**
  * @public
- * <p>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 <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html">Creating a
- *         location for SMB</a>.</p>
+ * <p>Updates some of the parameters of a Server Message Block
+ *       (SMB) file server location that you can use for DataSync transfers.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/index.d.ts

@@ -17,4 +17,5 @@ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
 export * from "./commands";
 export * from "./pagination";
 export * from "./models";
+import "@aws-sdk/util-endpoints";
 export { DataSyncServiceException } from "./models/DataSyncServiceException";

package/dist-types/models/models_0.d.ts

@@ -164,6 +164,21 @@ export declare class InvalidRequestException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<InvalidRequestException, __BaseException>);
 }
+/**
+ * @public
+ * <p>The platform-related details about the DataSync agent, such as the version
+ *       number.</p>
+ */
+export interface Platform {
+    /**
+     * @public
+     * <p>The version of the DataSync agent.</p>
+     *          <important>
+     *             <p>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, <a href="https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html">replace</a> those agents before then to avoid data transfer or storage discovery disruptions. If you need more help, contact <a href="https://aws.amazon.com/contact-us/">Amazon Web Services Support</a>.</p>
+     *          </important>
+     */
+    Version?: string;
+}
 /**
  * @public
  * @enum
@@ -194,10 +209,26 @@ export interface AgentListEntry {
     Name?: string;
     /**
      * @public
-     * <p>The status of an agent. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/understand-agent-statuses.html">DataSync agent
-     *         statuses</a>.</p>
+     * <p>The status of an agent.</p>
+     *          <ul>
+     *             <li>
+     *                <p>If the status is <code>ONLINE</code>, the agent is configured properly and ready to
+     *           use.</p>
+     *             </li>
+     *             <li>
+     *                <p>If the status is <code>OFFLINE</code>, 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 <a href="https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline">What do I do if my agent is offline?</a>
+     *                </p>
+     *             </li>
+     *          </ul>
      */
     Status?: AgentStatus;
+    /**
+     * @public
+     * <p>The platform-related details about the agent, such as the version number.</p>
+     */
+    Platform?: Platform;
 }
 /**
  * @public
@@ -935,19 +966,22 @@ export interface CreateLocationFsxWindowsRequest {
      * @public
      * <p>Specifies the user who has the permissions to access files, folders, and metadata in your
      *       file system.</p>
-     *          <p>For information about choosing a user with sufficient permissions, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions">Required permissions</a>.</p>
+     *          <p>For information about choosing a user with the right level of access for your transfer, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions">required permissions</a> for FSx for Windows File Server locations.</p>
      */
     User: string | undefined;
     /**
      * @public
      * <p>Specifies the name of the Windows domain that the FSx for Windows File Server belongs
      *       to.</p>
+     *          <p>If you have multiple domains in your environment, configuring this parameter makes sure that DataSync connects to the right file server.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions">required permissions</a> for FSx for Windows File Server locations.</p>
      */
     Domain?: string;
     /**
      * @public
      * <p>Specifies the password of the user who has the permissions to access files and folders in
      *       the file system.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions">required permissions</a> for FSx for Windows File Server locations.</p>
      */
     Password: string | undefined;
 }
@@ -1458,6 +1492,7 @@ export interface CreateLocationSmbRequest {
     /**
      * @public
      * <p>Specifies the Windows domain name that your SMB file server belongs to. </p>
+     *          <p>If you have multiple domains in your environment, configuring this parameter makes sure that DataSync connects to the right file server.</p>
      *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions">required permissions</a> for SMB locations.</p>
      */
     Domain?: string;
@@ -1975,7 +2010,7 @@ export interface TaskSchedule {
 }
 /**
  * @public
- * <p>Specifies the Amazon S3 bucket where DataSync uploads your <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">task report</a>.</p>
+ * <p>Specifies the Amazon S3 bucket where DataSync uploads your <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">task report</a>.</p>
  */
 export interface ReportDestinationS3 {
     /**
@@ -1990,13 +2025,13 @@ export interface ReportDestinationS3 {
     S3BucketArn: string | undefined;
     /**
      * @public
-     * <p>Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket. For more information, see <a href="https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">Allowing DataSync to upload a task report to an Amazon S3 bucket</a>.</p>
+     * <p>Specifies the Amazon Resource Name (ARN) of the IAM policy that allows DataSync to upload a task report to your S3 bucket. For more information, see <a href="https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">Allowing DataSync to upload a task report to an Amazon S3 bucket</a>.</p>
      */
     BucketAccessRoleArn: string | undefined;
 }
 /**
  * @public
- * <p>Specifies where DataSync uploads your <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">task report</a>.</p>
+ * <p>Specifies where DataSync uploads your <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">task report</a>.</p>
  */
 export interface ReportDestination {
     /**
@@ -2044,7 +2079,7 @@ export type ReportLevel = (typeof ReportLevel)[keyof typeof ReportLevel];
 /**
  * @public
  * <p>Specifies the level of detail for a particular aspect of your DataSync
- *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">task
+ *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">task
  *         report</a>.</p>
  */
 export interface ReportOverride {
@@ -2058,7 +2093,7 @@ export interface ReportOverride {
 /**
  * @public
  * <p>The level of detail included in each aspect of your DataSync
- *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">task
+ *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">task
  *         report</a>.</p>
  */
 export interface ReportOverrides {
@@ -2086,14 +2121,14 @@ export interface ReportOverrides {
 /**
  * @public
  * <p>Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">Task
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">Task
  *         reports</a>.</p>
  */
 export interface TaskReportConfig {
     /**
      * @public
      * <p>Specifies the Amazon S3 bucket where DataSync uploads your task report. For more
-     *       information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html#task-report-access">Task reports</a>.</p>
+     *       information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access">Task reports</a>.</p>
      */
     Destination?: ReportDestination;
     /**
@@ -2282,8 +2317,8 @@ export interface DeleteTaskResponse {
 export interface DescribeAgentRequest {
     /**
      * @public
-     * <p>Specifies the Amazon Resource Name (ARN) of the DataSync agent to
-     *       describe.</p>
+     * <p>Specifies the Amazon Resource Name (ARN) of the DataSync agent that you want
+     *       information about.</p>
      */
     AgentArn: string | undefined;
 }
@@ -2303,8 +2338,7 @@ export type EndpointType = (typeof EndpointType)[keyof typeof EndpointType];
 /**
  * @public
  * <p>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.</p>
+ *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc">virtual private cloud (VPC) service endpoint</a>. An agent that uses a VPC endpoint isn't accessible over the public internet.</p>
  */
 export interface PrivateLinkConfig {
     /**
@@ -2347,34 +2381,48 @@ export interface DescribeAgentResponse {
     Name?: string;
     /**
      * @public
-     * <p>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.</p>
+     * <p>The status of the agent.</p>
+     *          <ul>
+     *             <li>
+     *                <p>If the status is <code>ONLINE</code>, the agent is configured properly and ready to
+     *           use.</p>
+     *             </li>
+     *             <li>
+     *                <p>If the status is <code>OFFLINE</code>, 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 <a href="https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline">What do I do if my agent is offline?</a>
+     *                </p>
+     *             </li>
+     *          </ul>
      */
     Status?: AgentStatus;
     /**
      * @public
-     * <p>The time that the agent last connected to DataSync.</p>
+     * <p>The last time that the agent was communicating with the DataSync
+     *       service.</p>
      */
     LastConnectionTime?: Date;
     /**
      * @public
-     * <p>The time that the agent was activated (that is, created in your account).</p>
+     * <p>The time that the agent was <a href="https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html">activated</a>.</p>
      */
     CreationTime?: Date;
     /**
      * @public
-     * <p>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. </p>
+     * <p>The type of <a href="https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html">service endpoint</a> that your agent is connected to.</p>
      */
     EndpointType?: EndpointType;
     /**
      * @public
-     * <p>The subnet and the security group that DataSync used to access a VPC endpoint.</p>
+     * <p>The network configuration that the agent uses when connecting to a <a href="https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc">VPC
+     *         service endpoint</a>.</p>
      */
     PrivateLinkConfig?: PrivateLinkConfig;
+    /**
+     * @public
+     * <p>The platform-related details about the agent, such as the version number.</p>
+     */
+    Platform?: Platform;
 }
 /**
  * @public
@@ -3905,7 +3953,7 @@ export interface DescribeTaskResponse {
     Includes?: FilterRule[];
     /**
      * @public
-     * <p>The configuration of your task report. For more information, see <a href="https://docs.aws.amazon.com/https:/docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">Creating a task report</a>.</p>
+     * <p>The configuration of your task report. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">Creating a task report</a>.</p>
      */
     TaskReportConfig?: TaskReportConfig;
 }
@@ -3936,7 +3984,7 @@ export declare const PhaseStatus: {
 export type PhaseStatus = (typeof PhaseStatus)[keyof typeof PhaseStatus];
 /**
  * @public
- * <p>Indicates whether DataSync created a complete <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">task report</a> for your
+ * <p>Indicates whether DataSync created a complete <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">task report</a> for your
  *       transfer.</p>
  */
 export interface ReportResult {
@@ -4153,11 +4201,16 @@ export interface DescribeTaskExecutionResponse {
      * @public
      * <p>The number of files, objects, and directories that DataSync verified during your
      *       transfer.</p>
+     *          <note>
+     *             <p>When you configure your task to <a href="https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html">verify only the
+     *           data that's transferred</a>, DataSync doesn't verify directories in some
+     *         situations or files that fail to transfer.</p>
+     *          </note>
      */
     FilesVerified?: number;
     /**
      * @public
-     * <p>Indicates whether DataSync generated a complete <a href="https://docs.aws.amazon.com/datasync/latest/userguide/creating-task-reports.html">task report</a> for your
+     * <p>Indicates whether DataSync generated a complete <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html">task report</a> for your
      *       transfer.</p>
      */
     ReportResult?: ReportResult;
@@ -5142,58 +5195,44 @@ export interface UpdateLocationObjectStorageResponse {
 export interface UpdateLocationSmbRequest {
     /**
      * @public
-     * <p>The Amazon Resource Name (ARN) of the SMB location to update.</p>
+     * <p>Specifies the ARN of the SMB location that you want to update.</p>
      */
     LocationArn: string | undefined;
     /**
      * @public
-     * <p>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.</p>
-     *          <note>
-     *             <p>
-     *                <code>Subdirectory</code> must be specified with forward slashes. For example,
-     *           <code>/path/to/folder</code>.</p>
-     *          </note>
-     *          <p>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:</p>
-     *          <ul>
-     *             <li>
-     *                <p>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.</p>
-     *             </li>
-     *             <li>
-     *                <p>Use credentials of a member of the Backup Operators group to mount the share. </p>
-     *             </li>
-     *          </ul>
-     *          <p>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.</p>
+     * <p>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,
+     *       <code>/path/to/subdirectory</code>). Make sure that other SMB clients in your network can
+     *       also mount this path.</p>
+     *          <p>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 <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions">required permissions</a> for SMB locations.</p>
      */
     Subdirectory?: string;
     /**
      * @public
-     * <p>The user who can mount the share has the permissions to access files and folders in the
-     *       SMB share.</p>
+     * <p>Specifies the user name that can mount your SMB file server and has permission to access
+     *       the files and folders involved in your transfer.</p>
+     *          <p>For information about choosing a user with the right level of access for your transfer,
+     *       see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions">required permissions</a> for SMB locations.</p>
      */
     User?: string;
     /**
      * @public
-     * <p>The name of the Windows domain that the SMB server belongs to.</p>
+     * <p>Specifies the Windows domain name that your SMB file server belongs to. </p>
+     *          <p>If you have multiple domains in your environment, configuring this parameter makes sure that DataSync connects to the right file server.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions">required permissions</a> for SMB locations.</p>
      */
     Domain?: string;
     /**
      * @public
-     * <p>The password of the user who can mount the share has the permissions to access files and
-     *       folders in the SMB share.</p>
+     * <p>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.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions">required permissions</a> for SMB locations.</p>
      */
     Password?: string;
     /**
      * @public
-     * <p>The Amazon Resource Names (ARNs) of agents to use for a Simple Message Block (SMB)
-     *       location.</p>
+     * <p>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).</p>
      */
     AgentArns?: string[];
     /**

package/dist-types/ts3.4/index.d.ts

@@ -4,4 +4,5 @@ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
 export * from "./commands";
 export * from "./pagination";
 export * from "./models";
+import "@aws-sdk/util-endpoints";
 export { DataSyncServiceException } from "./models/DataSyncServiceException";

package/dist-types/ts3.4/models/models_0.d.ts

@@ -45,6 +45,9 @@ export declare class InvalidRequestException extends __BaseException {
     opts: __ExceptionOptionType<InvalidRequestException, __BaseException>
   );
 }
+export interface Platform {
+  Version?: string;
+}
 export declare const AgentStatus: {
   readonly OFFLINE: "OFFLINE";
   readonly ONLINE: "ONLINE";
@@ -54,6 +57,7 @@ export interface AgentListEntry {
   AgentArn?: string;
   Name?: string;
   Status?: AgentStatus;
+  Platform?: Platform;
 }
 export declare const Atime: {
   readonly BEST_EFFORT: "BEST_EFFORT";
@@ -526,6 +530,7 @@ export interface DescribeAgentResponse {
   CreationTime?: Date;
   EndpointType?: EndpointType;
   PrivateLinkConfig?: PrivateLinkConfig;
+  Platform?: Platform;
 }
 export interface DescribeDiscoveryJobRequest {
   DiscoveryJobArn: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-datasync",
   "description": "AWS SDK for JavaScript Datasync Client for Node.js, Browser and React Native",
-  "version": "3.437.0",
+  "version": "3.439.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,17 +21,17 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.437.0",
+    "@aws-sdk/client-sts": "3.438.0",
     "@aws-sdk/core": "3.436.0",
-    "@aws-sdk/credential-provider-node": "3.437.0",
+    "@aws-sdk/credential-provider-node": "3.438.0",
     "@aws-sdk/middleware-host-header": "3.433.0",
     "@aws-sdk/middleware-logger": "3.433.0",
     "@aws-sdk/middleware-recursion-detection": "3.433.0",
     "@aws-sdk/middleware-signing": "3.433.0",
-    "@aws-sdk/middleware-user-agent": "3.433.0",
+    "@aws-sdk/middleware-user-agent": "3.438.0",
     "@aws-sdk/region-config-resolver": "3.433.0",
     "@aws-sdk/types": "3.433.0",
-    "@aws-sdk/util-endpoints": "3.433.0",
+    "@aws-sdk/util-endpoints": "3.438.0",
     "@aws-sdk/util-user-agent-browser": "3.433.0",
     "@aws-sdk/util-user-agent-node": "3.437.0",
     "@smithy/config-resolver": "^2.0.16",
@@ -54,6 +54,7 @@
     "@smithy/util-body-length-node": "^2.1.0",
     "@smithy/util-defaults-mode-browser": "^2.0.16",
     "@smithy/util-defaults-mode-node": "^2.0.21",
+    "@smithy/util-endpoints": "^1.0.2",
     "@smithy/util-retry": "^2.0.5",
     "@smithy/util-utf8": "^2.0.0",
     "tslib": "^2.5.0",