az network front-door routing-rule
Note
Deze verwijzing maakt deel uit van de front-door-extensie voor de Azure CLI (versie 2.70.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az network front-door routing-rule opdracht uitvoert. Meer informatie over uitbreidingen.
Regels voor Front Door-routering beheren.
Opdracht
| Name | Description | Type | Status |
|---|---|---|---|
| az network front-door routing-rule create |
Maak een Front Door-routeringsregel. |
Extension | GA |
| az network front-door routing-rule delete |
Verwijder een Regel voor Front Door-routering. |
Extension | GA |
| az network front-door routing-rule list |
Lijst met regels voor Front Door-routering. |
Extension | GA |
| az network front-door routing-rule show |
Haal de details van een Front Door-routeringsregel op. |
Extension | GA |
| az network front-door routing-rule update |
Een Regel voor doorsturen van Front Door bijwerken. |
Extension | GA |
az network front-door routing-rule create
Maak een Front Door-routeringsregel.
Maak een Front Door-routeringsregel om de aanvragen door te sturen naar een back-end of om de gebruikers om te leiden naar een andere URL.
Voorbeeld 1: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1
Voorbeeld 2: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string querystring.
az network front-door routing-rule create --front-door-name
--frontend-endpoints
--name
--resource-group
--route-type {Forward, Redirect}
[--accepted-protocols]
[--backend-pool]
[--cache-duration]
[--caching {Disabled, Enabled}]
[--custom-forwarding-path]
[--custom-fragment]
[--custom-host]
[--custom-path]
[--custom-query-string]
[--disabled {false, true}]
[--dynamic-compression {Disabled, Enabled}]
[--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
[--patterns]
[--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
[--query-parameters]
[--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
[--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
[--rules-engine]
Vereiste parameters
Naam van de Front Door.
Door spaties gescheiden lijst met front-endeindpuntnamen of id's.
Naam van de routeringsregel.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Routetype om te definiƫren hoe Front Door aanvragen voor deze route moet verwerken, bijvoorbeeld doorsturen naar een back-end of de gebruikers omleiden naar een andere URL.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Routing Rule Arguments |
| Geaccepteerde waarden: | Forward, Redirect |
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Door spaties gescheiden lijst met protocollen die moeten worden geaccepteerd. Standaard: Http.
Naam of id van een back-endpool. Het is vereist om een doorsturende regel te maken.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
De duur waarvoor de inhoud in de cache moet worden opgeslagen. Toegestane indeling is ISO 8601 duur.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
Of caching voor deze route moet worden ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | Disabled, Enabled |
Aangepast pad dat wordt gebruikt voor het herschrijven van resourcepaden die overeenkomen met deze regel. Laat leeg om het binnenkomende pad te gebruiken.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
Fragment dat moet worden toegevoegd aan de omleidings-URL. Fragment is het deel van de URL die na #komt. Neem het #-bestand niet op.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
Host om te leiden. Laat leeg om de binnenkomende host te gebruiken als doelhost.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
Het volledige pad om om te leiden. Pad mag niet leeg zijn en moet beginnen met /. Laat leeg om het binnenkomende pad als doelpad te gebruiken.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
De set queryreeksen die in de omleidings-URL moeten worden geplaatst. Als u deze waarde instelt, wordt elke bestaande querytekenreeks vervangen; laat leeg om de binnenkomende queryreeks te behouden. De querytekenreeks moet een <key>=<value> indeling hebben. De eerste? en & wordt automatisch toegevoegd, dus neem ze niet op aan de voorkant, maar scheid meerdere queryreeksen met &.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
Maken in een uitgeschakelde status.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | false, true |
Gebruik dynamische compressie voor inhoud in de cache.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | Disabled, Enabled |
Protocol dat moet worden gebruikt voor het doorsturen van verkeer.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | HttpOnly, HttpsOnly, MatchRequest |
Door ruimte gescheiden lijst met patronen die overeenkomen. Standaard: /*.
Behandeling van URL-querytermen bij het vormen van de cachesleutel.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | StripAll, StripAllExcept, StripNone, StripOnly |
Queryparameters die moeten worden opgenomen of uitgesloten (door komma's gescheiden) bij het gebruik van respectievelijk het type StripAllExcept of StripOnly.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
Het protocol van de bestemming waarnaar het verkeer wordt omgeleid.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
| Default value: | MatchRequest |
| Geaccepteerde waarden: | HttpOnly, HttpsOnly, MatchRequest |
Het omleidingstype dat door de regel wordt gebruikt bij het omleiden van verkeer.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
| Default value: | Moved |
| Geaccepteerde waarden: | Found, Moved, PermanentRedirect, TemporaryRedirect |
Naam of id van een configuratie van de regelengine. Als u de eigenschap '--remove rulesEngine' wilt ontkoppelen.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az network front-door routing-rule delete
Verwijder een Regel voor Front Door-routering.
az network front-door routing-rule delete --front-door-name
--name
--resource-group
Vereiste parameters
Naam van de Front Door.
Naam van de routeringsregel.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az network front-door routing-rule list
Lijst met regels voor Front Door-routering.
az network front-door routing-rule list --front-door-name
--resource-group
Vereiste parameters
Naam van de Front Door.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az network front-door routing-rule show
Haal de details van een Front Door-routeringsregel op.
az network front-door routing-rule show --front-door-name
--name
--resource-group
Vereiste parameters
Naam van de Front Door.
Naam van de routeringsregel.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az network front-door routing-rule update
Een Regel voor doorsturen van Front Door bijwerken.
az network front-door routing-rule update --front-door-name
--name
--resource-group
[--accepted-protocols]
[--add]
[--backend-pool]
[--cache-duration]
[--caching {Disabled, Enabled}]
[--custom-forwarding-path]
[--custom-fragment]
[--custom-host]
[--custom-path]
[--custom-query-string]
[--dynamic-compression {Disabled, Enabled}]
[--enabled {Disabled, Enabled}]
[--force-string]
[--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
[--frontend-endpoints]
[--patterns]
[--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
[--query-parameters]
[--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
[--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
[--remove]
[--rules-engine]
[--set]
Vereiste parameters
Naam van de Front Door.
Naam van de routeringsregel.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Door spaties gescheiden lijst met protocollen die moeten worden geaccepteerd. Standaard: Http.
Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Generic Update Arguments |
| Default value: | [] |
Naam of id van een back-endpool. Het is vereist om een doorsturende regel te maken.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
De duur waarvoor de inhoud in de cache moet worden opgeslagen. Toegestane indeling is ISO 8601 duur.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
Of caching voor deze route moet worden ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | Disabled, Enabled |
Aangepast pad dat wordt gebruikt voor het herschrijven van resourcepaden die overeenkomen met deze regel. Laat leeg om het binnenkomende pad te gebruiken.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
Fragment dat moet worden toegevoegd aan de omleidings-URL. Fragment is het deel van de URL die na #komt. Neem het #-bestand niet op.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
Host om te leiden. Laat leeg om de binnenkomende host te gebruiken als doelhost.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
Het volledige pad om om te leiden. Pad mag niet leeg zijn en moet beginnen met /. Laat leeg om het binnenkomende pad als doelpad te gebruiken.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
De set queryreeksen die in de omleidings-URL moeten worden geplaatst. Als u deze waarde instelt, wordt elke bestaande querytekenreeks vervangen; laat leeg om de binnenkomende queryreeks te behouden. De querytekenreeks moet een <key>=<value> indeling hebben. De eerste? en & wordt automatisch toegevoegd, dus neem ze niet op aan de voorkant, maar scheid meerdere queryreeksen met &.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
Gebruik dynamische compressie voor inhoud in de cache.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | Disabled, Enabled |
Status ingeschakeld.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Probe Setting Arguments |
| Geaccepteerde waarden: | Disabled, Enabled |
Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Generic Update Arguments |
| Default value: | False |
Protocol dat moet worden gebruikt voor het doorsturen van verkeer.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | HttpOnly, HttpsOnly, MatchRequest |
Door spaties gescheiden lijst met front-endeindpuntnamen of id's.
Door ruimte gescheiden lijst met patronen die overeenkomen. Standaard: /*.
Behandeling van URL-querytermen bij het vormen van de cachesleutel.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
| Geaccepteerde waarden: | StripAll, StripAllExcept, StripNone, StripOnly |
Queryparameters die moeten worden opgenomen of uitgesloten (door komma's gescheiden) bij het gebruik van respectievelijk het type StripAllExcept of StripOnly.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Forward Routing Rule Arguments |
Het protocol van de bestemming waarnaar het verkeer wordt omgeleid.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
| Geaccepteerde waarden: | HttpOnly, HttpsOnly, MatchRequest |
Het omleidingstype dat door de regel wordt gebruikt bij het omleiden van verkeer.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Redirect Routing Rule Arguments |
| Geaccepteerde waarden: | Found, Moved, PermanentRedirect, TemporaryRedirect |
Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Generic Update Arguments |
| Default value: | [] |
Naam of id van een configuratie van de regelengine. Als u de eigenschap '--remove rulesEngine' wilt ontkoppelen.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Generic Update Arguments |
| Default value: | [] |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |