Message Service:DeleteMessage

Authorization

By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after these RAM users are granted related permissions. The following table describes the authorization information of this operation. For more information, see Permission policies and examples.

Description

You can call this operation to delete a message that has been consumed. You must use the receipt handle to identify the message. The receipt handle was returned after the message was last consumed. You can delete the message only before the time that is specified by the NextVisibleTime parameter. After the specified time, the message changes to the Active state and the receipt handle expires. To delete the message, you must retrieve a new receipt handle after the message is consumed again.

Request

A request consists of the following parts:

• Request line

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

• Operation-specific URI parameters

  Parameter	Type	Required	Example	Description
  ReceiptHandle	String	Yes	MbZj6wDWli+QEauMZc8ZRv37sIW2iJKq3M9Mx/KSbkJ0	The receipt handle that was returned when the message was last consumed. For more information, see ReceiveMessage.

• Operation-specific request headers

  None.

• Request Body

  None.

Response

A response consists of the following parts:

• HTTP Status Code

  HTTP/1.1 204 No Content

• Operation-specific response headers

  None.

• Response Body

  None.

Examples

Sample requests

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

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

Error codes