Excluir Mensagem (Armazenamento do Azure)

  • Artigo

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

Solicitação

Você pode construir a solicitação da Delete Message seguinte maneira. HTTPS é recomendado.

Método URI da solicitação Versão HTTP
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Substitua myaccount pelo nome da sua conta de armazenamento, myqueue pelo nome da fila e string-value pelo valor do recibo pop que foi obtido para que a mensagem seja excluída.

URI do serviço de armazenamento emulado

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

Método URI da solicitação Versão HTTP
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Parâmetros do URI

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

Parâmetro Descrição
popreceipt Obrigatórios. Um valor de recibo pop válido retornado de uma chamada anterior para a operação Obter Mensagens ou Atualizar Mensagem .
timeout Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Configurando tempos limite para operações de Armazenamento de Filas.

Cabeçalhos da solicitação

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

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
Date ou x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o 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 KiB (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitorar o Armazenamento de Filas do Azure.

Corpo da solicitação

Nenhum.

Resposta

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

Código de status

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 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 inclui 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 da solicitação Descrição
x-ms-request-id Esse cabeçalho identifica exclusivamente a solicitação que foi feita e pode ser usado para solucionar problemas da solicitação. Para obter mais informações, consulte Solução de problemas de operações de API.
x-ms-version Indica a versão do Armazenamento de Filas usada 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 que indica a hora em que a resposta foi iniciada. O serviço gera esse valor.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho, se ele estiver presente na solicitação. O valor é no máximo 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.

Corpo da resposta

Nenhum.

Autorização

O proprietário da conta pode executar essa operação. Além disso, qualquer pessoa com uma assinatura de acesso compartilhado que tenha permissão para executar essa operação pode executá-la.

Comentários

Quando você exclui uma mensagem com êxito, ela é marcada imediatamente 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 Obter Mensagens , espera-se 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 Delete Message operação seja bem-sucedida, o recibo pop especificado na solicitação deve corresponder ao recibo pop retornado da Get Messages operação ou Update Message .

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

  • A mensagem expira.

  • A mensagem é excluída usando o último recibo pop recebido, seja de Get Messages ou Update Message.

  • O tempo limite de invisibilidade expira e a mensagem é desativada por uma solicitação Get Messages . Quando o tempo limite de invisibilidade expira, a mensagem fica visível novamente. Se ele for recuperado por outra Get Messages solicitação, o recibo pop retornado poderá ser usado para excluir ou atualizar a mensagem.

  • A mensagem é atualizada com um novo tempo limite de visibilidade. Quando a mensagem é atualizada, um novo recibo pop é retornado.

Se uma mensagem com um recibo pop correspondente não for encontrada, o serviço retornará o código de erro 404 (Não encontrado). Esse erro ocorre nos casos listados anteriormente em que o recibo pop não é mais válido.

Confira também

Autorizar solicitações para o Armazenamento do Azure
Status e códigos de erro
Códigos de erro do Armazenamento de Filas