消費されたメッセージを削除します。
名前 | 値 |
API | DeleteMessage |
アクション | mns:DeleteMessage |
リソース | acs:mns:$region:$accountid:/queues/$queueName/messages |
説明
この操作を呼び出して、消費されたメッセージを削除できます。メッセージを識別するには、受信ハンドルを使用する必要があります。受信ハンドルは、メッセージが最後に消費された後に返されました。 NextVisibleTime パラメーターで指定された時間より前にのみ、メッセージを削除できます。指定された時間が経過すると、メッセージはアクティブ状態になり、受信ハンドルは期限切れになります。メッセージを削除するには、メッセージが再度消費された後に新しい受信ハンドルを取得する必要があります。
リクエスト
各リクエストは、次の部分で構成されます。
リクエスト行
DELETE /queues/$queueName/messages? ReceiptHandle=<receiptHandle> HTTP/1.1操作固有の URI パラメーター
パラメーター
説明
必須
ReceiptHandle
メッセージが最後に消費されたときに返された受信ハンドル。 詳細については、ReceiveMessage をご参照ください。
はい
操作固有のリクエストヘッダー
なし。
リクエスト本文
なし。
レスポンス
各レスポンスは、次の部分で構成されます。
HTTP ステータスコード
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 |
InvalidArgument | 要素の値は、Low ~ High 秒/バイトの範囲内にする必要があります。 | 400 |
ReceiptHandleError | 指定した受信ハンドルは無効です。 | 400 |