DeleteMessage - Simple Message Queue (formerly MNS) - Alibaba Cloud Documentation Center

Menghapus pesan yang telah dikonsumsi dari sebuah queue menggunakan receipt handle-nya.

Property	Value
API	DeleteMessage
Action	mns:DeleteMessage
Resource	acs:mns:$region:$accountid:/queues/$queueName/messages

Description

Operasi DeleteMessage menghapus pesan dari sebuah queue setelah pesan tersebut dikonsumsi. Untuk mengidentifikasi pesan tersebut, gunakan receipt handle yang dikembalikan oleh pemanggilan ReceiveMessage terbaru.

Receipt handle hanya berlaku hingga waktu yang ditentukan oleh NextVisibleTime. Setelah waktu tersebut, pesan kembali ke status Active dan receipt handle-nya kedaluwarsa. Untuk menghapus pesan setelah handle kedaluwarsa, konsumsi kembali pesan tersebut guna mendapatkan receipt handle baru.

Penting

Setiap operasi konsumsi menghasilkan receipt handle yang berbeda. Selalu gunakan receipt handle dari operasi receive terbaru karena handle sebelumnya tidak lagi valid untuk penghapusan.

Request

Request line

DELETE /queues/$queueName/messages? ReceiptHandle=<receiptHandle> HTTP/1.1

URI parameters

Parameter	Type	Required	Description
ReceiptHandle	String	Yes	Receipt handle yang dikembalikan saat pesan terakhir dikonsumsi. Untuk informasi lebih lanjut, lihat ReceiveMessage.

Request headers

Tidak ada header permintaan khusus untuk operasi ini.

Request body

Tidak ada.

Response

Success response

HTTP/1.1 204 No Content

Response headers

Tidak ada header respons khusus untuk operasi ini.

Response body

Tidak ada.

Examples

Sample request

DELETE /queues/$queueName/messages? ReceiptHandle=MbZj6wDWli+QEauMZc8ZRv37sIW2iJKq3M9Mx/KSbkJ0 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****

Sample response

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

Error codes

Error code	HTTP status code	Error message	Description
QueueNotExist	404	The queue name you provided does not exist.	Queue yang ditentukan tidak ada. Verifikasi nama queue dalam URI permintaan.
InvalidArgument	400	The value of Element should between Low and High seconds/bytes.	Nilai parameter berada di luar rentang yang valid. Periksa parameter permintaan terhadap rentang nilai yang diizinkan.
ReceiptHandleError	400	The receipt handle you provided is not valid.	Receipt handle telah kedaluwarsa karena `NextVisibleTime` telah lewat, atau handle lama digunakan. Konsumsi kembali pesan tersebut untuk mendapatkan receipt handle baru.