@aws-sdk/client-datasync 3.130.0 → 3.131.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.131.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.130.0...v3.131.0) (2022-07-15)
+
+**Note:** Version bump only for package @aws-sdk/client-datasync
+
+
+
+
+
 # [3.130.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.129.0...v3.130.0) (2022-07-14)
 
 

package/dist-types/DataSync.d.ts

@@ -158,25 +158,27 @@ export declare class DataSync extends DataSyncClient {
     createLocationSmb(args: CreateLocationSmbCommandInput, cb: (err: any, data?: CreateLocationSmbCommandOutput) => void): void;
     createLocationSmb(args: CreateLocationSmbCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateLocationSmbCommandOutput) => void): void;
     /**
-     * <p>Creates a task.</p>
-     *          <p>A task includes a source location and a destination location, and a configuration
-     *       that specifies how data is transferred. A task always transfers data from the source
-     *       location to the destination location. The configuration specifies options such as
-     *       task scheduling, bandwidth limits, etc. A task is the complete definition of a data
-     *       transfer.</p>
-     *          <p>When you create a task that transfers data between Amazon Web Services services in different Amazon Web Services Regions,
-     *       one of the two locations that you specify must reside in the Region where DataSync is being
-     *       used. The other location must be specified in a different Region.</p>
-     *          <p>You can transfer data between commercial Amazon Web Services Regions except for China, or between
-     *       Amazon Web Services GovCloud (US) Regions.</p>
-     *
-     *          <important>
-     *             <p>When you use DataSync to copy files or objects between Amazon Web Services Regions,
-     *       you pay for data transfer between Regions. This is billed as data transfer OUT
-     *       from your source Region to your destination Region. For more information,
-     *       see <a href="http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer">Data Transfer pricing</a>.
-     *     </p>
-     *          </important>
+     * <p>Configures a task, which defines where and how DataSync transfers your
+     *       data.</p>
+     *          <p>A task includes a source location, a destination location, and the preferences for how and
+     *       when you want to transfer your data (such as bandwidth limits, scheduling, among other
+     *       options).</p>
+     *          <p>When you create a task that transfers data between Amazon Web Services services in
+     *       different Amazon Web Services Regions, one of your locations must reside in the Region where
+     *       you're using DataSync.</p>
+     *          <p>For more information, see the following topics:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <a href="https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html">Working with DataSync locations</a>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-task.html">Configure DataSync task settings</a>
+     *                </p>
+     *             </li>
+     *          </ul>
      */
     createTask(args: CreateTaskCommandInput, options?: __HttpHandlerOptions): Promise<CreateTaskCommandOutput>;
     createTask(args: CreateTaskCommandInput, cb: (err: any, data?: CreateTaskCommandOutput) => void): void;
@@ -321,7 +323,7 @@ export declare class DataSync extends DataSyncClient {
     listTaskExecutions(args: ListTaskExecutionsCommandInput, cb: (err: any, data?: ListTaskExecutionsCommandOutput) => void): void;
     listTaskExecutions(args: ListTaskExecutionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTaskExecutionsCommandOutput) => void): void;
     /**
-     * <p>Returns a list of all the tasks.</p>
+     * <p>Returns a list of the DataSync tasks you created.</p>
      */
     listTasks(args: ListTasksCommandInput, options?: __HttpHandlerOptions): Promise<ListTasksCommandOutput>;
     listTasks(args: ListTasksCommandInput, cb: (err: any, data?: ListTasksCommandOutput) => void): void;

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

