@aws-sdk/client-datasync 3.398.0 → 3.403.0

package/dist-cjs/models/models_0.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateLocationFsxOpenZfsRequestFilterSensitiveLog = exports.CreateLocationFsxOntapRequestFilterSensitiveLog = exports.FsxProtocolFilterSensitiveLog = exports.FsxProtocolSmbFilterSensitiveLog = exports.CreateLocationAzureBlobRequestFilterSensitiveLog = exports.AzureBlobSasConfigurationFilterSensitiveLog = exports.AddStorageSystemRequestFilterSensitiveLog = exports.CredentialsFilterSensitiveLog = exports.TaskFilterName = exports.Operator = exports.LocationFilterName = exports.TaskExecutionStatus = exports.PhaseStatus = exports.TaskStatus = exports.RecommendationStatus = exports.DiscoveryResourceFilter = exports.DiscoveryResourceType = exports.StorageSystemConnectivityStatus = exports.DiscoveryJobStatus = exports.EndpointType = exports.VerifyMode = exports.Uid = exports.TransferMode = exports.TaskQueueing = exports.SmbSecurityDescriptorCopyFlags = exports.PreserveDevices = exports.PreserveDeletedFiles = exports.PosixPermissions = exports.OverwriteMode = exports.ObjectTags = exports.Mtime = exports.LogLevel = exports.Gid = exports.FilterType = exports.S3StorageClass = exports.ObjectStorageServerProtocol = exports.HdfsRpcProtection = exports.HdfsDataTransferProtection = exports.HdfsAuthenticationType = exports.SmbVersion = exports.NfsVersion = exports.EfsInTransitEncryption = exports.AzureBlobType = exports.AzureBlobAuthenticationType = exports.AzureAccessTier = exports.Atime = exports.AgentStatus = exports.InvalidRequestException = exports.InternalException = exports.DiscoverySystemType = void 0;
-exports.UpdateStorageSystemRequestFilterSensitiveLog = exports.UpdateLocationSmbRequestFilterSensitiveLog = exports.UpdateLocationObjectStorageRequestFilterSensitiveLog = exports.UpdateLocationAzureBlobRequestFilterSensitiveLog = exports.DescribeLocationFsxOpenZfsResponseFilterSensitiveLog = exports.DescribeLocationFsxOntapResponseFilterSensitiveLog = exports.CreateLocationSmbRequestFilterSensitiveLog = exports.CreateLocationObjectStorageRequestFilterSensitiveLog = exports.CreateLocationFsxWindowsRequestFilterSensitiveLog = void 0;
+exports.FsxProtocolSmbFilterSensitiveLog = exports.CreateLocationAzureBlobRequestFilterSensitiveLog = exports.AzureBlobSasConfigurationFilterSensitiveLog = exports.AddStorageSystemRequestFilterSensitiveLog = exports.CredentialsFilterSensitiveLog = exports.TaskFilterName = exports.Operator = exports.LocationFilterName = exports.TaskExecutionStatus = exports.PhaseStatus = exports.TaskStatus = exports.RecommendationStatus = exports.DiscoveryResourceFilter = exports.DiscoveryResourceType = exports.StorageSystemConnectivityStatus = exports.DiscoveryJobStatus = exports.EndpointType = exports.ReportLevel = exports.ReportOutputType = exports.ObjectVersionIds = exports.VerifyMode = exports.Uid = exports.TransferMode = exports.TaskQueueing = exports.SmbSecurityDescriptorCopyFlags = exports.PreserveDevices = exports.PreserveDeletedFiles = exports.PosixPermissions = exports.OverwriteMode = exports.ObjectTags = exports.Mtime = exports.LogLevel = exports.Gid = exports.FilterType = exports.S3StorageClass = exports.ObjectStorageServerProtocol = exports.HdfsRpcProtection = exports.HdfsDataTransferProtection = exports.HdfsAuthenticationType = exports.SmbVersion = exports.NfsVersion = exports.EfsInTransitEncryption = exports.AzureBlobType = exports.AzureBlobAuthenticationType = exports.AzureAccessTier = exports.Atime = exports.AgentStatus = exports.InvalidRequestException = exports.InternalException = exports.DiscoverySystemType = void 0;
+exports.UpdateStorageSystemRequestFilterSensitiveLog = exports.UpdateLocationSmbRequestFilterSensitiveLog = exports.UpdateLocationObjectStorageRequestFilterSensitiveLog = exports.UpdateLocationAzureBlobRequestFilterSensitiveLog = exports.DescribeLocationFsxOpenZfsResponseFilterSensitiveLog = exports.DescribeLocationFsxOntapResponseFilterSensitiveLog = exports.CreateLocationSmbRequestFilterSensitiveLog = exports.CreateLocationObjectStorageRequestFilterSensitiveLog = exports.CreateLocationFsxWindowsRequestFilterSensitiveLog = exports.CreateLocationFsxOpenZfsRequestFilterSensitiveLog = exports.CreateLocationFsxOntapRequestFilterSensitiveLog = exports.FsxProtocolFilterSensitiveLog = void 0;
 const smithy_client_1 = require("@smithy/smithy-client");
 const DataSyncServiceException_1 = require("./DataSyncServiceException");
 exports.DiscoverySystemType = {
@@ -164,6 +164,18 @@ exports.VerifyMode = {
     ONLY_FILES_TRANSFERRED: "ONLY_FILES_TRANSFERRED",
     POINT_IN_TIME_CONSISTENT: "POINT_IN_TIME_CONSISTENT",
 };
+exports.ObjectVersionIds = {
+    INCLUDE: "INCLUDE",
+    NONE: "NONE",
+};
+exports.ReportOutputType = {
+    STANDARD: "STANDARD",
+    SUMMARY_ONLY: "SUMMARY_ONLY",
+};
+exports.ReportLevel = {
+    ERRORS_ONLY: "ERRORS_ONLY",
+    SUCCESSES_AND_ERRORS: "SUCCESSES_AND_ERRORS",
+};
 exports.EndpointType = {
     FIPS: "FIPS",
     PRIVATE_LINK: "PRIVATE_LINK",

package/dist-cjs/protocols/Aws_json1_1.js

@@ -2959,15 +2959,21 @@ const de_DescribeTaskExecutionResponse = (output, context) => {
         BytesTransferred: smithy_client_1.expectLong,
         BytesWritten: smithy_client_1.expectLong,
         EstimatedBytesToTransfer: smithy_client_1.expectLong,
+        EstimatedFilesToDelete: smithy_client_1.expectLong,
         EstimatedFilesToTransfer: smithy_client_1.expectLong,
         Excludes: smithy_client_1._json,
+        FilesDeleted: smithy_client_1.expectLong,
+        FilesSkipped: smithy_client_1.expectLong,
         FilesTransferred: smithy_client_1.expectLong,
+        FilesVerified: smithy_client_1.expectLong,
         Includes: smithy_client_1._json,
         Options: smithy_client_1._json,
+        ReportResult: smithy_client_1._json,
         Result: smithy_client_1._json,
         StartTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(_))),
         Status: smithy_client_1.expectString,
         TaskExecutionArn: smithy_client_1.expectString,
+        TaskReportConfig: smithy_client_1._json,
     });
 };
 const de_DescribeTaskResponse = (output, context) => {
@@ -2988,6 +2994,7 @@ const de_DescribeTaskResponse = (output, context) => {
         SourceNetworkInterfaceArns: smithy_client_1._json,
         Status: smithy_client_1.expectString,
         TaskArn: smithy_client_1.expectString,
+        TaskReportConfig: smithy_client_1._json,
     });
 };
 const de_IOPS = (output, context) => {

package/dist-es/models/models_0.js

@@ -158,6 +158,18 @@ export const VerifyMode = {
     ONLY_FILES_TRANSFERRED: "ONLY_FILES_TRANSFERRED",
     POINT_IN_TIME_CONSISTENT: "POINT_IN_TIME_CONSISTENT",
 };
+export const ObjectVersionIds = {
+    INCLUDE: "INCLUDE",
+    NONE: "NONE",
+};
+export const ReportOutputType = {
+    STANDARD: "STANDARD",
+    SUMMARY_ONLY: "SUMMARY_ONLY",
+};
+export const ReportLevel = {
+    ERRORS_ONLY: "ERRORS_ONLY",
+    SUCCESSES_AND_ERRORS: "SUCCESSES_AND_ERRORS",
+};
 export const EndpointType = {
     FIPS: "FIPS",
     PRIVATE_LINK: "PRIVATE_LINK",

package/dist-es/protocols/Aws_json1_1.js

@@ -2834,15 +2834,21 @@ const de_DescribeTaskExecutionResponse = (output, context) => {
         BytesTransferred: __expectLong,
         BytesWritten: __expectLong,
         EstimatedBytesToTransfer: __expectLong,
+        EstimatedFilesToDelete: __expectLong,
         EstimatedFilesToTransfer: __expectLong,
         Excludes: _json,
+        FilesDeleted: __expectLong,
+        FilesSkipped: __expectLong,
         FilesTransferred: __expectLong,
+        FilesVerified: __expectLong,
         Includes: _json,
         Options: _json,
+        ReportResult: _json,
         Result: _json,
         StartTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         Status: __expectString,
         TaskExecutionArn: __expectString,
+        TaskReportConfig: _json,
     });
 };
 const de_DescribeTaskResponse = (output, context) => {
@@ -2863,6 +2869,7 @@ const de_DescribeTaskResponse = (output, context) => {
         SourceNetworkInterfaceArns: _json,
         Status: __expectString,
         TaskArn: __expectString,
+        TaskReportConfig: _json,
     });
 };
 const de_IOPS = (output, context) => {

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

@@ -23,9 +23,9 @@ export interface CreateTaskCommandOutput extends CreateTaskResponse, __MetadataB
 }
 /**
  * @public
- * <p>Configures a task, which defines where and how DataSync transfers your
+ * <p>Configures a transfer task, which defines where and how DataSync moves your
  *       data.</p>
- *          <p>A task includes a source location, a destination location, and the preferences for how and
+ *          <p>A task includes a source location, destination location, and the options for how and
  *       when you want to transfer your data (such as bandwidth limits, scheduling, among other
  *       options).</p>
  *          <important>
@@ -83,6 +83,32 @@ export interface CreateTaskCommandOutput extends CreateTaskResponse, __MetadataB
  *       Value: "STRING_VALUE",
  *     },
  *   ],
+ *   TaskReportConfig: { // TaskReportConfig
+ *     Destination: { // ReportDestination
+ *       S3: { // ReportDestinationS3
+ *         Subdirectory: "STRING_VALUE",
+ *         S3BucketArn: "STRING_VALUE", // required
+ *         BucketAccessRoleArn: "STRING_VALUE", // required
+ *       },
+ *     },
+ *     OutputType: "SUMMARY_ONLY" || "STANDARD",
+ *     ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *     ObjectVersionIds: "INCLUDE" || "NONE",
+ *     Overrides: { // ReportOverrides
+ *       Transferred: { // ReportOverride
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Verified: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Deleted: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Skipped: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *     },
+ *   },
  * };
  * const command = new CreateTaskCommand(input);
  * const response = await client.send(command);

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

@@ -23,7 +23,7 @@ export interface DeleteTaskCommandOutput extends DeleteTaskResponse, __MetadataB
 }
 /**
  * @public
- * <p>Deletes an DataSync task.</p>
+ * <p>Deletes an DataSync transfer task.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -84,6 +84,32 @@ export interface DescribeTaskCommandOutput extends DescribeTaskResponse, __Metad
  * //       Value: "STRING_VALUE",
  * //     },
  * //   ],
+ * //   TaskReportConfig: { // TaskReportConfig
+ * //     Destination: { // ReportDestination
+ * //       S3: { // ReportDestinationS3
+ * //         Subdirectory: "STRING_VALUE",
+ * //         S3BucketArn: "STRING_VALUE", // required
+ * //         BucketAccessRoleArn: "STRING_VALUE", // required
+ * //       },
+ * //     },
+ * //     OutputType: "SUMMARY_ONLY" || "STANDARD",
+ * //     ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //     ObjectVersionIds: "INCLUDE" || "NONE",
+ * //     Overrides: { // ReportOverrides
+ * //       Transferred: { // ReportOverride
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //       Verified: {
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //       Deleted: {
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //       Skipped: {
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //     },
+ * //   },
  * // };
  *
  * ```

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

@@ -23,8 +23,9 @@ export interface DescribeTaskExecutionCommandOutput extends DescribeTaskExecutio
 }
 /**
  * @public
- * <p>Provides information about an DataSync transfer task that's
- *       running.</p>
+ * <p>Provides information about an execution of your DataSync task. You can
+ *       use this operation to help monitor the progress of an ongoing transfer or check the results of
+ *       the transfer.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -86,6 +87,41 @@ export interface DescribeTaskExecutionCommandOutput extends DescribeTaskExecutio
  * //     ErrorDetail: "STRING_VALUE",
  * //   },
  * //   BytesCompressed: Number("long"),
+ * //   TaskReportConfig: { // TaskReportConfig
+ * //     Destination: { // ReportDestination
+ * //       S3: { // ReportDestinationS3
+ * //         Subdirectory: "STRING_VALUE",
+ * //         S3BucketArn: "STRING_VALUE", // required
+ * //         BucketAccessRoleArn: "STRING_VALUE", // required
+ * //       },
+ * //     },
+ * //     OutputType: "SUMMARY_ONLY" || "STANDARD",
+ * //     ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //     ObjectVersionIds: "INCLUDE" || "NONE",
+ * //     Overrides: { // ReportOverrides
+ * //       Transferred: { // ReportOverride
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //       Verified: {
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //       Deleted: {
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //       Skipped: {
+ * //         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ * //       },
+ * //     },
+ * //   },
+ * //   FilesDeleted: Number("long"),
+ * //   FilesSkipped: Number("long"),
+ * //   FilesVerified: Number("long"),
+ * //   ReportResult: { // ReportResult
+ * //     Status: "PENDING" || "SUCCESS" || "ERROR",
+ * //     ErrorCode: "STRING_VALUE",
+ * //     ErrorDetail: "STRING_VALUE",
+ * //   },
+ * //   EstimatedFilesToDelete: Number("long"),
  * // };
  *
  * ```

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

@@ -23,8 +23,8 @@ export interface StartTaskExecutionCommandOutput extends StartTaskExecutionRespo
 }
 /**
  * @public
- * <p>Starts an DataSync task. For each task, you can only run one task execution
- *       at a time.</p>
+ * <p>Starts an DataSync transfer task. For each task, you can only run one task
+ *       execution at a time.</p>
  *          <p>There are several phases to a task execution. For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses">Task execution statuses</a>.</p>
  *          <important>
  *             <p>If you're planning to transfer data to or from an Amazon S3 location, review
@@ -75,6 +75,32 @@ export interface StartTaskExecutionCommandOutput extends StartTaskExecutionRespo
  *       Value: "STRING_VALUE",
  *     },
  *   ],
+ *   TaskReportConfig: { // TaskReportConfig
+ *     Destination: { // ReportDestination
+ *       S3: { // ReportDestinationS3
+ *         Subdirectory: "STRING_VALUE",
+ *         S3BucketArn: "STRING_VALUE", // required
+ *         BucketAccessRoleArn: "STRING_VALUE", // required
+ *       },
+ *     },
+ *     OutputType: "SUMMARY_ONLY" || "STANDARD",
+ *     ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *     ObjectVersionIds: "INCLUDE" || "NONE",
+ *     Overrides: { // ReportOverrides
+ *       Transferred: { // ReportOverride
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Verified: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Deleted: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Skipped: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *     },
+ *   },
  * };
  * const command = new StartTaskExecutionCommand(input);
  * const response = await client.send(command);

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

@@ -23,7 +23,7 @@ export interface UpdateTaskCommandOutput extends UpdateTaskResponse, __MetadataB
 }
 /**
  * @public
- * <p>Updates the metadata associated with a task.</p>
+ * <p>Updates the configuration of a DataSync transfer task.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -66,6 +66,32 @@ export interface UpdateTaskCommandOutput extends UpdateTaskResponse, __MetadataB
  *       Value: "STRING_VALUE",
  *     },
  *   ],
+ *   TaskReportConfig: { // TaskReportConfig
+ *     Destination: { // ReportDestination
+ *       S3: { // ReportDestinationS3
+ *         Subdirectory: "STRING_VALUE",
+ *         S3BucketArn: "STRING_VALUE", // required
+ *         BucketAccessRoleArn: "STRING_VALUE", // required
+ *       },
+ *     },
+ *     OutputType: "SUMMARY_ONLY" || "STANDARD",
+ *     ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *     ObjectVersionIds: "INCLUDE" || "NONE",
+ *     Overrides: { // ReportOverrides
+ *       Transferred: { // ReportOverride
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Verified: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Deleted: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *       Skipped: {
+ *         ReportLevel: "ERRORS_ONLY" || "SUCCESSES_AND_ERRORS",
+ *       },
+ *     },
+ *   },
  * };
  * const command = new UpdateTaskCommand(input);
  * const response = await client.send(command);

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

@@ -23,13 +23,13 @@ export interface UpdateTaskExecutionCommandOutput extends UpdateTaskExecutionRes
 }
 /**
  * @public
- * <p>Modifies a running DataSync task.</p>
+ * <p>Updates the configuration of a running DataSync task execution.</p>
  *          <note>
  *             <p>Currently, the only <code>Option</code> that you can modify with
  *           <code>UpdateTaskExecution</code> is <code>
  *                   <a href="https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond">BytesPerSecond</a>
  *                </code>, which throttles bandwidth for a running or queued
- *         task.</p>
+ *         task execution.</p>
  *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -244,8 +244,7 @@ export type AzureBlobAuthenticationType = (typeof AzureBlobAuthenticationType)[k
 export interface AzureBlobSasConfiguration {
     /**
      * @public
-     * <p>Specifies a SAS token that provides permissions at the Azure storage account, container,
-     *       or folder level.</p>
+     * <p>Specifies a SAS token that provides permissions to access your Azure Blob Storage.</p>
      *          <p>The token is part of the SAS URI string that comes after the storage resource URI and a question mark. A token looks something like this:</p>
      *          <p>
      *             <code>sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D</code>
@@ -1696,11 +1695,11 @@ export declare const VerifyMode: {
 export type VerifyMode = (typeof VerifyMode)[keyof typeof VerifyMode];
 /**
  * @public
- * <p>Configures your DataSync task settings. These options include how DataSync handles files, objects, and their associated metadata. You also can specify how
- *         DataSync verifies data integrity, set bandwidth limits for your task, among other
+ * <p>Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You
+ *       also can specify how to verify data integrity, set bandwidth limits for your task, among other
  *       options.</p>
- *          <p>Each task setting has a default value. Unless you need to, you don't have to configure
- *       any of these <code>Options</code> before starting your task.</p>
+ *          <p>Each option has a default value. Unless you need to, you don't have to configure any of
+ *       these options before starting your task.</p>
  */
 export interface Options {
     /**
@@ -1974,6 +1973,177 @@ export interface TaskSchedule {
      */
     ScheduleExpression: string | undefined;
 }
