내보내기(0) 인쇄
모두 확장

큐에서 메시지 보기-잠금(비삭제 읽기)

업데이트 날짜: 2014년 2월

처리 시 큐에서 메시지를 자동으로 검색하고 잠급니다. 메시지는 큐 설명에 지정된 잠금 기간에는 다른 수신기로 배달되지 않습니다(동일 구독의 경우에 한함). 잠금이 만료되면 다른 수신기에서 메시지를 사용할 수 있습니다. 메시지 처리를 완료하려면 수신기가 이 작업에서 받은 잠금 ID를 사용하여 삭제 명령을 실행해야 합니다. 메시지 처리를 중단하고 다른 수신기에서 사용할 수 있도록 메시지 잠금을 해제하려면 메시지 잠금 해제 명령을 실행해야 하며, 그렇지 않으면 잠금 기간이 만료될 수 있습니다.

이 작업은 적어도 한 번 배달 보증이 필요한 응용 프로그램에서 사용해야 합니다. 메시지가 정상적으로 처리되기 전에 수신기가 메시지를 삭제하지 않는다고 가정할 때 이 작업을 수행하면 잠금 기간이 만료된 후 다른 수신기가 메시지 처리를 시도할 수 있습니다.

 

메서드 요청 URI HTTP 버전

POST

https://{serviceNamespace}.servicebus.Windows.net/{queue path}/messages/head?timeout={seconds}

HTTP/1.1

아래 표에는 필수 및 선택적 요청 헤더에 대한 설명이 나와 있습니다.

 

요청 헤더 설명

권한 부여

ACS에서 가져온 SimpleWebToken이 포함된 WRAPv0.9.7.2 토큰을 지정합니다. WRAP access_token=”{swt}”로 설정합니다.

없음.

응답에는 HTTP 상태 코드와 응답 헤더 집합이 포함됩니다.

 

코드 설명

201

메시지가 처리를 위해 올바르게 잠겼으며 잠금이 만들어졌습니다.

204

지정된 시간 제한 기간 내에 메시지를 사용할 수 없습니다.

400

시간 제한이 잘못되었습니다.

401

권한 부여에 실패했습니다.

404

구독이 없었습니다.

410

지정된 구독이 없습니다.

500

내부 오류입니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하십시오.

이 작업에 대한 응답에는 다음 헤더가 포함됩니다. 이 응답에는 추가 표준 HTTP 헤더도 포함될 수 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

위치

잠긴 메시지의 URI입니다. 이 URI는 메시지를 삭제하거나 잠금을 해제하는 데 필요합니다.

BrokerProperties{LockToken}

잠긴 메시지의 잠금 ID입니다.

BrokerProperties{SequenceNumber}

잠긴 메시지의 시퀀스 번호입니다.

검색된 메시지의 본문입니다.

표시:
© 2014 Microsoft