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.

 Jádro GHANŠTINA
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.

 Jádro GHANŠTINA
az afd route list

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

 Jádro GHANŠTINA
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.

 Jádro GHANŠTINA
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.

 Jádro GHANŠTINA
az afd route wait

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

 Jádro GHANŠTINA

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 na této trase povolené ukládání do mezipaměti.

Přípustné 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 nebude komprimován u požadovaného obsahu AzureFrontDoorwhen menší než 8 MB nebo větší než 1 kB.

Přípustné 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řípustné hodnoty: Disabled, Enabled
--forwarding-protocol

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

Přípustné hodnoty: HttpOnly, HttpsOnly, MatchRequest
Default value: 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řípustné hodnoty: Disabled, Enabled
Default value: Disabled
--link-to-default-domain

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

Přípustné hodnoty: Disabled, Enabled
Default value: Disabled
--no-wait

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

Přípustné 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.

Default value: ['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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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řípustné 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í.

Default value: 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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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. Pokud chcete pokračovat ve 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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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, string or JSON string>.

--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 na této trase povolené ukládání do mezipaměti.

Přípustné 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 nebude komprimován u požadovaného obsahu AzureFrontDoorwhen menší než 8 MB nebo větší než 1 kB.

Přípustné 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řípustné 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řípustné 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řípustné 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řípustné 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řípustné hodnoty: Disabled, Enabled
--name --route-name -n

Název pravidla směrování

--no-wait

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

Přípustné 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 <indexToRemove> 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=<value>.

--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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

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

Default value: 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í.

Default value: False
--endpoint-name

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

--exists

Počkejte, až prostředek existuje.

Default value: 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

Default value: 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.

Default value: 3600
--updated

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

Default value: 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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

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