解釋 Amazon SQS JSON API 回應

Amazon SQS 回應動作請求時，會傳回包含請求結果的JSON資料結構。如需詳細資訊，請參閱 Amazon 簡單佇列服務API參考和中的個別動作Amazon SQS AWS JSON 協議 FAQs。

成功的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."
}