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

Cuando envía una solicitud a Amazon SQS, devuelve una respuesta XML que contiene los resultados de la solicitud. Para comprender la estructura y los detalles de estas respuestas, consulte las acciones específicas de la API en la referencia de la API de Amazon Simple Queue Service.

Estructura de una respuesta XML correcta

Si la solicitud se realiza correctamente, el elemento principal de la respuesta tiene el mismo nombre que la acción, pero se le añade Response (por ejemplo, ActionNameResponse).

Este elemento contiene los siguientes elementos secundarios:

• ActionNameResult: contiene un elemento específico de la acción. Por ejemplo, el elemento CreateQueueResult contiene el elemento QueueUrl que, a su vez, contiene la URL de la cola que se ha creado.

• ResponseMetadata: contiene el RequestId que, a su vez, contiene el identificador único universal (UUID) de la solicitud.

A continuación se muestra un ejemplo de una respuesta correcta en formato XML:

<CreateQueueResponse
   xmlns=https://sqs.us-east-2.amazonaws.com/doc/2012-11-05/
   xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
   xsi:type=CreateQueueResponse>
   <CreateQueueResult>
      <QueueUrl>https://sqs.us-east-2.amazonaws.com/770098461991/queue2</QueueUrl>
   </CreateQueueResult>
   <ResponseMetadata>
      <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
   </ResponseMetadata>
</CreateQueueResponse>

Estructura de una respuesta de error XML

Si una solicitud no se realiza correctamente, Amazon SQS siempre devuelve el elemento principal de la respuesta ErrorResponse. Este elemento contiene un elemento Error y un elemento RequestId.

El elemento Error contiene los siguientes elementos secundarios:

• Type: especifica si se trata de un error del productor o del consumidor.

• Code: especifica el tipo de error.

• Message: especifica la condición de error en formato legible.

• Detail: (opcional) especifica información adicional sobre el error.

El elemento RequestId contiene el UUID de la solicitud.

A continuación se muestra un ejemplo de una respuesta de error en formato XML:

<ErrorResponse>
   <Error>
      <Type>Sender</Type>
      <Code>InvalidParameterValue</Code>
      <Message>
         Value (quename_nonalpha) for parameter QueueName is invalid.
         Must be an alphanumeric String of 1 to 80 in length.
      </Message>
   </Error>
   <RequestId>42d59b56-7407-4c4a-be0f-4c88daeea257</RequestId>
</ErrorResponse>