すべてのプロダクト
Search
ドキュメントセンター

Simple Message Queue (formerly MNS):DeleteMessage

最終更新日:Jan 13, 2025

消費されたメッセージを削除します。

名前

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