Amazon Simple Queue Service
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

响应

在响应操作请求时,Amazon SQS 会返回包含请求结果的 XML 数据结构。此数据符合 Amazon SQS 架构。有关更多信息,请参阅 Amazon SQS API 参考 中的 API 版本。

成功响应的结构

如果请求成功了,则主要响应元素会以该操作命名,但会附加上“Response”。例如,CreateQueueResponse 是针对成功的 CreateQueue 请求返回的响应元素。此元素包含以下子元素:

  • ResponseMetadata,它包含 RequestId 子元素

  • 包含特定于操作的结果的可选元素;例如,CreateQueueResponse 元素包含名为 CreateQueueResult 的元素

XML 架构描述了针对每个 SQS 操作的 Amazon SQS 响应消息。

以下是成功响应的示例。

Copy
<CreateQueueResponse xmlns=http://sqs.us-east-2.amazonaws.com/doc/2012-11-05/ xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:type=CreateQueueResponse> <CreateQueueResult> <QueueUrl> http://sqs.us-east-2.amazonaws.com/770098461991/queue2 </QueueUrl> </CreateQueueResult> <ResponseMetadata> <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId> </ResponseMetadata> </CreateQueueResponse>

错误响应的结构

如果请求不成功,则无论调用的操作如何,主要响应元素都名为 ErrorResponse。此元素包含一个 Error 元素和一个 RequestId 元素。每个 Error 都包含:

  • 一个 Type 元素,用于识别错误是创建者错误还是使用者错误

  • 一个 Code 元素,该元素标识所发生错误的类型

  • 一个 Message 元素,该元素以人类可读的格式来描述错误条件

  • 一个 Detail 元素,该元素可能会提供有关错误的其他详细信息或者可能为空

以下是错误响应的示例。

Copy
<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>