az afd rule

Referenz

Verwalten von Übermittlungsregeln innerhalb des angegebenen Regelsatzes.

Befehle

az afd rule action	Verwalten von Übermittlungsregelaktionen für eine Regel.
az afd rule action add	Fügen Sie einer Übermittlungsregel eine Aktion hinzu.
az afd rule action list	Anzeigen von Aktionen, die mit der Regel verbunden sind.
az afd rule action remove	Entfernen einer Aktion aus einer Übermittlungsregel
az afd rule condition	Verwalten von Lieferregelbedingungen für eine Regel.
az afd rule condition add	Fügen Sie einer Übermittlungsregel eine Bedingung hinzu.
az afd rule condition list	Mit der Regel verbundene Kondtionen anzeigen.
az afd rule condition remove	Entfernen einer Bedingung aus einer Übermittlungsregel.
az afd rule create	Erstellt eine neue Übermittlungsregel innerhalb des angegebenen Regelsatzes.
az afd rule delete	Entfernen einer Übermittlungsregel aus regelsatz.
az afd rule list	Listet alle vorhandenen Übermittlungsregeln innerhalb eines Regelsatzes auf.
az afd rule show	Anzeigen von Übermittlungsregeldetails.

az afd rule create

Erstellt eine neue Übermittlungsregel innerhalb des angegebenen Regelsatzes.

