解譯 Amazon SQS XML API 回應

做為對於動作請求的回應，Amazon SQS 會傳回內有回應動作請求的結果的 XML 資料結構。如需詳細資訊，請參閱 Amazon 簡單佇列服務 API 參考中的個別動作。

成功的 XML 回應結構

若請求成功，主要回應元素將以請求的動作命名並加上 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 錯誤回應結構

若請求不成功，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>