Condividi tramite

az network front-door routing-rule

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione frontdoor per l'interfaccia della riga di comando di Azure (versione 2.57.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az network front-door routing-rule . Altre informazioni sulle estensioni.

Gestire le regole di routing di Frontdoor.

Comandi

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

Creare una regola di routing di Frontdoor.

 Estensione Disponibilità generale
az network front-door routing-rule delete

Eliminare una regola di routing di Frontdoor.

 Estensione Disponibilità generale
az network front-door routing-rule list

Elencare le regole di routing di Frontdoor.

 Estensione Disponibilità generale
az network front-door routing-rule show

Ottenere i dettagli di una regola di routing di Frontdoor.

 Estensione Disponibilità generale
az network front-door routing-rule update

Aggiornare una regola di routing di Frontdoor.

 Estensione Disponibilità generale

az network front-door routing-rule create

Creare una regola di routing di Frontdoor.

Creare una regola di routing di Frontdoor per inoltrare le richieste a un back-end o reindirizzare gli utenti a un URL diverso.

Esempio 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

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

Parametri necessari

--front-door-name -f

Nome della frontdoor.

--frontend-endpoints

Elenco delimitato da spazi di nomi di endpoint front-end o ID.

--name -n

Nome della regola di routing.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--route-type

Tipo di route per definire il modo in cui Frontdoor deve gestire le richieste per questa route, ad esempio inoltrarle a un back-end o reindirizzare gli utenti a un URL diverso.

Valori accettati: Forward, Redirect

Parametri facoltativi

--accepted-protocols

Elenco delimitato da spazi di protocolli da accettare. Impostazione predefinita: Http.

--backend-pool

Nome o ID di un pool back-end. È necessario creare una regola di routing di inoltro.

--cache-duration

Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è la durata ISO 8601.

--caching

Indica se abilitare la memorizzazione nella cache per la route.

Valori accettati: Disabled, Enabled
--custom-forwarding-path

Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso di ingresso.

--custom-fragment

Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #.

--custom-host

Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione.

--custom-path

Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione.

--custom-query-string

Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in formato = . La prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &.

--disabled

Crea in uno stato disabilitato.

Valori accettati: false, true
--dynamic-compression

Usare la compressione dinamica per il contenuto memorizzato nella cache.

Valori accettati: Disabled, Enabled
--forwarding-protocol

Protocollo da usare per l'inoltro del traffico.

Valori accettati: HttpOnly, HttpsOnly, MatchRequest
--patterns

Elenco delimitato da spazi di modelli da trovare in corrispondenza. Impostazione predefinita: '/*'.

--query-parameter-strip-directive

Trattamento dei termini di query URL quando si forma la chiave della cache.

Valori accettati: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parametri di query da includere o escludere (delimitati da virgole) quando si usa rispettivamente il tipo di direttiva strip-parameter-query StripAllExcept o StripOnly.

--redirect-protocol

Protocollo della destinazione in cui viene reindirizzato il traffico.

Valori accettati: HttpOnly, HttpsOnly, MatchRequest
Valore predefinito: MatchRequest
--redirect-type

Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico.

Valori accettati: Found, Moved, PermanentRedirect, TemporaryRedirect
Valore predefinito: Moved
--rules-engine

Nome o ID di una configurazione del motore regole. Per scollegare la proprietà "-remove rulesEngine".

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network front-door routing-rule delete

Eliminare una regola di routing di Frontdoor.

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

Parametri necessari

--front-door-name -f

Nome della frontdoor.

--name -n

Nome della regola di routing.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network front-door routing-rule list

Elencare le regole di routing di Frontdoor.

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

Parametri necessari

--front-door-name -f

Nome della frontdoor.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network front-door routing-rule show

Ottenere i dettagli di una regola di routing di Frontdoor.

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

Parametri necessari

--front-door-name -f

Nome della frontdoor.

--name -n

Nome della regola di routing.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az network front-door routing-rule update

Aggiornare una regola di routing di Frontdoor.

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]

Parametri necessari

--front-door-name -f

Nome della frontdoor.

--name -n

Nome della regola di routing.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--accepted-protocols

Elenco delimitato da spazi di protocolli da accettare. Impostazione predefinita: Http.

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Valore predefinito: []
--backend-pool

Nome o ID di un pool back-end. È necessario creare una regola di routing di inoltro.

--cache-duration

Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è la durata ISO 8601.

--caching

Indica se abilitare la memorizzazione nella cache per la route.

Valori accettati: Disabled, Enabled
--custom-forwarding-path

Percorso personalizzato usato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso di ingresso.

--custom-fragment

Frammento da aggiungere all'URL di reindirizzamento. Fragment è la parte dell'URL che segue #. Non includere il file #.

--custom-host

Host da reindirizzare. Lasciare vuoto per usare l'host in ingresso come host di destinazione.

--custom-path

Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione.

--custom-query-string

Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in formato = . La prima? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &.

--dynamic-compression

Usare la compressione dinamica per il contenuto memorizzato nella cache.

Valori accettati: Disabled, Enabled
--enabled

Stato abilitato.

Valori accettati: Disabled, Enabled
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valore predefinito: False
--forwarding-protocol

Protocollo da usare per l'inoltro del traffico.

Valori accettati: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Elenco delimitato da spazi di nomi di endpoint front-end o ID.

--patterns

Elenco delimitato da spazi di modelli da trovare in corrispondenza. Impostazione predefinita: '/*'.

--query-parameter-strip-directive

Trattamento dei termini di query URL quando si forma la chiave della cache.

Valori accettati: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parametri di query da includere o escludere (delimitati da virgole) quando si usa rispettivamente il tipo di direttiva strip-parameter-query StripAllExcept o StripOnly.

--redirect-protocol

Protocollo della destinazione in cui viene reindirizzato il traffico.

Valori accettati: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

Tipo di reindirizzamento che verrà usata dalla regola durante il reindirizzamento del traffico.

Valori accettati: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valore predefinito: []
--rules-engine

Nome o ID di una configurazione del motore regole. Per scollegare la proprietà "-remove rulesEngine".

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Valore predefinito: []
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.