本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 解释 Amazon SQS XML API 响应
<a name="sqs-xml-api-responses"></a>

当您向 Amazon SQS 发送请求时，它会返回包含请求结果的 XML 响应。要了解这些响应的结构和详情，请参阅《Amazon Simple Queue Service API 参考》**中的特定 [API 操作](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html)。

## 成功的 XML 响应结构
<a name="sqs-api-successful-response-structure"></a>

如果请求成功，则主要响应元素将以操作命名并附加上 `Response`（例如，`ActionNameResponse`)。

此元素包含以下子元素：
+ **`ActionNameResult`** – 包含一个特定于操作的元素。例如，`CreateQueueResult` 元素包含 `QueueUrl` 元素，后者又包含所创建队列的 URL。
+ **`ResponseMetadata`** – 包含 `RequestId`，后者又包含请求的通用唯一标识符 (UUID)。

以下是 XML 格式的成功响应的示例：

```
<CreateQueueResponse
   xmlns=https://sqs.us-east-2.amazonaws.com/doc/2012-11-05/
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
   xsi:type=CreateQueueResponse>
   <CreateQueueResult>
      <QueueUrl>https://sqs.us-east-2.amazonaws.com/770098461991/queue2</QueueUrl>
   </CreateQueueResult>
   <ResponseMetadata>
      <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
   </ResponseMetadata>
</CreateQueueResponse>
```

## XML 错误响应结构
<a name="sqs-api-error-response-structure"></a>

如果请求不成功，则 Amazon SQS 将始终返回主要响应元素 `ErrorResponse`。此元素包含一个 `Error` 元素和一个 `RequestId` 元素。

`Error` 元素包含以下子元素：
+ **`Type`** – 指定错误是创建者错误还是使用者错误。
+ **`Code`** – 指定错误类型。
+ **`Message`** – 以可读格式指定错误情况。
+ **`Detail`** –（可选）指定有关错误的其他详细信息。

`RequestId` 元素包含请求的 UUID。

下面是 XML 格式的错误响应的示例：

```
<ErrorResponse>
   <Error>
      <Type>Sender</Type>
      <Code>InvalidParameterValue</Code>
      <Message>
         Value (quename_nonalpha) for parameter QueueName is invalid.
         Must be an alphanumeric String of 1 to 80 in length.
      </Message>
   </Error>
   <RequestId>42d59b56-7407-4c4a-be0f-4c88daeea257</RequestId>
</ErrorResponse>
```