Получение и удаление сообщений (разрушающее чтение)
Эта операция получает сообщение из очереди или подписки и удаляет сообщение из этой очереди или подписки в одной атомарной операции.
Запрос
Метод | Универсальный код ресурса (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