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 la respuesta depende de la acción de la API que haya utilizado.

Para obtener más información sobre estas respuestas, consulte:

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