Compartilhar via

az afd rule

  • Referência

Gerenciar regras de entrega dentro do conjunto de regras especificado.

Comandos

Nome Description Tipo Status
az afd rule action

Gerenciar regras de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule action add

Atualize uma nova regra de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule action list

Obtenha uma regra de entrega existente dentro de um conjunto de regras.

 Núcleo GA
az afd rule action remove

Atualize uma nova regra de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule condition

Gerenciar regras de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule condition add

Atualize uma nova regra de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule condition list

Obtenha uma regra de entrega existente dentro de um conjunto de regras.

 Núcleo GA
az afd rule condition remove

Atualize uma nova regra de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule create

Crie uma nova regra de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule delete

Exclua uma regra de entrega existente dentro de um conjunto de regras.

 Núcleo GA
az afd rule list

Liste todas as regras de entrega existentes em um conjunto de regras.

 Núcleo GA
az afd rule show

Obtenha uma regra de entrega existente dentro de um conjunto de regras.

 Núcleo GA
az afd rule update

Atualize uma nova regra de entrega dentro do conjunto de regras especificado.

 Núcleo GA
az afd rule wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Núcleo GA

az afd rule create

Crie uma nova regra de entrega dentro do conjunto de regras especificado.

az afd rule create --name
                   --profile-name
                   --resource-group
                   --rule-set-name
                   [--action-name]
                   [--cache-behavior]
                   [--cache-duration]
                   [--custom-fragment]
                   [--custom-hostname]
                   [--custom-path]
                   [--custom-querystring]
                   [--destination]
                   [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                   [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                   [--forwarding-protocol]
                   [--header-action]
                   [--header-name]
                   [--header-value]
                   [--match-processing-behavior {Continue, Stop}]
                   [--match-values]
                   [--match-variable]
                   [--negate-condition {0, 1, f, false, n, no, t, true, y, yes}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--operator]
                   [--order]
                   [--origin-group]
                   [--preserve-unmatched-path {0, 1, f, false, n, no, t, true, y, yes}]
                   [--query-parameters]
                   [--query-string-caching-behavior]
                   [--redirect-protocol]
                   [--redirect-type]
                   [--selector]
                   [--source-pattern]
                   [--transforms]

Exemplos

Crie uma regra para acrescentar um cabeçalho de resposta para solicitações da Tailândia.

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 2 --match-variable RemoteAddress --operator GeoMatch --match-values TH --rule-name disablecaching --action-name ModifyResponseHeader --header-action Append --header-name X-CDN --header-value AFDX

Criar uma regra para redirecionamento http para https

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

Parâmetros Exigidos

--name --rule-name -n

Nome da regra de entrega que é exclusiva dentro do ponto de extremidade.

--profile-name

Nome do perfil Azure Front Door Standard ou Azure Front Door Premium, que é exclusivo dentro do grupo de recursos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-set-name

Nome do conjunto de regras no perfil.

Parâmetros Opcionais

--action-name

O nome da ação para a regra de entrega: https://learn.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions.

--cache-behavior

Comportamento de cache para as solicitações.

--cache-duration

A duração para a qual o conteúdo precisa ser armazenado em cache. O formato permitido é hh:mm:ss.xxxxxx.

--custom-fragment

Fragmento a ser adicionado à URL de redirecionamento.

--custom-hostname

Hospedar para redirecionar. Deixe vazio para usar o host de entrada como o host de destino.

--custom-path

O caminho completo para redirecionamento. O caminho não pode estar vazio e deve começar com /. Deixe vazio para usar o caminho de entrada como pat de destino.

--custom-querystring

O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento.deixe vazio para preservar a cadeia de caracteres de consulta de entrada.

--destination

O caminho de destino a ser usado na reescrita.

--enable-caching

Indica se o cache deve ser habilitado na rota.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Indica se a compactação de conteúdo está habilitada no AzureFrontDoor. O valor padrão é falso. Se a compactação estiver habilitada, o conteúdo será servido como compactado se o usuário solicitar uma versão compactada. O conteúdo não será compactado no AzureFrontDoorwhen que o conteúdo solicitado for menor que 8 MB ou maior que 1 KB.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Protocolo que essa regra usará ao encaminhar o tráfego para back-ends.

--header-action

Ação de cabeçalho para as solicitações.

--header-name

Nome do cabeçalho a ser modificado.

--header-value

Valor do cabeçalho.

--match-processing-behavior

Se essa regra for uma correspondência, o mecanismo de regras continuará executando as regras restantes ou parando. Se não estiver presente, o padrão será Continuar.

Valores aceitos: Continue, Stop
Valor padrão: Continue
--match-values

Corresponde aos valores da condição de correspondência. por exemplo, os valores separados por espaço 'GET' 'HTTP'. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--match-variable

Nome da condição de correspondência: https://learn.microsoft.com/en-us/azure/frontdoor/rules-match-conditions.

--negate-condition

Se for verdade, nega a condição.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--operator

Operador da condição de correspondência.

--order

A ordem na qual as regras são aplicadas ao ponto de extremidade. Valores possíveis {0,1,2,3,ââ'¬Â>ââ'¬Â>ââ'¬Â>}. Uma regra com uma ordem menor será aplicada antes de uma regra com uma ordem maior. Regra com ordem 0 é uma regra especial. Ela não requer nenhuma condição e as ações listadas nela sempre serão aplicadas.

--origin-group

Nome ou ID do OriginGroup que substituiria o OriginGroup padrão.

--preserve-unmatched-path

Se True, o caminho restante após o padrão de origem será acrescentado ao novo caminho de destino.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--query-parameters

Parâmetros de consulta a serem incluídos ou excluídos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--query-string-caching-behavior

Define como a CDN armazena em cache solicitações que incluem cadeias de caracteres de consulta. Você pode ignorar todas as cadeias de caracteres de consulta ao armazenar em cache, ignorar o cache para impedir que solicitações que contêm cadeias de caracteres de consulta sejam armazenadas em cache ou armazenar em cache cada solicitação com uma URL exclusiva.

--redirect-protocol

Protocolo a ser usado para o redirecionamento.

--redirect-type

O tipo de redirecionamento que a regra usará ao redirecionar o tráfego.

--selector

Seletor da condição de correspondência.

--source-pattern

Um padrão de URI de solicitação que identifica o tipo de solicitações que podem ser reescritas.

--transforms

Transformar para aplicar antes da correspondência. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az afd rule delete

Exclua uma regra de entrega existente dentro de um conjunto de regras.

az afd rule delete [--ids]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--profile-name]
                   [--resource-group]
                   [--rule-set-name]
                   [--subscription]
                   [--yes]

Exemplos

Remova uma regra com a regra de nome1.

az afd rule delete -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name --rule-name -n

Nome da regra de entrega que é exclusiva dentro do ponto de extremidade.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Nome do perfil Azure Front Door Standard ou Azure Front Door Premium, que é exclusivo dentro do grupo de recursos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-set-name

Nome do conjunto de regras no perfil.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az afd rule list

Liste todas as regras de entrega existentes em um conjunto de regras.

az afd rule list --profile-name
                 --resource-group
                 --rule-set-name
                 [--max-items]
                 [--next-token]

Exemplos

Liste todas as rotas dentro do ponto de extremidade especificado.

az afd route list -g group --profile-name profile --endpoint-name endpoint1

Parâmetros Exigidos

--profile-name

Nome do perfil Azure Front Door Standard ou Azure Front Door Premium, que é exclusivo dentro do grupo de recursos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-set-name

Nome do conjunto de regras no perfil.

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az afd rule show

Obtenha uma regra de entrega existente dentro de um conjunto de regras.

az afd rule show [--ids]
                 [--name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]

Exemplos

mostrar detalhes da regra de entrega com a regra de nome1.

az afd rule show -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name --rule-name -n

Nome da regra de entrega que é exclusiva dentro do ponto de extremidade.

--profile-name

Nome do perfil Azure Front Door Standard ou Azure Front Door Premium, que é exclusivo dentro do grupo de recursos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-set-name

Nome do conjunto de regras no perfil.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az afd rule update

Atualize uma nova regra de entrega dentro do conjunto de regras especificado.

az afd rule update [--actions]
                   [--add]
                   [--conditions]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--match-processing-behavior {Continue, Stop}]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--order]
                   [--profile-name]
                   [--remove]
                   [--resource-group]
                   [--rule-set-name]
                   [--set]
                   [--subscription]

