SQSJSONAPIAntworten von Amazon interpretieren

Als Antwort auf eine Aktionsanfrage SQS gibt Amazon eine JSON Datenstruktur zurück, die die Ergebnisse der Anfrage enthält. Weitere Informationen finden Sie in den einzelnen Aktionen in der Amazon Simple Queue Service API Reference undSQS AWS JSONAmazon-Protokoll FAQs.

Erfolgreiche JSON Antwortstruktur

Wenn die Anfrage erfolgreich ist, ist das Hauptantwortelementx-amzn-RequestId, das den Universal Unique Identifier (UUID) der Anfrage sowie weitere angehängte Antwortfelder enthält. Die folgende CreateQueue Antwort enthält beispielsweise das QueueUrl Feld, das wiederum das Feld URL der erstellten Warteschlange enthält.

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"
}

JSONStruktur der Fehlerantwort

Wenn eine Anfrage nicht erfolgreich ist, SQS gibt Amazon die Hauptantwort zurück, einschließlich der HTTP Kopfzeile und des Hauptteils.

x-amzn-RequestIdEnthält in der HTTP Kopfzeile die UUID der Anfrage. x-amzn-query-errorenthält zwei Informationen: die Art des Fehlers und die Angabe, ob es sich bei dem Fehler um einen Hersteller- oder einen Verbraucherfehler handelt.

"__type" gibt im Antworttext weitere Fehlerdetails an und Message zeigt die Fehlerbedingung in lesbarem Format an.

Im Folgenden finden Sie ein Beispiel für eine Fehlerantwort im JSON Format:

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."
}