@@ -7,25 +7,27 @@ export interface CreateTaskCommandInput extends CreateTaskRequest {
 export interface CreateTaskCommandOutput extends CreateTaskResponse, __MetadataBearer {
 }
 /**
- * <p>Creates a task.</p>
- *          <p>A task includes a source location and a destination location, and a configuration
- *       that specifies how data is transferred. A task always transfers data from the source
- *       location to the destination location. The configuration specifies options such as
- *       task scheduling, bandwidth limits, etc. A task is the complete definition of a data
- *       transfer.</p>
- *          <p>When you create a task that transfers data between Amazon Web Services services in different Amazon Web Services Regions,
- *       one of the two locations that you specify must reside in the Region where DataSync is being
- *       used. The other location must be specified in a different Region.</p>
- *          <p>You can transfer data between commercial Amazon Web Services Regions except for China, or between
- *       Amazon Web Services GovCloud (US) Regions.</p>
- *
- *          <important>
- *             <p>When you use DataSync to copy files or objects between Amazon Web Services Regions,
- *       you pay for data transfer between Regions. This is billed as data transfer OUT
- *       from your source Region to your destination Region. For more information,
- *       see <a href="http://aws.amazon.com/ec2/pricing/on-demand/#Data_Transfer">Data Transfer pricing</a>.
- *     </p>
- *          </important>
+ * <p>Configures a task, which defines where and how DataSync transfers your
+ *       data.</p>
+ *          <p>A task includes a source location, a destination location, and the preferences for how and
+ *       when you want to transfer your data (such as bandwidth limits, scheduling, among other
+ *       options).</p>
+ *          <p>When you create a task that transfers data between Amazon Web Services services in
+ *       different Amazon Web Services Regions, one of your locations must reside in the Region where
+ *       you're using DataSync.</p>
+ *          <p>For more information, see the following topics:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/datasync/latest/userguide/working-with-locations.html">Working with DataSync locations</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-task.html">Configure DataSync task settings</a>
+ *                </p>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,7 +7,7 @@ export interface ListTasksCommandInput extends ListTasksRequest {
 export interface ListTasksCommandOutput extends ListTasksResponse, __MetadataBearer {
 }
 /**
- * <p>Returns a list of all the tasks.</p>
+ * <p>Returns a list of the DataSync tasks you created.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -422,7 +422,42 @@ export interface FsxProtocolSmb {
      */
     Password: string | undefined;
     /**
-     * <p>Specifies a user who has permission to access your SVM.</p>
+     * <p>Specifies a user name that can mount the location and access the files, folders, and metadata that you need in the SVM.</p>
+     *          <p>If you provide a user in your Active Directory, note the following:</p>
+     *          <ul>
+     *             <li>
+     *                <p>If you're using Directory Service for Microsoft Active Directory, the user
+     *           must be a member of the Amazon Web Services Delegated
+     *             FSx Administrators group.</p>
+     *             </li>
+     *             <li>
+     *                <p>If you're using a self-managed Active Directory, the user must be a member of either
+     *           the Domain Admins group or a custom group that you specified for file system
+     *           administration when you created your file system.</p>
+     *             </li>
+     *          </ul>
+     *          <p>Make sure that the user has the permissions it needs
+     *       to copy the data you want:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>SE_TCB_NAME</code>: Required to
+     *           set object ownership and file metadata. With this
+     *           privilege, you also can copy NTFS discretionary
+     *           access lists (DACLs).</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>SE_SECURITY_NAME</code>: May be
+     *           needed to copy NTFS system access control lists
+     *           (SACLs). This operation specifically requires the
+     *           Windows privilege, which is granted to members of
+     *           the Domain Admins group. If
+     *           you configure your task to copy SACLs, make sure
+     *           that the user has the required privileges. For
+     *           information about copying SACLs, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-task.html#configure-ownership-and-permissions">Ownership and permissions-related options</a>.</p>
+     *             </li>
+     *          </ul>
      */
     User: string | undefined;
 }
@@ -457,19 +492,22 @@ export interface CreateLocationFsxOntapRequest {
      */
     Protocol: FsxProtocol | undefined;
     /**
-     * <p>Specifies the security groups that DataSync can use to access your FSx for ONTAP file system. You must configure the security groups to allow outbound
-     *       traffic on the following ports (depending on the protocol that you're using):</p>
+     * <p>Specifies the Amazon EC2 security groups that provide access to your file system's preferred subnet.</p>
+     *          <p>The security groups must allow outbound traffic on the following ports (depending on the
+     *       protocol you use):</p>
      *          <ul>
      *             <li>
      *                <p>
-     *                   <b>Network File System (NFS)</b>: TCP port 2049</p>
+     *                   <b>Network File System (NFS)</b>: TCP ports 111, 635, and
+     *           2049</p>
      *             </li>
      *             <li>
      *                <p>
      *                   <b>Server Message Block (SMB)</b>: TCP port 445</p>
      *             </li>
      *          </ul>
-     *          <p>Your file system's security groups must also allow inbound traffic on the same port.</p>
+     *          <p>Your file system's security groups must also allow inbound traffic on the same
+     *       ports.</p>
      */
     SecurityGroupArns: string[] | undefined;
     /**
@@ -556,40 +594,54 @@ export declare namespace CreateLocationFsxOpenZfsResponse {
 }
 export interface CreateLocationFsxWindowsRequest {
     /**
-     * <p>A subdirectory in the location's path. This subdirectory in the Amazon FSx for Windows
-     *       File Server file system is used to read data from the Amazon FSx for Windows File Server
-     *       source location or write data to the FSx for Windows File Server destination.</p>
+     * <p>Specifies a mount path for your file system using forward slashes. This is where DataSync reads or
+     *       writes data (depending on if this is a source or destination location).</p>
      */
     Subdirectory?: string;
     /**
-     * <p>The Amazon Resource Name (ARN) for the FSx for Windows File Server file system.</p>
+     * <p>Specifies the Amazon Resource Name (ARN) for the FSx for Windows File Server file
+     *       system.</p>
      */
     FsxFilesystemArn: string | undefined;
     /**
-     * <p>The ARNs of the security groups that are used to configure the
-     *       FSx for Windows File Server file system.</p>
+     * <p>Specifies the ARNs of the security groups that provide access to your file system's
+     *       preferred subnet.</p>
+     *          <note>
+     *             <p>If you choose a security group that doesn't allow connections from within
+     *         itself, do one of the following:</p>
+     *             <ul>
+     *                <li>
+     *                   <p>Configure the security group to allow it to communicate within
+     *             itself.</p>
+     *                </li>
+     *                <li>
+     *                   <p>Choose a different security group that can communicate with the
+     *             mount target's security group.</p>
+     *                </li>
+     *             </ul>
+     *          </note>
      */
     SecurityGroupArns: string[] | undefined;
     /**
-     * <p>The key-value pair that represents a tag that you want to add to the resource. The
-     *       value can be an empty string. This value helps you manage, filter, and search for your
-     *       resources. We recommend that you create a name tag for your location.</p>
+     * <p>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.</p>
      */
     Tags?: TagListEntry[];
     /**
-     * <p>The user who has the permissions to access files and folders in the FSx for Windows File
-     *       Server file system.</p>
+     * <p>Specifies the user who has the permissions to access files and folders in the file
+     *       system.</p>
      *          <p>For information about choosing a user name that ensures sufficient permissions to files,
      *       folders, and metadata, see <a href="create-fsx-location.html#FSxWuser">user</a>.</p>
      */
     User: string | undefined;
     /**
-     * <p>The name of the Windows domain that the FSx for Windows File Server belongs to.</p>
+     * <p>Specifies the name of the Windows domain that the FSx for Windows File Server belongs
+     *       to.</p>
      */
     Domain?: string;
     /**
-     * <p>The password of the user who has the permissions to access files and folders in the FSx
-     *       for Windows File Server file system.</p>
+     * <p>Specifies the password of the user who has the permissions to access files and folders in
+     *       the file system.</p>
      */
     Password: string | undefined;
 }
