次の方法で共有

メッセージの削除

  • [アーティクル]

この操作は、ロックしたメッセージの処理を完了し、キューまたはサブスクリプションから削除します。 This operation should only be called after successfully processing a previously locked message, in order to maintain At-Least-Once の配信保証を維持するため、前のロックされたメッセージの処理が正常に行われた場合のみ、この操作を呼び出します。

Request

Method 要求 URI HTTP バージョン
DELETE http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

または

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

URI パラメーター

この URI はピークされたメッセージの場所ヘッダーで指定するか、または次の表に示すパーツから構築できます。

パラメーター 説明
messageId プレビュー メッセージ操作によって返されるBrokerProperties{MessageId}削除されるメッセージの ID。
sequence-number プレビュー メッセージ操作によって返されるBrokerProperties{SequenceNumber}削除されるメッセージのシーケンス番号。
lockToken の プレビュー Message 操作によって返される削除されるメッセージのロックのBrokerProperties{LockToken}トークン。

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。 ヘッダーには、記載されているプロパティに加えて、カスタム プロパティが含まれる場合があります。 例を参照してください。

要求ヘッダー 説明
承認 次のいずれかのトークン値を指定します。

要求本文

[なし] :

Response

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

応答コード

コード 説明
200 メッセージは正常に削除されました。
401 認証エラー。
404 指定した MessageId または LockTokenのメッセージが見つかりませんでした。
410 指定されたキューまたはサブスクリプションが存在しません。
500 内部エラーです。

状態コードの詳細については、「 状態コードとエラー コード」を参照してください。

レスポンス ヘッダー

応答ヘッダー 説明
Content-Type application/atom+xml;type=entry;charset=utf-8 を設定します。

応答本文

[なし] :

例

次の HTTP 要求は、キューからメッセージを削除します。

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus は、次の応答を返します。

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

参照

Service Bus HTTP クライアントのサンプル