az cdn endpoint rule
This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Manage delivery rules for an endpoint.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az cdn endpoint rule action |
Manage delivery rule actions for an endpoint. |
Core | Preview |
| az cdn endpoint rule action add |
Add an action to a delivery rule. |
Core | Preview |
| az cdn endpoint rule action remove |
Remove an action from a delivery rule. |
Core | Preview |
| az cdn endpoint rule action show |
Show delivery rules asscociate with the endpoint. |
Core | Preview |
| az cdn endpoint rule add |
Add a delivery rule to a CDN endpoint. |
Core | Preview |
| az cdn endpoint rule condition |
Manage delivery rule conditions for an endpoint. |
Core | Preview |
| az cdn endpoint rule condition add |
Add a condition to a delivery rule. |
Core | Preview |
| az cdn endpoint rule condition remove |
Remove a condition from a delivery rule. |
Core | Preview |
| az cdn endpoint rule condition show |
Show delivery rules associate with the endpoint. |
Core | Preview |
| az cdn endpoint rule remove |
Remove a delivery rule from an endpoint. |
Core | Preview |
| az cdn endpoint rule show |
Show delivery rules associate with the endpoint. |
Core | Preview |
az cdn endpoint rule add
Command group 'cdn endpoint rule' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Add a delivery rule to a CDN endpoint.
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}]Examples
Create a global rule to disable caching.
az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 0 --rule-name global --action-name CacheExpiration --cache-behavior BypassCacheCreate a rule for http to https redirect.
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 MovedCreate a rule to distribute requests with "/test1" in its URL path to origin group with name "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 origingroup1Required Parameters
The name of the action for the delivery rule: https://docs.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions.
The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lower order will be applied before one with a higher order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied.
Optional Parameters
Caching behavior for the requests.
The duration for which the content needs to be cached. Allowed format is [d.]hh:mm:ss.
Fragment to add to the redirect URL.
Host to redirect. Leave empty to use the incoming host as the destination host.
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path.
The set of query strings to be placed in the redirect URL. leave empty to preserve the incoming query string.
The destination path to be used in the rewrite.
Header action for the requests.
Name of the header to modify.
Value of the header.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Match values of the match condition. e.g, space separated values "GET" "HTTP".
Name of the match condition: https://docs.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-match-conditions.
Name of the CDN endpoint.
If true, negates the condition.
Operator of the match condition.
Name or ID of the OriginGroup that would override the default OriginGroup.
If True, the remaining path after the source pattern will be appended to the new destination path.
Name of the CDN profile which is unique within the resource group.
Query parameters to include or exclude (comma separated).
Query string behavior for the requests.
Protocol to use for the redirect.
The redirect type the rule will use when redirecting traffic.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Name of the rule, only required for Microsoft SKU.
Selector of the match condition.
A request URI pattern that identifies the type of requests that may be rewritten.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Transform to apply before matching.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az cdn endpoint rule remove
Command group 'cdn endpoint rule' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Remove a delivery rule from an endpoint.
az cdn endpoint rule remove [--ids]
[--name]
[--order]
[--profile-name]
[--resource-group]
[--rule-name]
[--subscription]Examples
Remove the global rule.
az cdn endpoint rule remove -g group -n endpoint --profile-name profile --rule-name GlobalRemove the rule with the order 4.
az cdn endpoint rule remove -g group -n endpoint --profile-name profile --order 4Optional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the CDN endpoint.
The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lower order will be applied before one with a higher order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied.
Name of the CDN profile which is unique within the resource group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Name of the rule.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az cdn endpoint rule show
Command group 'cdn endpoint rule' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Show delivery rules associate with the endpoint.
az cdn endpoint rule show [--ids]
[--name]
[--profile-name]
[--resource-group]
[--subscription]Examples
show delivery rules associate with the endpoint.
az cdn endpoint rule show -g group -n endpoint --profile-name profileOptional Parameters
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of the CDN endpoint.
Name of the CDN profile which is unique within the resource group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for