Excluir mensagem (Armazenamento do Azure)
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 a mensagem a ser excluída.
URI do serviço de armazenamento emulado
Quando você fizer uma solicitação no serviço de armazenamento emulado, especifique o nome do host do emulador e a porta do Armazenamento de Filas do Azure como 127.0.0.1:10001
, seguido pelo nome da conta de armazenamento emulada.
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 será 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 está mais acessível.
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
ouUpdate 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 outraGet 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