Amazon Simple Queue Service
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

解释响应

在响应操作请求时,Amazon SQS 会返回包含请求结果的 XML 数据结构。有关更多信息,请参阅 Amazon Simple Queue Service API Reference 中的相关部分。

成功的响应结构

如果请求成功,则主要响应元素将以请求的操作命名并附加上 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>

错误响应结构

如果请求不成功,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>