@aws-sdk/client-datasync 3.229.0 → 3.233.0

package/dist-cjs/endpoint/ruleset.js

@@ -6,7 +6,7 @@ exports.ruleSet = {
     parameters: {
         Region: {
             builtIn: "AWS::Region",
-            required: false,
+            required: true,
             documentation: "The AWS region used to dispatch the request.",
             type: "String",
         },
@@ -56,15 +56,6 @@ exports.ruleSet = {
                                 },
                             ],
                         },
-                        {
-                            fn: "parseURL",
-                            argv: [
-                                {
-                                    ref: "Endpoint",
-                                },
-                            ],
-                            assign: "url",
-                        },
                     ],
                     type: "tree",
                     rules: [

package/dist-cjs/models/models_0.js

@@ -90,6 +90,7 @@ var S3StorageClass;
 (function (S3StorageClass) {
     S3StorageClass["DEEP_ARCHIVE"] = "DEEP_ARCHIVE";
     S3StorageClass["GLACIER"] = "GLACIER";
+    S3StorageClass["GLACIER_INSTANT_RETRIEVAL"] = "GLACIER_INSTANT_RETRIEVAL";
     S3StorageClass["INTELLIGENT_TIERING"] = "INTELLIGENT_TIERING";
     S3StorageClass["ONEZONE_IA"] = "ONEZONE_IA";
     S3StorageClass["OUTPOSTS"] = "OUTPOSTS";

package/dist-cjs/protocols/Aws_json1_1.js

@@ -2527,6 +2527,7 @@ const serializeAws_json1_1StartTaskExecutionRequest = (input, context) => {
         ...(input.OverrideOptions != null && {
             OverrideOptions: serializeAws_json1_1Options(input.OverrideOptions, context),
         }),
+        ...(input.Tags != null && { Tags: serializeAws_json1_1InputTagList(input.Tags, context) }),
         ...(input.TaskArn != null && { TaskArn: input.TaskArn }),
     };
 };

package/dist-es/endpoint/ruleset.js

@@ -3,7 +3,7 @@ export const ruleSet = {
     parameters: {
         Region: {
             builtIn: "AWS::Region",
-            required: false,
+            required: true,
             documentation: "The AWS region used to dispatch the request.",
             type: "String",
         },
@@ -53,15 +53,6 @@ export const ruleSet = {
                                 },
                             ],
                         },
-                        {
-                            fn: "parseURL",
-                            argv: [
-                                {
-                                    ref: "Endpoint",
-                                },
-                            ],
-                            assign: "url",
-                        },
                     ],
                     type: "tree",
                     rules: [

package/dist-es/models/models_0.js

@@ -83,6 +83,7 @@ export var S3StorageClass;
 (function (S3StorageClass) {
     S3StorageClass["DEEP_ARCHIVE"] = "DEEP_ARCHIVE";
     S3StorageClass["GLACIER"] = "GLACIER";
+    S3StorageClass["GLACIER_INSTANT_RETRIEVAL"] = "GLACIER_INSTANT_RETRIEVAL";
     S3StorageClass["INTELLIGENT_TIERING"] = "INTELLIGENT_TIERING";
     S3StorageClass["ONEZONE_IA"] = "ONEZONE_IA";
     S3StorageClass["OUTPOSTS"] = "OUTPOSTS";

package/dist-es/protocols/Aws_json1_1.js

@@ -2435,6 +2435,7 @@ const serializeAws_json1_1StartTaskExecutionRequest = (input, context) => {
         ...(input.OverrideOptions != null && {
             OverrideOptions: serializeAws_json1_1Options(input.OverrideOptions, context),
         }),
+        ...(input.Tags != null && { Tags: serializeAws_json1_1InputTagList(input.Tags, context) }),
         ...(input.TaskArn != null && { TaskArn: input.TaskArn }),
     };
 };

package/dist-types/DataSync.d.ts

@@ -46,13 +46,12 @@ import { UpdateTaskExecutionCommandInput, UpdateTaskExecutionCommandOutput } fro
 import { DataSyncClient } from "./DataSyncClient";
 /**
  * <fullname>DataSync</fullname>
- *
  *          <p>DataSync is a managed data transfer service that makes it simpler for you
  *       to automate moving data between on-premises storage and Amazon Web Services storage services. You also can use DataSync to transfer data between other cloud providers and Amazon Web Services storage services.</p>
  *          <p>This API interface reference includes documentation for using DataSync
  *       programmatically. For complete information, see the <i>
  *                <a href="https://docs.aws.amazon.com/datasync/latest/userguide/what-is-datasync.html">DataSync User
- *           Guide</a>
+ *         Guide</a>
  *             </i>.</p>
  */
 export declare class DataSync extends DataSyncClient {
@@ -79,8 +78,6 @@ export declare class DataSync extends DataSyncClient {
      *          <p>You can use an agent for more than one location. If a task uses multiple agents, all of
      *       them need to have status AVAILABLE for the task to run. If you use multiple agents for a
      *       source location, the status of all the agents must be AVAILABLE for the task to run. </p>
-     *
-     *
      *          <p>Agents are automatically updated by Amazon Web Services on a regular basis, using a mechanism that
      *       ensures minimal interruption to your tasks.</p>
      */
@@ -145,8 +142,6 @@ export declare class DataSync extends DataSyncClient {
     createLocationObjectStorage(args: CreateLocationObjectStorageCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateLocationObjectStorageCommandOutput) => void): void;
     /**
      * <p>Creates an endpoint for an Amazon S3 bucket that DataSync can access for a transfer.</p>
-     *
-     *
      *          <p>For
      *       more information, see
      *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli">Create an Amazon S3 location</a>
@@ -168,22 +163,6 @@ export declare class DataSync extends DataSyncClient {
      *          <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;
@@ -204,7 +183,7 @@ export declare class DataSync extends DataSyncClient {
     deleteLocation(args: DeleteLocationCommandInput, cb: (err: any, data?: DeleteLocationCommandOutput) => void): void;
     deleteLocation(args: DeleteLocationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteLocationCommandOutput) => void): void;
     /**
-     * <p>Deletes a task.</p>
+     * <p>Deletes an DataSync task.</p>
      */
     deleteTask(args: DeleteTaskCommandInput, options?: __HttpHandlerOptions): Promise<DeleteTaskCommandOutput>;
     deleteTask(args: DeleteTaskCommandInput, cb: (err: any, data?: DeleteTaskCommandOutput) => void): void;
@@ -322,7 +301,7 @@ export declare class DataSync extends DataSyncClient {
     listLocations(args: ListLocationsCommandInput, cb: (err: any, data?: ListLocationsCommandOutput) => void): void;
     listLocations(args: ListLocationsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListLocationsCommandOutput) => void): void;
     /**
-     * <p>Returns all the tags associated with a specified resource. </p>
+     * <p>Returns all the tags associated with an Amazon Web Services resource.</p>
      */
     listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
     listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
@@ -340,27 +319,22 @@ export declare class DataSync extends DataSyncClient {
     listTasks(args: ListTasksCommandInput, cb: (err: any, data?: ListTasksCommandOutput) => void): void;
     listTasks(args: ListTasksCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTasksCommandOutput) => void): void;
     /**
-     * <p>Starts a specific invocation of a task. A <code>TaskExecution</code> value represents
-     *       an individual run of a task. Each task can have at most one <code>TaskExecution</code> at a
-     *       time.</p>
-     *          <p>
-     *             <code>TaskExecution</code> has the following transition phases: INITIALIZING |
-     *       PREPARING | TRANSFERRING | VERIFYING | SUCCESS/FAILURE. </p>
-     *
-     *          <p>For detailed information, see the Task Execution section in the Components and
-     *       Terminology topic in the <i>DataSync User Guide</i>.</p>
+     * <p>Starts an DataSync 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>
      */
     startTaskExecution(args: StartTaskExecutionCommandInput, options?: __HttpHandlerOptions): Promise<StartTaskExecutionCommandOutput>;
     startTaskExecution(args: StartTaskExecutionCommandInput, cb: (err: any, data?: StartTaskExecutionCommandOutput) => void): void;
     startTaskExecution(args: StartTaskExecutionCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StartTaskExecutionCommandOutput) => void): void;
     /**
-     * <p>Applies a key-value pair to an Amazon Web Services resource.</p>
+     * <p>Applies a <i>tag</i> to an Amazon Web Services
+     *       resource. Tags are key-value pairs that can help you manage, filter, and search for your resources.</p>
+     *          <p>These include DataSync resources, such as locations, tasks, and task executions.</p>
      */
     tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
     tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     /**
-     * <p>Removes a tag from an Amazon Web Services resource.</p>
+     * <p>Removes tags from an Amazon Web Services resource.</p>
      */
     untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
     untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
@@ -412,7 +386,6 @@ export declare class DataSync extends DataSyncClient {
      * <p>Updates execution of a task.</p>
      *          <p>You can modify bandwidth throttling for a task execution that is running or queued.
      *       For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#adjust-bandwidth-throttling">Adjusting Bandwidth Throttling for a Task Execution</a>.</p>
-     *
      *          <note>
      *             <p>The only <code>Option</code> that can be modified by <code>UpdateTaskExecution</code>
      *         is <code>

package/dist-types/DataSyncClient.d.ts

@@ -168,13 +168,12 @@ export interface DataSyncClientResolvedConfig extends DataSyncClientResolvedConf
 }
 /**
  * <fullname>DataSync</fullname>
- *
  *          <p>DataSync is a managed data transfer service that makes it simpler for you
  *       to automate moving data between on-premises storage and Amazon Web Services storage services. You also can use DataSync to transfer data between other cloud providers and Amazon Web Services storage services.</p>
  *          <p>This API interface reference includes documentation for using DataSync
  *       programmatically. For complete information, see the <i>
  *                <a href="https://docs.aws.amazon.com/datasync/latest/userguide/what-is-datasync.html">DataSync User
- *           Guide</a>
+ *         Guide</a>
  *             </i>.</p>
  */
 export declare class DataSyncClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, DataSyncClientResolvedConfig> {

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

@@ -18,8 +18,6 @@ export interface CreateAgentCommandOutput extends CreateAgentResponse, __Metadat
  *          <p>You can use an agent for more than one location. If a task uses multiple agents, all of
  *       them need to have status AVAILABLE for the task to run. If you use multiple agents for a
  *       source location, the status of all the agents must be AVAILABLE for the task to run. </p>
- *
- *
  *          <p>Agents are automatically updated by Amazon Web Services on a regular basis, using a mechanism that
  *       ensures minimal interruption to your tasks.</p>
  * @example

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

@@ -9,8 +9,6 @@ export interface CreateLocationS3CommandOutput extends CreateLocationS3Response,
 }
 /**
  * <p>Creates an endpoint for an Amazon S3 bucket that DataSync can access for a transfer.</p>
- *
- *
  *          <p>For
  *       more information, see
  *       <a href="https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli">Create an Amazon S3 location</a>

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

@@ -13,22 +13,6 @@ export interface CreateTaskCommandOutput extends CreateTaskResponse, __MetadataB
  *          <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/DeleteTaskCommand.d.ts

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

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

@@ -8,7 +8,7 @@ export interface ListTagsForResourceCommandInput extends ListTagsForResourceRequ
 export interface ListTagsForResourceCommandOutput extends ListTagsForResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Returns all the tags associated with a specified resource. </p>
+ * <p>Returns all the tags associated with an Amazon Web Services resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -8,15 +8,8 @@ export interface StartTaskExecutionCommandInput extends StartTaskExecutionReques
 export interface StartTaskExecutionCommandOutput extends StartTaskExecutionResponse, __MetadataBearer {
 }
 /**
- * <p>Starts a specific invocation of a task. A <code>TaskExecution</code> value represents
- *       an individual run of a task. Each task can have at most one <code>TaskExecution</code> at a
- *       time.</p>
- *          <p>
- *             <code>TaskExecution</code> has the following transition phases: INITIALIZING |
- *       PREPARING | TRANSFERRING | VERIFYING | SUCCESS/FAILURE. </p>
- *
- *          <p>For detailed information, see the Task Execution section in the Components and
- *       Terminology topic in the <i>DataSync User Guide</i>.</p>
+ * <p>Starts an DataSync 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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -8,7 +8,9 @@ export interface TagResourceCommandInput extends TagResourceRequest {
 export interface TagResourceCommandOutput extends TagResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Applies a key-value pair to an Amazon Web Services resource.</p>
+ * <p>Applies a <i>tag</i> to an Amazon Web Services
+ *       resource. Tags are key-value pairs that can help you manage, filter, and search for your resources.</p>
+ *          <p>These include DataSync resources, such as locations, tasks, and task executions.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -8,7 +8,7 @@ export interface UntagResourceCommandInput extends UntagResourceRequest {
 export interface UntagResourceCommandOutput extends UntagResourceResponse, __MetadataBearer {
 }
 /**
- * <p>Removes a tag from an Amazon Web Services resource.</p>
+ * <p>Removes tags from an Amazon Web Services resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -11,7 +11,6 @@ export interface UpdateTaskExecutionCommandOutput extends UpdateTaskExecutionRes
  * <p>Updates execution of a task.</p>
  *          <p>You can modify bandwidth throttling for a task execution that is running or queued.
  *       For more information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#adjust-bandwidth-throttling">Adjusting Bandwidth Throttling for a Task Execution</a>.</p>
- *
  *          <note>
  *             <p>The only <code>Option</code> that can be modified by <code>UpdateTaskExecution</code>
  *         is <code>

package/dist-types/endpoint/EndpointParameters.d.ts

@@ -12,7 +12,7 @@ export declare const resolveClientEndpointParameters: <T>(options: T & ClientInp
     defaultSigningName: string;
 };
 export interface EndpointParameters extends __EndpointParameters {
-    Region?: string;
+    Region: string;
     UseDualStack?: boolean;
     UseFIPS?: boolean;
     Endpoint?: string;