az afd rule

Riferimento

Gestire le regole di recapito all'interno del set di regole specificato.

Comandi

Nome	Descrizione	Tipo	Stato
az afd rule action	Gestire le regole di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule action add	Aggiornare una nuova regola di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule action list	Ottenere una regola di recapito esistente all'interno di un set di regole.	Core	Disponibilità generale
az afd rule action remove	Aggiornare una nuova regola di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule condition	Gestire le regole di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule condition add	Aggiornare una nuova regola di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule condition list	Ottenere una regola di recapito esistente all'interno di un set di regole.	Core	Disponibilità generale
az afd rule condition remove	Aggiornare una nuova regola di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule create	Creare una nuova regola di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule delete	Eliminare una regola di recapito esistente all'interno di un set di regole.	Core	Disponibilità generale
az afd rule list	Elencare tutte le regole di recapito esistenti all'interno di un set di regole.	Core	Disponibilità generale
az afd rule show	Ottenere una regola di recapito esistente all'interno di un set di regole.	Core	Disponibilità generale
az afd rule update	Aggiornare una nuova regola di recapito all'interno del set di regole specificato.	Core	Disponibilità generale
az afd rule wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Core	Disponibilità generale

az afd rule create

Creare una nuova regola di recapito all'interno del set di regole specificato.

az afd rule create --name
                   --profile-name
                   --resource-group
                   --rule-set-name
                   [--action-name]
                   [--cache-behavior]
                   [--cache-duration]
                   [--custom-fragment]
                   [--custom-hostname]
                   [--custom-path]
                   [--custom-querystring]
                   [--destination]
                   [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                   [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                   [--forwarding-protocol]
                   [--header-action]
                   [--header-name]
                   [--header-value]
                   [--match-processing-behavior {Continue, Stop}]
                   [--match-values]
                   [--match-variable]
                   [--negate-condition {0, 1, f, false, n, no, t, true, y, yes}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--operator]
                   [--order]
                   [--origin-group]
                   [--preserve-unmatched-path {0, 1, f, false, n, no, t, true, y, yes}]
                   [--query-parameters]
                   [--query-string-caching-behavior]
                   [--redirect-protocol]
                   [--redirect-type]
                   [--selector]
                   [--source-pattern]
                   [--transforms]

Esempio

Creare una regola per aggiungere un'intestazione di risposta per le richieste dalla Thailandia.

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 2 --match-variable RemoteAddress --operator GeoMatch --match-values TH --rule-name disablecaching --action-name ModifyResponseHeader --header-action Append --header-name X-CDN --header-value AFDX

Creare una regola per il reindirizzamento da http a https

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

Parametri necessari

--name --rule-name -n

Nome della regola di recapito univoca all'interno dell'endpoint.

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

--rule-set-name

Nome del set di regole nel profilo.

Parametri facoltativi

--action-name

Nome dell'azione per la regola di recapito: https://docs.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions.

--cache-behavior

Comportamento di memorizzazione nella cache per le richieste.

--cache-duration

Durata per cui il contenuto deve essere memorizzato nella cache. Il formato consentito è [d.]hh:mm:ss.

--custom-fragment

Frammento da aggiungere all'URL di reindirizzamento.

--custom-hostname

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 pat di destinazione.

--custom-querystring

Set di stringhe di query da inserire nell'URL di reindirizzamento. Lasciare vuoto per mantenere la stringa di query in ingresso.

--destination

Percorso di destinazione da utilizzare nella riscrittura.

--enable-caching

Indica se abilitare la memorizzazione nella cache nella 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

--forwarding-protocol

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

--header-action

Azione di intestazione per le richieste.

--header-name

Nome dell'intestazione da modificare.

--header-value

Valore dell'intestazione.

--match-processing-behavior

Se questa regola è una corrispondenza, il motore regole deve continuare a eseguire le regole rimanenti o arrestare. Se non è presente, l'impostazione predefinita è Continua.

valori accettati: Continue, Stop

valore predefinito: Continue

--match-values

Trova la corrispondenza dei valori della condizione di corrispondenza. Ad esempio, spazi separati da valori 'GET' 'HTTP'. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--match-variable

Nome della condizione di corrispondenza: https://docs.microsoft.com/en-us/azure/frontdoor/rules-match-conditions.

--negate-condition

Se true, nega la condizione.

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

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

--operator

Operatore della condizione di corrispondenza.

--order

Ordine in cui vengono applicate le regole per l'endpoint. Valori possibili {0,1,2,3,Ã'^â'^Â^Ã'â'^Â^Ã^â'\â'}. Una regola con un ordine minore verrà applicata prima di una regola con un ordine maggiore. La regola con ordine 0 è una regola speciale. Non richiede alcuna condizione e le azioni elencate in esso verranno sempre applicate.

--origin-group

Nome o ID del OriginGroup che sostituirà il OriginGroup predefinito.

--preserve-unmatched-path

Se True, il percorso rimanente dopo il modello di origine verrà aggiunto al nuovo percorso di destinazione.

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

--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 la rete CDN memorizza nella cache le richieste che includono stringhe di query. È possibile ignorare le stringhe di query durante la memorizzazione nella cache, ignorare la memorizzazione nella cache per impedire che le richieste contenenti stringhe di query vengano memorizzate nella cache o memorizzare nella cache ogni richiesta con un URL univoco.

--redirect-protocol

Protocollo da usare per il reindirizzamento.

--redirect-type

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

--selector

Selettore della condizione di corrispondenza.

--source-pattern

Modello di URI della richiesta che identifica il tipo di richieste che possono essere riscritte.

--transforms

Trasformazione da applicare prima della corrispondenza. 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 rule delete

Eliminare una regola di recapito esistente all'interno di un set di regole.

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

Esempio

Rimuovere una regola con nome rule1.

az afd rule delete -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Parametri facoltativi

--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 --rule-name -n

Nome della regola di recapito univoca all'interno dell'endpoint.

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

--rule-set-name

Nome del set di regole nel profilo.

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

Elencare tutte le regole di recapito esistenti all'interno di un set di regole.

az afd rule list --profile-name
                 --resource-group
                 --rule-set-name
                 [--max-items]
                 [--next-token]

Esempio

Elencare tutte le route all'interno dell'endpoint specificato.

az afd route list -g group --profile-name profile --endpoint-name endpoint1

Parametri necessari

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

--rule-set-name

Nome del set di regole nel profilo.

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

Ottenere una regola di recapito esistente all'interno di un set di regole.

az afd rule show [--ids]
                 [--name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]

Esempio

visualizzare i dettagli della regola di recapito con nome rule1.

az afd rule show -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Parametri facoltativi

--ids

--name --rule-name -n

Nome della regola di recapito univoca all'interno dell'endpoint.

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

--rule-set-name

Nome del set di regole nel profilo.

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

Aggiornare una nuova regola di recapito all'interno del set di regole specificato.

az afd rule update [--actions]
                   [--add]
                   [--conditions]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--match-processing-behavior {Continue, Stop}]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--order]
                   [--profile-name]
                   [--remove]
                   [--resource-group]
                   [--rule-set-name]
                   [--set]
                   [--subscription]

