az afd route

  • Referens

Hantera vägar under en AFD-slutpunkt.

Kommandon

Name Description Typ Status
az afd route create

Skapa en ny väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

 Kärna Allmän tillgänglighet
az afd route delete

Ta bort en befintlig väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

 Kärna Allmän tillgänglighet
az afd route list

Visa en lista över alla befintliga ursprung i en profil.

 Kärna Allmän tillgänglighet
az afd route show

Hämta en befintlig väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

 Kärna Allmän tillgänglighet
az afd route update

Uppdatera en ny väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

 Kärna Allmän tillgänglighet
az afd route wait

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

 Kärna Allmän tillgänglighet

az afd route create

Skapa en ny väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

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]

Exempel

Skapar en väg för att associera slutpunktens standarddomän med en ursprungsgrupp för alla HTTPS-begäranden.

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

Skapar en väg för att associera slutpunktens standarddomän med en ursprungsgrupp för alla begäranden och använder de angivna regeluppsättningarna för att anpassa routningsbeteendet.

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

Skapar en väg för att associera slutpunktens standarddomän och en anpassad domän med en ursprungsgrupp för alla begäranden med de angivna sökvägsmönstren och omdirigera alla trafic för att använda 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

Obligatoriska parametrar

--endpoint-name

Namnet på slutpunkten under profilen som är unik globalt.

--name --route-name -n

Namn på routningsregeln.

--profile-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--content-types-to-compress

Lista över innehållstyper som komprimering gäller för. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--custom-domains

Anpassade domäner som refereras av den här slutpunkten. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--enable-caching

Anger om cachelagring ska sparas på den vägen.

accepterade 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 "falsk". 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 det begärda innehållet är mindre än 1 byte eller större än 1 MB.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade".

accepterade värden: Disabled, Enabled
--forwarding-protocol

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

accepterade värden: HttpOnly, HttpsOnly, MatchRequest
standardvärde: MatchRequest
--https-redirect

Om HTTP-trafik ska omdirigeras automatiskt till HTTPS-trafik. Observera att det här är ett enkelt sätt att konfigurera den här regeln och att det blir den första regeln som körs.

accepterade värden: Disabled, Enabled
standardvärde: Disabled
--link-to-default-domain

Om den här vägen ska länkas till standardslutpunktsdomänen.

accepterade värden: Disabled, Enabled
standardvärde: Disabled
--no-wait

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

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Namn eller ID för den ursprungsgrupp som ska associeras med.

--origin-path

En katalogsökväg på ursprunget som AzureFrontDoor kan använda för att hämta innehåll från, t.ex. contoso.cloudapp.net/originpath.

--patterns-to-match

Regelns vägmönster. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--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 Frontdoor cachelagrar begäranden som innehåller frågesträngar. Du kan ignorera alla frågesträngar vid cachelagring, ignorera specifika frågesträngar, cachelagra varje begäran med en unik URL eller cachelagra specifika frågesträngar.

--rule-sets

Samling med ID eller namn på regeluppsättningen som refereras av vägen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--supported-protocols

Lista över protokoll som stöds för den här vägen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

standardvärde: ['Http', 'Https']
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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az afd route delete

Ta bort en befintlig väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

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]

Exempel

Ta bort en väg med namnet route1.

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

Valfria parametrar

--endpoint-name

Namnet på slutpunkten under profilen som är unik globalt.

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

Namn på routningsregeln.

--no-wait

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

accepterade 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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az afd route list

Visa en lista över alla befintliga ursprung i en profil.

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

Obligatoriska parametrar

--endpoint-name

Namnet på slutpunkten under profilen som är unik globalt.

--profile-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

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

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az afd route show

Hämta en befintlig väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

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

Valfria parametrar

--endpoint-name

Namnet på slutpunkten under profilen som är unik globalt.

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

Namn på routningsregeln.

--profile-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az afd route update

Uppdatera en ny väg med det angivna vägnamnet under den angivna prenumerationen, resursgruppen, profilen och AzureFrontDoor-slutpunkten.

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]

Exempel

Uppdatera en väg för att acceptera både Http- och Https-begäranden och omdirigera alla trafic för att använda Https.

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

Uppdatera inställningarna för en vägs regeluppsättningar för att anpassa routningsbeteendet.

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

Uppdatera komprimeringsinställningarna för en väg för att aktivera komprimering för de angivna innehållstyperna.

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

Valfria parametrar

--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 eller JSON string>.

--content-types-to-compress

Lista över innehållstyper som komprimering gäller för. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--custom-domains

Anpassade domäner som refereras av den här slutpunkten. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--enable-caching

Anger om cachelagring ska sparas på den vägen.

accepterade 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 det begärda innehållet är mindre än 1 byte eller större än 1 MB.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade".

accepterade värden: Disabled, Enabled
--endpoint-name

Namnet på slutpunkten under profilen som är unik globalt.

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

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

accepterade värden: HttpOnly, HttpsOnly, MatchRequest
--https-redirect

Om HTTP-trafik ska omdirigeras automatiskt till HTTPS-trafik. Observera att det här är ett enkelt sätt att konfigurera den här regeln och att det blir den första regeln som körs.

accepterade värden: Disabled, Enabled
--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.

--link-to-default-domain

Om den här vägen ska länkas till standardslutpunktsdomänen.

accepterade värden: Disabled, Enabled
--name --route-name -n

Namn på routningsregeln.

--no-wait

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

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Namn eller ID för den ursprungsgrupp som ska associeras med.

--origin-path

En katalogsökväg på ursprunget som AzureFrontDoor kan använda för att hämta innehåll från, t.ex. contoso.cloudapp.net/originpath.

--patterns-to-match

Regelns vägmönster. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--profile-name

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

--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 Frontdoor cachelagrar begäranden som innehåller frågesträngar. Du kan ignorera alla frågesträngar vid cachelagring, ignorera specifika frågesträngar, cachelagra varje begäran med en unik URL eller cachelagra specifika frågesträngar.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--rule-sets

Samling med ID eller namn på regeluppsättningen som refereras av vägen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--set

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--supported-protocols

Lista över protokoll som stöds för den här vägen. 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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az afd route wait

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

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

Namnet på slutpunkten under profilen som är unik globalt.

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

Namn på routningsregeln.

--profile-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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