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

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

解释 Amazon SQS JSON API 响应

在响应操作请求时,Amazon SQS 会返回包含请求结果的 JSON 数据结构。有关更多信息,请参阅 Amazon Simple Queue Service API 参考中的各操作和 Amazon SQS Amazon JSON 协议常见问题

成功的 JSON 响应结构

如果请求成功,则主响应元素为 x-amzn-RequestId,其中包含请求的通用唯一标识符 (UUID) 以及其他附加的响应字段。例如,以下 CreateQueue 响应包含 QueueUrl 字段,后者又包含所创建队列的 URL。

HTTP/1.1 200 OK x-amzn-RequestId: <requestId> Content-Length: <PayloadSizeBytes> Date: <Date> Content-Type: application/x-amz-json-1.0 { "QueueUrl":"https://sqs.us-east-1.amazonaws.com/111122223333/MyQueue" }

JSON 错误响应结构

如果请求失败,则 Amazon SQS 将返回主响应,包括 HTTP 标头和正文。

在 HTTP 标头中,x-amzn-RequestId 包含请求的 UUID。x-amzn-query-error 包含两条信息:错误类型,以及错误是创建者错误还是使用者错误。

在响应正文中,"__type" 表示其他错误详细信息,Message 以可读的格式指明错误情况。

以下是 JSON 格式的错误响应示例:

HTTP/1.1 400 Bad Request x-amzn-RequestId: 66916324-67ca-54bb-a410-3f567a7a0571 x-amzn-query-error: AWS.SimpleQueueService.NonExistentQueue;Sender Content-Length: <PayloadSizeBytes> Date: <Date> Content-Type: application/x-amz-json-1.0 { "__type": "com.amazonaws.sqs#QueueDoesNotExist", "message": "The specified queue does not exist." }