メッセージのロックを解除する
他の受信者が処理できるように、指定したサブスクリプションのメッセージのロックを解除します。 この操作はロック オブジェクトを削除することにより、メッセージのロックを解除します。 この操作を呼び出す前に、受信者はまずメッセージをロックする必要があります。
Request
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| PUT | 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 はピークされたメッセージの場所ヘッダーで指定するか、または次の表に示すパーツから構築できます。
| パラメーター | Description |
|---|---|
messageId |
ピーク メッセージ操作によって返されるロック解除されるBrokerProperties{MessageId}メッセージの ID。 |
sequence-number |
メッセージのピーク操作によって返されるロック解除されるメッセージのBrokerProperties{SequenceNumber}シーケンス番号。 |
lockToken |
の [メッセージのピーク] 操作によって返される、ロック解除される メッセージ のロックの BrokerProperties{LockToken}トークン。 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
| 承認 | 次のいずれかを指定します。
|
要求本文
なし。
[応答]
応答には HTTP ステータス コード、一連の応答ヘッダー、および応答の本文が含まれます。
応答コード
| コード | 説明 |
|---|---|
| 200 | メッセージは正常にロック解除されました。 |
| 401 | 認証エラー。 |
| 404 | 指定した MessageId または LockTokenのメッセージが見つかりませんでした。 |
| 410 | 指定されたキューまたはサブスクリプションが存在しません。 |
| 500 | 内部エラーです。 |
状態コードの詳細については、「 状態コードとエラー コード」を参照してください。
レスポンス ヘッダー
| 応答ヘッダー | Description |
|---|---|
| Content-Type | application/atom+xml;type=entry;charset=utf-8 を設定します。 |
応答本文
[なし] :
例
次の HTTP 要求は、メッセージのロックを解除します。
PUT 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