Freigeben über


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.

Core Preview
az cdn endpoint rule action add

Fügen Sie einer Übermittlungsregel eine Aktion hinzu.

Core Preview
az cdn endpoint rule action remove

Entfernen sie eine Aktion aus einer Übermittlungsregel.

Core Preview
az cdn endpoint rule action show

Anzeigen von Übermittlungsregeln asscociate mit dem Endpunkt.

Core Preview
az cdn endpoint rule add

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

Core Preview
az cdn endpoint rule condition

Verwalten von Zustellungsregelbedingungen für einen Endpunkt.

Core Preview
az cdn endpoint rule condition add

Fügen Sie einer Übermittlungsregel eine Bedingung hinzu.

Core Preview
az cdn endpoint rule condition remove

Entfernen sie eine Bedingung aus einer Übermittlungsregel.

Core Preview
az cdn endpoint rule condition show

Übermittlungsregeln anzeigen, die dem Endpunkt zugeordnet sind.

Core Preview
az cdn endpoint rule remove

Entfernen sie eine Übermittlungsregel von einem Endpunkt.

Core Preview
az cdn endpoint rule show

Übermittlungsregeln anzeigen, die dem Endpunkt zugeordnet sind.

Core Preview

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 Zustellungsregel: https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions.

Eigenschaft Wert
Parameter group: Action Arguments
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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cache-behavior

Zwischenspeicherungsverhalten für die Anforderungen.

Eigenschaft Wert
Parameter group: Action Arguments
Zulässige Werte: BypassCache, Override, SetIfMissing
--cache-duration

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

Eigenschaft Wert
Parameter group: Action Arguments
--custom-fragment

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

Eigenschaft Wert
Parameter group: Action Arguments
--custom-hostname

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

Eigenschaft Wert
Parameter group: Action Arguments
--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.

Eigenschaft Wert
Parameter group: Action Arguments
--custom-querystring

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

Eigenschaft Wert
Parameter group: Action Arguments
--destination

Der Zielpfad, der im Umschreiben verwendet werden soll.

Eigenschaft Wert
Parameter group: Action Arguments
--header-action

Headeraktion für die Anforderungen.

Eigenschaft Wert
Parameter group: Action Arguments
Zulässige Werte: Append, Delete, Overwrite
--header-name

Der Name der zu ändernden Kopfzeile.

Eigenschaft Wert
Parameter group: Action Arguments
--header-value

Wert der Kopfzeile.

Eigenschaft Wert
Parameter group: Action Arguments
--ids

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--match-values

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

Eigenschaft Wert
Parameter group: Match Condition Arguments
--match-variable

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

Eigenschaft Wert
Parameter group: Match Condition Arguments
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.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--negate-condition

Wenn "true" lautet, wird die Bedingung aufgehoben.

Eigenschaft Wert
Parameter group: Match Condition Arguments
Zulässige Werte: false, true
--operator

Operator der Übereinstimmungsbedingung.

Eigenschaft Wert
Parameter group: Match Condition Arguments
--origin-group

Name oder ID der OriginGroup, die die Standardmäßige OriginGroup überschreiben würde.

Eigenschaft Wert
Parameter group: Action Arguments
--preserve-unmatched-path

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

Eigenschaft Wert
Parameter group: Action Arguments
Zulässige Werte: false, true
--profile-name

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--query-parameters

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

Eigenschaft Wert
Parameter group: Action Arguments
--query-string-behavior

Abfragezeichenfolgenverhalten für die Anforderungen.

Eigenschaft Wert
Parameter group: Action Arguments
Zulässige Werte: Exclude, ExcludeAll, Include, IncludeAll
--redirect-protocol

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

Eigenschaft Wert
Parameter group: Action Arguments
Zulässige Werte: Http, Https, MatchRequest
--redirect-type

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

Eigenschaft Wert
Parameter group: Action Arguments
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.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--rule-name

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

--selector

Auswahl der Übereinstimmungsbedingung.

Eigenschaft Wert
Parameter group: Match Condition Arguments
--source-pattern

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

Eigenschaft Wert
Parameter group: Action Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--transform

Transformation, die vor dem Abgleich angewendet werden soll.

Eigenschaft Wert
Parameter group: Match Condition Arguments
Zulässige Werte: Lowercase, Uppercase
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

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

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

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--name -n

Name des CDN-Endpunkts.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--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.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--rule-name

Name der Regel.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

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

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

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--name -n

Name des CDN-Endpunkts.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--profile-name

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parameter group: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

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

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

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False