DeleteMessage API を使用した受信ハンドルを伴う消費済みメッセージの削除 - Simple Message Queue (旧称：MNS)

受信ハンドルを使用して、キューから消費済みのメッセージを削除します。

プロパティ	値
API	DeleteMessage
アクション	mns:DeleteMessage
リソース	acs:mns:$region:$accountid:/queues/$queueName/messages

説明

DeleteMessage は、メッセージが消費された後、キューからメッセージを削除します。メッセージを識別するには、直近の ReceiveMessage 呼び出しによって返された受信ハンドルを指定します。

受信ハンドルは、NextVisibleTime で指定された時刻までのみ有効です。その時刻を過ぎると、メッセージはアクティブ状態に戻り、受信ハンドルは期限切れになります。ハンドルの有効期限が切れた後にメッセージを削除するには、メッセージを再度消費して新しい受信ハンドルを取得する必要があります。

重要

消費操作ごとに異なる受信ハンドルが返されます。常に最新の受信操作で取得した受信ハンドルを使用してください。それ以前のハンドルは、削除には使用できなくなります。

リクエスト

リクエストライン

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

URI パラメーター

パラメーター	型	必須	説明
ReceiptHandle	文字列	はい	メッセージが最後に消費されたときに返される受信ハンドル。詳細については、「ReceiveMessage」をご参照ください。

リクエストヘッダー

操作固有のリクエストヘッダーはありません。

リクエストボディ

なし。

レスポンス

成功レスポンス

HTTP/1.1 204 No Content

レスポンスヘッダー

操作固有のレスポンスヘッダーはありません。

レスポンスボディ

なし。

例

リクエスト例

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****

レスポンス例

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

エラーコード

エラーコード	HTTP ステータスコード	エラーメッセージ	説明
QueueNotExist	404	The queue name you provided does not exist.	指定されたキューは存在しません。リクエスト URI のキュー名を確認してください。
InvalidArgument	400	The value of Element should between Low and High seconds/bytes.	パラメーター値が有効範囲外です。リクエストパラメーターが許容される値の範囲内にあるか確認してください。
ReceiptHandleError	400	The receipt handle you provided is not valid.	受信ハンドルは、`NextVisibleTime` を過ぎたか、古いハンドルが使用されたため、期限切れになっています。メッセージを再度消費して、新しい受信ハンドルを取得してください。