Compartilhar via

az network front-door routing-rule

  • Referência

Observação

Essa referência faz parte da extensão de porta frontal para a CLI do Azure (versão 2.57.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az network front-door routing-rule . Saiba mais sobre extensões.

Gerenciar regras de roteamento do Front Door.

Comandos

Nome Description Tipo Status
az network front-door routing-rule create

Crie uma regra de roteamento Front Door.

 Extensão GA
az network front-door routing-rule delete

Exclua uma regra de roteamento da Porta da Frente.

 Extensão GA
az network front-door routing-rule list

Listar regras de roteamento da porta de entrada.

 Extensão GA
az network front-door routing-rule show

Obtenha os detalhes de uma regra de roteamento de porta de entrada.

 Extensão GA
az network front-door routing-rule update

Atualize uma regra de roteamento Front Door.

 Extensão GA

az network front-door routing-rule create

Crie uma regra de roteamento Front Door.

Crie uma regra de roteamento Front Door para encaminhar as solicitações para um back-end ou redirecionar os usuários para uma URL diferente.

Exemplo 1: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

Exemplo 2: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string querystring.

az network front-door routing-rule create --front-door-name
                                          --frontend-endpoints
                                          --name
                                          --resource-group
                                          --route-type {Forward, Redirect}
                                          [--accepted-protocols]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--disabled {false, true}]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--rules-engine]

Parâmetros Exigidos

--front-door-name -f

Nome da porta da frente.

--frontend-endpoints

Lista separada por espaço de nomes ou IDs de ponto de extremidade front-end.

--name -n

Nome da regra de roteamento.

--resource-group -g

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

--route-type

Tipo de rota para definir como o Front Door deve lidar com solicitações para essa rota, ou seja, encaminhá-las para um back-end ou redirecionar os usuários para uma URL diferente.

Valores aceitos: Forward, Redirect

Parâmetros Opcionais

--accepted-protocols

Lista separada por espaço de protocolos a serem aceitos. Padrão: Http.

--backend-pool

Nome ou ID de um pool de back-end. É necessário criar uma regra de roteamento de encaminhamento.

--cache-duration

A duração pela qual o conteúdo precisa ser armazenado em cache. O formato permitido é a duração ISO 8601.

--caching

Se deseja habilitar o cache para essa rota.

Valores aceitos: Disabled, Enabled
--custom-forwarding-path

Caminho personalizado usado para reescrever caminhos de recursos correspondentes a essa regra. Deixe em branco para usar o caminho de entrada.

--custom-fragment

Fragmento para adicionar à URL de redirecionamento. Fragmento é a parte da URL que vem depois de #. Não inclua o #.

--custom-host

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

--custom-path

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

--custom-query-string

O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. A definição desse valor substituiria qualquer cadeia de caracteres de consulta existente; Deixe em branco para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar em = formato. O primeiro ? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &.

--disabled

Criar em um estado desabilitado.

Valores aceitos: false, true
--dynamic-compression

Use compactação dinâmica para conteúdo armazenado em cache.

Valores aceitos: Disabled, Enabled
--forwarding-protocol

Protocolo a ser usado para encaminhamento de tráfego.

Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
--patterns

Lista separada por espaço de padrões a serem correspondidos. Padrão: '/*'.

--query-parameter-strip-directive

Tratamento de termos de consulta de URL ao formar a chave de cache.

Valores aceitos: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parâmetros de consulta para incluir ou excluir (separados por vírgula) ao usar o tipo query-parameter-strip-directive StripAllExcept ou StripOnly respectivamente.

--redirect-protocol

O protocolo do destino para onde o tráfego é redirecionado.

Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
Valor padrão: MatchRequest
--redirect-type

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

Valores aceitos: Found, Moved, PermanentRedirect, TemporaryRedirect
Valor padrão: Moved
--rules-engine

Nome ou ID de uma configuração do Mecanismo de Regras. Para desvincular a propriedade, "--remove rulesEngine".

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az network front-door routing-rule delete

Exclua uma regra de roteamento da Porta da Frente.

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

Parâmetros Exigidos

--front-door-name -f

Nome da porta da frente.

--name -n

Nome da regra de roteamento.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az network front-door routing-rule list

Listar regras de roteamento da porta de entrada.

az network front-door routing-rule list --front-door-name
                                        --resource-group

Parâmetros Exigidos

--front-door-name -f

Nome da porta da frente.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az network front-door routing-rule show

Obtenha os detalhes de uma regra de roteamento de porta de entrada.

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

Parâmetros Exigidos

--front-door-name -f

Nome da porta da frente.

--name -n

Nome da regra de roteamento.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.

az network front-door routing-rule update

Atualize uma regra de roteamento Front Door.

az network front-door routing-rule update --front-door-name
                                          --name
                                          --resource-group
                                          [--accepted-protocols]
                                          [--add]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--enabled {Disabled, Enabled}]
                                          [--force-string]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--frontend-endpoints]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--remove]
                                          [--rules-engine]
                                          [--set]

Parâmetros Exigidos

--front-door-name -f

Nome da porta da frente.

--name -n

Nome da regra de roteamento.

--resource-group -g

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

Parâmetros Opcionais

--accepted-protocols

Lista separada por espaço de protocolos a serem aceitos. Padrão: Http.

--add

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

Valor padrão: []
--backend-pool

Nome ou ID de um pool de back-end. É necessário criar uma regra de roteamento de encaminhamento.

--cache-duration

A duração pela qual o conteúdo precisa ser armazenado em cache. O formato permitido é a duração ISO 8601.

--caching

Se deseja habilitar o cache para essa rota.

Valores aceitos: Disabled, Enabled
--custom-forwarding-path

Caminho personalizado usado para reescrever caminhos de recursos correspondentes a essa regra. Deixe em branco para usar o caminho de entrada.

--custom-fragment

Fragmento para adicionar à URL de redirecionamento. Fragmento é a parte da URL que vem depois de #. Não inclua o #.

--custom-host

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

--custom-path

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

--custom-query-string

O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. A definição desse valor substituiria qualquer cadeia de caracteres de consulta existente; Deixe em branco para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar em = formato. O primeiro ? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &.

--dynamic-compression

Use compactação dinâmica para conteúdo armazenado em cache.

Valores aceitos: Disabled, Enabled
--enabled

Status habilitado.

Valores aceitos: Disabled, Enabled
--force-string

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

Valor padrão: False
--forwarding-protocol

Protocolo a ser usado para encaminhamento de tráfego.

Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Lista separada por espaço de nomes ou IDs de ponto de extremidade front-end.

--patterns

Lista separada por espaço de padrões a serem correspondidos. Padrão: '/*'.

--query-parameter-strip-directive

Tratamento de termos de consulta de URL ao formar a chave de cache.

Valores aceitos: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parâmetros de consulta para incluir ou excluir (separados por vírgula) ao usar o tipo query-parameter-strip-directive StripAllExcept ou StripOnly respectivamente.

--redirect-protocol

O protocolo do destino para onde o tráfego é redirecionado.

Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Valores aceitos: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

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

Valor padrão: []
--rules-engine

Nome ou ID de uma configuração do Mecanismo de Regras. Para desvincular a propriedade, "--remove rulesEngine".

--set

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

Valor padrão: []
Parâmetros Globais
--debug

Aumente o detalhamento 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 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 o detalhamento do log. Use --debug para logs de depuração completos.