메시지 수신 및 삭제(파괴적 읽기)
이 작업은 하나의 원자성 작업으로 큐 또는 구독의 메시지를 수신하고 해당 큐 또는 구독에서 메시지를 제거합니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| DELETE | 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 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
응답 코드
| 코드 | Description |
|---|---|
| 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는 다음 응답을 반환합니다. 이 메시지에는 사용자 지정 속성 “Priority” 및 “Customer”가 포함됩니다.
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