Freigeben über

az network front-door routing-rule

  • Referenz

Hinweis

Diese Referenz ist Teil der Front-Door-Erweiterung für die Azure CLI (Version 2.57.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal einen Az-Front-Door-Routingregelbefehl ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Regeln für das Routing von Front Door.

Befehle

Name Beschreibung Typ Status
az network front-door routing-rule create

Erstellen Sie eine Vortür-Routingregel.

 Erweiterung Allgemein verfügbar
az network front-door routing-rule delete

Löschen einer Vortürroutingregel.

 Erweiterung Allgemein verfügbar
az network front-door routing-rule list

Regeln für die Weiterleitung von Vortüren auflisten.

 Erweiterung Allgemein verfügbar
az network front-door routing-rule show

Rufen Sie die Details einer Front Door-Routingregel ab.

 Erweiterung Allgemein verfügbar
az network front-door routing-rule update

Aktualisieren einer Vortürroutingregel.

 Erweiterung Allgemein verfügbar

az network front-door routing-rule create

Erstellen Sie eine Vortür-Routingregel.

Erstellen Sie eine Front Door-Routingregel, um die Anforderungen entweder an ein Back-End weiterzuleiten oder die Benutzer an eine andere URL umzuleiten.

Beispiel 1: az-Front-Door-Routingregel create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

Beispiel 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 query-query-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]

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--frontend-endpoints

Leerzeichentrennte Liste der Front-End-Endpunktnamen oder -IDs.

--name -n

Name der Routingregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--route-type

Route type to define how Front Door should handle requests for this route i.e. forward them to a backend or redirect the users to a different URL.

Zulässige Werte: Forward, Redirect

Optionale Parameter

--accepted-protocols

Durch Leerzeichen getrennte Liste der zu akzeptierenden Protokolle. Standard: HTTP.

--backend-pool

Name oder ID eines Back-End-Pools. Es ist erforderlich, eine Weiterleitungsregel zu erstellen.

--cache-duration

Die Dauer, für die der Inhalt zwischengespeichert werden muss. Zulässiges Format ist iso 8601 Dauer.

--caching

Gibt an, ob für diese Route Zwischenspeichern aktiviert werden soll.

Zulässige Werte: Disabled, Enabled
--custom-forwarding-path

Benutzerdefinierter Pfad zum Umschreiben von Ressourcenpfaden, die mit dieser Regel übereinstimmen. Machen Sie keine Angabe, um einen eingehenden Pfad zu verwenden.

--custom-fragment

Fragment, das der Umleitungs-URL hinzugefügt werden soll. Fragment ist der Teil der URL, die nach #kommt. Schließen Sie die Datei "#" nicht ein.

--custom-host

Host, der umgeleitet werden soll. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.

--custom-path

Der vollständige Pfad zur Umleitung. Der Pfad darf nicht leer sein und muss mit /beginnen. Lassen Sie leer, um den eingehenden Pfad als Zielpfad zu verwenden.

--custom-query-string

Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. Durch festlegen dieses Werts würde jede vorhandene Abfragezeichenfolge ersetzt; Lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten. Die Abfragezeichenfolge muss im = Format vorliegen. Die erste ? und & wird automatisch hinzugefügt, sodass sie nicht in den Vordergrund eingeschlossen werden, aber trennen Sie mehrere Abfragezeichenfolgen mit &.

--disabled

Erstellen sie in einem deaktivierten Zustand.

Zulässige Werte: false, true
--dynamic-compression

Verwenden Sie die dynamische Komprimierung für zwischengespeicherte Inhalte.

Zulässige Werte: Disabled, Enabled
--forwarding-protocol

Protokoll zur Weiterleitung von Datenverkehr.

Zulässige Werte: HttpOnly, HttpsOnly, MatchRequest
--patterns

Mit Leerzeichen getrennte Liste von Mustern, die übereinstimmen sollen. Standard: '/*'.