+/**
+ * @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>
+ */
+export interface ReportDestinationS3 {
+    /**
+     * @public
+     * <p>Specifies a bucket prefix for your report.</p>
+     */
+    Subdirectory?: string;
+    /**
+     * @public
+     * <p>Specifies the ARN of the S3 bucket where DataSync uploads your report.</p>
+     */
+    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>
+     */
+    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>
+ */
+export interface ReportDestination {
+    /**
+     * @public
+     * <p>Specifies the Amazon S3 bucket where DataSync uploads your task report.</p>
+     */
+    S3?: ReportDestinationS3;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const ObjectVersionIds: {
+    readonly INCLUDE: "INCLUDE";
+    readonly NONE: "NONE";
+};
+/**
+ * @public
+ */
+export type ObjectVersionIds = (typeof ObjectVersionIds)[keyof typeof ObjectVersionIds];
+/**
+ * @public
+ * @enum
+ */
+export declare const ReportOutputType: {
+    readonly STANDARD: "STANDARD";
+    readonly SUMMARY_ONLY: "SUMMARY_ONLY";
+};
+/**
+ * @public
+ */
+export type ReportOutputType = (typeof ReportOutputType)[keyof typeof ReportOutputType];
+/**
+ * @public
+ * @enum
+ */
+export declare const ReportLevel: {
+    readonly ERRORS_ONLY: "ERRORS_ONLY";
+    readonly SUCCESSES_AND_ERRORS: "SUCCESSES_AND_ERRORS";
+};
+/**
+ * @public
+ */
+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
+ *         report</a>.</p>
+ */
+export interface ReportOverride {
+    /**
+     * @public
+     * <p>Specifies whether your task report includes errors only or successes and errors.</p>
+     *          <p>For example, your report might mostly include only what didn't go well in your transfer (<code>ERRORS_ONLY</code>). At the same time, you want to verify that your <a href="https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html">task filter</a> is working correctly. In this situation, you can get a list of what files DataSync successfully skipped and if something transferred that you didn't to transfer (<code>SUCCESSES_AND_ERRORS</code>).</p>
+     */
+    ReportLevel?: ReportLevel | string;
+}
+/**
+ * @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
+ *         report</a>.</p>
+ */
+export interface ReportOverrides {
+    /**
+     * @public
+     * <p>Specifies the level of reporting for the files, objects, and directories that DataSync attempted to transfer.</p>
+     */
+    Transferred?: ReportOverride;
+    /**
+     * @public
+     * <p>Specifies the level of reporting for the files, objects, and directories that DataSync attempted to verify at the end of your transfer. This only applies if you <a href="https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html">configure your task</a> to verify data during and after the transfer (which DataSync does by default).</p>
+     */
+    Verified?: ReportOverride;
+    /**
+     * @public
+     * <p>Specifies the level of reporting for the files, objects, and directories that DataSync attempted to delete in your destination location. This only applies if you <a href="https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html">configure your task</a> to delete data in the destination that isn't in the source.</p>
+     */
+    Deleted?: ReportOverride;
+    /**
+     * @public
+     * <p>Specifies the level of reporting for the files, objects, and directories that DataSync attempted to skip during your transfer.</p>
+     */
+    Skipped?: ReportOverride;
+}
+/**
+ * @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
+ *         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>
+     */
+    Destination?: ReportDestination;
+    /**
+     * @public
+     * <p>Specifies the type of task report that you want:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>SUMMARY_ONLY</code>: Provides necessary details about your task, including the number of
+     *           files, objects, and directories transferred and transfer duration.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>STANDARD</code>: Provides complete details about your task, including a full list of
+     *           files, objects, and directories that were transferred, skipped, verified, and more.</p>
+     *             </li>
+     *          </ul>
+     */
+    OutputType?: ReportOutputType | string;
+    /**
+     * @public
+     * <p>Specifies whether you want your task report to include only what went wrong with your transfer or a list of what succeeded and didn't.</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>ERRORS_ONLY</code>: A report shows what DataSync was unable to transfer, skip,
+     *           verify, and delete.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>SUCCESSES_AND_ERRORS</code>: A report shows what DataSync was able and unable
+     *           to transfer, skip, verify, and delete.</p>
+     *             </li>
+     *          </ul>
+     */
+    ReportLevel?: ReportLevel | string;
+    /**
+     * @public
+     * <p>Specifies whether your task report includes the new version of each object transferred into an S3 bucket. This only applies if you <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html">enable versioning on your bucket</a>. Keep in mind that setting this to <code>INCLUDE</code> can increase the duration of your task execution.</p>
+     */
+    ObjectVersionIds?: ObjectVersionIds | string;
+    /**
+     * @public
+     * <p>Customizes the reporting level for aspects of your task report. For example, your report
+     *       might generally only include errors, but you could specify that you want a list of successes
+     *       and errors just for the files that DataSync attempted to delete in your destination
+     *       location.</p>
+     */
+    Overrides?: ReportOverrides;
+}
 /**
  * @public
  * <p>CreateTaskRequest</p>
@@ -2038,6 +2208,12 @@ export interface CreateTaskRequest {
      *       information and examples, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html">Filtering data transferred by DataSync</a>.</p>
      */
     Includes?: FilterRule[];
+    /**
+     * @public
+     * <p>Specifies how you want to configure a task report, which provides detailed information
+     *       about for your DataSync transfer.</p>
+     */
+    TaskReportConfig?: TaskReportConfig;
 }
 /**
  * @public
@@ -3727,6 +3903,11 @@ export interface DescribeTaskResponse {
      *       information and examples, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html">Filtering data transferred by DataSync</a>.</p>
      */
     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>
