メッセージのロックを更新する
既にロックされているメッセージのロックを更新します。
Request
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| POST | 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 |
でメッセージの ピーク 操作 BrokerProperties{LockToken}によって返される、ロックが更新されるメッセージのロックのトークン。 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
| 承認 | 次のいずれかのトークン値を指定します。
|
要求本文
なし。
[応答]
応答には HTTP ステータス コード、一連の応答ヘッダー、および応答の本文が含まれます。
応答コード
| コード | 説明 |
|---|---|
| 200 | メッセージのロックは正常に更新されました。 |
| 401 | 認証エラー。 |
| 404 | 指定した MessageId または LockTokenのメッセージが見つかりませんでした。 |
| 410 | 指定されたキューまたはサブスクリプションが存在しません。 |
| 500 | 内部エラーです。 |
状態コードの詳細については、「 状態コードとエラー コード」を参照してください。
レスポンス ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
| 応答ヘッダー | 説明 |
|---|---|
| Content-Type | application/atom+xml;type=entry;charset=utf-8 を設定します。 |
応答本文
[なし] :
例
次の HTTP 要求は、ロックされたメッセージのロックを更新します。
POST 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