Azion CLI firewall-instance

Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem instâncias de function em um firewall, com cada flag, o tipo e o padrão dela.

Última atualização

Ver como Markdown Configurar agente

Os comandos firewall-instance da Azion CLI criam, listam, descrevem, atualizam e excluem instâncias de function em um firewall. Uma instância vincula uma function a um firewall e guarda os argumentos que a function recebe ali. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.

Criar

azion create firewall-instance cria uma instância de function no firewall que você indica:

azion create firewall-instance [flags]
FlagCurtaTipoPadrãoDescrição
--active—string"true"Se a instância está ativa: true ou false.
--args—string—Caminho para um arquivo JSON com os argumentos que a function recebe nesta instância.
--file—string—Caminho para um arquivo JSON com os atributos da instância. Use - para ler o JSON da entrada padrão.
--firewall-id—int—ID do firewall que contém a instância.
--function-id—int—Obrigatório, exceto quando --file é informada. ID da function que a instância executa. Sem ela, o comando pergunta ? Enter the Function's ID:.
--name—string—Nome da instância.

Este comando cria uma instância chamada my-firewall-instance da function com ID 12370 no firewall com ID 12353, com os argumentos de args.json:

azion create firewall-instance --firewall-id 12353 --function-id 12370 --name my-firewall-instance --args ./args.json

O comando exibe o ID da instância:

Created Firewall Function Instance with ID 12355

Listar

azion list firewall-instance lista as instâncias de function de um firewall, 50 por página:

azion list firewall-instance [flags]
FlagCurtaTipoPadrãoDescrição
--details———Adiciona as colunas LAST EDITOR e LAST MODIFIED às colunas ID, NAME, ACTIVE e FUNCTION.
--filter—string—Nome pelo qual filtrar a lista.
--firewall-id—int—ID do firewall cujas instâncias listar.
--order-by—string—Campo pelo qual ordenar a lista.
--page—int1Número da página a retornar.
--page-size—int50Número de instâncias em cada página.

Este comando lista as instâncias do firewall com ID 12353:

azion list firewall-instance --firewall-id 12353

O comando exibe uma linha por instância. A coluna FUNCTION contém o ID da function que cada instância executa:

Texto
01ID NAME ACTIVE FUNCTION
0212355 my-firewall-instance true 12370
0312356 my-file-instance true 12370

Descrever

azion describe firewall-instance exibe as configurações de uma instância de function:

azion describe firewall-instance [flags]
FlagCurtaTipoPadrãoDescrição
--firewall-id—int—ID do firewall que contém a instância.
--instance-id—int—ID da instância a descrever.

Este comando descreve a instância com ID 12355 no firewall com ID 12353:

azion describe firewall-instance --firewall-id 12353 --instance-id 12355

O comando exibe o ID, o nome e a function da instância, além de quem a alterou por último e quando:

Texto
01ID: 12355
02Name: my-firewall-instance
03Function: 12370
04Last Editor: you@example.com
05Last Modified: "2026-01-01T12:00:00.276936Z"

Com --format json, o comando exibe o objeto completo: active, args, azion_form, created_at, function, id, last_editor, last_modified e name. O objeto args contém os argumentos que --args ou o arquivo JSON definiram, e function contém o ID da function.

Um ID de instância que não existe no firewall falha com Error: failed to describe the Firewall Function Instance: The given ID or API's endpoint doesn't exist or isn't available. Check that the identifying information is correct.

Atualizar

azion update firewall-instance altera os atributos de uma instância de function:

azion update firewall-instance [flags]
FlagCurtaTipoPadrãoDescrição
--active—string"true"Se a instância está ativa: true ou false.
--args—string—Caminho para um arquivo JSON com os argumentos que a function recebe nesta instância.
--file—string—Caminho para um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão.
--firewall-id—int—ID do firewall que contém a instância.
--function-id—int—ID da function que a instância executa.
--instance-id—int—ID da instância a atualizar.
--name—string—Novo nome da instância.

Não é possível desativar uma instância. Com --active false, o comando falha com este erro:

Error: failed to update the Firewall Function Instance: ["You can't deactivate a function instance."]

Este comando renomeia a instância com ID 12355 para my-firewall-instance-renamed:

azion update firewall-instance --firewall-id 12353 --instance-id 12355 --name my-firewall-instance-renamed

O comando exibe o ID da instância atualizada. Os argumentos da instância mantêm os valores deles:

Updated Firewall Function Instance with ID 12355

Excluir

azion delete firewall-instance exclui uma instância de function de um firewall:

azion delete firewall-instance [flags]
FlagCurtaTipoPadrãoDescrição
--firewall-id—int—ID do firewall que contém a instância.
--instance-id—int—ID da instância a excluir.

Este comando exclui a instância com ID 12356 do firewall com ID 12353:

azion delete firewall-instance --firewall-id 12353 --instance-id 12356 -y

O comando confirma a exclusão:

Firewall Function Instance 12356 was successfully deleted

Usar um arquivo JSON

azion create firewall-instance e azion update firewall-instance leem os atributos da instância de um arquivo JSON com --file. Nos dois casos, passe --firewall-id na linha de comando.

Este arquivo cria uma instância ativa chamada my-file-instance da function com ID 12370, sem argumentos. Como o arquivo contém function, --function-id não é necessária:

JSON
01{
02 "name": "my-file-instance",
03 "function": 12370,
04 "active": true,
05 "args": {}
06}

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

azion create firewall-instance --firewall-id 12353 --file fwi-create.json

O comando exibe o ID da instância:

Created Firewall Function Instance with ID 12356

Na atualização, passe também --instance-id. Este arquivo renomeia a instância e substitui os argumentos dela:

JSON
01{
02 "name": "my-file-instance-updated",
03 "args": {"mode": "updated"}
04}

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

azion update firewall-instance --firewall-id 12353 --instance-id 12356 --file fwi-update.json

O comando exibe o ID da instância atualizada:

Updated Firewall Function Instance with ID 12356

A atualização é parcial: um campo que o arquivo omite, como active, mantém o valor dele.

Recursos relacionados

Opções globais

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

Instâncias de função no Firewall

O que uma instância contém e como os argumentos dela chegam à function.

Azion CLI function

Os comandos que criam a function que uma instância executa e exibem o ID dela.

Azion CLI firewall-rule

Os comandos que criam as regras que executam uma instância em um firewall.