feat(client-sqs): Revert previous SQS protocol change.

aws · May 5, 2023 · 75d4246 · 75d4246
1 parent 81d3554
commit 75d4246
Show file tree

Hide file tree

Showing 28 changed files with 6,889 additions and 8,176 deletions.
diff --git a/clients/client-sqs/README.md b/clients/client-sqs/README.md
@@ -10,15 +10,12 @@
 AWS SDK for JavaScript SQS Client for Node.js, Browser and React Native.
 
 <p>Welcome to the <i>Amazon SQS API Reference</i>.</p>
-<p>Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel
-between applications or microservices. Amazon SQS moves data between distributed application
-components and helps you decouple these components.</p>
-<p>For information on the permissions you need to use this API, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html">Identity and access management</a> in the <i>Amazon SQS Developer
-Guide.</i>
+<p>Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.</p>
+<p>For information on the permissions you need to use this API, see
+<a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html">Identity and
+access management</a> in the <i>Amazon SQS Developer Guide.</i>
 </p>
-<p>You can use <a href="http://aws.amazon.com/tools/#sdk">Amazon Web Services SDKs</a> to access
-Amazon SQS using your favorite programming language. The SDKs perform tasks such as the
-following automatically:</p>
+<p>You can use <a href="http://aws.amazon.com/tools/#sdk">Amazon Web Services SDKs</a> to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:</p>
 <ul>
 <li>
 <p>Cryptographically sign your service requests</p>
@@ -74,8 +71,7 @@ following automatically:</p>
 <ul>
 <li>
 <p>
-<a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region">Regions and
-Endpoints</a>
+<a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region">Regions and Endpoints</a>
 </p>
 </li>
 </ul>

diff --git a/clients/client-sqs/package.json b/clients/client-sqs/package.json
@@ -55,6 +55,7 @@
     "@aws-sdk/util-user-agent-browser": "*",
     "@aws-sdk/util-user-agent-node": "*",
     "@aws-sdk/util-utf8": "*",
