Azion CLI waf-exceptions

Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem exceções do WAF, com cada flag, seu tipo e seu padrão.

Última atualização

Ver como Markdown Configurar agente

Os comandos waf-exceptions da Azion CLI criam, listam, descrevem, atualizam e excluem as exceções de um Web Application Firewall (WAF). Uma exceção isenta uma parte de uma requisição de uma regra do WAF. Todo comando recebe o --waf-id do WAF que guarda as exceções. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.

Criar

azion create waf-exceptions cria uma exceção em um WAF a partir de um arquivo JSON:

azion create waf-exceptions [flags]
FlagCurtaTipoPadrãoDescrição
--active—string"true"Ativa (true) ou desativa (false) a exceção.
--conditions—string—Condições da exceção, em formato JSON.
--file—string—Obrigatório. Caminho de um arquivo JSON com os atributos da exceção. Use - para ler o JSON da entrada padrão. Sem ela, o comando falha com Error: failed to create the WAF Exception: ["Ensure this field has at least 1 elements."], qualquer que seja o conteúdo de --conditions.
--name—string—Nome da exceção.
--operator—string—Operador que compara as condições: regex ou contains.
--path—string—Caminho ao qual a exceção se aplica.
--rule-id—int—ID da regra do WAF à qual a exceção se aplica.
--waf-id—int—ID do WAF que guarda a exceção.

Este arquivo descreve uma exceção ativa chamada my-exception. Ela isenta o parâmetro de query string chamado docs da regra 1000 do WAF nas requisições cujo caminho contém /my-path:

JSON
01{
02 "name": "my-exception",
03 "rule_id": 1000,
04 "path": "/my-path",
05 "operator": "contains",
06 "active": true,
07 "conditions": [
08 {
09 "match": "specific_query_string_name",
10 "name": "docs"
11 }
12 ]
13}

Este comando cria a exceção a partir do arquivo exception.json no WAF com ID 12347:

azion create waf-exceptions --waf-id 12347 --file exception.json

O comando imprime o ID da exceção:

Created WAF Exception with ID 123486

Listar

azion list waf-exceptions lista as exceções de um WAF, 50 por página:

azion list waf-exceptions [flags]
FlagCurtaTipoPadrãoDescrição
--details———Adiciona as colunas LAST EDITOR e LAST MODIFIED às colunas ID, NAME, RULE ID, PATH e ACTIVE.
--filter—string—Nome pelo qual filtrar a lista.
--order-by—string—Campo pelo qual ordenar a lista.
--page—int1Número da página a retornar.
--page-size—int50Número de exceções em cada página.
--waf-id—int—ID do WAF cujas exceções o comando lista.

Este comando lista as exceções do WAF com ID 12347:

azion list waf-exceptions --waf-id 12347

O comando imprime uma linha por exceção:

Texto
01ID NAME RULE ID PATH ACTIVE
02123486 my-exception 86463130383232 /my-path true

Descrever

azion describe waf-exceptions imprime as configurações de uma exceção:

azion describe waf-exceptions [flags]
FlagCurtaTipoPadrãoDescrição
--exception-id—int—ID da exceção a descrever.
--waf-id—int—ID do WAF que guarda a exceção.

Este comando descreve a exceção com ID 123486 no WAF com ID 12347:

azion describe waf-exceptions --waf-id 12347 --exception-id 123486

O comando imprime a regra, o caminho, o operador e o estado da exceção:

Texto
01ID: 123486
02Rule ID: 1000
03Name: my-exception
04Path: "/my-path"
05Operator: contains
06Active: true
07Last Editor: you@example.com
08Last Modified: "2026-01-01T12:00:00.490688Z"

Com --format json, o comando imprime o objeto completo: active, conditions, id, last_editor, last_modified, name, operator, path e rule_id. O array conditions aparece somente na saída JSON.

Atualizar

azion update waf-exceptions altera o nome, a regra, o caminho, as condições ou o estado de uma exceção:

azion update waf-exceptions [flags]
FlagCurtaTipoPadrãoDescrição
--active—string"true"Ativa (true) ou desativa (false) a exceção.
--conditions—string—Condições da exceção, em formato JSON.
--exception-id—int—ID da exceção a atualizar.
--file—string—Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão.
--name—string—Novo nome da exceção.
--operator—string—Operador que compara as condições: regex ou contains.
--path—string—Caminho ao qual a exceção se aplica.
--rule-id—int—ID da regra do WAF à qual a exceção se aplica.
--waf-id—int—ID do WAF que guarda a exceção.

Excluir

azion delete waf-exceptions exclui uma exceção de um WAF:

azion delete waf-exceptions [flags]
FlagCurtaTipoPadrãoDescrição
--exception-id—int—ID da exceção a excluir.
--waf-id—int—ID do WAF que guarda a exceção.

Usar um arquivo JSON

azion create waf-exceptions lê os atributos de uma exceção de um arquivo JSON com --file. O arquivo carrega name, rule_id, path, operator, active e conditions, e o ID do WAF vai na linha de comando com --waf-id.

Cada entrada de conditions recebe um valor match, que nomeia a parte da requisição que a exceção cobre. O valor specific_query_string_name recebe também uma chave name, que guarda o nome do parâmetro de query string. Para cada valor que match aceita e as chaves que cada um recebe, consulte Exceções.

Quando a plataforma recusa uma condição, o erro que o comando imprime não nomeia o campo. Um valor match que a plataforma não aceita falha com este erro:

Error: failed to create the WAF Exception: ["\"any_query_string\" is not a valid choice."]

Uma condição specific_query_string_name que carrega value no lugar de name falha com Error: failed to create the WAF Exception: ["This field is required."]. Para ver qual campo a plataforma recusou, adicione --debug e mantenha a linha que carrega o erro detalhado:

azion create waf-exceptions --waf-id 12347 --file exception.json --debug 2>&1 | grep 'Detailed error message'

A linha nomeia o campo pelo seu JSON pointer, depois de Source::

2026-01-01T12:00:00.320-0300 DEBUG {"Detailed error message from API": "Error: Required Field - Source: /data/conditions/0/name - Message: This field is required.\n"}

Recursos relacionados

Opções globais

As opções que todo comando aceita, como --format, --out e -y.

Exceções

Os campos de uma exceção, as match zones que suas condições aceitam e os erros que a plataforma retorna.

Azion CLI waf

Os comandos que criam e gerenciam o WAF ao qual uma exceção pertence.

Azion CLI firewall

Os comandos que criam e gerenciam o firewall no qual um WAF é executado.