Azion CLI network-list
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem network lists e adicionam ou removem itens delas, com cada flag e o padrão dela.
Os comandos network-list da Azion CLI criam, listam, descrevem, atualizam e excluem network lists. Uma network list é um conjunto nomeado de endereços IP e intervalos CIDR, de Autonomous System Numbers (ASNs) ou de países, com o qual uma regra de firewall compara o cliente de uma requisição. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.
Criar
azion create network-list cria uma network list com o nome, o tipo e os itens que você passa:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--active | — | string | — | Ativa (true) ou desativa (false) a network list. |
--file | — | string | — | Caminho para um arquivo JSON com os atributos da network list. |
--items | — | string | — | Obrigatório, exceto quando --file é informada. Itens da network list, separados por vírgula. Sem ela, o comando pergunta os itens. |
--name | — | string | — | Nome da network list. |
--type | — | string | — | Tipo dos itens: asn, countries ou ip_cidr. |
Um valor de --type fora desses três é recusado:
Este comando cria uma network list ativa chamada my-ip-list com dois intervalos CIDR:
O comando exibe o ID da network list:
Listar
azion list network-list lista as network lists da sua conta, 50 por página:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--details | — | — | — | Adiciona a coluna TYPE à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 network lists em cada página. |
Este comando lista as network lists da conta com os tipos delas:
O comando exibe uma linha por network list. A lista com ID 2 é a lista de exit nodes Tor que a Azion fornece a toda conta:
Descrever
azion describe network-list exibe o tipo, os itens e o estado de uma network list:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--network-list-id | — | int | — | ID da network list a descrever. |
Este comando descreve a network list com ID 12365:
O comando exibe o nome, o tipo, os itens e o estado da network list:
Com --format json, o comando exibe o objeto completo: active, created_at, id, is_versioned, items, last_editor, last_modified, name, type, version, version_id e version_state.
Um ID que não existe falha com este erro:
Atualizar
azion update network-list altera o nome, os itens ou o estado ativo de uma network list:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--active | — | string | — | Ativa (true) ou desativa (false) a network list. |
--add-item | — | string | — | Itens a adicionar à network list, separados por vírgula. Os itens que já estão na lista permanecem. |
--file | — | string | — | Caminho para um arquivo JSON com os atributos a alterar. |
--items | — | string | — | Itens da network list, separados por vírgula. Eles substituem todos os itens que a lista contém. |
--name | — | string | — | Novo nome da network list. |
--network-list-id | — | int | — | Obrigatório, também com --file. ID da network list a atualizar. Sem ela, o comando pergunta o ID. |
--remove-item | — | string | — | Itens a remover da network list, separados por vírgula. Os outros itens permanecem. |
--type | — | string | — | Tipo dos itens: asn, countries ou ip_cidr. |
--items substitui a lista inteira, enquanto --add-item e --remove-item alteram somente os itens que indicam. Para manter os itens que uma lista contém, use --add-item.
Este comando adiciona o intervalo 203.0.113.5/32 à network list com ID 12365:
O comando exibe o ID da network list atualizada:
A lista passa a conter 192.0.2.0/24, 198.51.100.7/32 e 203.0.113.5/32. A mesma lista atualizada com --items '192.0.2.10/32' contém somente 192.0.2.10/32.
Excluir
azion delete network-list exclui uma network list:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--network-list-id | — | int | — | ID da network list a excluir. |
Este comando exclui a network list com ID 12366:
O comando confirma a exclusão:
Usar um arquivo JSON
azion create network-list e azion update network-list leem os atributos da network list de um arquivo JSON com --file. O arquivo traz items como um array de strings.
Este arquivo cria uma network list ativa chamada my-country-list que contém dois países:
Passe o arquivo para o comando de criação:
O comando exibe o ID da network list:
Na atualização, o comando não lê "id" do arquivo. Passe --network-list-id na linha de comando, ou o comando pergunta o ID. Os campos que o arquivo omite mantêm os valores deles. Este arquivo renomeia a network list com ID 12366 e adiciona PT aos itens dela:
Passe o arquivo e o ID para o comando de atualização:
O comando exibe o ID da network list atualizada: