Compartilhar via

az network front-door routing-rule

Note

Essa referência faz parte da extensão front-door da CLI do Azure (versão 2.70.0 ou superior). A extensão instalará 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 do Front Door.

 Extension GA
az network front-door routing-rule delete

Exclua uma regra de roteamento do Front Door.

 Extension GA
az network front-door routing-rule list

Liste as regras de roteamento do Front Door.

 Extension GA
az network front-door routing-rule show

Obtenha os detalhes de uma regra de roteamento do Front Door.

 Extension GA
az network front-door routing-rule update

Atualize uma regra de roteamento do Front Door.

 Extension GA

az network front-door routing-rule create

Crie uma regra de roteamento do Front Door.

Crie uma regra de roteamento do 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 do Front Door.

--frontend-endpoints

Lista separada por espaço de IDs ou nomes de ponto de extremidade de 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.

Propriedade Valor
Grupo de parâmetros: Routing Rule Arguments
Valores aceitos: Forward, Redirect

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--cache-duration

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

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--caching

Se deseja habilitar o cache para essa rota.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: Disabled, Enabled
--custom-forwarding-path

Caminho personalizado usado para reescrever caminhos de recurso correspondentes a essa regra. Deixe vazio para usar o caminho de entrada.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--custom-fragment

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--custom-host

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--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 caminho de destino.

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--custom-query-string

O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. Definir esse valor substituiria qualquer cadeia de caracteres de consulta existente; deixe vazio para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar no formato <key>=<value>. O primeiro? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &.

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--disabled

Crie em um estado desabilitado.

Propriedade Valor
Valores aceitos: false, true
--dynamic-compression

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

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: Disabled, Enabled
--forwarding-protocol

Protocolo a ser usado para encaminhar o tráfego.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
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.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parâmetros de consulta a serem incluídos ou excluídos (separados por vírgula) ao usar o tipo de consulta-parâmetro-strip-directive StripAllExcept ou StripOnly, respectivamente.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--redirect-protocol

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
Valor padrão: MatchRequest
Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
Valor padrão: Moved
Valores aceitos: Found, Moved, PermanentRedirect, TemporaryRedirect
--rules-engine

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az network front-door routing-rule delete

Exclua uma regra de roteamento do Front Door.

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

Parâmetros Exigidos

--front-door-name -f

Nome do Front Door.

--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az network front-door routing-rule list

Liste as regras de roteamento do Front Door.

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

Parâmetros Exigidos

--front-door-name -f

Nome do Front Door.

--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az network front-door routing-rule show

Obtenha os detalhes de uma regra de roteamento do Front Door.

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

Parâmetros Exigidos

--front-door-name -f

Nome do Front Door.

--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False

az network front-door routing-rule update

Atualize uma regra de roteamento do 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 do Front Door.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--backend-pool

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

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--cache-duration

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

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--caching

Se deseja habilitar o cache para essa rota.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: Disabled, Enabled
--custom-forwarding-path

Caminho personalizado usado para reescrever caminhos de recurso correspondentes a essa regra. Deixe vazio para usar o caminho de entrada.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--custom-fragment

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--custom-host

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--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 caminho de destino.

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--custom-query-string

O conjunto de cadeias de caracteres de consulta a serem colocadas na URL de redirecionamento. Definir esse valor substituiria qualquer cadeia de caracteres de consulta existente; deixe vazio para preservar a cadeia de caracteres de consulta de entrada. A cadeia de caracteres de consulta deve estar no formato <key>=<value>. O primeiro? e & serão adicionados automaticamente, portanto, não os inclua na frente, mas separe várias cadeias de caracteres de consulta com &.

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
--dynamic-compression

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

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: Disabled, Enabled
--enabled

Status habilitado.

Propriedade Valor
Grupo de parâmetros: Probe Setting Arguments
Valores aceitos: Disabled, Enabled
--force-string

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: False
--forwarding-protocol

Protocolo a ser usado para encaminhar o tráfego.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Lista separada por espaço de IDs ou nomes de ponto de extremidade de 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.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
Valores aceitos: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parâmetros de consulta a serem incluídos ou excluídos (separados por vírgula) ao usar o tipo de consulta-parâmetro-strip-directive StripAllExcept ou StripOnly, respectivamente.

Propriedade Valor
Grupo de parâmetros: Forward Routing Rule Arguments
--redirect-protocol

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
Valores aceitos: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Propriedade Valor
Grupo de parâmetros: Redirect Routing Rule Arguments
Valores aceitos: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

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

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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 ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Valor padrão: False