解释 Amazon SQS XML API 响应 - Amazon Simple Queue Service
成功的 XML 响应结构XML 错误响应结构
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

解释 Amazon SQS XML API 响应

当您向 Amazon SQS 发送请求时，它会返回包含请求结果的 XML 响应。要了解这些响应的结构和细节，请参阅《亚马逊简单队列服务 API 参考》中的特定 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>