Azion CLI rules-engine

Os comandos rules-engine da Azion CLI criam, listam, descrevem, atualizam, ordenam e excluem as regras do Rules Engine de uma aplicação. Uma regra guarda critérios que uma requisição ou uma resposta precisa atender e os behaviors que ela aplica em seguida. Cada regra pertence a uma fase, request ou response, e cada comando recebe essa fase com --phase. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.

Criar

azion create rules-engine cria uma regra em uma fase de uma aplicação, a partir de um arquivo JSON:

Um valor de --phase diferente de request ou response é recusado com Error: Invalid phase value provided. The value must be 'request' or 'response'.

Este arquivo descreve uma regra que entrega toda requisição cuja URI começa com /static:

Este comando cria a regra na fase de requisição da aplicação com ID 1234567890:

O comando imprime o ID da regra:

Listar

azion list rules-engine lista as regras de uma fase de uma aplicação, 50 por página:

Este comando lista as regras da fase de requisição da aplicação com ID 1234567890:

O comando imprime uma linha por regra:

Descrever

azion describe rules-engine imprime os critérios, os behaviors e a posição de uma regra:

Uma regra descrita na fase errada falha com Error: Failed to describe the rule in Rules Engine: The given ID or API's endpoint doesn't exist or isn't available.

Este comando descreve a regra com ID 123456 na fase de requisição:

O comando imprime os atributos da regra:

Com --format json, o comando imprime o objeto completo: active, behaviors, created_at, criteria, description, id, last_editor, last_modified, name e order. Com --out e o caminho de um arquivo, o comando grava o mesmo JSON nesse arquivo, com ou sem --format json.

Atualizar

azion update rules-engine altera os atributos de uma regra a partir de um arquivo JSON:

A atualização é parcial. As chaves que o arquivo omite mantêm os seus valores, então um arquivo sem criteria ou behaviors mantém os que a regra já tem.

Este arquivo renomeia a regra, a desativa e adiciona uma descrição:

Este comando aplica o arquivo à regra com ID 123456:

O comando imprime o ID da regra atualizada:

Ordenar regras

azion update rules-engine-order define a ordem em que as regras de uma fase são executadas, a partir de uma lista de IDs de regras:

A lista precisa nomear todas as regras. Com uma de duas regras omitida, o comando falha com este erro:

Este comando move a regra com ID 123457 para antes da regra com ID 123456:

O comando confirma a nova ordem:

Uma listagem com --details mostra em seguida a nova posição de cada regra na coluna ORDER, a partir de 0:

Excluir

azion delete rules-engine exclui uma regra:

Este comando exclui a regra com ID 123457 da fase de requisição:

O comando confirma a exclusão:

Usar um arquivo JSON

azion create rules-engine e azion update rules-engine leem os atributos de uma regra apenas de um arquivo JSON, passado com --file. Use - no lugar do caminho para ler o JSON da entrada padrão. O arquivo recebe estas chaves:

Na criação, o arquivo traz a regra inteira. Na atualização, o arquivo traz apenas as chaves a alterar, e a regra mantém todos os outros valores. O ID da regra, o ID da aplicação e a fase vão na linha de comando com as suas flags.

Recursos relacionados