메시지 보기-잠금(비파괴 읽기)
이 작업은 처리를 위해 큐 또는 구독에서 메시지를 자동으로 검색하고 잠급니다. 큐/구독 설명에 지정된 잠금 기간 동안 메시지가 다른 수신기(같은 큐 또는 구독에만 해당)로 배달되지 않습니다. 잠금이 만료되면 메시지를 다른 수신기에 보낼 수 있게 됩니다. 메시지 처리를 완료하려면 수신기가 이 작업으로부터 받은 잠금 ID를 사용하여 삭제 명령을 실행해야 합니다. 메시지 처리를 포기하고 다른 수신기에 대해 잠금을 해제하려면 메시지 잠금 해제 명령을 실행해야 합니다. 그렇지 않으면 잠금 기간이 만료될 수 있습니다.
이 작업은 최소 1회 배달 보증을 요구하는 응용 프로그램에서 사용해야 합니다. 처리가 성공하기 전에 수신자가 메시지를 삭제하지 않는 경우 이 작업을 수행하면 잠금 기간이 만료된 후 다른 수신기가 처리를 시도할 수 있습니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head또는 http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다. 나열된 속성 외에도, 헤더에는 사용자 지정 속성이 포함될 수 있습니다. 예제를 참조 하세요.
| 요청 헤더 | Description |
|---|---|
| 권한 부여 | 다음 토큰 값 중 하나를 지정합니다.
|
요청 본문
없음
응답
응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.
응답 코드
| 코드 | 설명 |
|---|---|
| 201 | 메시지를 검색하고 잠갔습니다. |
| 204 | 지정된 제한 시간 내에 메시지를 사용할 수 없습니다. |
| 400 | 잘못된 요청입니다. |
| 401 | 인증 실패 |
| 410 | 지정된 큐 또는 구독이 존재하지 않습니다. |
| 500 | 내부 오류입니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.
| 응답 헤더 | 설명 |
|---|---|
Content-Type |
application/atom+xml;type=entry;charset=utf-8로 설정합니다. |
Location |
잠긴 메시지의 URI입니다. 이 URI를 사용하여 메시지를 잠금 해제하거나 삭제할 수 있습니다. |
BrokerProperties |
받은 메시지의 JSON으로 인코딩 BrokerProperties 됩니다. 속성은 LockToken 반환된 메시지의 잠금 ID를 나타냅니다. 속성은 SequenceNumber 반환된 메시지의 시퀀스 번호를 나타냅니다. |
응답 본문
응답 본문은 검색된 메시지의 메시지 본문입니다.
예제
다음 HTTP 요청은 메시지를 잠그고 큐에서 반환합니다.
POST https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey
Host: your-namespace.servicebus.windows.net
Content-Length: 0
Service Bus는 다음 응답을 반환합니다. 메시지에는 사용자 지정 속성 Priority 및 Customer가 포함됩니다.
HTTP/1.1 201 Created
Transfer-Encoding: chunked
Content-Type: application/atom+xml;type=entry;charset=utf-8
Location: https://your-namespace.servicebus.windows.net/httpclientsamplequeue/messages/2/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547
Server: Microsoft-HTTPAPI/2.0
BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Wed, 02 Jul 2014 01:32:27 GMT","Label":"M1","LockToken":"7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547","LockedUntilUtc":"Wed, 02 Jul 2014 01:33:27 GMT","MessageId":"31907572164743c38741631acd554d6f","SequenceNumber":2,"State":"Active","TimeToLive":10}
Priority: "High"
Customer: "12345,ABC"
Date: Wed, 02 Jul 2014 01:32:27 GMT
12
This is a message.
0