本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 解譯 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>
```