+     */
+    TaskReportConfig?: TaskReportConfig;
 }
 /**
  * @public
@@ -3735,7 +3916,8 @@ export interface DescribeTaskResponse {
 export interface DescribeTaskExecutionRequest {
     /**
      * @public
-     * <p>Specifies the Amazon Resource Name (ARN) of the transfer task that's running.</p>
+     * <p>Specifies the Amazon Resource Name (ARN) of the task execution that you want
+     *       information about.</p>
      */
     TaskExecutionArn: string | undefined;
 }
@@ -3752,6 +3934,30 @@ export declare const PhaseStatus: {
  * @public
  */
 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
+ *       transfer.</p>
+ */
+export interface ReportResult {
+    /**
+     * @public
+     * <p>Indicates whether DataSync is still working on your report, created a report, or
+     *       can't create a complete report.</p>
+     */
+    Status?: PhaseStatus | string;
+    /**
+     * @public
+     * <p>Indicates the code associated with the error if DataSync can't create a complete
+     *       report.</p>
+     */
+    ErrorCode?: string;
+    /**
+     * @public
+     * <p>Provides details about issues creating a report.</p>
+     */
+    ErrorDetail?: string;
+}
 /**
  * @public
  * <p>Describes the detailed result of a <code>TaskExecution</code> operation. This result
@@ -3835,7 +4041,7 @@ export type TaskExecutionStatus = (typeof TaskExecutionStatus)[keyof typeof Task
 export interface DescribeTaskExecutionResponse {
     /**
      * @public
-     * <p>The Amazon Resource Name (ARN) of the task execution that was described.
+     * <p>The ARN of the task execution that you wanted information about.
      *         <code>TaskExecutionArn</code> is hierarchical and includes <code>TaskArn</code> for the task
      *       that was executed. </p>
      *          <p>For example, a <code>TaskExecution</code> value with the ARN
@@ -3847,18 +4053,15 @@ export interface DescribeTaskExecutionResponse {
     /**
      * @public
      * <p>The status of the task execution. </p>
-     *          <p>For detailed information about task execution statuses, see Understanding
-     *       Task Statuses in the <i>DataSync User Guide.</i>
-     *          </p>
      */
     Status?: TaskExecutionStatus | string;
     /**
      * @public
-     * <p>Configures your DataSync task settings. These options include how DataSync handles files, objects, and their associated metadata. You also can specify how
-     *         DataSync verifies data integrity, set bandwidth limits for your task, among other
+     * <p>Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You
+     *       also can specify how to verify data integrity, set bandwidth limits for your task, among other
      *       options.</p>
-     *          <p>Each task setting has a default value. Unless you need to, you don't have to configure
-     *       any of these <code>Options</code> before starting your task.</p>
+     *          <p>Each option has a default value. Unless you need to, you don't have to configure any of
+     *       these options before starting your task.</p>
      */
     Options?: Options;
     /**
@@ -3875,41 +4078,38 @@ export interface DescribeTaskExecutionResponse {
     Includes?: FilterRule[];
     /**
      * @public
-     * <p>The time that the task execution was started.</p>
+     * <p>The time when the task execution started.</p>
      */
     StartTime?: Date;
     /**
      * @public
-     * <p>The expected number of files that is to be transferred over the network. This value is
-     *       calculated during the <code>PREPARING</code> phase before the <code>TRANSFERRING</code> phase
-     *       of the task execution. This value is the expected number of files to be transferred. It's
-     *       calculated based on comparing the content of the source and destination locations and finding
-     *       the delta that needs to be transferred. </p>
+     * <p>The expected number of files, objects, and directories that DataSync will
+     *       transfer over the network. This value is calculated during the task execution's
+     *         <code>PREPARING</code> phase before the <code>TRANSFERRING</code> phase. The calculation is
+     *       based on comparing the content of the source and destination locations and finding the
+     *       difference that needs to be transferred. </p>
      */
     EstimatedFilesToTransfer?: number;
     /**
      * @public
-     * <p>The estimated physical number of bytes that is to be transferred over the
-     *       network.</p>
+     * <p>The estimated physical number of bytes that will transfer over the network.</p>
      */
     EstimatedBytesToTransfer?: number;
     /**
      * @public
-     * <p>The actual number of files that was transferred over the network. This value is
-     *       calculated and updated on an ongoing basis during the <code>TRANSFERRING</code> phase of the
-     *       task execution. It's updated periodically when each file is read from the source and sent over
-     *       the network. </p>
-     *          <p>If failures occur during a transfer, this value can be less than
+     * <p>The actual number of files, objects, and directories that DataSync
+     *       transferred over the network. This value is updated periodically during the task execution's
+     *         <code>TRANSFERRING</code> phase when something is read from the source and sent over the
+     *       network.</p>
+     *          <p>If DataSync fails to transfer something, this value can be less than
      *         <code>EstimatedFilesToTransfer</code>. In some cases, this value can also be greater than
      *         <code>EstimatedFilesToTransfer</code>. This element is implementation-specific for some
-     *       location types, so don't use it as an indicator for a correct file number or to monitor your
-     *       task execution.</p>
+     *       location types, so don't use it as an exact indication of what transferred or to monitor your task execution.</p>
      */
     FilesTransferred?: number;
     /**
      * @public
-     * <p>The number of logical bytes written to the destination Amazon Web Services storage
-     *       resource.</p>
+     * <p>The number of logical bytes written to the destination location.</p>
      */
     BytesWritten?: number;
     /**
@@ -3930,6 +4130,45 @@ export interface DescribeTaskExecutionResponse {
      *       compressible.</p>
      */
     BytesCompressed?: number;
+    /**
+     * @public
+     * <p>The configuration of your task report, which provides detailed information about for your DataSync transfer.</p>
+     */
+    TaskReportConfig?: TaskReportConfig;
+    /**
+     * @public
+     * <p>The number of files, objects, and directories that DataSync deleted in your
+     *       destination location. If you don't <a href="https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html">configure your task</a> to
+     *       delete data in the destination that isn't in the source, the value is always
+     *       <code>0</code>.</p>
+     */
+    FilesDeleted?: number;
+    /**
+     * @public
+     * <p>The number of files, objects, and directories that DataSync skipped during your
+     *       transfer.</p>
+     */
+    FilesSkipped?: number;
+    /**
+     * @public
+     * <p>The number of files, objects, and directories that DataSync verified during your
+     *       transfer.</p>
+     */
+    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
+     *       transfer.</p>
+     */
+    ReportResult?: ReportResult;
+    /**
+     * @public
+     * <p>The expected number of files, objects, and directories that DataSync will delete
+     *       in your destination location.  If you don't <a href="https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html">configure your task</a> to
+     *       delete data in the destination that isn't in the source, the value is always
+     *       <code>0</code>.</p>
+     */
+    EstimatedFilesToDelete?: number;
 }
 /**
  * @public
@@ -4515,11 +4754,11 @@ export interface StartTaskExecutionRequest {
     TaskArn: string | undefined;
     /**
      * @public
-     * <p>Configures your DataSync task settings. These options include how DataSync handles files, objects, and their associated metadata. You also can specify how
-     *         DataSync verifies data integrity, set bandwidth limits for your task, among other
+     * <p>Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You
+     *       also can specify how to verify data integrity, set bandwidth limits for your task, among other
      *       options.</p>
-     *          <p>Each task setting has a default value. Unless you need to, you don't have to configure
-     *       any of these <code>Options</code> before starting your task.</p>
+     *          <p>Each option has a default value. Unless you need to, you don't have to configure any of
+     *       these options before starting your task.</p>
      */
     OverrideOptions?: Options;
     /**
@@ -4546,6 +4785,11 @@ export interface StartTaskExecutionRequest {
      *       your DataSync resources.</p>
      */
     Tags?: TagListEntry[];
