Compartilhar via

Renovar bloqueio para uma mensagem

  • Artigo

Renova o bloqueio em uma mensagem já bloqueada.

Solicitação

Método URI da solicitação Versão de 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 de URI

O URI é fornecido no cabeçalho de Localização da mensagem inspecionada ou é possível construi-lo com base nas partes descritas na tabela a seguir.

Parâmetro Descrição
messageId A ID da mensagem, conforme retornado pela BrokerProperties{MessageId} operação Espiar Mensagem , para a qual o bloqueio deve ser renovado.
sequence-number O número de sequência da mensagem, conforme retornado pela BrokerProperties{SequenceNumber} operação Espiar Mensagem , para a qual o bloqueio deve ser renovado.
lockToken O token do bloqueio da mensagem, conforme retornado pela operação Espiar Mensagem em BrokerProperties{LockToken}, para o qual o bloqueio deve ser renovado.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação Descrição
Autorização Especifique um dos seguintes valores de token:
  • Token JWT (Token Web JSON) do Azure Active Directory (Azure AD).
    Exemplo: Authorization: Bearer <Azure AD JWT token>.
    Para obter informações sobre como gerar um token Azure AD, consulte Autenticar de um aplicativo.
  • Um token 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 SAS, consulte Gerar um token de Assinatura de Acesso Compartilhado e Gerar token SAS.

Corpo da solicitação

Nenhum.

Resposta

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

Códigos de resposta

Código Descrição
200 Bloqueio de mensagem renovado com êxito.
401 Falha de autorização.
404 Nenhuma mensagem foi encontrada com o especificado MessageId ou LockToken.
410 A fila ou assinatura especificada não existe.
500 Erro interno.

Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

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

Cabeçalho de Resposta Descrição
Tipo de conteúdo Defina como application/atom+xml;type=entry;charset=utf-8.

Corpo da resposta

Nenhum.

Exemplo

A seguinte solicitação 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 Barramento de Serviço retorna 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 de Barramento de Serviço