Partilhar via

az network front-door routing-rule

  • Referência

Nota

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.

Gerencie as regras de roteamento da porta da frente.

Comandos

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

Crie uma regra de roteamento de porta frontal.

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

Exclua uma regra de roteamento da porta frontal.

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

Liste as regras de roteamento da porta frontal.

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

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

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

Atualize uma regra de roteamento da porta frontal.

 Extensão GA

az network front-door routing-rule create

Crie uma regra de roteamento de porta frontal.

Crie uma regra de roteamento da 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 Obrigatórios

--front-door-name -f

Nome da porta da frente.

--frontend-endpoints

Lista separada por espaço de nomes ou IDs de pontos finais de frontend.

--name -n

Nome da regra de roteamento.

--resource-group -g

o 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 aceites: Forward, Redirect

Parâmetros Opcionais

--accepted-protocols

Lista separada por espaços de protocolos a aceitar. 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 durante a qual o conteúdo precisa ser armazenado em cache. O formato permitido é a duração ISO 8601.

--caching

Se o cache deve ser habilitado para essa rota.

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

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

--custom-fragment

Fragmente para adicionar ao URL de redirecionamento. Fragmento é a parte do 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. Definir esse 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 desativado.

Valores aceites: false, true
--dynamic-compression

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

Valores aceites: Disabled, Enabled
--forwarding-protocol

Protocolo a utilizar para reencaminhamento de tráfego.

Valores aceites: 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 aceites: 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 aceites: HttpOnly, HttpsOnly, MatchRequest
Default value: MatchRequest
--redirect-type

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

Valores aceites: Found, Moved, PermanentRedirect, TemporaryRedirect
Default value: Moved
--rules-engine

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

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
Default value: 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 network front-door routing-rule delete

Exclua uma regra de roteamento da porta frontal.

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

Parâmetros Obrigatórios

--front-door-name -f

Nome da porta da frente.

--name -n

Nome da regra de roteamento.

--resource-group -g

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

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
Default value: 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 network front-door routing-rule list

Liste as regras de roteamento da porta frontal.

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

Parâmetros Obrigatórios

--front-door-name -f

Nome da porta da frente.

--resource-group -g

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

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
Default value: 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 network front-door routing-rule show

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

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

Parâmetros Obrigatórios

--front-door-name -f

Nome da porta da frente.

--name -n

Nome da regra de roteamento.

--resource-group -g

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

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
Default value: 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 network front-door routing-rule update

Atualize uma regra de roteamento da porta frontal.

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

--front-door-name -f

Nome da porta da frente.

--name -n

Nome da regra de roteamento.

--resource-group -g

o 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ços de protocolos a aceitar. 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>.

Default value: []
--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 durante a qual o conteúdo precisa ser armazenado em cache. O formato permitido é a duração ISO 8601.

--caching

Se o cache deve ser habilitado para essa rota.

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

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

--custom-fragment

Fragmente para adicionar ao URL de redirecionamento. Fragmento é a parte do 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. Definir esse 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 a compactação dinâmica para conteúdo armazenado em cache.

Valores aceites: Disabled, Enabled
--enabled

Status habilitado.

Valores aceites: Disabled, Enabled
--force-string

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

Default value: False
--forwarding-protocol

Protocolo a utilizar para reencaminhamento de tráfego.

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

Lista separada por espaço de nomes ou IDs de pontos finais de frontend.

--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 aceites: 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 aceites: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

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

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

Default value: []
--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>.

Default value: []
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
Default value: 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.