Parametri facoltativi

--actions

Elenco di azioni eseguite quando vengono soddisfatte tutte le condizioni di una regola. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

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

--conditions

Elenco di condizioni che devono essere soddisfatte per l'esecuzione delle azioni Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

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

--ids

--match-processing-behavior

Se questa regola è una corrispondenza, il motore regole deve continuare a eseguire le regole rimanenti o arrestare. Se non è presente, l'impostazione predefinita è Continua.

valori accettati: Continue, Stop

--name --rule-name -n

Nome della regola di recapito univoca all'interno dell'endpoint.

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

--order

Ordine in cui vengono applicate le regole per l'endpoint. Valori possibili {0,1,2,3,Ã^Æ'Ã†â€™Ããâ€šÃ'Â^Ãããæ'Ã'Ã'Â^Ãã\Ã^â¢šÂ\... Â¡Ããâ€šÃ'Â^ÃæÆ'Ã^â'Å¡Ããâ€šÃ'Â^Ããã'Ã†â€™Ãââ€šÃ'Â^Ãã'Ãã'Ãã'Ããâ¢â¢šÂ^Ã... Â¡Ããâ€šÃ'Â^ÃæÆ'Ã^â'Å¡Ããâ€šÃ'Â^Ããã'Ã†â€™Ãââ€šÃ'Â^Ãã'Ãã'Ãã'Ããâ¢â¢šÂ^Ã... Â¡Ãã€šÃ'Â^ÃæÆ'Ã'Â'Â'Å¡Ãââ€šÃ'Â}. Una regola con un ordine minore verrà applicata prima di una regola con un ordine maggiore. La regola con ordine 0 è una regola speciale. Non richiede alcuna condizione e le azioni elencate in esso verranno sempre applicate.

--profile-name

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

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

Nome del set di regole nel profilo.

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

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

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

az afd rule wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--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

--exists

Attendere che la risorsa esista.

valore predefinito: False

--ids

--interval

Intervallo di polling in secondi.

valore predefinito: 30

--name --rule-name -n

Nome della regola di recapito univoca all'interno dell'endpoint.

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

--rule-set-name

Nome del set di regole nel profilo.

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

Condividi tramite

az afd rule

Comandi

az afd rule create

Esempio

Parametri necessari

Parametri facoltativi

az afd rule delete

Esempio

Parametri facoltativi

az afd rule list

Esempio

Parametri necessari

Parametri facoltativi

az afd rule show

Esempio

Parametri facoltativi

az afd rule update

Parametri facoltativi

az afd rule wait

Parametri facoltativi

Risorse aggiuntive