Menafsirkan tanggapan Amazon SQS XMLAPI

Menanggapi permintaan tindakan, Amazon SQS mengembalikan struktur data XMLyang berisi hasil permintaan. Untuk informasi selengkapnya, lihat tindakan individual di Referensi API Layanan Antrian Sederhana Amazon.

Struktur respons XHTML yang sukses

Jika permintaan berhasil, elemen respons utama dinamai setelah tindakan, dengan Response ditambahkan (misalnya,ActionNameResponse).

Elemen ini berisi elemen turunan berikut:

• ActionNameResult— Berisi elemen khusus tindakan. Misalnya, CreateQueueResult elemen berisi QueueUrl elemen yang, pada gilirannya, berisi URL antrian yang dibuat.

• ResponseMetadata— Berisi RequestId yang, pada gilirannya, berisi Universal Unique Identifier (UUID) dari permintaan.

Berikut ini adalah contoh respon sukses dalam format 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>

Struktur respon kesalahan XML

Jika permintaan tidak berhasil, Amazon SQS selalu mengembalikan elemen respons utama. ErrorResponse Elemen ini berisi elemen Error dan elemen RequestId.

ErrorElemen berisi elemen anak berikut:

• Type- Menentukan apakah kesalahan adalah produsen atau kesalahan konsumen.

• Code- Menentukan jenis kesalahan.

• Message- Menentukan kondisi kesalahan dalam format yang dapat dibaca.

• Detail- (Opsional) Menentukan rincian tambahan tentang kesalahan.

RequestIdElemen berisi UUID permintaan.

Berikut ini adalah contoh respon kesalahan dalam format 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>