Azion CLI firewall

Os comandos firewall da Azion CLI criam, listam, descrevem, atualizam e excluem firewalls. Um firewall inspeciona as requisições de um workload antes da aplicação dele, e esses comandos ativam ou desativam WAF, Network Shield e Functions no firewall. Um firewall não inspeciona nenhuma requisição até que um deployment do workload o indique, por meio da flag --firewall-id de azion create workload-deployment. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.

Criar

azion create firewall cria um firewall com o nome e as configurações que você passa:

azion create firewall [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--active`	—	string	—	Ativa (`true`) ou desativa (`false`) o firewall.
`--debug-rules`	—	string	—	Aceita `true` ou `false`. Com `true`, você pode verificar se as regras do Rules Engine para Firewall do firewall foram executadas.
`--file`	—	string	—	Caminho para um arquivo JSON com os atributos do firewall. Use `-` para ler o JSON da entrada padrão.
`--functions-enabled`	—	string	—	Ativa (`true`) ou desativa (`false`) Functions no Firewall para o firewall.
`--name`	—	string	—	Obrigatório, exceto quando `--file` é informada. Nome do firewall. Sem ela, o comando pergunta o nome.
`--network-protection`	—	string	—	Ativa (`true`) ou desativa (`false`) Network Shield para o firewall.
`--waf-enabled`	—	string	—	Ativa (`true`) ou desativa (`false`) WAF para o firewall.

Este comando cria um firewall ativo chamado my-firewall, com Functions e WAF ativados:

azion create firewall --name my-firewall --active true --functions-enabled true --waf-enabled true

O comando exibe o ID do firewall:

Created Firewall with ID 12353

Listar

azion list firewall lista os firewalls da sua conta, 50 por página:

azion list firewall [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--details`	—	—	—	Adiciona as colunas `DEBUG`, `LAST EDITOR` e `LAST MODIFIED` às colunas `ID`, `NAME` e `ACTIVE`.
`--filter`	—	string	—	Nome pelo qual filtrar a lista.
`--order-by`	—	string	—	Campo pelo qual ordenar a lista.
`--page`	—	int	`1`	Número da página a retornar.
`--page-size`	—	int	`50`	Número de firewalls em cada página.

Este comando lista os firewalls da conta:

azion list firewall

O comando exibe uma linha por firewall:

Texto

01ID NAME ACTIVE

0212350 my-blog-firewall true

0312351 my-store-firewall true

0412352 my-api-firewall true

0512353 my-firewall true

0612354 my-site-firewall true

Descrever

azion describe firewall exibe as configurações de um firewall:

azion describe firewall [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--firewall-id`	—	int	—	ID do firewall a descrever.

Este comando descreve o firewall com ID 12353:

azion describe firewall --firewall-id 12353

O comando exibe o nome, as opções de ativação e o estado do firewall:

Texto

01ID: 12353

02Name: my-firewall

Modules:       {"ddos_protection":{"enabled":true},"functions":{"enabled":true},"network_protection":{"enabled":true},"waf":{"enabled":true}}

04Debug: false

05Active: true

06Last Editor: you@example.com

07Modified at: "2026-01-01T12:00:00.853715Z"

Com --format json, o comando exibe o objeto completo: active, created_at, debug, id, is_versioned, last_editor, last_modified, modules, name, product_version, version, version_id e version_state. O objeto modules contém um valor enabled para ddos_protection, functions, network_protection e waf. As flags de criação e de atualização definem os três últimos, e network_protection é o nome de Network Shield na API.

Um ID que não existe falha com este erro:

Error: Failed to get the Firewall: The given ID or API's endpoint doesn't exist or isn't available. Check that the identifying information is correct. Check your settings and try again. If the error persists, contact Azion support

Atualizar

azion update firewall altera o nome, o estado ativo ou as opções de ativação de um firewall:

azion update firewall [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--active`	—	string	—	Ativa (`true`) ou desativa (`false`) o firewall.
`--debug-rules`	—	string	—	Aceita `true` ou `false`. Com `true`, você pode verificar se as regras do Rules Engine para Firewall do firewall foram executadas.
`--file`	—	string	—	Caminho para um arquivo JSON com os atributos a alterar. Use `-` para ler o JSON da entrada padrão.
`--firewall-id`	—	int	—	Obrigatório, também com `--file`. ID do firewall a atualizar. Sem ela, o comando pergunta o ID.
`--functions-enabled`	—	string	—	Ativa (`true`) ou desativa (`false`) Functions no Firewall para o firewall.
`--name`	—	string	—	Novo nome do firewall.
`--network-protection`	—	string	—	Ativa (`true`) ou desativa (`false`) Network Shield para o firewall.
`--waf-enabled`	—	string	—	Ativa (`true`) ou desativa (`false`) WAF para o firewall.

As flags de ativação aceitam true ou false. Qualquer outro valor, como yes, é recusado:

Error: Invalid value for --waf-enabled flag: yes

Este comando renomeia o firewall com ID 12353 para my-firewall-renamed, ativa a depuração e ativa Network Shield:

azion update firewall --firewall-id 12353 --name my-firewall-renamed --debug-rules true --network-protection true

O comando exibe o ID do firewall atualizado:

Updated Firewall with ID 12353

Excluir

azion delete firewall exclui um firewall:

azion delete firewall [flags]

Flag	Curta	Tipo	Padrão	Descrição
`--firewall-id`	—	int	—	ID do firewall a excluir.

Este comando exclui o firewall com ID 12353:

azion delete firewall --firewall-id 12353

O comando confirma a exclusão:

Firewall 12353 was successfully deleted

Usar um arquivo JSON

azion create firewall e azion update firewall leem os atributos do firewall de um arquivo JSON com --file.

Este arquivo cria um firewall ativo chamado my-site-firewall. O comando lê name e active dele:

JSON

01{

02 "name": "my-site-firewall",

03 "active": true

04}

Passe o arquivo para o comando de criação:

azion create firewall --file fw-create.json

O comando exibe o ID do firewall:

Created Firewall with ID 12354

O firewall criado a partir desse arquivo tem Functions e Network Shield ativados e WAF desativado, como azion describe firewall --format json mostra no objeto modules.

Na atualização, o comando não lê "id" do arquivo. Passe --firewall-id na linha de comando, ou o comando pergunta o ID. Este arquivo renomeia o firewall com ID 12354 e o mantém ativo:

JSON

01{

02 "id": 12354,

03 "name": "my-site-firewall-updated",

04 "active": true

05}

Passe o arquivo e o ID para o comando de atualização:

azion update firewall --firewall-id 12354 --file fw-update.json

O comando exibe o ID do firewall atualizado:

Updated Firewall with ID 12354