Dela via

az afd rule

  • Referens

Hantera leveransregler inom den angivna regeluppsättningen.

Kommandon

Name Description Typ Status
az afd rule action

Hantera leveransregler inom den angivna regeluppsättningen.

 Kärna GA
az afd rule action add

Uppdatera en ny leveransregel i den angivna regeluppsättningen.

 Kärna GA
az afd rule action list

Hämta en befintlig leveransregel i en regeluppsättning.

 Kärna GA
az afd rule action remove

Uppdatera en ny leveransregel i den angivna regeluppsättningen.

 Kärna GA
az afd rule condition

Hantera leveransregler inom den angivna regeluppsättningen.

 Kärna GA
az afd rule condition add

Uppdatera en ny leveransregel i den angivna regeluppsättningen.

 Kärna GA
az afd rule condition list

Hämta en befintlig leveransregel i en regeluppsättning.

 Kärna GA
az afd rule condition remove

Uppdatera en ny leveransregel i den angivna regeluppsättningen.

 Kärna GA
az afd rule create

Skapa en ny leveransregel i den angivna regeluppsättningen.

 Kärna GA
az afd rule delete

Ta bort en befintlig leveransregel i en regeluppsättning.

 Kärna GA
az afd rule list

Visa en lista över alla befintliga leveransregler i en regeluppsättning.

 Kärna GA
az afd rule show

Hämta en befintlig leveransregel i en regeluppsättning.

 Kärna GA
az afd rule update

Uppdatera en ny leveransregel i den angivna regeluppsättningen.

 Kärna GA
az afd rule wait

Placera CLI i vänteläge tills ett villkor uppfylls.

 Kärna GA

az afd rule create

Skapa en ny leveransregel i den angivna regeluppsättningen.

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]

Exempel

Skapa en regel för att lägga till ett svarshuvud för begäranden från Thailand.

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

Skapa en regel för http till https-omdirigering

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

Obligatoriska parametrar

--name --rule-name -n

Namnet på leveransregeln som är unik inom slutpunkten.

--profile-name

Namnet på Azure Front Door Standard- eller Azure Front Door Premium-profilen som är unik i resursgruppen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rule-set-name

Namnet på regeluppsättningen under profilen.

Valfria parametrar

--action-name

Namnet på åtgärden för leveransregeln: https://learn.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions.

--cache-behavior

Cachelagringsbeteende för begäranden.

--cache-duration

Hur länge innehållet måste cachelagras. Det tillåtna formatet är hh:mm:ss.xxxxxx.

--custom-fragment

Fragment som ska läggas till i omdirigerings-URL:en.

--custom-hostname

Värd för omdirigering. Låt vara tom om du vill använda den inkommande värden som målvärd.

--custom-path

Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tom om du vill använda den inkommande sökvägen som måltlapp.

--custom-querystring

Den uppsättning frågesträngar som ska placeras i omdirigerings-URL:en.lämna tom för att bevara den inkommande frågesträngen.

--destination

Målsökvägen som ska användas i omskrivningen.

--enable-caching

Anger om cachelagring ska aktiveras på vägen.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Anger om innehållskomprimering är aktiverat på AzureFrontDoor. Standardvärdet är falskt. Om komprimering är aktiverat kommer innehållet att fungera som komprimerat om användaren begär en komprimerad version. Innehållet komprimeras inte på AzureFrontDoor när begärt innehåll är mindre än 8 MB eller större än 1 KB.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.

--header-action

Rubrikåtgärd för begäranden.

--header-name

Namnet på rubriken som ska ändras.

--header-value

Värdet för rubriken.

--match-processing-behavior

Om den här regeln är en matchning ska regelmotorn fortsätta att köra de återstående reglerna eller stoppa. Om det inte finns, är standardvärdet Fortsätt.

Godkända värden: Continue, Stop
Standardvärde: Continue
--match-values

Matcha värden för matchningsvillkoret. t.ex. blankstegsavgränsade värden "GET" "HTTP". Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--match-variable

Namnet på matchningsvillkoret: https://learn.microsoft.com/en-us/azure/frontdoor/rules-match-conditions.

--negate-condition

Om det är sant, negerar villkoret.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--operator

Operator för matchningsvillkoret.

--order

