@aws-sdk/client-datasync 3.1150.0 → 3.1151.0

package/dist-cjs/index.js

@@ -69,7 +69,7 @@ const commonParams = {
     UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
 };
 
-var version = "3.1149.0";
+var version = "3.1150.0";
 var packageInfo = {
 	version: version};
 
@@ -400,6 +400,7 @@ const _NN = "NameNodes";
 const _NT = "NextToken";
 const _O = "Options";
 const _OM = "OverwriteMode";
+const _OMb = "ObjectMetadata";
 const _OO = "OverrideOptions";
 const _OPC = "OnPremConfig";
 const _OSSK = "ObjectStorageSecretKey";
@@ -1040,8 +1041,8 @@ var OnPremConfig$ = [3, n0, _OPC,
 ];
 var Options$ = [3, n0, _O,
     0,
-    [_VM, _OM, _At, _M, _Ui, _G, _PDF, _PD, _PP, _BPS, _TQ, _LL, _TMr, _SDCF, _OT],
-    [0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0]
+    [_VM, _OM, _At, _M, _Ui, _G, _PDF, _PD, _PP, _BPS, _TQ, _LL, _TMr, _SDCF, _OT, _OMb],
+    [0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0]
 ];
 var Platform$ = [3, n0, _P,
     0,
@@ -1937,6 +1938,7 @@ const NfsVersion = {
     NFS3: "NFS3",
     NFS4_0: "NFS4_0",
     NFS4_1: "NFS4_1",
+    NFS4_2: "NFS4_2",
 };
 const SmbVersion = {
     AUTOMATIC: "AUTOMATIC",
@@ -2003,6 +2005,10 @@ const Mtime = {
     NONE: "NONE",
     PRESERVE: "PRESERVE",
 };
+const ObjectMetadata = {
+    NONE: "NONE",
+    PRESERVE: "PRESERVE",
+};
 const ObjectTags = {
     NONE: "NONE",
     PRESERVE: "PRESERVE",
@@ -2308,6 +2314,7 @@ exports.ManifestFormat = ManifestFormat;
 exports.Mtime = Mtime;
 exports.NfsMountOptions$ = NfsMountOptions$;
 exports.NfsVersion = NfsVersion;
+exports.ObjectMetadata = ObjectMetadata;
 exports.ObjectStorageServerProtocol = ObjectStorageServerProtocol;
 exports.ObjectTags = ObjectTags;
 exports.ObjectVersionIds = ObjectVersionIds;

package/dist-es/models/enums.js

@@ -27,6 +27,7 @@ export const NfsVersion = {
     NFS3: "NFS3",
     NFS4_0: "NFS4_0",
     NFS4_1: "NFS4_1",
+    NFS4_2: "NFS4_2",
 };
 export const SmbVersion = {
     AUTOMATIC: "AUTOMATIC",
@@ -93,6 +94,10 @@ export const Mtime = {
     NONE: "NONE",
     PRESERVE: "PRESERVE",
 };
+export const ObjectMetadata = {
+    NONE: "NONE",
+    PRESERVE: "PRESERVE",
+};
 export const ObjectTags = {
     NONE: "NONE",
     PRESERVE: "PRESERVE",

package/dist-es/schemas/schemas_0.js

@@ -226,6 +226,7 @@ const _NN = "NameNodes";
 const _NT = "NextToken";
 const _O = "Options";
 const _OM = "OverwriteMode";
+const _OMb = "ObjectMetadata";
 const _OO = "OverrideOptions";
 const _OPC = "OnPremConfig";
 const _OSSK = "ObjectStorageSecretKey";
@@ -869,8 +870,8 @@ export var OnPremConfig$ = [3, n0, _OPC,
 ];
 export var Options$ = [3, n0, _O,
     0,
-    [_VM, _OM, _At, _M, _Ui, _G, _PDF, _PD, _PP, _BPS, _TQ, _LL, _TMr, _SDCF, _OT],
-    [0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0]
+    [_VM, _OM, _At, _M, _Ui, _G, _PDF, _PD, _PP, _BPS, _TQ, _LL, _TMr, _SDCF, _OT, _OMb],
+    [0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0]
 ];
 export var Platform$ = [3, n0, _P,
     0,

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

@@ -41,7 +41,7 @@ declare const CreateLocationFsxOntapCommand_base: {
  *   Protocol: { // FsxProtocol
  *     NFS: { // FsxProtocolNfs
  *       MountOptions: { // NfsMountOptions
- *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  *       },
  *     },
  *     SMB: { // FsxProtocolSmb

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

@@ -47,7 +47,7 @@ declare const CreateLocationFsxOpenZfsCommand_base: {
  *   Protocol: { // FsxProtocol
  *     NFS: { // FsxProtocolNfs
  *       MountOptions: { // NfsMountOptions
- *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  *       },
  *     },
  *     SMB: { // FsxProtocolSmb

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

@@ -47,7 +47,7 @@ declare const CreateLocationNfsCommand_base: {
  *     ],
  *   },
  *   MountOptions: { // NfsMountOptions
- *     Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ *     Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  *   },
  *   Tags: [ // InputTagList
  *     { // TagListEntry

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

@@ -63,6 +63,7 @@ declare const CreateTaskCommand_base: {
  *     TransferMode: "CHANGED" || "ALL",
  *     SecurityDescriptorCopyFlags: "NONE" || "OWNER_DACL" || "OWNER_DACL_SACL",
  *     ObjectTags: "PRESERVE" || "NONE",
+ *     ObjectMetadata: "PRESERVE" || "NONE",
  *   },
  *   Excludes: [ // FilterList
  *     { // FilterRule

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

@@ -49,7 +49,7 @@ declare const DescribeLocationFsxOntapCommand_base: {
  * //   Protocol: { // FsxProtocol
  * //     NFS: { // FsxProtocolNfs
  * //       MountOptions: { // NfsMountOptions
- * //         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ * //         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  * //       },
  * //     },
  * //     SMB: { // FsxProtocolSmb

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

@@ -51,7 +51,7 @@ declare const DescribeLocationFsxOpenZfsCommand_base: {
  * //   Protocol: { // FsxProtocol
  * //     NFS: { // FsxProtocolNfs
  * //       MountOptions: { // NfsMountOptions
- * //         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ * //         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  * //       },
  * //     },
  * //     SMB: { // FsxProtocolSmb

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

@@ -48,7 +48,7 @@ declare const DescribeLocationNfsCommand_base: {
  * //     ],
  * //   },
  * //   MountOptions: { // NfsMountOptions
- * //     Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ * //     Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  * //   },
  * //   CreationTime: new Date("TIMESTAMP"),
  * // };

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

@@ -69,6 +69,7 @@ declare const DescribeTaskCommand_base: {
  * //     TransferMode: "CHANGED" || "ALL",
  * //     SecurityDescriptorCopyFlags: "NONE" || "OWNER_DACL" || "OWNER_DACL_SACL",
  * //     ObjectTags: "PRESERVE" || "NONE",
+ * //     ObjectMetadata: "PRESERVE" || "NONE",
  * //   },
  * //   Excludes: [ // FilterList
  * //     { // FilterRule

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

@@ -64,6 +64,7 @@ declare const DescribeTaskExecutionCommand_base: {
  * //     TransferMode: "CHANGED" || "ALL",
  * //     SecurityDescriptorCopyFlags: "NONE" || "OWNER_DACL" || "OWNER_DACL_SACL",
  * //     ObjectTags: "PRESERVE" || "NONE",
+ * //     ObjectMetadata: "PRESERVE" || "NONE",
  * //   },
  * //   Excludes: [ // FilterList
  * //     { // FilterRule

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

@@ -59,6 +59,7 @@ declare const StartTaskExecutionCommand_base: {
  *     TransferMode: "CHANGED" || "ALL",
  *     SecurityDescriptorCopyFlags: "NONE" || "OWNER_DACL" || "OWNER_DACL_SACL",
  *     ObjectTags: "PRESERVE" || "NONE",
+ *     ObjectMetadata: "PRESERVE" || "NONE",
  *   },
  *   Includes: [ // FilterList
  *     { // FilterRule

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

@@ -41,7 +41,7 @@ declare const UpdateLocationFsxOntapCommand_base: {
  *   Protocol: { // FsxUpdateProtocol
  *     NFS: { // FsxProtocolNfs
  *       MountOptions: { // NfsMountOptions
- *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  *       },
  *     },
  *     SMB: { // FsxUpdateProtocolSmb

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

@@ -45,7 +45,7 @@ declare const UpdateLocationFsxOpenZfsCommand_base: {
  *   Protocol: { // FsxProtocol
  *     NFS: { // FsxProtocolNfs
  *       MountOptions: { // NfsMountOptions
- *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ *         Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  *       },
  *     },
  *     SMB: { // FsxProtocolSmb

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

@@ -46,7 +46,7 @@ declare const UpdateLocationNfsCommand_base: {
  *     ],
  *   },
  *   MountOptions: { // NfsMountOptions
- *     Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1",
+ *     Version: "AUTOMATIC" || "NFS3" || "NFS4_0" || "NFS4_1" || "NFS4_2",
  *   },
  * };
  * const command = new UpdateLocationNfsCommand(input);

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

@@ -52,6 +52,7 @@ declare const UpdateTaskCommand_base: {
  *     TransferMode: "CHANGED" || "ALL",
  *     SecurityDescriptorCopyFlags: "NONE" || "OWNER_DACL" || "OWNER_DACL_SACL",
  *     ObjectTags: "PRESERVE" || "NONE",
+ *     ObjectMetadata: "PRESERVE" || "NONE",
  *   },
  *   Excludes: [ // FilterList
  *     { // FilterRule

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

@@ -58,6 +58,7 @@ declare const UpdateTaskExecutionCommand_base: {
  *     TransferMode: "CHANGED" || "ALL",
  *     SecurityDescriptorCopyFlags: "NONE" || "OWNER_DACL" || "OWNER_DACL_SACL",
  *     ObjectTags: "PRESERVE" || "NONE",
+ *     ObjectMetadata: "PRESERVE" || "NONE",
  *   },
  * };
  * const command = new UpdateTaskExecutionCommand(input);

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

@@ -79,6 +79,7 @@ export declare const NfsVersion: {
     readonly NFS3: "NFS3";
     readonly NFS4_0: "NFS4_0";
     readonly NFS4_1: "NFS4_1";
+    readonly NFS4_2: "NFS4_2";
 };
 /**
  * @public
@@ -253,6 +254,18 @@ export declare const Mtime: {
  * @public
  */
 export type Mtime = (typeof Mtime)[keyof typeof Mtime];
+/**
+ * @public
+ * @enum
+ */
+export declare const ObjectMetadata: {
+    readonly NONE: "NONE";
+    readonly PRESERVE: "PRESERVE";
+};
+/**
+ * @public
+ */
+export type ObjectMetadata = (typeof ObjectMetadata)[keyof typeof ObjectMetadata];
 /**
  * @public
  * @enum

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

@@ -1,4 +1,4 @@
-import type { AgentStatus, Atime, AzureAccessTier, AzureBlobAuthenticationType, AzureBlobType, EfsInTransitEncryption, EndpointType, FilterType, Gid, HdfsAuthenticationType, HdfsDataTransferProtection, HdfsRpcProtection, LocationFilterName, LogLevel, ManifestAction, ManifestFormat, Mtime, NfsVersion, ObjectStorageServerProtocol, ObjectTags, ObjectVersionIds, Operator, OverwriteMode, PhaseStatus, PosixPermissions, PreserveDeletedFiles, PreserveDevices, ReportLevel, ReportOutputType, S3StorageClass, ScheduleDisabledBy, ScheduleStatus, SmbAuthenticationType, SmbSecurityDescriptorCopyFlags, SmbVersion, TaskExecutionStatus, TaskFilterName, TaskMode, TaskQueueing, TaskStatus, TransferMode, Uid, VerifyMode } from "./enums";
+import type { AgentStatus, Atime, AzureAccessTier, AzureBlobAuthenticationType, AzureBlobType, EfsInTransitEncryption, EndpointType, FilterType, Gid, HdfsAuthenticationType, HdfsDataTransferProtection, HdfsRpcProtection, LocationFilterName, LogLevel, ManifestAction, ManifestFormat, Mtime, NfsVersion, ObjectMetadata, ObjectStorageServerProtocol, ObjectTags, ObjectVersionIds, Operator, OverwriteMode, PhaseStatus, PosixPermissions, PreserveDeletedFiles, PreserveDevices, ReportLevel, ReportOutputType, S3StorageClass, ScheduleDisabledBy, ScheduleStatus, SmbAuthenticationType, SmbSecurityDescriptorCopyFlags, SmbVersion, TaskExecutionStatus, TaskFilterName, TaskMode, TaskQueueing, TaskStatus, TransferMode, Uid, VerifyMode } from "./enums";
 /**
  * <p>The platform-related details about the DataSync agent, such as the version
  *       number.</p>
@@ -157,18 +157,28 @@ export interface CreateAgentRequest {
      *             <p>The VPC service endpoint you use must include the DataSync service name (for
      *         example, <code>com.amazonaws.us-east-2.datasync</code>).</p>
      *          </important>
+     *          <p>The endpoint ID is informational. DataSync doesn't verify it or use it to connect
+     *       to your agent. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#vpc-endpoint-multiple-subnets">Using a single VPC service endpoint across multiple subnets</a>.</p>
      * @public
      */
     VpcEndpointId?: string | undefined;
     /**
-     * <p>Specifies the ARN of the subnet where your VPC service endpoint is located. You can only
-     *       specify one ARN.</p>
+     * <p>Specifies the ARN of the subnet where DataSync creates the <a href="https://docs.aws.amazon.com/datasync/latest/userguide/required-network-interfaces.html">network
+     *         interfaces</a> that handle data transfer traffic for your tasks. You can only specify one
+     *       ARN.</p>
+     *          <p>The subnet doesn't have to be the subnet that contains your VPC service endpoint. The
+     *       subnet can be one that another Amazon Web Services account shared with you through <a href="https://docs.aws.amazon.com/ram/latest/userguide/what-is.html">RAM</a>, in
+     *       which case the ARN must specify the account that owns the subnet. For more information, see
+     *         <a href="https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#vpc-endpoint-multiple-subnets">Using a single VPC service endpoint across multiple subnets</a>.</p>
      * @public
      */
     SubnetArns?: string[] | undefined;
     /**
      * <p>Specifies the Amazon Resource Name (ARN) of the security group that allows traffic between
      *       your agent and VPC service endpoint. You can only specify one ARN.</p>
+     *          <p>The ARN must specify your own account, even when the security group was shared with you
+     *       from the account that owns the VPC. The security group must belong to the same VPC as the
+     *       subnet that you specify in <code>SubnetArns</code>.</p>
      * @public
      */
     SecurityGroupArns?: string[] | undefined;
@@ -484,7 +494,9 @@ export interface NfsMountOptions {
      *          <ul>
      *             <li>
      *                <p>
-     *                   <code>AUTOMATIC</code> (default): DataSync chooses NFS version 4.1.</p>
+     *                   <code>AUTOMATIC</code> (default): DataSync chooses NFS version 4.1. For
+     *           Amazon FSx for OpenZFS locations, DataSync first attempts to use NFS
+     *           version 4.2, then falls back to version 4.1, and then to earlier versions if needed.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -502,6 +514,13 @@ export interface NfsMountOptions {
      *           delegations, and parallel data processing. NFS version 4.1 also includes all features
      *           available in version 4.0.</p>
      *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>NFSv4_2</code>: Stateful protocol version that supports sparse file
+     *           operations, space reservation, and server-side copy operations, in addition to all
+     *           features available in version 4.1. Selecting NFS version 4.2 requires an Enhanced mode
+     *           task.</p>
+     *             </li>
      *          </ul>
      *          <note>
      *             <p>DataSync currently only supports NFS version 3 with Amazon FSx for NetApp ONTAP locations.</p>
@@ -2031,6 +2050,17 @@ export interface Options {
      * @public
      */
     ObjectTags?: ObjectTags | undefined;
+    /**
+     * <p>Specifies whether you want DataSync to <code>PRESERVE</code> object metadata
+     *       (default behavior) when transferring between object storage systems. If you want your
+     *       DataSync task to ignore object metadata, specify the <code>NONE</code> value.</p>
+     *          <note>
+     *             <p>Even if you specify <code>NONE</code>, metadata for the last modified time is still
+     *         preserved.</p>
+     *          </note>
+     * @public
+     */
+    ObjectMetadata?: ObjectMetadata | undefined;
 }
 /**
  * <p>Configures your DataSync task to run on a <a href="https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html">schedule</a>
@@ -2409,7 +2439,10 @@ export interface DescribeAgentRequest {
  */
 export interface PrivateLinkConfig {
     /**
-     * <p>Specifies the ID of the VPC endpoint that your agent connects to.</p>
+     * <p>Specifies the ID of the VPC service endpoint that's recorded for your agent. The endpoint ID
+     *       is informational and isn't verified by DataSync. Your agent communicates through the
+     *       private IP address in <code>PrivateLinkEndpoint</code>, which is set when you activate the
+     *       agent.</p>
      * @public
      */
     VpcEndpointId?: string | undefined;
@@ -2419,8 +2452,9 @@ export interface PrivateLinkConfig {
      */
     PrivateLinkEndpoint?: string | undefined;
     /**
-     * <p>Specifies the ARN of the subnet where your VPC endpoint is located. You can only specify
-     *       one ARN.</p>
+     * <p>Specifies the ARN of the subnet where DataSync creates the network interfaces
+     *       that handle data transfer traffic for your tasks. You can only specify one ARN.</p>
+     *          <p>The subnet doesn't have to be the subnet that contains your VPC endpoint.</p>
      * @public
      */
     SubnetArns?: string[] | undefined;
@@ -4893,11 +4927,13 @@ export interface UpdateLocationHdfsRequest {
      *          <p>The number of NameNodes you can specify depends on the task mode:</p>
      *          <ul>
      *             <li>
-     *                <p>Enhanced mode – You can specify multiple NameNodes for HDFS High Availability (HA)
+     *                <p>
+     *                   <b>Enhanced mode</b> – You can specify multiple NameNodes for HDFS High Availability (HA)
      *           configurations.</p>
      *             </li>
      *             <li>
-     *                <p>Basic mode – You can specify only one NameNode.</p>
+     *                <p>
+     *                   <b>Basic mode</b> – You can specify only one NameNode.</p>
      *             </li>
      *          </ul>
      * @public

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

@@ -35,6 +35,7 @@ export declare const NfsVersion: {
   readonly NFS3: "NFS3";
   readonly NFS4_0: "NFS4_0";
   readonly NFS4_1: "NFS4_1";
+  readonly NFS4_2: "NFS4_2";
 };
 export type NfsVersion = (typeof NfsVersion)[keyof typeof NfsVersion];
 export declare const SmbVersion: {
@@ -119,6 +120,11 @@ export declare const Mtime: {
   readonly PRESERVE: "PRESERVE";
 };
 export type Mtime = (typeof Mtime)[keyof typeof Mtime];
+export declare const ObjectMetadata: {
+  readonly NONE: "NONE";
+  readonly PRESERVE: "PRESERVE";
+};
+export type ObjectMetadata = (typeof ObjectMetadata)[keyof typeof ObjectMetadata];
 export declare const ObjectTags: {
   readonly NONE: "NONE";
   readonly PRESERVE: "PRESERVE";

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

@@ -17,6 +17,7 @@ import {
   ManifestFormat,
   Mtime,
   NfsVersion,
+  ObjectMetadata,
   ObjectStorageServerProtocol,
   ObjectTags,
   ObjectVersionIds,
@@ -307,6 +308,7 @@ export interface Options {
   TransferMode?: TransferMode | undefined;
   SecurityDescriptorCopyFlags?: SmbSecurityDescriptorCopyFlags | undefined;
   ObjectTags?: ObjectTags | undefined;
+  ObjectMetadata?: ObjectMetadata | undefined;
 }
 export interface TaskSchedule {
   ScheduleExpression: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/client-datasync",
-  "version": "3.1150.0",
+  "version": "3.1151.0",
   "description": "AWS SDK for JavaScript Datasync Client for Node.js, Browser and React Native",
   "homepage": "https://github.com/aws/aws-sdk-js-v3/tree/main/clients/client-datasync",
   "license": "Apache-2.0",