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

2025-03-19

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

Просьба

Метод	URI запроса	Версия HTTP
КЛАСТЬ	`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 (JWT) Microsoft Entra JSON. Пример: `Authorization: Bearer <Azure AD JWT token>`. Сведения о создании маркера 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.

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

Токен веб-токена JSON (JWT) Microsoft Entra JSON.
Пример: Authorization: Bearer <Azure AD JWT token>.
Сведения о создании маркера 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	Внутренняя ошибка.

Сведения о кодах состояния см. в коды состояния и коды ошибок.

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

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