Delete Message
目次を折りたたむ
目次を展開する
この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

Delete Message

 

Delete Message 操作は、指定されたメッセージを削除します。

Delete Message 要求は次のように作成されます。 HTTPS が推奨されます。 置き換える myaccount 、ストレージ アカウントの名前を持つ myqueue 、キューの名前を持つと string-value で削除するメッセージに対して取得された popreceipt の値。

メソッド

要求 URI

HTTP バージョン

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

エミュー レートされたストレージ サービスに対する要求を行うときに、エミュレーターのホスト名ととしてのキュー サービスのポートを指定 127.0.0.1:10001, 、その後にエミュー レートされたストレージ アカウントの名前。

メソッド

要求 URI

HTTP バージョン

DELETE

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

要求の URI では、次のパラメーターがサポートされています。

Parameter

description

popreceipt

必須。

有効な popreceipt 値は、事前に呼び出したから返される、 Get Messages または Update Message 操作します。

timeout

省略可能です。 timeout パラメーターは、秒単位で表されます。 詳細については、次を参照してください。 キュー サービス操作のタイムアウトの設定です。

次の表は、必須の要求ヘッダーおよび省略可能な要求ヘッダーを示します。

要求ヘッダー

description

Authorization

必須。

認証スキーム、アカウント名、および署名を指定します。 詳細については、次を参照してください。 Azure ストレージ サービスの認証です。

Date または x-ms-date

必須。

要求の世界協定時刻 (UTC) を指定します。 詳細については、次を参照してください。 Azure ストレージ サービスの認証です。

x-ms-version

省略可能です。 この要求に使用する操作のバージョンを指定します。 詳細については、次を参照してください。 Windows Azure の BLOB サービス、キュー サービス、およびテーブル サービスのバージョン管理です。

x-ms-client-request-id

省略可能です。 ストレージ解析ロギングが有効なときに解析ログに記録される、クライアントで生成された非透過の値を 1 KB の文字制限付きで提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるために、このヘッダーを使用することを強くお勧めします。 詳細については、次を参照してください Storage Analytics Logging についてAzure ロギング:ログ ストレージ要求の追跡を使用したです。

ありません。

応答には、HTTP ステータス コードと一連の応答ヘッダーが含まれます。

操作が正常に終了すると、ステータス コード 204 (No Content) が返されます。

状態コードについては、次を参照してください。 ステータス コードとエラー コードです。

この操作の応答には、次のヘッダーが含まれています。 応答には追加の標準 HTTP ヘッダーも含まれます。 すべての標準ヘッダーに準拠している、 http/1.1 プロトコル仕様です。

要求ヘッダー

description

x-ms-request-id

このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。 詳細については、次を参照してください。 API 操作のトラブルシューティングです。

x-ms-version

要求の実行に使用するキュー サービスのバージョンを示します。 このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。

Date

サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。

ありません。

この操作を実行できるのは、アカウント所有者と、この操作を実行するアクセス許可を持つ共有アクセス署名を使用する任意のユーザーです。

正常に削除されたメッセージは、その時点で削除対象としてマークされ、クライアントからアクセスできなくなります。 このメッセージは、後でガベージ コレクション中にキューから削除されます。

クライアントはメッセージを取得した後、 Get Messages 操作では、クライアントに処理し、メッセージの削除は必要です。 メッセージを削除するにはの応答本文で返されるデータの 2 つの項目を設定する必要がありますが、 Get Messages 操作。

  • メッセージ ID。キュー内のメッセージを識別する非透過の GUID 値です。

  • 有効な POPReceipt。メッセージが取得されたことを示す非透過の値です。

ID は、前の返されたメッセージ Get Messages 操作します。 Popreceipt は、最も新しいから返される Get Messages または Update Message 操作します。 ために、 Delete Message 操作が成功すると、する、要求に指定した popreceipt がから返された popreceipt と一致する必要があります、 Get Messages または Update Message 操作します。

PopReceipt は、次のいずれかのイベントが発生するまで有効な状態に維持されます。

  1. メッセージの有効期限が切れた。

  2. 最後を使用して、メッセージが削除された popreceipt から受信した Get Messages または Update Messageです。

  3. 非表示タイムアウトが経過して、により、メッセージがデキューされた、 Get Messages 要求します。 非表示タイムアウトが経過し、再びメッセージを参照できるようになった。 別の作業で取得した場合 Get Messages 要求では、削除またはメッセージを更新するのには、返された popreceipt を使用できます。

  4. 新しい表示タイムアウトでメッセージが更新された。 メッセージが更新されると、新しい PopReceipt が返されます。

PoPReceipt が一致するメッセージが見つからない場合は、ステータス コード 404 (Not Found) が返されます。 このエラーは、PopReceipt が有効でなくなった上記の状況で発生します。

表示:
© 2016 Microsoft