I vilken ordning reglerna tillämpas för slutpunkten. Möjliga värden {0,1,2,3,ââ'¬Â|ââ'¬Â¬Â¢Ã¢â'¬Â|}. En regel med en mindre ordning tillämpas före en regel med större ordning. Regel med ordning 0 är en särskild regel. Det kräver inte några villkor och åtgärder som anges i den kommer alltid att tillämpas.

--origin-group

Namn eller ID för Den OriginGroup som skulle åsidosätta standardvärdet OriginGroup.

--preserve-unmatched-path

Om sant läggs den återstående sökvägen efter källmönstret till i den nya målsökvägen.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--query-parameters

Frågeparametrar som ska inkluderas eller exkluderas. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--query-string-caching-behavior

Definierar hur CDN cachelagrar begäranden som innehåller frågesträngar. Du kan ignorera alla frågesträngar när du cachelagrar, kringgår cachelagring för att förhindra att begäranden som innehåller frågesträngar cachelagras eller cachelagrar varje begäran med en unik URL.

--redirect-protocol

Protokoll som ska användas för omdirigeringen.

--redirect-type

Omdirigeringstypen som regeln ska använda vid omdirigering av trafik.

--selector

Väljare för matchningsvillkoret.

--source-pattern

Ett URI-mönster för begäranden som identifierar den typ av begäranden som kan skrivas om.

--transforms

Transformera så att den tillämpas innan matchningen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az afd rule delete

Ta bort en befintlig leveransregel i en regeluppsättning.

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]

Exempel

Ta bort en regel med namnregel1.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --rule-name -n

Namnet på leveransregeln som är unik inom slutpunkten.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Namnet på Azure Front Door Standard- eller Azure Front Door Premium-profilen som är unik i resursgruppen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rule-set-name

Namnet på regeluppsättningen under profilen.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az afd rule list

Visa en lista över alla befintliga leveransregler i en regeluppsättning.

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

Exempel

Visa en lista över alla vägar inom den angivna slutpunkten.

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

Obligatoriska parametrar

--profile-name

Namnet på Azure Front Door Standard- eller Azure Front Door Premium-profilen som är unik i resursgruppen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rule-set-name

Namnet på regeluppsättningen under profilen.

Valfria parametrar

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argument för ett efterföljande kommando.

--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az afd rule show

Hämta en befintlig leveransregel i en regeluppsättning.

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

Exempel

visa information om leveransregeln med namnregel1.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --rule-name -n

Namnet på leveransregeln som är unik inom slutpunkten.

--profile-name

Namnet på Azure Front Door Standard- eller Azure Front Door Premium-profilen som är unik i resursgruppen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rule-set-name

Namnet på regeluppsättningen under profilen.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az afd rule update

Uppdatera en ny leveransregel i den angivna regeluppsättningen.

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]

Valfria parametrar

--actions

En lista över åtgärder som körs när alla villkor för en regel är uppfyllda. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

--conditions

En lista över villkor som måste matchas för att åtgärderna ska köras Stöder shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--match-processing-behavior

Om den här regeln är en matchning ska regelmotorn fortsätta att köra de återstående reglerna eller stoppa. Om det inte finns, är standardvärdet Fortsätt.

Godkända värden: Continue, Stop
--name --rule-name -n

Namnet på leveransregeln som är unik inom slutpunkten.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--order

I vilken ordning reglerna tillämpas för slutpunkten. Möjliga värden {0,1,2,3,ÃÆ'ƒÂÃ'¢ÃÆ'Ã'¢Ã¢â€Ã... ¡Ã‚Ã'¬ÃÆ'ââ'¬Å¡Ãƒâ€šÃ'Â|ÃÆ''ƒÂÃ'¢ÃÆ'Ã'¢Ã¢â‚¬Ã... ¡Ã‚Ã'¬ÃÆ'ââ'¬Å¡Ãƒâ€šÃ'Â|ÃÆ''ƒÂÃ'¢ÃÆ'Ã'¢Ã¢â‚¬Ã... ¡Ã‚Ã'¬ÃÆ'ââ'¬Å¡Ãƒâ€šÃ'Â|}. En regel med en mindre ordning tillämpas före en regel med större ordning. Regel med ordning 0 är en särskild regel. Det kräver inte några villkor och åtgärder som anges i den kommer alltid att tillämpas.

--profile-name

Namnet på Azure Front Door Standard- eller Azure Front Door Premium-profilen som är unik i resursgruppen.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rule-set-name

Namnet på regeluppsättningen under profilen.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az afd rule wait

Placera CLI i vänteläge tills ett villkor uppfylls.

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

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

Standardvärde: False
--exists

Vänta tills resursen finns.

Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--interval

Avsökningsintervall i sekunder.

Standardvärde: 30
--name --rule-name -n

Namnet på leveransregeln som är unik inom slutpunkten.

--profile-name

Namnet på Azure Front Door Standard- eller Azure Front Door Premium-profilen som är unik i resursgruppen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rule-set-name

Namnet på regeluppsättningen under profilen.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--timeout

Maximal väntetid i sekunder.

Standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.