Share via


az cdn endpoint rule

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Zustellungsregeln für einen Endpunkt.

Befehle

Name Beschreibung Typ Status
az cdn endpoint rule action

Verwalten von Zustellungsregelaktionen für einen Endpunkt.

Kernspeicher Vorschau
az cdn endpoint rule action add

Fügen Sie einer Übermittlungsregel eine Aktion hinzu.

Kernspeicher Vorschau
az cdn endpoint rule action remove

Entfernen sie eine Aktion aus einer Übermittlungsregel.

Kernspeicher Vorschau
az cdn endpoint rule action show

Anzeigen von Übermittlungsregeln asscociate mit dem Endpunkt.

Kernspeicher Vorschau
az cdn endpoint rule add

Fügen Sie einem CDN-Endpunkt eine Übermittlungsregel hinzu.

Kernspeicher Vorschau
az cdn endpoint rule condition

Verwalten von Zustellungsregelbedingungen für einen Endpunkt.

Kernspeicher Vorschau
az cdn endpoint rule condition add

Fügen Sie einer Übermittlungsregel eine Bedingung hinzu.

Kernspeicher Vorschau
az cdn endpoint rule condition remove

Entfernen sie eine Bedingung aus einer Übermittlungsregel.

Kernspeicher Vorschau
az cdn endpoint rule condition show

Übermittlungsregeln anzeigen, die dem Endpunkt zugeordnet sind.

Kernspeicher Vorschau
az cdn endpoint rule remove

Entfernen sie eine Übermittlungsregel von einem Endpunkt.

Kernspeicher Vorschau
az cdn endpoint rule show

Übermittlungsregeln anzeigen, die dem Endpunkt zugeordnet sind.

Kernspeicher Vorschau

az cdn endpoint rule add

Vorschau

Die Befehlsgruppe "cdn-Endpunktregel" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Fügen Sie einem CDN-Endpunkt eine Übermittlungsregel hinzu.

az cdn endpoint rule add --action-name {CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite}
                         --order
                         [--cache-behavior {BypassCache, Override, SetIfMissing}]
                         [--cache-duration]
                         [--custom-fragment]
                         [--custom-hostname]
                         [--custom-path]
                         [--custom-querystring]
                         [--destination]
                         [--header-action {Append, Delete, Overwrite}]
                         [--header-name]
                         [--header-value]
                         [--ids]
                         [--match-values]
                         [--match-variable {ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath}]
                         [--name]
                         [--negate-condition {false, true}]
                         [--operator]
                         [--origin-group]
                         [--preserve-unmatched-path {false, true}]
                         [--profile-name]
                         [--query-parameters]
                         [--query-string-behavior {Exclude, ExcludeAll, Include, IncludeAll}]
                         [--redirect-protocol {Http, Https, MatchRequest}]
                         [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                         [--resource-group]
                         [--rule-name]
                         [--selector]
                         [--source-pattern]
                         [--subscription]
                         [--transform {Lowercase, Uppercase}]

Beispiele

Erstellen Sie eine globale Regel, um die Zwischenspeicherung zu deaktivieren.

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 0 --rule-name global --action-name CacheExpiration --cache-behavior BypassCache

Erstellen Sie eine Regel für http zu https-Umleitung.

az cdn endpoint rule add -g group -n endpoint --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

Erstellen Sie eine Regel zum Verteilen von Anforderungen mit "/test1" im URL-Pfad zur Ursprungsgruppe mit dem Namen "origingroup1".

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 1 --rule-name "origin-group-override" --match-variable UrlPath --operator Contains --match-values /test1 --action-name "OriginGroupOverride" --origin-group origingroup1

Erforderliche Parameter

--action-name

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

Zulässige Werte: CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, 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 einer höheren Reihenfolge angewendet. Regel mit Reihenfolge 0 ist eine spezielle Regel. Es ist keine Bedingung erforderlich, und die darin aufgeführten Aktionen werden immer angewendet.

Optionale Parameter

--cache-behavior

Zwischenspeicherungsverhalten für die Anforderungen.

Zulässige Werte: BypassCache, Override, SetIfMissing
--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, 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-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.

--header-action

Headeraktion für die Anforderungen.

Zulässige Werte: Append, Delete, Overwrite
--header-name

Der Name der zu ändernden Kopfzeile.

--header-value

Wert des Headers.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--match-values

Stimmen Sie die Werte der Übereinstimmungsbedingung ab. z. B. durch Leerzeichen getrennte Werte "GET" "HTTP".

--match-variable

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

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

Name des CDN-Endpunkts.

--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 Standardmäßige OriginGroup überschreiben würde.

--preserve-unmatched-path

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

Zulässige Werte: false, true
--profile-name

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

--query-parameters

Abfrageparameter, die eingeschlossen oder ausgeschlossen werden sollen (durch Trennzeichen getrennt).

--query-string-behavior

Abfragezeichenfolgenverhalten für die Anforderungen.

Zulässige Werte: Exclude, ExcludeAll, Include, IncludeAll
--redirect-protocol

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

Zulässige Werte: Http, Https, MatchRequest
--redirect-type

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

Zulässige Werte: Found, Moved, PermanentRedirect, TemporaryRedirect
--resource-group -g

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

--rule-name

Name der Regel, nur erforderlich für Microsoft SKU.

--selector

Auswahl der Übereinstimmungsbedingung.

--source-pattern

Ein Anforderungs-URI-Muster, das den Typ der Anforderungen identifiziert, die möglicherweise umgeschrieben werden.

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

--transform

Transformation, die vor dem Abgleich angewendet werden soll.

Zulässige Werte: Lowercase, Uppercase
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 cdn endpoint rule remove

Vorschau

Die Befehlsgruppe "cdn-Endpunktregel" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Entfernen sie eine Übermittlungsregel von einem Endpunkt.

az cdn endpoint rule remove [--ids]
                            [--name]
                            [--order]
                            [--profile-name]
                            [--resource-group]
                            [--rule-name]
                            [--subscription]

Beispiele

Entfernen Sie die globale Regel.

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --rule-name Global

Entfernen Sie die Regel mit der Reihenfolge 4.

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --order 4

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des CDN-Endpunkts.

--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 einer höheren Reihenfolge angewendet. Regel mit Reihenfolge 0 ist eine spezielle Regel. Es ist keine Bedingung erforderlich, und die darin aufgeführten Aktionen 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.

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

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 cdn endpoint rule show

Vorschau

Die Befehlsgruppe "cdn-Endpunktregel" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Übermittlungsregeln anzeigen, die dem Endpunkt zugeordnet sind.

az cdn endpoint rule show [--ids]
                          [--name]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]

Beispiele

Übermittlungsregeln anzeigen, die dem Endpunkt zugeordnet sind.

az cdn endpoint rule show -g group -n endpoint --profile-name profile

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des CDN-Endpunkts.

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

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

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.