Compartilhar via


Excluir fila

Importante

Essa API está obsoleta e desativada a partir de 1º/11/2021 e não deve mais ser usada.

Exclui uma fila existente. Essa operação também remove todos os estados associados, incluindo mensagens na fila.

Solicitação

Método URI da solicitação Versão HTTP
Delete (excluir) https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path} HTTP/1.1

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
Namespace URL do ponto de extremidade de gerenciamento
x-ms-version 2012-03-01

A solicitação também exige um certificado do cliente. Esse certificado deve corresponder ao carregado para uma assinatura específica.

Corpo da solicitação

Nenhum.

Resposta

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

Códigos de resposta

Observação

Se você criar uma fila com um nome que contenha caracteres especiais ou codificados (por exemplo, test?Name=value&, que é codificado para test%3FName%3Dvalue%26), uma exceção (401) Não autorizada será gerada.

Código Descrição
200 Fila excluída com êxito. Isso não significa que a fila foi completamente excluída no retorno da chamada da API. Significa que ele foi marcado para exclusão.
401 Falha de autorização.
404 A fila especificada não existe.
500 Erro interno.

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

Cabeçalhos de resposta

Nenhum.

Corpo da resposta

Nenhum.