Разблокировка сообщений

Статья
08/05/2023

Разблокирует сообщение для обработки другими получателями в указанной подписке. Эта операция удаляет объект блокировки, что приводит к разблокировке сообщения. Перед вызовом этой операции получатель сначала должен заблокировать сообщение.

Запрос

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
PUT	`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}` операции "Показать сообщение ".
`sequence-number`	Порядковый номер разблокированного сообщения, возвращаемого операцией `BrokerProperties{SequenceNumber}`"Показать сообщение ".
`lockToken`	Маркер блокировки разблокированного сообщения, возвращаемого операцией "Показать сообщение" в `BrokerProperties{LockToken}`.

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

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

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

Авторизация

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

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

Маркер веб-маркера JSON (Azure AD) Azure Active Directory (Azure AD).
Например, Authorization: Bearer <Azure AD JWT token>.
Сведения о создании маркера Azure AD см. в разделе Проверка подлинности из приложения.
Маркер 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 выполняет разблокировку сообщения.

PUT 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-клиента служебной шины