Удалить сообщение

Статья
02/03/2024

Эта операция завершает обработку заблокированного сообщения и удаляет его из очереди или подписки. Эту операцию следует вызывать только после успешной обработки предыдущего заблокированного сообщения, чтобы обеспечить однократную гарантированную доставку.

Запрос

Метод	Универсальный код ресурса (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 просматриваемого сообщения или же его можно составить из частей, описанных в следующей таблице.

Параметр	Описание
`messageId`	Идентификатор удаляемого сообщения, возвращенного операцией `BrokerProperties{MessageId}`Обзор Message.
`sequence-number`	Порядковый номер удаляемого сообщения, возвращаемого операцией `BrokerProperties{SequenceNumber}`Обзор Message.
`lockToken`	Маркер блокировки удаляемого сообщения, возвращаемый операцией Обзор Message в `BrokerProperties{LockToken}`.

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

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

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

Авторизация

Заголовок запроса	Описание
Авторизация	Укажите одно из следующих значений токена: Microsoft Entra ID маркера JSON Web Token (JWT). Например, `Authorization: Bearer <Azure AD JWT token>`. Сведения о создании маркера Microsoft Entra см. в статье Получение маркера Microsoft Entra. Маркер SAS. Например, `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Сведения о создании маркера SAS см. в разделах Создание маркера подписанного URL-адреса и Создание маркера SAS.

Укажите одно из следующих значений токена:

Microsoft Entra ID маркера JSON Web Token (JWT).
Например, Authorization: Bearer <Azure AD JWT token>.
Сведения о создании маркера Microsoft Entra см. в статье Получение маркера Microsoft Entra.
Маркер SAS.
Например, Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
Сведения о создании маркера SAS см. в разделах Создание маркера подписанного URL-адреса и Создание маркера SAS.

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

Нет.

Ответ

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Коды ответов

Код	Описание
200	Сообщение успешно удалено.
401	Ошибка авторизации.
404	Сообщение с указанным `MessageId` или `LockToken`не найдено.
410	Указанная очередь или подписка не существует.
500	Внутренняя ошибка.

Сведения о кодах состояний см. в разделе Коды состояний и ошибок.

Заголовки откликов

Заголовок ответа	Описание
Content-Type	Задано значение 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

Служебная шина возвращает следующий ответ:

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

См. также:

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

Share via