VENDAS: 1-800-867-1389

Mensagem de exclusão

Atualizado: setembro de 2011

A operação Delete Message exclui a mensagem especificada.

A solicitação Delete Message pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da conta de armazenamento, myqueue pelo nome da fila e string-value pelo valor de recebimento de mensagem pop-up que foi obtido para que a mensagem seja excluída:

 

Método URI de solicitação Versão de HTTP

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome de host do emulador e a porta do serviço Fila como 127.0.0.1:10001, seguido pelo nome da conta de armazenamento emulado:

 

Método URI de solicitação Versão de HTTP

DELETE

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

Para obter mais informações, consulte About Development Storage.

O URI da solicitação oferece suporte aos parâmetros a seguir.

 

Parâmetro Descrição

popreceipt

Obrigatória. Um valor válido de recebimento de mensagem pop-up retornado de uma chamada anterior para a operação Receber mensagens ou Atualizar Mensagem (REST API).

timeout

Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Definindo tempos limite para operações de serviço Fila.

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

 

Cabeçalho de solicitação Descrição

Authorization

Obrigatória. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

Date ou x-ms-date

Obrigatória. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

x-ms-version

Opcional. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure.

x-ms-client-request-id

Opcional. Fornece um valor opaco, gerado pelo cliente, com um limite de caracteres de 1 KB que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. É altamente recomendável usar esse cabeçalho para correlacionar atividades do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o registro em log da Análise de Armazenamento e Log do Windows Azure: Usando logs para rastrear solicitações de armazenamento.

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

Uma operação bem-sucedida retorna o código de status 204 (Sem conteúdo).

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

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também inclui cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de solicitação Descrição

x-ms-request-id

Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solucionando problemas de operações de API.

x-ms-version

Indica a versão do serviço Fila usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.

Date

Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

Essa operação poderá ser executada pelo proprietário da conta e por qualquer pessoa com uma assinatura de acesso compartilhado que tenha permissão para executar essa operação.

Quando uma mensagem é excluída com êxito, ela é imediatamente marcada para exclusão e não é mais acessível aos clientes. A mensagem é posteriormente removida da fila durante a coleta de lixo.

Depois que um cliente recupera uma mensagem com a operação Receber mensagens, é esperado que o cliente processe e exclua a mensagem. Para excluir a mensagem, você deve ter dois itens de dados retornados no corpo da resposta da operação Get Messages:

  • A ID de mensagem, um valor de GUID opaco que identifica a mensagem na fila.

  • Um recebimento de mensagem pop-up válido, um valor opaco que indica que a mensagem foi recuperada.

A ID da mensagem é retornada da operação Get Messages anterior. O recebimento de mensagem pop-up é retornado da operação Get Messages ou Update Message mais recente. Para que a operação Delete Message seja bem-sucedida, o recebimento de mensagem pop-up especificado na solicitação deve corresponder ao recebimento de mensagem pop-up retornado da operação Get Messages ou de Update Message.

Os recebimentos de mensagem pop-up permanecem válidos até que um dos seguintes eventos ocorra:

  1. A mensagem expirou.

  2. A mensagem foi excluída usando o último recebimento de mensagem pop-up de Get Messages ou de Update Message.

  3. O tempo limite de invisibilidade expirou, e a mensagem foi removida da fila por uma solicitação Get Messages. Quando o tempo limite de invisibilidade expira, a mensagem se torna visível novamente. Se for recuperada por outra solicitação Get Messages, o recebimento de mensagem pop-up retornado poderá ser usado para excluir ou atualizar a mensagem.

  4. A mensagem foi atualizada com um novo tempo limite da visibilidade. Quando a mensagem for atualizada, um novo recebimento de mensagem pop-up será retornado.

Se uma mensagem com um recebimento de mensagem pop-up correspondente não for localizada, o serviço retornará o código de erro 400 (Não Encontrada). Esse erro ocorrerá nos casos listados acima em que o recebimento de mensagem pop-up não é mais válido.

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2014 Microsoft