Interprétation des SQS JSON API réponses d'Amazon

En réponse à une demande d'action, Amazon SQS renvoie une structure de JSON données contenant les résultats de la demande. Pour plus d'informations, consultez les actions individuelles dans le manuel Amazon Simple Queue Service API Reference etSQS AWS JSONProtocole Amazon FAQs.

Structure de JSON réponse efficace

Si la demande aboutit, l'élément de réponse principal estx-amzn-RequestId, qui contient l'identifiant unique universel (UUID) de la demande, ainsi que d'autres champs de réponse ajoutés. Par exemple, la CreateQueue réponse suivante contient le QueueUrl champ qui, à son tour, contient le nom URL de la file d'attente créée.

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

JSONstructure de réponse aux erreurs

Si une demande échoue, Amazon SQS renvoie la réponse principale, y compris l'HTTPen-tête et le corps du message.

Dans l'HTTPen-tête, x-amzn-RequestId contient le nom UUID de la demande. x-amzn-query-errorcontient deux informations : le type d'erreur et s'il s'agit d'une erreur du producteur ou du consommateur.

Dans le corps de la réponse, "__type" indique les autres détails de l'erreur et Message indique la condition d'erreur dans un format lisible.

Voici un exemple de réponse d'erreur au 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."
}