Interpretazione delle risposte dell'API XML di Amazon SQS

In risposta a una richiesta di azione, Amazon SQS restituisce una struttura di dati XML che contiene i risultati della richiesta. Per ulteriori informazioni, consulta le operazioni singole nella Documentazione di riferimento delle API di Amazon Simple Queue Service.

Struttura di una risposta XML corretta

Se la richiesta è andata a buon fine, l'elemento principale della risposta prende il nome dell'azione, con la dicitura Response aggiunta (ad esempio, ActionNameResponse).

Questo elemento contiene i seguenti elementi figli:

• ActionNameResult: contiene un elemento specifico dell'operazione. Ad esempio, l'elemento CreateQueueResult contiene l'elemento QueueUrl che, a sua volta, contiene l'URL della coda creata.

• ResponseMetadata: contiene RequestId che, a sua volta, contiene l'UUID della richiesta.

Di seguito è riportato un esempio di risposta corretta in 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>

Struttura di una risposta di errore XML

Se una richiesta ha esito negativo, Amazon SQS restituisce sempre il principale elemento di risposta ErrorResponse. Questo elemento contiene un elemento Error e un elemento RequestId.

L'elemento Error contiene i seguenti elementi figli:

• Type: specifica se l'errore è stato un errore di produttore o consumatore.

• Code: specifica il tipo di errore.

• Message: specifica la condizione dell'errore in un formato leggibile.

• Detail: (Facoltativo) Specifica ulteriori dettagli sull'errore.

L'elemento RequestId contiene l'UUID della richiesta.

Di seguito è riportato un esempio di risposta di errore in 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>