az afd rule

  • Referência

Gerencie regras de entrega dentro do conjunto de regras especificado.

Comandos

Name Description Tipo Estado
az afd rule action

Gerencie regras de entrega dentro do conjunto de regras especificado.

 Principal GA
az afd rule action add

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

 Principal GA
az afd rule action list

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

 Principal GA
az afd rule action remove

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

 Principal GA
az afd rule condition

Gerencie regras de entrega dentro do conjunto de regras especificado.

 Principal GA
az afd rule condition add

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

 Principal GA
az afd rule condition list

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

 Principal GA
az afd rule condition remove

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

 Principal GA
az afd rule create

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

 Principal GA
az afd rule delete

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

 Principal GA
az afd rule list

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

 Principal GA
az afd rule show

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

 Principal GA
az afd rule update

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

 Principal GA
az afd rule wait

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

 Principal 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 o 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 Obrigatórios

--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

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

--rule-set-name

Nome da regra definida sob o perfil.

Parâmetros Opcionais

--action-name

O nome da ação para a regra de entrega: https://docs.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 durante a qual o conteúdo precisa ser armazenado em cache. O formato permitido é [d.]hh:mm:ss.

--custom-fragment

Fragmente para adicionar ao URL de redirecionamento.

--custom-hostname

Host para redirecionar. Deixe em branco para usar o host de entrada como host de destino.

--custom-path

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

--custom-querystring

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

--destination

O caminho de destino a ser usado na regravação.

--enable-caching

Indica se o cache deve ser habilitado na rota.

valores aceites: 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 é false. 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 AzureFrontDoorquando o conteúdo solicitado for menor que 1 byte ou maior que 1 MB.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Protocolo que esta regra usará ao encaminhar 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 esta regra for uma correspondência, o mecanismo de regras continuará executando as regras restantes ou parar. Se não estiver presente, o padrão será Continuar.

valores aceites: Continue, Stop
valor predefinido: Continue
--match-values

Corresponder valores da condição de correspondência. por exemplo, valores separados por espaço 'GET' 'HTTP'. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--match-variable

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

--negate-condition

Se verdadeiro, nega a condição.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--operator

Operador da condição de correspondência.

--order

A ordem em que as regras são aplicadas para o 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. A regra com ordem 0 é uma regra especial. Não requer nenhuma condição e as ações listadas nele serão sempre 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á anexado ao novo caminho de destino.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--query-parameters

Parâmetros de consulta a serem incluídos ou excluídos. Suporta sintaxe taquigráfica, json-file 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 contenham cadeias de caracteres de consulta sejam armazenadas em cache ou armazenar em cache todas as solicitações 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

Transforme para aplicar antes de combinar. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --rule-name -n

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

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 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

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

--rule-set-name

Nome da regra definida sob o perfil.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az afd rule list

Liste todas as regras de entrega existentes dentro de 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 Obrigatórios

--profile-name

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

--resource-group -g

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

--rule-set-name

Nome da regra definida sob o 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 no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--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

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

--rule-set-name

Nome da regra definida sob o perfil.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 que são executadas quando todas as condições de uma regra são satisfeitas. Suporta sintaxe taquigráfica, json-file 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 ou JSON string>.

--conditions

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

--force-string

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

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--match-processing-behavior

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

valores aceites: Continue, Stop
--name --rule-name -n

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

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--order

A ordem em que as regras são aplicadas para o 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. A regra com ordem 0 é uma regra especial. Não requer nenhuma condição e as ações listadas nele serão sempre 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 OR --remove propertyToRemove.

--resource-group -g

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

--rule-set-name

Nome da regra definida sob o perfil.

--set

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 predefinido: False
--custom

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

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 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

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

--rule-set-name

Nome da regra definida sob o perfil.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

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

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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