+    "fast-xml-parser": "4.1.2",
     "tslib": "^2.5.0"
   },
   "devDependencies": {

diff --git a/clients/client-sqs/src/SQS.ts b/clients/client-sqs/src/SQS.ts
@@ -371,15 +371,12 @@ export interface SQS {
 /**
  * @public
  * <p>Welcome to the <i>Amazon SQS API Reference</i>.</p>
- *          <p>Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel
- *             between applications or microservices. Amazon SQS moves data between distributed application
- *             components and helps you decouple these components.</p>
- *          <p>For information on the permissions you need to use this API, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html">Identity and access management</a> in the <i>Amazon SQS Developer
- *                 Guide.</i>
+ *          <p>Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.</p>
+ *          <p>For information on the permissions you need to use this API, see
+ *             <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html">Identity and
+ *             access management</a> in the <i>Amazon SQS Developer Guide.</i>
  *          </p>
- *          <p>You can use <a href="http://aws.amazon.com/tools/#sdk">Amazon Web Services SDKs</a> to access
- *             Amazon SQS using your favorite programming language. The SDKs perform tasks such as the
- *             following automatically:</p>
+ *          <p>You can use <a href="http://aws.amazon.com/tools/#sdk">Amazon Web Services SDKs</a> to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:</p>
  *          <ul>
  *             <li>
  *                <p>Cryptographically sign your service requests</p>
@@ -435,8 +432,7 @@ export interface SQS {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region">Regions and
- *                                 Endpoints</a>
+ *                         <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region">Regions and Endpoints</a>
  *                      </p>
  *                   </li>
  *                </ul>

diff --git a/clients/client-sqs/src/SQSClient.ts b/clients/client-sqs/src/SQSClient.ts
@@ -308,15 +308,12 @@ export interface SQSClientResolvedConfig extends SQSClientResolvedConfigType {}
 /**
  * @public
  * <p>Welcome to the <i>Amazon SQS API Reference</i>.</p>
- *          <p>Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel
- *             between applications or microservices. Amazon SQS moves data between distributed application
- *             components and helps you decouple these components.</p>
- *          <p>For information on the permissions you need to use this API, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html">Identity and access management</a> in the <i>Amazon SQS Developer
- *                 Guide.</i>
+ *          <p>Amazon SQS is a reliable, highly-scalable hosted queue for storing messages as they travel between applications or microservices. Amazon SQS moves data between distributed application components and helps you decouple these components.</p>
+ *          <p>For information on the permissions you need to use this API, see
+ *             <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html">Identity and
+ *             access management</a> in the <i>Amazon SQS Developer Guide.</i>
  *          </p>
- *          <p>You can use <a href="http://aws.amazon.com/tools/#sdk">Amazon Web Services SDKs</a> to access
- *             Amazon SQS using your favorite programming language. The SDKs perform tasks such as the
- *             following automatically:</p>
+ *          <p>You can use <a href="http://aws.amazon.com/tools/#sdk">Amazon Web Services SDKs</a> to access Amazon SQS using your favorite programming language. The SDKs perform tasks such as the following automatically:</p>
  *          <ul>
  *             <li>
  *                <p>Cryptographically sign your service requests</p>
@@ -372,8 +369,7 @@ export interface SQSClientResolvedConfig extends SQSClientResolvedConfigType {}
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region">Regions and
- *                                 Endpoints</a>
+ *                         <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#sqs_region">Regions and Endpoints</a>
  *                      </p>
  *                   </li>
  *                </ul>

diff --git a/clients/client-sqs/src/commands/AddPermissionCommand.ts b/clients/client-sqs/src/commands/AddPermissionCommand.ts
@@ -14,7 +14,7 @@ import {
 } from "@aws-sdk/types";
 
 import { AddPermissionRequest } from "../models/models_0";
-import { de_AddPermissionCommand, se_AddPermissionCommand } from "../protocols/Aws_json1_0";
+import { de_AddPermissionCommand, se_AddPermissionCommand } from "../protocols/Aws_query";
 import { ServiceInputTypes, ServiceOutputTypes, SQSClientResolvedConfig } from "../SQSClient";
 
 /**
@@ -32,39 +32,45 @@ export interface AddPermissionCommandOutput extends __MetadataBearer {}
 
 /**
  * @public
- * <p>Adds a permission to a queue for a specific <a href="https://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P">principal</a>. This allows sharing
- *             access to the queue.</p>
- *          <p>When you create a queue, you have full control access rights for the queue. Only you,
- *             the owner of the queue, can grant or deny permissions to the queue. For more information
- *             about these permissions, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue">Allow Developers to Write Messages to a Shared Queue</a> in the <i>Amazon SQS
- *                 Developer Guide</i>.</p>
+ * <p>Adds a permission to a queue for a specific
+ *       <a href="https://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P">principal</a>.
+ *       This allows sharing access to the queue.</p>
+ *          <p>When you create a queue, you have full control access rights for the queue.
+ *       Only you, the owner of the queue, can grant or deny permissions to the queue.
+ *       For more information about these permissions, see
+ *       <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue">Allow
+ *           Developers to Write Messages to a Shared Queue</a> in the <i>Amazon SQS Developer Guide</i>.</p>
  *          <note>
  *             <ul>
  *                <li>
  *                   <p>
  *                      <code>AddPermission</code> generates a policy for you. You can use
- *                                 <code>
+ *                      <code>
  *                         <a>SetQueueAttributes</a>
- *                      </code> to upload your
- *                         policy. For more information, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-creating-custom-policies.html">Using Custom Policies with the Amazon SQS Access Policy Language</a> in
- *                         the <i>Amazon SQS Developer Guide</i>.</p>
+ *                      </code> to
+ *                         upload your policy. For more information, see
+ *                             <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-creating-custom-policies.html">Using Custom Policies with the Amazon SQS Access Policy Language</a> in
+ *                      the <i>Amazon SQS Developer Guide</i>.</p>
  *                </li>
  *                <li>
- *                   <p>An Amazon SQS policy can have a maximum of seven actions per statement.</p>
+ *                   <p>An Amazon SQS policy can have a maximum of 7 actions.</p>
  *                </li>
  *                <li>
  *                   <p>To remove the ability to change queue permissions, you must deny permission to the <code>AddPermission</code>, <code>RemovePermission</code>, and <code>SetQueueAttributes</code> actions in your IAM policy.</p>
  *                </li>
- *                <li>
- *                   <p>Amazon SQS <code>AddPermission</code> does not support adding a non-account
- *                         principal.</p>
- *                </li>
  *             </ul>
  *          </note>
+ *          <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p>
+ *          <p>
+ *             <code>&AttributeName.1=first</code>
+ *          </p>
+ *          <p>
+ *             <code>&AttributeName.2=second</code>
+ *          </p>
  *          <note>
  *             <p>Cross-account permissions don't apply to this action. For more information,
  * see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name">Grant
- * cross-account permissions to a role and a username</a> in the <i>Amazon SQS Developer Guide</i>.</p>
+ * cross-account permissions to a role and a user name</a> in the <i>Amazon SQS Developer Guide</i>.</p>
  *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -94,43 +100,12 @@ export interface AddPermissionCommandOutput extends __MetadataBearer {}
  * @see {@link AddPermissionCommandOutput} for command's `response` shape.
  * @see {@link SQSClientResolvedConfig | config} for SQSClient's `config` shape.
  *
- * @throws {@link InvalidAddress} (client fault)
- *  <p>The <code>accountId</code> is invalid.</p>
- *
- * @throws {@link InvalidSecurity} (client fault)
- *  <p>When the request to a queue is not HTTPS and SigV4.</p>
- *
  * @throws {@link OverLimit} (client fault)
  *  <p>The specified action violates a limit. For example, <code>ReceiveMessage</code>
- *             returns this error if the maximum number of in flight messages is reached and
+ *             returns this error if the maximum number of inflight messages is reached and
  *                 <code>AddPermission</code> returns this error if the maximum number of permissions
  *             for the queue is reached.</p>
  *
- * @throws {@link QueueDoesNotExist} (client fault)
- *  <p>The specified queue doesn't exist.</p>
- *
- * @throws {@link RequestThrottled} (client fault)
- *  <p>The request was denied due to request throttling.</p>
- *          <ul>
- *             <li>
- *                <p>The rate of requests per second exceeds the AWS KMS request quota for an
- *                     account and Region. </p>
- *             </li>
- *             <li>
- *                <p>A burst or sustained high rate of requests to change the state of the same KMS
- *                     key. This condition is often known as a "hot key."</p>
- *             </li>
- *             <li>
- *                <p>Requests for operations on KMS keys in a Amazon Web Services CloudHSM key store
- *                     might be throttled at a lower-than-expected rate when the Amazon Web Services
- *                     CloudHSM cluster associated with the Amazon Web Services CloudHSM key store is
- *                     processing numerous commands, including those unrelated to the Amazon Web Services CloudHSM key store.</p>
- *             </li>
- *          </ul>
- *
- * @throws {@link UnsupportedOperation} (client fault)
- *  <p>Error code 400. Unsupported operation.</p>
- *
  * @throws {@link SQSServiceException}
  * <p>Base exception class for all service exceptions from SQS service.</p>
  *

diff --git a/clients/client-sqs/src/commands/ChangeMessageVisibilityBatchCommand.ts b/clients/client-sqs/src/commands/ChangeMessageVisibilityBatchCommand.ts
@@ -14,10 +14,7 @@ import {
 } from "@aws-sdk/types";
 
 import { ChangeMessageVisibilityBatchRequest, ChangeMessageVisibilityBatchResult } from "../models/models_0";
-import {
-  de_ChangeMessageVisibilityBatchCommand,
-  se_ChangeMessageVisibilityBatchCommand,
-} from "../protocols/Aws_json1_0";
+import { de_ChangeMessageVisibilityBatchCommand, se_ChangeMessageVisibilityBatchCommand } from "../protocols/Aws_query";
 import { ServiceInputTypes, ServiceOutputTypes, SQSClientResolvedConfig } from "../SQSClient";
 
 /**
@@ -37,17 +34,21 @@ export interface ChangeMessageVisibilityBatchCommandOutput
 
 /**
  * @public
- * <p>Changes the visibility timeout of multiple messages. This is a batch version of
- *                     <code>
- *                <a>ChangeMessageVisibility</a>.</code> The result of the action
- *             on each message is reported individually in the response. You can send up to 10
- *                     <code>
+ * <p>Changes the visibility timeout of multiple messages. This is a batch version of <code>
+ *                <a>ChangeMessageVisibility</a>.</code> The result of the action on each message is reported individually in the response.
+ *           You can send up to 10 <code>
  *                <a>ChangeMessageVisibility</a>
- *             </code> requests with each
- *                 <code>ChangeMessageVisibilityBatch</code> action.</p>
+ *             </code> requests with each <code>ChangeMessageVisibilityBatch</code> action.</p>
  *          <important>
  *             <p>Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p>
  *          </important>
+ *          <p>Some actions take lists of parameters. These lists are specified using the <code>param.n</code> notation. Values of <code>n</code> are integers starting from 1. For example, a parameter list with two elements looks like this:</p>
+ *          <p>
+ *             <code>&AttributeName.1=first</code>
+ *          </p>
+ *          <p>
+ *             <code>&AttributeName.2=second</code>
+ *          </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -97,37 +98,11 @@ export interface ChangeMessageVisibilityBatchCommandOutput
  *  <p>The batch request doesn't contain any entries.</p>
  *
  * @throws {@link InvalidBatchEntryId} (client fault)
- *  <p>The <code>Id</code> of a batch entry in a batch request doesn't abide by the
- *             specification.</p>
- *
- * @throws {@link QueueDoesNotExist} (client fault)
- *  <p>The specified queue doesn't exist.</p>
- *
- * @throws {@link RequestThrottled} (client fault)
- *  <p>The request was denied due to request throttling.</p>
- *          <ul>
- *             <li>
- *                <p>The rate of requests per second exceeds the AWS KMS request quota for an
- *                     account and Region. </p>
- *             </li>
- *             <li>
- *                <p>A burst or sustained high rate of requests to change the state of the same KMS
- *                     key. This condition is often known as a "hot key."</p>
- *             </li>
- *             <li>
- *                <p>Requests for operations on KMS keys in a Amazon Web Services CloudHSM key store
- *                     might be throttled at a lower-than-expected rate when the Amazon Web Services
- *                     CloudHSM cluster associated with the Amazon Web Services CloudHSM key store is
- *                     processing numerous commands, including those unrelated to the Amazon Web Services CloudHSM key store.</p>
- *             </li>
- *          </ul>
+ *  <p>The <code>Id</code> of a batch entry in a batch request doesn't abide by the specification.</p>
  *
  * @throws {@link TooManyEntriesInBatchRequest} (client fault)
  *  <p>The batch request contains more entries than permissible.</p>
  *
- * @throws {@link UnsupportedOperation} (client fault)
- *  <p>Error code 400. Unsupported operation.</p>
- *
  * @throws {@link SQSServiceException}
  * <p>Base exception class for all service exceptions from SQS service.</p>
  *