DeleteMessage
Deletes the specified message from the specified queue. To select the message to
delete, use the ReceiptHandle
of the message (not the
MessageId
which you receive when you send the message). Amazon SQS can
delete a message from a queue even if a visibility timeout setting causes the message to
be locked by another consumer. Amazon SQS automatically deletes messages left in a queue
longer than the retention period configured for the queue.
The 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.
When you use the DeleteMessage
action, you must provide the most
recently received ReceiptHandle
for the message (otherwise, the request
succeeds, but the message will 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. The copy remains on the server and might be returned to you during a subsequent receive request. You should ensure that your application is idempotent, so that receiving a message more than once does not cause issues.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- QueueUrl
-
The URL of the Amazon SQS queue from which messages are deleted.
Queue URLs and names are case-sensitive.
Type: String
Required: Yes
- ReceiptHandle
-
The receipt handle associated with the message to delete.
Type: String
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidIdFormat
-
The specified receipt handle isn't valid for the current version.
HTTP Status Code: 400
- ReceiptHandleIsInvalid
-
The specified receipt handle isn't valid.
HTTP Status Code: 400
Examples
Example
The following example query request deletes a message from the queue named
MyQueue
. The structure of AUTHPARAMS
depends on the signature of the API request.
For more information, see
Examples of Signed Signature Version 4 Requests in the
AWS General Reference.
Sample Request
https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue/
?Action=DeleteMessage
&ReceiptHandle=MbZj6wDWli%2BJvwwJaBV%2B3dcjk2YW2vA3%2BSTFFljT
M8tJJg6HRG6PYSasuWXPJB%2BCwLj1FjgXUv1uSj1gUPAWV66FU/WeR4mq2OKpEGY
WbnLmpRCJVAyeMjeU5ZBdtcQ%2BQEauMZc8ZRv37sIW2iJKq3M9MFx1YvV11A2x/K
SbkJ0=
&Expires=2020-04-18T22%3A52%3A43PST
&Version=2012-11-05
&AUTHPARAMS
Sample Response
<DeleteMessageResponse>
<ResponseMetadata>
<RequestId>b5293cb5-d306-4a17-9048-b263635abe42</RequestId>
</ResponseMetadata>
</DeleteMessageResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: