Renew-Lock para uma mensagem
Renova o bloqueio em uma mensagem já bloqueada.
Pedir
Método | URI de solicitação | Versão HTTP |
---|---|---|
POSTAR | 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 Local da mensagem espiada ou você pode construí-lo a partir das partes descritas na tabela a seguir.
Parâmetro | Descrição |
---|---|
messageId |
A ID da mensagem, conforme retornado em BrokerProperties{MessageId} pela operação Peek Message, para a qual o bloqueio deve ser renovado. |
sequence-number |
O número de sequência da mensagem, conforme retornado em BrokerProperties{SequenceNumber} pela operação de Peek Message, para a qual o bloqueio deve ser renovado. |
lockToken |
O token do bloqueio da mensagem, conforme retornado pela operação Peek Message no BrokerProperties{LockToken} , para o qual o bloqueio deve ser renovado. |
Cabeçalhos de solicitação
A tabela a seguir descreve cabeçalhos de solicitação obrigatórios e opcionais.
Cabeçalho de solicitação | Descrição |
---|---|
Autorização | Especifique um dos seguintes valores de token:
|
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 da 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 MessageId ou LockToken especificado. |
410 | A fila ou assinatura especificada não existe. |
500 | Erro interno. |
Para obter informações sobre códigos de status, consulte status e códigos de erro.
Cabeçalhos de resposta
A resposta dessa operação inclui os cabeçalhos a seguir. A resposta também pode incluir mais cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação de protocolo HTTP/1.1 .
Cabeçalho de resposta | Descrição |
---|---|
Tipo de conteúdo | Definido como application/atom+xml;type=entry;charset=utf-8 . |
Corpo da resposta
Nenhum.
Exemplo
A solicitação HTTP a seguir 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