Condividi tramite

az afd route

  • Riferimento

Gestire le route in un endpoint AFD.

Comandi

Nome Descrizione Tipo Stato
az afd route create

Creare una nuova route con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

 Memoria centrale Disponibilità generale
az afd route delete

Eliminare una route esistente con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

 Memoria centrale Disponibilità generale
az afd route list

Elencare tutte le origini esistenti all'interno di un profilo.

 Memoria centrale Disponibilità generale
az afd route show

Ottenere una route esistente con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

 Memoria centrale Disponibilità generale
az afd route update

Aggiornare una nuova route con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

 Memoria centrale Disponibilità generale
az afd route wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Memoria centrale Disponibilità generale

az afd route create

Creare una nuova route con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

az afd route create --endpoint-name
                    --name
                    --profile-name
                    --resource-group
                    [--content-types-to-compress]
                    [--custom-domains]
                    [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enabled-state {Disabled, Enabled}]
                    [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                    [--https-redirect {Disabled, Enabled}]
                    [--link-to-default-domain {Disabled, Enabled}]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--origin-group]
                    [--origin-path]
                    [--patterns-to-match]
                    [--query-parameters]
                    [--query-string-caching-behavior]
                    [--rule-sets]
                    [--supported-protocols]

Esempio

Crea una route per associare il dominio predefinito dell'endpoint a un gruppo di origine per tutte le richieste HTTPS.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --https-redirect Disabled --origin-group og001 --supported-protocols Https --link-to-default-domain Enabled --forwarding-protocol MatchRequest

Crea una route per associare il dominio predefinito dell'endpoint a un gruppo di origine per tutte le richieste e usare i set di regole specificati per personalizzare il comportamento della route.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --rule-sets ruleset1 rulseset2 --origin-group og001 --supported-protocols Http Https --link-to-default-domain Enabled --forwarding-protocol MatchRequest --https-redirect Disabled

