Получение и удаление сообщений (разрушающее чтение)

Эта операция получает сообщение из очереди или подписки и удаляет сообщение из этой очереди или подписки в одной атомарной операции.

Запрос

Метод Универсальный код ресурса (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

Заголовки запросов

В следующей таблице перечислены обязательные и необязательные заголовки запросов. Наряду с указанными свойствами заголовок может содержать настраиваемые свойства. См. пример.

Заголовок запроса Описание
Авторизация Укажите одно из следующих значений токена:

Текст запроса

Нет.

Ответ

Ответ включает код состояния 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  

Служебная шина возвращает следующий ответ. Сообщение содержит настраиваемые свойства "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  

См. также:

Образец HTTP-клиента служебной шины