Simple Message Queue (formerly MNS):BatchDeleteMessage

Deskripsi

Operasi ini digunakan untuk menghapus beberapa pesan dari antrian, dengan batas maksimal 16 pesan dalam satu permintaan. Handle penerimaan setiap pesan yang ingin dihapus harus disertakan dalam permintaan.

Untuk meningkatkan efisiensi, Anda dapat menggunakan operasi BatchReceiveMessage dan BatchDeleteMessage untuk menerima serta menghapus beberapa pesan sekaligus. Permintaan penghapusan mencakup beberapa subpermintaan, dan jika salah satu subpermintaan gagal, kode status HTTP 204 tidak akan dikembalikan. Dalam hal ini, Anda perlu memeriksa pesan kesalahan dalam setiap respons.

Permintaan

Permintaan terdiri dari bagian-bagian berikut:

• Baris Permintaan

  DELETE /queues/$queueName/messages HTTP/1.1

• Header Permintaan Spesifik Operasi

  Tidak ada.

• Badan Permintaan

  Badan permintaan dalam format XML. Handle penerimaan setiap pesan yang ingin dihapus harus disertakan dalam permintaan.

Respons

Respons terdiri dari bagian-bagian berikut:

• Kode Status HTTP

  HTTP/1.1 204 NoContent

• Header Respons Spesifik Operasi

  Tidak ada.

• Badan Respons

  Tidak ada.

Contoh

Contoh Permintaan

DELETE  /queues/$queueName/messages HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 28 May 2012 22:32:00 GMT
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXA****

<? xml version="1.0" encoding="UTF-8"? >
<ReceiptHandles xmlns="http://mns.aliyuncs.com/doc/v1/">
    <ReceiptHandle>1-ODU4OTkzNDU5My0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
    <ReceiptHandle>1-ODU4OTkzNDU5NC0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
    <ReceiptHandle>1-ODU4OTkzNDU5NS0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
</ReceiptHandles>            

Contoh Respons

• Contoh respons sukses ketika semua pesan berhasil dihapus

      HTTP/1.1 204 No Content
      x-mns-request-id:512B2A634403E52B1956****
      x-mns-version: 2015-06-06                  

• Contoh respons ketika beberapa pesan gagal dihapus

      HTTP/1.1 404
      Connection:close
      Content-Type=text/xml;charset=utf-8
      Content-Length:500
      x-mns-request-id:512B2A634403E52B1956****
      x-mns-version: 2015-06-06
  
      <? xml version="1.0" encoding="UTF-8"? >
      <Errors xmlns="http://mns.aliyuncs.com/doc/v1/">
      <Error>
          <ErrorCode>MessageNotExist</ErrorCode>
          <ErrorMessage>Pesan tidak ada. </ErrorMessage>
          <ReceiptHandle>1-ODU4OTkzNDU5My0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
      </Error>
      <Error>
          <ErrorCode>MessageNotExist</ErrorCode>
          <ErrorMessage>Pesan tidak ada. </ErrorMessage>
          <ReceiptHandle>1-ODU4OTkzNDU5NC0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
      </Error>
      </Errors>                    

Kesalahan Spesial