Desbloquear Mensagem

Artigo
08/05/2023

Desbloqueia uma mensagem para processamento por outros recetores numa subscrição especificada. Esta operação elimina o objeto de bloqueio, fazendo com que a mensagem seja desbloqueada. Antes de a operação ser chamada, um recetor tem primeiro de bloquear a mensagem.

Pedir

Método	URI do pedido	Versão HTTP
PUT	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId\|sequenceNumber}/{lockToken}` ou `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId\|sequenceNumber}/{lockToken}\|HTTP/1.1`

Parâmetros do URI

O URI é fornecido no cabeçalho Localização da mensagem pré-visualizada ou pode construí-lo a partir das partes descritas na seguinte tabela.

Parâmetro	Description
`messageId`	O ID da mensagem a desbloquear conforme devolvido `BrokerProperties{MessageId}` pela operação Pré-visualizar Mensagem .
`sequence-number`	O número de sequência da mensagem a desbloquear conforme devolvido `BrokerProperties{SequenceNumber}` pela operação Pré-visualizar Mensagem .
`lockToken`	O token do bloqueio da mensagem a desbloquear conforme devolvido pela operação Pré-visualizar Mensagem no `BrokerProperties{LockToken}`.

Cabeçalhos de Pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do Pedido Description

Autorização

Cabeçalho do Pedido	Description
Autorização	Especifique uma das seguintes opções: Token Web JSON (JWT) do Azure Active Directory (Azure AD). Exemplo: `Authorization: Bearer <Azure AD JWT token>`. Para obter informações sobre como gerar um token de Azure AD, veja Authenticate from an application (Autenticar a partir de uma aplicação). Um token de SAS. Exemplo: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Para obter informações sobre como gerar um token de SAS, veja Gerar um token de Assinatura de Acesso Partilhado e Gerar token de SAS.

Especifique uma das seguintes opções:

Token Web JSON (JWT) do Azure Active Directory (Azure AD).
Exemplo: Authorization: Bearer <Azure AD JWT token>.
Para obter informações sobre como gerar um token de Azure AD, veja Authenticate from an application (Autenticar a partir de uma aplicação).
Um token de SAS.
Exemplo: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
Para obter informações sobre como gerar um token de SAS, veja Gerar um token de Assinatura de Acesso Partilhado e Gerar token de SAS.

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e o corpo da resposta.

Códigos de Resposta

Código	Descrição
200	Mensagem desbloqueada com êxito.
401	Falha de autorização.
404	Não foi encontrada nenhuma mensagem com o especificado `MessageId` ou `LockToken`.
410	A fila ou subscrição especificada não existe.
500	Erro interno.

Para obter informações sobre códigos de estado, veja Códigos de Estado e erro.

Cabeçalhos de Resposta

Cabeçalho de Resposta	Description
Content-Type	Definido como aplicação/atom+xml;type=entry;charset=utf-8.

Corpo da Resposta

Nenhum.

Exemplo

O seguinte pedido HTTP desbloqueia uma mensagem:

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

O Service Bus devolve a seguinte resposta:

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

Consulte também

Exemplo de Cliente HTTP do Service Bus

Partilhar via