Interpretación de las respuestas de la API JSON de Amazon SQS

Cuando envía una solicitud a Amazon SQS, devuelve una respuesta JSON con los resultados. La estructura de respuesta depende de la acción de API que haya utilizado.

Para entender los detalles de estas respuestas, consulta:

• La acción de API específica en las acciones de API de la referencia de la API de Amazon Simple Queue Service

• la Protocolo Amazon SQS JSON AWS FAQs,

Estructura de una respuesta JSON correcta

Si la solicitud se realiza correctamente, el elemento de respuesta principal es x-amzn-RequestId, que contiene el identificador único universal (UUID) de la solicitud, así como otros campos de respuesta añadidos. Por ejemplo, la siguiente respuesta de CreateQueue contiene el campo QueueUrl que, a su vez, contiene la URL de la cola creada.

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

Estructura de una respuesta de error JSON

Si una solicitud no se realiza correctamente, Amazon SQS devuelve la respuesta principal, incluidos el encabezado HTTP y el cuerpo.

En el encabezado HTTP, x-amzn-RequestId contiene el UUID de la solicitud. x-amzn-query-error contiene dos informaciones: el tipo de error y si se trata de un error del productor o del consumidor.

En el cuerpo de la respuesta, "__type" indica otros detalles del error y Message señala la condición del error en un formato legible.

El siguiente es un ejemplo de respuesta de error en formato 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."
}