--query-parameter-strip-directive

Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

Zulässige Werte: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen (durch Trennzeichen getrennt), wenn sie den Typ StripAllExcept oder StripOnly verwenden.

--redirect-protocol

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird.

Zulässige Werte: HttpOnly, HttpsOnly, MatchRequest
Standardwert: MatchRequest
--redirect-type

Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

Zulässige Werte: Found, Moved, PermanentRedirect, TemporaryRedirect
Standardwert: Moved
--rules-engine

Name oder ID einer Regelmodulkonfiguration. Um die Verknüpfungseigenschaft aufzuheben, "--remove rulesEngine".

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az network front-door routing-rule delete

Löschen einer Vortürroutingregel.

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--name -n

Name der Routingregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az network front-door routing-rule list

Regeln für die Weiterleitung von Vortüren auflisten.

az network front-door routing-rule list --front-door-name
                                        --resource-group

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az network front-door routing-rule show

Rufen Sie die Details einer Front Door-Routingregel ab.

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--name -n

Name der Routingregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az network front-door routing-rule update

Aktualisieren einer Vortürroutingregel.

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]

Erforderliche Parameter

--front-door-name -f

Name der Vordertür.

--name -n

Name der Routingregel.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--accepted-protocols

Durch Leerzeichen getrennte Liste der zu akzeptierenden Protokolle. Standard: HTTP.

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--backend-pool

Name oder ID eines Back-End-Pools. Es ist erforderlich, eine Weiterleitungsregel zu erstellen.

--cache-duration

Die Dauer, für die der Inhalt zwischengespeichert werden muss. Zulässiges Format ist iso 8601 Dauer.

--caching

Gibt an, ob für diese Route Zwischenspeichern aktiviert werden soll.

Zulässige Werte: Disabled, Enabled
--custom-forwarding-path

Benutzerdefinierter Pfad zum Umschreiben von Ressourcenpfaden, die mit dieser Regel übereinstimmen. Machen Sie keine Angabe, um einen eingehenden Pfad zu verwenden.

--custom-fragment

Fragment, das der Umleitungs-URL hinzugefügt werden soll. Fragment ist der Teil der URL, die nach #kommt. Schließen Sie die Datei "#" nicht ein.

--custom-host

Host, der umgeleitet werden soll. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.

--custom-path

Der vollständige Pfad zur Umleitung. Der Pfad darf nicht leer sein und muss mit /beginnen. Lassen Sie leer, um den eingehenden Pfad als Zielpfad zu verwenden.

--custom-query-string

Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. Durch festlegen dieses Werts würde jede vorhandene Abfragezeichenfolge ersetzt; Lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten. Die Abfragezeichenfolge muss im = Format vorliegen. Die erste ? und & wird automatisch hinzugefügt, sodass sie nicht in den Vordergrund eingeschlossen werden, aber trennen Sie mehrere Abfragezeichenfolgen mit &.

--dynamic-compression

Verwenden Sie die dynamische Komprimierung für zwischengespeicherte Inhalte.

Zulässige Werte: Disabled, Enabled
--enabled

Aktivierter Status.

Zulässige Werte: Disabled, Enabled
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--forwarding-protocol

Protokoll zur Weiterleitung von Datenverkehr.

Zulässige Werte: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Leerzeichentrennte Liste der Front-End-Endpunktnamen oder -IDs.

--patterns

Mit Leerzeichen getrennte Liste von Mustern, die übereinstimmen sollen. Standard: '/*'.

--query-parameter-strip-directive

Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

Zulässige Werte: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen (durch Trennzeichen getrennt), wenn sie den Typ StripAllExcept oder StripOnly verwenden.

--redirect-protocol

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird.

Zulässige Werte: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

Zulässige Werte: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--rules-engine

Name oder ID einer Regelmodulkonfiguration. Um die Verknüpfungseigenschaft aufzuheben, "--remove rulesEngine".

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.