Sdílet prostřednictvím

az afd route

  • Reference

Spravujte trasy v rámci koncového bodu AFD.

Příkazy

Name Description Typ Stav
az afd route create

Vytvořte novou trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

 Základ GA
az afd route delete

Odstraňte existující trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

 Základ GA
az afd route list

Zobrazí seznam všech existujících zdrojů v rámci profilu.

 Základ GA
az afd route show

Získejte existující trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

 Základ GA
az afd route update

Aktualizujte novou trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

 Základ GA
az afd route wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

 Základ GA

az afd route create

Vytvořte novou trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

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]

Příklady

Vytvoří trasu pro přidružení výchozí domény koncového bodu ke skupině původu pro všechny požadavky 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

Vytvoří trasu pro přidružení výchozí domény koncového bodu ke skupině původu pro všechny požadavky a použití zadaných sad pravidel k přizpůsobení chování trasy.

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

Vytvoří trasu, která přidruží výchozí doménu koncového bodu a vlastní doménu ke skupině původu pro všechny požadavky se zadanými vzory cesty a přesměruje všechny trafické na používání protokolu 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

Povinné parametry

--endpoint-name

Název koncového bodu pod profilem, který je globálně jedinečný.

--name --route-name -n

Název pravidla směrování

--profile-name

Název profilu Azure Front Door Standard nebo Azure Front Door Premium, který je jedinečný v rámci skupiny prostředků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--content-types-to-compress

Seznam typů obsahu, na které se komprese vztahuje. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--custom-domains

Vlastní domény odkazované tímto koncovým bodem Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--enable-caching

Určuje, jestli je ukládání do mezipaměti na této trase zahlcené.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Určuje, jestli je v AzureFrontDoor povolená komprese obsahu. Výchozí hodnotou je false. Pokud je povolená komprese, obsah se bude obsluhovat jako komprimovaný, pokud uživatel požádá o komprimovanou verzi. Obsah se nebude komprimovat u požadovaného obsahu AzureFrontDoorwhen menší než 1 bajt nebo větší než 1 MB.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Zda chcete povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno).

přijímané hodnoty: Disabled, Enabled
--forwarding-protocol

Toto pravidlo se použije při předávání provozu do back-endů.

přijímané hodnoty: HttpOnly, HttpsOnly, MatchRequest
výchozí hodnota: MatchRequest
--https-redirect

Určuje, jestli se má automaticky přesměrovat provoz HTTP na provoz HTTPS. Všimněte si, že toto pravidlo je snadný způsob, jak toto pravidlo nastavit a bude prvním pravidlem, které se spustí.

přijímané hodnoty: Disabled, Enabled
výchozí hodnota: Disabled
--link-to-default-domain

Určuje, jestli bude tato trasa propojená s výchozí doménou koncového bodu.

přijímané hodnoty: Disabled, Enabled
výchozí hodnota: Disabled
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Název nebo ID skupiny původu, ke které se má přidružit.

--origin-path

Cesta k adresáři v původu, ze kterého může AzureFrontDoor načíst obsah, např. contoso.cloudapp.net/originpath.

--patterns-to-match

Vzory tras pravidla. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--query-parameters

Parametry dotazu, které se mají zahrnout nebo vyloučit Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--query-string-caching-behavior

Definuje, jak frontdoor ukládá požadavky, které zahrnují řetězce dotazů. Při ukládání do mezipaměti můžete ignorovat všechny řetězce dotazů, ignorovat konkrétní řetězce dotazů, ukládat každý požadavek do mezipaměti s jedinečnou adresou URL nebo ukládat do mezipaměti konkrétní řetězce dotazu.

--rule-sets

Kolekce ID nebo názvu sady pravidel odkazované trasou Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--supported-protocols

Seznam podporovaných protokolů pro tuto trasu Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

výchozí hodnota: ['Http', 'Https']
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az afd route delete

Odstraňte existující trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

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]

Příklady

Odstraňte trasu s názvem route1.

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

Volitelné parametry

--endpoint-name

Název koncového bodu pod profilem, který je globálně jedinečný.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name --route-name -n

Název pravidla směrování

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Název profilu Azure Front Door Standard nebo Azure Front Door Premium, který je jedinečný v rámci skupiny prostředků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--yes -y

Nezotvádejte výzvu k potvrzení.

výchozí hodnota: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az afd route list

Zobrazí seznam všech existujících zdrojů v rámci profilu.

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

Povinné parametry

--endpoint-name

