Method for deleting messages from a queue. To select the message to delete, use the
ReceiptHandle of the message. A message can be deleted even if it is received and being processed by another consumer. Message Queue automatically deletes messages if the value specified for the
RetentionPeriod parameter is reached.
ReceiptHandle is associated with a specific instance of receiving a message. If you receive a message more than once, the
ReceiptHandle is different each time you receive a message. To delete a message, provide the most recently received
ReceiptHandle for the message. Otherwise, the request will be successful but the message might not be deleted.
For standard queues, it is possible to receive a message even after you delete it. This might happen on rare occasions if one of the servers which stores a copy of the message is unavailable when you send the request to delete the message. Make sure that your application is idempotent, so that receiving a message more than once does not cause issues.
||string||Yes||URL of the queue where the message is placed.|
Successful response fields
The response does not contain any fields.
For the list of possible responses, see Common errors.
|HTTP code||Error ID||Description|
Action=DeleteMessage &Version=2012-11-05 &QueueUrl=https://message-queue.api.cloud.yandex.net/b1g8ad42m6he1ooql78r/dj600000000000le07ol/sample-queue &ReceiptHandle=EAEggPjXhogtKAA
For more information about forming requests, see General API request format.
<DeleteMessageResponse> <ResponseMetadata> <RequestId>c79cd3cb-ffb474f7-9d5a8a3e-e5db06c-7c4ef5d027dd4219c28bf6c263f88b93</RequestId> </ResponseMetadata> </DeleteMessageResponse>