Crea una route per associare il dominio predefinito dell'endpoint e un dominio personalizzato a un gruppo di origine per tutte le richieste con i modelli di percorso specificati e reindirizzare tutti i trafic per l'uso di Https.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --patterns-to-match /test1/* /tes2/* --origin-group og001 --supported-protocols Http Https --custom-domains cd001 --forwarding-protocol MatchRequest --https-redirect Enabled --link-to-default-domain Enabled

Parametri necessari

--endpoint-name

Nome dell'endpoint nel profilo univoco a livello globale.

--name --route-name -n

Nome della regola di routing.

--profile-name

Nome del profilo Frontdoor di Azure Standard o Frontdoor Di Azure Premium univoco all'interno del gruppo di risorse.

--resource-group -g

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

Parametri facoltativi

--content-types-to-compress

Elenco dei tipi di contenuto a cui si applica la compressione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--custom-domains

Domini personalizzati a cui fa riferimento questo endpoint. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--enable-caching

Indica se la memorizzazione nella cache è enanbled in tale route.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Indica se la compressione del contenuto è abilitata in AzureFrontDoor. Il valore predefinito è false. Se la compressione è abilitata, il contenuto verrà fornito come compresso se l'utente richiede una versione compressa. Il contenuto non verrà compresso in AzureFrontDoorquando il contenuto richiesto è inferiore a 1 byte o maggiore di 1 MB.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled'.

valori accettati: Disabled, Enabled
--forwarding-protocol

Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end.

valori accettati: HttpOnly, HttpsOnly, MatchRequest
valore predefinito: MatchRequest
--https-redirect

Indica se reindirizzare automaticamente il traffico HTTP al traffico HTTPS. Si noti che si tratta di un modo semplice per configurare questa regola e sarà la prima regola che viene eseguita.

valori accettati: Disabled, Enabled
valore predefinito: Disabled
--link-to-default-domain

Indica se questa route verrà collegata al dominio endpoint predefinito.

valori accettati: Disabled, Enabled
valore predefinito: Disabled
--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Nome o ID del gruppo di origine a cui associare.

--origin-path

Percorso di directory nell'origine che AzureFrontDoor può usare per recuperare il contenuto, ad esempio contoso.cloudapp.net/originpath.

--patterns-to-match

Modelli di route della regola. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--query-parameters

Parametri di query da includere o escludere. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--query-string-caching-behavior

Definisce il modo in cui Frontdoor memorizza nella cache le richieste che includono stringhe di query. È possibile ignorare qualsiasi stringa di query durante la memorizzazione nella cache, ignorare stringhe di query specifiche, memorizzare nella cache ogni richiesta con un URL univoco o memorizzare nella cache stringhe di query specifiche.

--rule-sets

Raccolta di ID o nome del set di regole a cui fa riferimento la route. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--supported-protocols

Elenco dei protocolli supportati per questa route. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

valore predefinito: ['Http', 'Https']
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 afd route delete

Eliminare una route esistente con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

az afd route delete [--endpoint-name]
                    [--ids]
                    [--name]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--profile-name]
                    [--resource-group]
                    [--subscription]
                    [--yes]

Esempio

Eliminare una route denominata route1.

az afd route delete -g group --profile-name profile --endpoint-name endpoint1 --route-name route1

Parametri facoltativi

--endpoint-name

Nome dell'endpoint nel profilo univoco a livello globale.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --route-name -n

Nome della regola di routing.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Nome del profilo Frontdoor di Azure Standard o Frontdoor Di Azure Premium univoco all'interno del gruppo di risorse.

--resource-group -g

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

--subscription

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

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
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 afd route list

Elencare tutte le origini esistenti all'interno di un profilo.

az afd route list --endpoint-name
                  --profile-name
                  --resource-group
                  [--max-items]
                  [--next-token]

Parametri necessari

--endpoint-name

Nome dell'endpoint nel profilo univoco a livello globale.

--profile-name

Nome del profilo Frontdoor di Azure Standard o Frontdoor Di Azure Premium univoco all'interno del gruppo di risorse.

--resource-group -g

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

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

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 afd route show

Ottenere una route esistente con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

az afd route show [--endpoint-name]
                  [--ids]
                  [--name]
                  [--profile-name]
                  [--resource-group]
                  [--subscription]

Parametri facoltativi

--endpoint-name

Nome dell'endpoint nel profilo univoco a livello globale.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --route-name -n

Nome della regola di routing.

--profile-name

Nome del profilo Frontdoor di Azure Standard o Frontdoor Di Azure Premium univoco all'interno del gruppo di risorse.

--resource-group -g

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

--subscription

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

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 afd route update

Aggiornare una nuova route con il nome di route specificato nella sottoscrizione, nel gruppo di risorse, nel profilo e nell'endpoint AzureFrontDoor specificati.

az afd route update [--add]
                    [--content-types-to-compress]
                    [--custom-domains]
                    [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enabled-state {Disabled, Enabled}]
                    [--endpoint-name]
                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                    [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                    [--https-redirect {Disabled, Enabled}]
                    [--ids]
                    [--link-to-default-domain {Disabled, Enabled}]
                    [--name]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--origin-group]
                    [--origin-path]
                    [--patterns-to-match]
                    [--profile-name]
                    [--query-parameters]
                    [--query-string-caching-behavior]
                    [--remove]
                    [--resource-group]
                    [--rule-sets]
                    [--set]
                    [--subscription]
                    [--supported-protocols]

Esempio

Aggiornare una route per accettare le richieste Http e Https e reindirizzare tutte le trafic per l'uso di Https.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --supported-protocols Http Https --https-redirect Enabled

Aggiornare le impostazioni dei set di regole di una route per personalizzare il comportamento della route.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --rule-sets ruleset1 rulseset2

Aggiornare le impostazioni di compressione di una route per abilitare la compressione per i tipi di contenuto specificati.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --query-string-caching-behavior IgnoreQueryString --enable-compression true --content-types-to-compress text/javascript text/plain

Parametri facoltativi

--add

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

--content-types-to-compress

Elenco dei tipi di contenuto a cui si applica la compressione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--custom-domains

Domini personalizzati a cui fa riferimento questo endpoint. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--enable-caching

Indica se la memorizzazione nella cache è enanbled in tale route.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Indica se la compressione del contenuto è abilitata in AzureFrontDoor. Il valore predefinito è false. Se la compressione è abilitata, il contenuto verrà servito come compresso se l'utente richiede una versione compressa. Il contenuto non verrà compresso in AzureFrontDoorquando il contenuto richiesto è inferiore a 1 byte o maggiore di 1 MB.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled'.

valori accettati: Disabled, Enabled
--endpoint-name

Nome dell'endpoint nel profilo univoco a livello globale.

--force-string

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

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Protocollo che questa regola verrà usata durante l'inoltro del traffico ai back-end.

valori accettati: HttpOnly, HttpsOnly, MatchRequest
--https-redirect

Indica se reindirizzare automaticamente il traffico HTTP al traffico HTTPS. Si noti che si tratta di un modo semplice per configurare questa regola e sarà la prima regola che viene eseguita.

valori accettati: Disabled, Enabled
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--link-to-default-domain

Indica se questa route verrà collegata al dominio endpoint predefinito.

valori accettati: Disabled, Enabled
--name --route-name -n

Nome della regola di routing.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Nome o ID del gruppo di origine a cui associare.

--origin-path

Percorso di directory nell'origine che AzureFrontDoor può usare per recuperare il contenuto, ad esempio contoso.cloudapp.net/originpath.

--patterns-to-match

Modelli di route della regola. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--profile-name

Nome del profilo Frontdoor di Azure Standard o Frontdoor Di Azure Premium univoco all'interno del gruppo di risorse.

--query-parameters

Parametri di query da includere o escludere. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--query-string-caching-behavior

Definisce il modo in cui Frontdoor memorizza nella cache le richieste che includono stringhe di query. È possibile ignorare qualsiasi stringa di query durante la memorizzazione nella cache, ignorare stringhe di query specifiche, memorizzare nella cache ogni richiesta con un URL univoco o memorizzare nella cache stringhe di query specifiche.

--remove

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

--resource-group -g

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

--rule-sets

Raccolta di ID o nome del set di regole a cui fa riferimento la route. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--set

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

--subscription

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

--supported-protocols

Elenco dei protocolli supportati per questa route. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

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 afd route wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

az afd route wait [--created]
                  [--custom]
                  [--deleted]
                  [--endpoint-name]
                  [--exists]
                  [--ids]
                  [--interval]
                  [--name]
                  [--profile-name]
                  [--resource-group]
                  [--subscription]
                  [--timeout]
                  [--updated]

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

valore predefinito: False
--endpoint-name

Nome dell'endpoint nel profilo univoco a livello globale.

--exists

Attendere che la risorsa esista.

valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--interval

Intervallo di polling in secondi.

valore predefinito: 30
--name --route-name -n

Nome della regola di routing.

--profile-name

Nome del profilo Frontdoor di Azure Standard o Frontdoor Di Azure Premium univoco all'interno del gruppo di risorse.

--resource-group -g

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

--subscription

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

--timeout

Attesa massima in secondi.

valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

valore predefinito: False
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.