+    /**
+     * @public
+     * <p>Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.</p>
+     */
+    TaskReportConfig?: TaskReportConfig;
 }
 /**
  * @public
@@ -5019,11 +5263,11 @@ export interface UpdateTaskRequest {
     TaskArn: string | undefined;
     /**
      * @public
-     * <p>Configures your DataSync task settings. These options include how DataSync handles files, objects, and their associated metadata. You also can specify how
-     *         DataSync verifies data integrity, set bandwidth limits for your task, among other
+     * <p>Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You
+     *       also can specify how to verify data integrity, set bandwidth limits for your task, among other
      *       options.</p>
-     *          <p>Each task setting has a default value. Unless you need to, you don't have to configure
-     *       any of these <code>Options</code> before starting your task.</p>
+     *          <p>Each option has a default value. Unless you need to, you don't have to configure any of
+     *       these options before starting your task.</p>
      */
     Options?: Options;
     /**
@@ -5057,6 +5301,11 @@ export interface UpdateTaskRequest {
      *       information and examples, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html">Filtering data transferred by DataSync</a>.</p>
      */
     Includes?: FilterRule[];
+    /**
+     * @public
+     * <p>Specifies how you want to configure a task report, which provides detailed information about for your DataSync transfer.</p>
+     */
+    TaskReportConfig?: TaskReportConfig;
 }
 /**
  * @public
@@ -5075,11 +5324,11 @@ export interface UpdateTaskExecutionRequest {
     TaskExecutionArn: string | undefined;
     /**
      * @public
-     * <p>Configures your DataSync task settings. These options include how DataSync handles files, objects, and their associated metadata. You also can specify how
-     *         DataSync verifies data integrity, set bandwidth limits for your task, among other
+     * <p>Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You
+     *       also can specify how to verify data integrity, set bandwidth limits for your task, among other
      *       options.</p>
-     *          <p>Each task setting has a default value. Unless you need to, you don't have to configure
-     *       any of these <code>Options</code> before starting your task.</p>
+     *          <p>Each option has a default value. Unless you need to, you don't have to configure any of
+     *       these options before starting your task.</p>
      */
     Options: Options | undefined;
 }

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

