Amazon Simple Queue Service
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

响应

在响应操作请求时,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>