Parâmetros Opcionais

--actions

Uma lista de ações executadas quando todas as condições de uma regra são atendidas. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

--conditions

Uma lista de condições que devem ser correspondidas para que as ações sejam executadas Suporte à sintaxe de taquigrafia, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--match-processing-behavior

Se essa regra for uma correspondência, o mecanismo de regras continuará executando as regras restantes ou parando. Se não estiver presente, o padrão será Continuar.

Valores aceitos: Continue, Stop
--name --rule-name -n

Nome da regra de entrega que é exclusiva dentro do ponto de extremidade.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--order

A ordem na qual as regras são aplicadas ao ponto de extremidade. Valores possíveis {0,1,2,3,ÃÆ'ƒÂÃ'¢ÃÆ'Ã'¢Ã¢â‚¬Ã... Â.ÂÃ'¬ÃÆ'ââ'¬Å#ÂÃ'Â.ÃÆ'ƒÂÃ'¢ÃÆ'Ã'¢Ã¢â‚¬Ã... Â.ÂÃ'¬ÃÆ'ââ'¬Å#ÂÃ'Â.ÃÆ'ƒÂÃ'¢ÃÆ'Ã'¢Ã¢â‚¬Ã... Â>ÂÃ'¬ÃÆ'ââ'¬Å\ÂÃ'Â>}. Uma regra com uma ordem menor será aplicada antes de uma regra com uma ordem maior. Regra com ordem 0 é uma regra especial. Ela não requer nenhuma condição e as ações listadas nela sempre serão aplicadas.

--profile-name

Nome do perfil Azure Front Door Standard ou Azure Front Door Premium, que é exclusivo dentro do grupo de recursos.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-set-name

Nome do conjunto de regras no perfil.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az afd rule wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az afd rule wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]
                 [--timeout]
                 [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--name --rule-name -n

Nome da regra de entrega que é exclusiva dentro do ponto de extremidade.

--profile-name

Nome do perfil Azure Front Door Standard ou Azure Front Door Premium, que é exclusivo dentro do grupo de recursos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rule-set-name

Nome do conjunto de regras no perfil.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.