메시지 삭제
이 작업은 잠긴 메시지에 대한 처리를 완료하고 잠긴 메시지를 큐 또는 구독에서 삭제합니다. 최소 1회 배달 보증을 유지하기 위해, 이전에 잠긴 메시지를 처리한 후에만 이 작업을 호출해야 합니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| DELETE | 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는 미리 본 메시지의 Location 헤더에서 제공되거나 다음 표에서 설명하는 부분에서 구성할 수 있습니다.
| 매개 변수 | Description |
|---|---|
messageId |
Peek 메시지 작업에서 BrokerProperties{MessageId} 반환된 대로 삭제할 메시지의 ID입니다. |
sequence-number |
Peek 메시지 작업에서 BrokerProperties{SequenceNumber} 반환된 대로 삭제할 메시지의 시퀀스 번호입니다. |
lockToken |
의 Peek 메시지 작업에서 BrokerProperties{LockToken}반환된 대로 삭제할 메시지 잠금의 토큰입니다. |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다. 나열된 속성 외에도, 헤더에는 사용자 지정 속성이 포함될 수 있습니다. 예제를 참조 하세요.
| 요청 헤더 | Description |
|---|---|
| 권한 부여 | 다음 토큰 값 중 하나를 지정합니다.
|
요청 본문
없음
응답
응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.
응답 코드
| 코드 | Description |
|---|---|
| 200 | 메시지를 삭제했습니다. |
| 401 | 인증 실패 |
| 404 | 지정된 MessageId 또는 LockToken와 함께 메시지를 찾을 수 없습니다. |
| 410 | 지정된 큐 또는 구독이 없습니다. |
| 500 | 내부 오류입니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
| 응답 헤더 | Description |
|---|---|
| 콘텐츠 형식 | application/atom+xml;type=entry;charset=utf-8로 설정합니다. |
응답 본문
없음
예제
다음 HTTP 요청은 큐에서 메시지를 삭제합니다.
DELETE 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