Interpretieren von Amazon-SQS-XML-API-Antworten - Amazon Simple Queue Service
Struktur einer XML-Antwort bei ErfolgXML-Fehler-Antwortstruktur

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Interpretieren von Amazon-SQS-XML-API-Antworten

Amazon SQS gibt als Antwort auf eine Aktionsanforderung eine XML-Datenstruktur mit den Ergebnissen der Anforderung zurück. Weitere Informationen finden Sie unter den individuellen Aktionen in der Amazon-Simple-Queue-Service-API-Referenz.

Struktur einer XML-Antwort bei Erfolg

Wenn die Anforderung erfolgreich ist, wird das Hauptantwortelement nach der Aktion mit dem Zusatz Response (zum Beispiel ActionNameResponse) benannt.

Dieses Element enthält die folgenden untergeordneten Elemente:

  • ActionNameResult – Enthält ein aktionsspezifisches Element. Das Element CreateQueueResult enthält das Element QueueUrl, das wiederum die URL der erstellten Warteschlange enthält.

  • ResponseMetadata – Enthält die RequestId, die wiederum die UUID (Universal Unique Identifier) der Anforderung enthält.

Nachfolgend finden Sie ein Beispiel für eine Antwort bei Erfolg im XML-Format:

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

XML-Fehler-Antwortstruktur

Wenn eine Anforderung fehlschlägt, gibt Amazon SQS immer das Haupt-Antwort-Element ErrorResponse zurück. Dieses Element enthält ein Error- und ein RequestId-Element.

Das Element Error enthält die folgenden untergeordneten Elemente:

  • Type – Gibt an, ob es sich bei dem Fehler um einen Produzenten- oder einen Konsumentenfehler handelt.

  • Code – Gibt den Typ des Fehlers an.

  • Message – Gibt die Fehlerbedingung in einem lesbaren Format an.

  • Detail – (Optional) Gibt zusätzliche Details zu dem Fehler an.

Das Element RequestId enthält die UUID der Anforderung.

Nachfolgend finden Sie ein Beispiel für eine Antwort bei Fehlschlagen im XML-Format:

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