@@ -601,8 +653,7 @@ export declare namespace CreateLocationFsxWindowsRequest {
 }
 export interface CreateLocationFsxWindowsResponse {
     /**
-     * <p>The Amazon Resource Name (ARN) of the FSx for Windows File Server file system location
-     *       you created.</p>
+     * <p>The ARN of the FSx for Windows File Server file system location you created.</p>
      */
     LocationArn?: string;
 }
@@ -2614,9 +2665,12 @@ export declare enum Operator {
     NOT_CONTAINS = "NotContains"
 }
 /**
- * <p>You can use API filters to narrow down the list of resources returned by <code>ListLocations</code>.
- *       For example, to retrieve all your Amazon S3 locations, you can use <code>ListLocations</code> with
- *       filter name <code>LocationType S3</code> and <code>Operator Equals</code>.</p>
+ * <p>Narrow down the list of resources returned by <code>ListLocations</code>. For example, to
+ *       see all your Amazon S3 locations, create a filter using <code>"Name":
+ *         "LocationType"</code>, <code>"Operator": "Equals"</code>, and <code>"Values":
+ *       "S3"</code>.</p>
+ *          <p>For more information, see
+ *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html">filtering resources</a>.</p>
  */
 export interface LocationFilter {
     /**
@@ -2631,8 +2685,7 @@ export interface LocationFilter {
     Values: string[] | undefined;
     /**
      * <p>The operator that is used to compare filter values (for example, <code>Equals</code> or
-     *       <code>Contains</code>). For more about API filtering operators, see
-     *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html">API filters for ListTasks and ListLocations</a>.</p>
+     *       <code>Contains</code>).</p>
      */
     Operator: Operator | string | undefined;
 }
@@ -2846,6 +2899,7 @@ export declare enum TaskFilterName {
  *       For example, to retrieve all tasks on a source location, you can use <code>ListTasks</code>
  *       with filter name <code>LocationId</code> and <code>Operator Equals</code> with the ARN for the
  *       location.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html">filtering DataSync resources</a>.</p>
  */
 export interface TaskFilter {
     /**
@@ -2860,8 +2914,7 @@ export interface TaskFilter {
     Values: string[] | undefined;
     /**
      * <p>The operator that is used to compare filter values (for example, <code>Equals</code> or
-     *       <code>Contains</code>). For more about API filtering operators, see
-     *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html">API filters for ListTasks and ListLocations</a>.</p>
+     *       <code>Contains</code>).</p>
      */
     Operator: Operator | 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.130.0",
+  "version": "3.131.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,10 +18,10 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "2.0.0",
     "@aws-crypto/sha256-js": "2.0.0",
-    "@aws-sdk/client-sts": "3.130.0",
+    "@aws-sdk/client-sts": "3.131.0",
     "@aws-sdk/config-resolver": "3.130.0",
-    "@aws-sdk/credential-provider-node": "3.130.0",
-    "@aws-sdk/fetch-http-handler": "3.127.0",
+    "@aws-sdk/credential-provider-node": "3.131.0",
+    "@aws-sdk/fetch-http-handler": "3.131.0",
     "@aws-sdk/hash-node": "3.127.0",
     "@aws-sdk/invalid-dependency": "3.127.0",
     "@aws-sdk/middleware-content-length": "3.127.0",