다음을 통해 공유


메시지 잠금 해제

지정된 구독에서 다른 수신자가 처리하기 위한 메시지의 잠금을 해제합니다. 이 작업은 잠금 개체를 삭제하여 메시지의 잠금을 해제합니다. 작업이 호출되기 전에 수신기는 먼저 메시지를 잠가야 합니다.

요청

메서드 요청 URI HTTP 버전
놓다 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} 작업에서 반환된 대로 잠금 해제할 메시지 잠금의 토큰입니다.

요청 헤더

다음 표에서는 필수 및 선택적 요청 헤더에 대해 설명합니다.

요청 헤더 묘사
권한 부여 다음 값 중 하나를 지정합니다.
  • Microsoft Entra JSON JWT(웹 토큰) 토큰입니다.
    예: Authorization: Bearer <Azure AD JWT token>.
    Microsoft Entra 토큰 생성에 대한 자세한 내용은 애플리케이션 인증을 참조하세요.
  • SAS 토큰입니다.
    예: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    SAS 토큰 생성에 대한 자세한 내용은 공유 액세스 서명 토큰 생성 및 SAS 토큰 생성참조하세요.

요청 본문

없음.

응답

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

응답 코드

코드 묘사
200 메시지가 성공적으로 잠금 해제되었습니다.
401 권한 부여 실패.
404 지정된 MessageId 또는 LockToken있는 메시지를 찾을 수 없습니다.
410 지정된 큐 또는 구독이 없습니다.
500 내부 오류입니다.

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

응답 헤더

응답 헤더 묘사
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  

참고 항목