Název koncového bodu pod profilem, který je globálně jedinečný.

--profile-name

Název profilu Azure Front Door Standard nebo Azure Front Door Premium, který je jedinečný v rámci skupiny prostředků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--max-items

Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Chcete-li obnovit stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

--next-token

Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az afd route show

Získejte existující trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

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

Volitelné parametry

--endpoint-name

Název koncového bodu pod profilem, který je globálně jedinečný.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name --route-name -n

Název pravidla směrování

--profile-name

Název profilu Azure Front Door Standard nebo Azure Front Door Premium, který je jedinečný v rámci skupiny prostředků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az afd route update

Aktualizujte novou trasu se zadaným názvem trasy pod zadaným předplatným, skupinou prostředků, profilem a koncovým bodem AzureFrontDoor.

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]

Příklady

Aktualizujte trasu tak, aby přijímala požadavky HTTP i HTTPS, a přesměrovává všechny trafické na používání protokolu HTTPS.

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

Aktualizace nastavení sady pravidel trasy pro přizpůsobení chování trasy

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

Aktualizujte nastavení komprese trasy, aby se povolila komprese pro zadané typy obsahu.

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

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, řetězec nebo řetězec> JSON.

--content-types-to-compress

Seznam typů obsahu, na které se komprese vztahuje. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--custom-domains

Vlastní domény odkazované tímto koncovým bodem Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--enable-caching

Určuje, jestli je ukládání do mezipaměti na této trase zahlcené.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Určuje, jestli je v AzureFrontDoor povolená komprese obsahu. Výchozí hodnota je false. Pokud je povolená komprese, obsah se bude obsluhovat jako komprimovaný, pokud uživatel požádá o komprimovanou verzi. Obsah se nebude komprimovat u požadovaného obsahu AzureFrontDoorwhen menší než 1 bajt nebo větší než 1 MB.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Zda chcete povolit použití tohoto pravidla. Povolené hodnoty jsou Enabled (Povoleno) nebo Disabled (Zakázáno).

přijímané hodnoty: Disabled, Enabled
--endpoint-name

Název koncového bodu pod profilem, který je globálně jedinečný.

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Toto pravidlo se použije při předávání provozu do back-endů.

přijímané hodnoty: HttpOnly, HttpsOnly, MatchRequest
--https-redirect

Určuje, jestli se má automaticky přesměrovat provoz HTTP na provoz HTTPS. Všimněte si, že toto pravidlo je snadný způsob, jak toto pravidlo nastavit a bude prvním pravidlem, které se spustí.

přijímané hodnoty: Disabled, Enabled
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--link-to-default-domain

Určuje, jestli bude tato trasa propojená s výchozí doménou koncového bodu.

přijímané hodnoty: Disabled, Enabled
--name --route-name -n

Název pravidla směrování

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

přijímané hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Název nebo ID skupiny původu, ke které se má přidružit.

--origin-path

Cesta k adresáři v původu, ze kterého může AzureFrontDoor načíst obsah, např. contoso.cloudapp.net/originpath.

--patterns-to-match

Vzory tras pravidla. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--profile-name

Název profilu Azure Front Door Standard nebo Azure Front Door Premium, který je jedinečný v rámci skupiny prostředků.

--query-parameters

Parametry dotazu, které se mají zahrnout nebo vyloučit Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--query-string-caching-behavior

Definuje, jak frontdoor ukládá požadavky, které zahrnují řetězce dotazů. Při ukládání do mezipaměti můžete ignorovat všechny řetězce dotazů, ignorovat konkrétní řetězce dotazů, ukládat každý požadavek do mezipaměti s jedinečnou adresou URL nebo ukládat do mezipaměti konkrétní řetězce dotazu.

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--rule-sets

Kolekce ID nebo názvu sady pravidel odkazované trasou Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--supported-protocols

Seznam podporovaných protokolů pro tuto trasu Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az afd route wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

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

Volitelné parametry

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

výchozí hodnota: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

výchozí hodnota: False
--endpoint-name

Název koncového bodu pod profilem, který je globálně jedinečný.

--exists

Počkejte, až prostředek existuje.

výchozí hodnota: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--interval

Interval dotazování v sekundách

výchozí hodnota: 30
--name --route-name -n

Název pravidla směrování

--profile-name

Název profilu Azure Front Door Standard nebo Azure Front Door Premium, který je jedinečný v rámci skupiny prostředků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--timeout

Maximální čekání v sekundách.

výchozí hodnota: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

výchozí hodnota: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.