Prev

Next

DeleteMessage

Description

The DeleteMessage action unconditionally removes the specified message from the specified queue. Even if the message is locked by another reader due to the visibility timeout setting, it is still deleted from the queue.

Request Parameters

The following table lists the special request parameters the action uses (in addition to the common request parameters listed in Common Request Parameters).

Name Description Required

MessageId

The ID of the message to delete. The value must be a message ID value returned by a SendMessage request.

Type: String

Yes

Response Elements

The response contains no special elements besides the common elements listed in The Structure of a Response.

Special Errors

The request doesn't fail unless the MessageId is malformed. Even if the specified MessageID doesn't exist, the action returns Success.

Examples

The following example Query request deletes a message from the specified queue.

Sample Request

http://queue.amazonaws.com/A29E9VSPHGOG23/queue1
?Action=DeleteMessage
&AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE
&Version=2007-05-01
&MessageId=17VXQHSGX0SG4ZEPPK7R%7C0QE42ST4KW7RK9HSY074%7C0Z4AN912X0H2EP8BV6XJ
&Expires=2007-05-12T12:00:00Z
&Signature=CN2SbNq%2B2Vw1W3lbc7wpM5gzDHEXAMPLE=

Sample Response

<DeleteMessageResponse>
    <ResponseStatus>
      <StatusCode>Success</StatusCode>
      <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
    </ResponseStatus>
</DeleteMessageResponse>

Related Actions

	Copyright Information