다음을 통해 공유


메시지 수신 및 삭제(파괴적인 읽기)

이 작업은 큐 또는 구독에서 메시지를 수신하고 하나의 원자성 작업에서 해당 큐 또는 구독에서 메시지를 제거합니다.

요청

메서드 요청 URI HTTP 버전
삭제하다 http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head

또는

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1

요청 헤더

다음 표에서는 필수 및 선택적 요청 헤더에 대해 설명합니다. 나열된 속성 외에도 헤더에 사용자 지정 속성이 포함될 수 있습니다. 예제를 참조하세요.

요청 헤더 묘사
권한 부여 다음 토큰 값 중 하나를 지정합니다.
  • 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 메시지가 성공적으로 검색 및 삭제되었습니다.
204 지정된 제한 시간 내에 사용할 수 있는 메시지가 없습니다.
400 잘못된 요청입니다.
401 권한 부여 실패.
410 지정된 큐 또는 구독이 없습니다.
500 내부 오류입니다.

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

응답 헤더

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

응답 본문

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

본보기

다음 HTTP 요청은 큐에서 메시지를 수신하고 삭제합니다.

DELETE 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는 다음 응답을 반환합니다. 메시지에는 PriorityCustomer사용자 지정 속성이 포함됩니다.

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10}  
Priority: "High"  
Customer: "12345,ABC"  
Date: Tue, 01 Jul 2014 23:00:23 GMT  
  
12  
This is a message.  
0  

참고 항목