메시지 잠금 해제
지정된 구독에서 다른 수신기가 처리할 수 있도록 메시지의 잠금을 해제합니다. 이 작업은 잠금 개체를 삭제하여 메시지의 잠금이 해제되도록 합니다. 이 작업을 호출하기 전에 먼저 수신기가 메시지를 잠가야 합니다.
요청
메서드 | 요청 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는 미리 본 메시지의 Location 헤더에서 제공되거나 다음 표에서 설명하는 부분에서 구성할 수 있습니다.
매개 변수 | 설명 |
---|---|
messageId |
메시지 피킹 작업에서 BrokerProperties{MessageId} 반환된 대로 잠금 해제할 메시지의 ID입니다. |
sequence-number |
메시지 피킹 작업에서 BrokerProperties{SequenceNumber} 반환된 대로 잠금 해제할 메시지의 시퀀스 번호입니다. |
lockToken |
의 메시지 피킹 작업에서 반환된 대로 잠금 해제할 메시지 잠금의 토큰입니다 BrokerProperties{LockToken} . |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
요청 헤더 | Description |
---|---|
권한 부여 | 다음 중 하나를 지정합니다.
|
요청 본문
없음
응답
응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.
응답 코드
코드 | Description |
---|---|
200 | 메시지의 잠금을 해제했습니다. |
401 | 인증 실패 |
404 | 지정된 MessageId 또는 LockToken 와 함께 메시지를 찾을 수 없습니다. |
410 | 지정된 큐 또는 구독이 존재하지 않습니다. |
500 | 내부 오류입니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
응답 헤더 | 설명 |
---|---|
콘텐츠 형식 | 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