@@ -435,6 +435,47 @@ export interface Options {
 export interface TaskSchedule {
   ScheduleExpression: string | undefined;
 }
+export interface ReportDestinationS3 {
+  Subdirectory?: string;
+  S3BucketArn: string | undefined;
+  BucketAccessRoleArn: string | undefined;
+}
+export interface ReportDestination {
+  S3?: ReportDestinationS3;
+}
+export declare const ObjectVersionIds: {
+  readonly INCLUDE: "INCLUDE";
+  readonly NONE: "NONE";
+};
+export type ObjectVersionIds =
+  (typeof ObjectVersionIds)[keyof typeof ObjectVersionIds];
+export declare const ReportOutputType: {
+  readonly STANDARD: "STANDARD";
+  readonly SUMMARY_ONLY: "SUMMARY_ONLY";
+};
+export type ReportOutputType =
+  (typeof ReportOutputType)[keyof typeof ReportOutputType];
+export declare const ReportLevel: {
+  readonly ERRORS_ONLY: "ERRORS_ONLY";
+  readonly SUCCESSES_AND_ERRORS: "SUCCESSES_AND_ERRORS";
+};
+export type ReportLevel = (typeof ReportLevel)[keyof typeof ReportLevel];
+export interface ReportOverride {
+  ReportLevel?: ReportLevel | string;
+}
+export interface ReportOverrides {
+  Transferred?: ReportOverride;
+  Verified?: ReportOverride;
+  Deleted?: ReportOverride;
+  Skipped?: ReportOverride;
+}
+export interface TaskReportConfig {
+  Destination?: ReportDestination;
+  OutputType?: ReportOutputType | string;
+  ReportLevel?: ReportLevel | string;
+  ObjectVersionIds?: ObjectVersionIds | string;
+  Overrides?: ReportOverrides;
+}
 export interface CreateTaskRequest {
   SourceLocationArn: string | undefined;
   DestinationLocationArn: string | undefined;
@@ -445,6 +486,7 @@ export interface CreateTaskRequest {
   Schedule?: TaskSchedule;
   Tags?: TagListEntry[];
   Includes?: FilterRule[];
+  TaskReportConfig?: TaskReportConfig;
 }
 export interface CreateTaskResponse {
   TaskArn?: string;
@@ -830,6 +872,7 @@ export interface DescribeTaskResponse {
   ErrorDetail?: string;
   CreationTime?: Date;
   Includes?: FilterRule[];
+  TaskReportConfig?: TaskReportConfig;
 }
 export interface DescribeTaskExecutionRequest {
   TaskExecutionArn: string | undefined;
@@ -840,6 +883,11 @@ export declare const PhaseStatus: {
   readonly SUCCESS: "SUCCESS";
 };
 export type PhaseStatus = (typeof PhaseStatus)[keyof typeof PhaseStatus];
+export interface ReportResult {
+  Status?: PhaseStatus | string;
+  ErrorCode?: string;
+  ErrorDetail?: string;
+}
 export interface TaskExecutionResultDetail {
   PrepareDuration?: number;
   PrepareStatus?: PhaseStatus | string;
@@ -876,6 +924,12 @@ export interface DescribeTaskExecutionResponse {
   BytesTransferred?: number;
   Result?: TaskExecutionResultDetail;
   BytesCompressed?: number;
+  TaskReportConfig?: TaskReportConfig;
+  FilesDeleted?: number;
+  FilesSkipped?: number;
+  FilesVerified?: number;
+  ReportResult?: ReportResult;
+  EstimatedFilesToDelete?: number;
 }
 export interface DiscoveryJobListEntry {
   DiscoveryJobArn?: string;
@@ -1020,6 +1074,7 @@ export interface StartTaskExecutionRequest {
   Includes?: FilterRule[];
   Excludes?: FilterRule[];
   Tags?: TagListEntry[];
+  TaskReportConfig?: TaskReportConfig;
 }
 export interface StartTaskExecutionResponse {
   TaskExecutionArn?: string;
@@ -1119,6 +1174,7 @@ export interface UpdateTaskRequest {
   Name?: string;
   CloudWatchLogGroupArn?: string;
   Includes?: FilterRule[];
+  TaskReportConfig?: TaskReportConfig;
 }
 export interface UpdateTaskResponse {}
 export interface UpdateTaskExecutionRequest {

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.398.0",
+  "version": "3.403.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",