az afd rule create --action-name {ModifyRequestHeader, ModifyResponseHeader, RouteConfigurationOverride, UrlRedirect, UrlRewrite}
                   --order
                   --profile-name
                   --resource-group
                   --rule-name
                   --rule-set-name
                   [--cache-behavior {HonorOrigin, OverrideAlways, OverrideIfOriginMissing}]
                   [--cache-duration]
                   [--custom-fragment]
                   [--custom-hostname]
                   [--custom-path]
                   [--custom-querystring]
                   [--destination]
                   [--enable-caching {false, true}]
                   [--enable-compression {false, true}]
                   [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                   [--header-action {Append, Delete, Overwrite}]
                   [--header-name]
                   [--header-value]
                   [--match-processing-behavior {Continue, Stop}]
                   [--match-values]
                   [--match-variable {ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath}]
                   [--negate-condition {false, true}]
                   [--operator]
                   [--origin-group]
                   [--preserve-unmatched-path {false, true}]
                   [--query-parameters]
                   [--query-string-caching-behavior {IgnoreQueryString, IgnoreSpecifiedQueryStrings, IncludeSpecifiedQueryStrings, UseQueryString}]
                   [--redirect-protocol {Http, Https, MatchRequest}]
                   [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                   [--selector]
                   [--source-pattern]
                   [--transforms {Lowercase, RemoveNulls, Trim, Uppercase, UrlDecode, UrlEncode}]

Beispiele

Erstellen Sie eine Regel, um einen Antwortheader für Anforderungen aus Thailand anzufügen.

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 2 --match-variable RemoteAddress --operator GeoMatch --match-values TH --rule-name disablecahing --action-name ModifyResponseHeader --header-action Append --header-name X-CDN --header-value AFDX

Erstellen einer Regel für http zu https-Umleitung

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

Erforderliche Parameter

--action-name

Der Name der Aktion für die Übermittlungsregel: https://docs.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions.

Zulässige Werte: ModifyRequestHeader, ModifyResponseHeader, RouteConfigurationOverride, UrlRedirect, UrlRewrite

--order

Die Reihenfolge, in der die Regeln für den Endpunkt angewendet werden. Mögliche Werte {0,1,2,3,.........}. Eine Regel mit einer niedrigeren Reihenfolge wird vor einer mit höherer Reihenfolge angewendet. Regel mit Reihenfolge 0 ist eine spezielle Regel. Es erfordert keine Bedingung und Aktionen, die darin aufgeführt sind, werden immer angewendet.

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--rule-name

Name der Regel.

--rule-set-name

Name des Regelsatzes.

Optionale Parameter

--cache-behavior

Zwischenspeicherungsverhalten für die Anforderungen.

Zulässige Werte: HonorOrigin, OverrideAlways, OverrideIfOriginMissing

--cache-duration

Die Dauer, für die der Inhalt zwischengespeichert werden muss. Zulässiges Format ist [d.]hh:mm:ss.

--custom-fragment

Fragment, das der Umleitungs-URL hinzugefügt werden soll.

--custom-hostname

Host zum Umleiten. 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-querystring

Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten.

--destination

Der Zielpfad, der im Umschreiben verwendet werden soll.

--enable-caching

Gibt an, ob das Zwischenspeichern auf der Route aktiviert werden soll.

Zulässige Werte: false, true

--enable-compression

Gibt an, ob die Inhaltskomprimierung in AzureFrontDoor aktiviert ist. Der Standardwert ist „false“. Wenn die Komprimierung aktiviert ist, wird der Inhalt als komprimiert bereitgestellt, wenn der Benutzer eine komprimierte Version anfordert. Inhalte werden in AzureFrontDoor nicht komprimiert, wenn angeforderte Inhalte kleiner als 1 Byte oder größer als 1 MB sind.

Zulässige Werte: false, true

--forwarding-protocol

Protokollieren Sie diese Regel, wenn Sie Datenverkehr an Back-Ends weiterleiten.

Zulässige Werte: HttpOnly, HttpsOnly, MatchRequest

--header-action

Kopfzeilenaktion für die Anforderungen.

Zulässige Werte: Append, Delete, Overwrite

--header-name

Name des zu ändernden Headers.

--header-value

Wert des Headers.

--match-processing-behavior

Geben Sie an, ob das Regelmodul weiterhin die verbleibenden Regeln ausführen oder beenden soll, wenn die Übereinstimmung erfolgt. Standardmäßig wird 'Weiter' angezeigt.

Zulässige Werte: Continue, Stop

--match-values

Übereinstimmungswerte der Übereinstimmungsbedingung.

--match-variable

Name der Übereinstimmungsbedingung: https://docs.microsoft.com/en-us/azure/frontdoor/rules-match-conditions.

Zulässige Werte: ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath

--negate-condition

Wenn "true" lautet, wird die Bedingung aufgehoben.

Zulässige Werte: false, true

--operator

Operator der Übereinstimmungsbedingung.

--origin-group

Name oder ID der OriginGroup, die die Standard-OriginGroup überschreiben würde.

--preserve-unmatched-path

Wenn True, wird der verbleibende Pfad nach dem Quellmuster an den neuen Zielpfad angefügt.

Zulässige Werte: false, true

--query-parameters

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen.

--query-string-caching-behavior

Definiert, wie CDN-Anforderungen zwischengespeichert werden, die Abfragezeichenfolgen enthalten. Sie können alle Abfragezeichenfolgen beim Zwischenspeichern ignorieren, die Zwischenspeicherung umgehen, um Anforderungen zu verhindern, die Abfragezeichenfolgen zwischengespeichert haben, oder jede Anforderung mit einer eindeutigen URL zwischenspeichern.

Zulässige Werte: IgnoreQueryString, IgnoreSpecifiedQueryStrings, IncludeSpecifiedQueryStrings, UseQueryString

--redirect-protocol

Protokoll, das für die Umleitung verwendet werden soll.

Zulässige Werte: Http, Https, MatchRequest

--redirect-type

Der Umleitungstyp verwendet die Regel beim Umleiten von Datenverkehr.

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

--selector

Auswahl der Übereinstimmungsbedingung.

--source-pattern

Ein Anforderungs-URI-Muster, das den Typ der Anforderungen identifiziert, die neu geschrieben werden können.

--transforms

Transformieren, um vor dem Abgleich anzuwenden.

Zulässige Werte: Lowercase, RemoveNulls, Trim, Uppercase, UrlDecode, UrlEncode

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.

--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 afd rule delete

Entfernen einer Übermittlungsregel aus regelsatz.

az afd rule delete [--ids]
                   [--profile-name]
                   [--resource-group]
                   [--rule-name]
                   [--rule-set-name]
                   [--yes]

Beispiele

Entfernen sie eine Regel mit Name Rule1.

az afd rule delete -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--rule-name

Name der Regel.

--rule-set-name

Name des Regelsatzes.

--yes -y

Nicht zur Bestätigung auffordern

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.

--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 afd rule list

Listet alle vorhandenen Übermittlungsregeln innerhalb eines Regelsatzes auf.

az afd rule list --profile-name
                 --resource-group
                 --rule-set-name

Erforderliche Parameter

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--rule-set-name

Name des Regelsatzes.

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.

--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 afd rule show

Anzeigen von Übermittlungsregeldetails.

az afd rule show [--ids]
                 [--profile-name]
                 [--resource-group]
                 [--rule-name]
                 [--rule-set-name]

Beispiele

Details der Übermittlungsregel mit Namenregel1 anzeigen.

az afd rule show -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Optionale Parameter

--ids

--profile-name

Name des CDN-Profils, das innerhalb der Ressourcengruppe eindeutig ist.

--resource-group -g

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

--rule-name

Name der Regel.

--rule-set-name

Name des Regelsatzes.

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.

--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 afd rule

Befehle

az afd rule create

Beispiele

Erforderliche Parameter

Optionale Parameter

az afd rule delete

Beispiele

Optionale Parameter

az afd rule list

Erforderliche Parameter

az afd rule show

Beispiele

Optionale Parameter

Feedback