Renew-Lock para uma Mensagem

Renova o bloqueio numa mensagem já bloqueada.

Pedir

Método	URI do pedido	Versão HTTP
POST	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, conforme devolvido BrokerProperties{MessageId} pela operação Pré-visualizar Mensagem , para a qual o bloqueio deve ser renovado.
sequence-number	O número de sequência da mensagem, conforme devolvido BrokerProperties{SequenceNumber} pela operação Pré-visualizar Mensagem , para a qual o bloqueio deve ser renovado.
lockToken	O token do bloqueio da mensagem, conforme devolvido pela operação Pré-visualizar Mensagem em BrokerProperties{LockToken}, para a qual o bloqueio deve ser renovado.

Cabeçalhos de Pedido

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

Cabeçalho do Pedido

Description

Autorização

Especifique um dos seguintes valores de token: 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	Bloqueio de mensagens renovado 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

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

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

Corpo da Resposta

Nenhum.

Exemplo

O seguinte pedido HTTP renova o bloqueio de uma mensagem bloqueada:

POST 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