解释响应 - Amazon Simple Queue Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

解释响应

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

成功的响应结构

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