az afd origin-group
Manage origin groups under the specified profile.
Commands
Name | Description | Type | Status |
---|---|---|---|
az afd origin-group create |
Create a new origin group within the specified profile. |
Core | GA |
az afd origin-group delete |
Delete an existing origin group within a profile. |
Core | GA |
az afd origin-group list |
List all of the existing origin groups within a profile. |
Core | GA |
az afd origin-group show |
Get an existing origin group within a profile. |
Core | GA |
az afd origin-group update |
Update a new origin group within the specified profile. |
Core | GA |
az afd origin-group wait |
Place the CLI in a waiting state until a condition is met. |
Core | GA |
az afd origin-group create
Create a new origin group within the specified profile.
az afd origin-group create --name
--profile-name
--resource-group
[--additional-latency-in-milliseconds]
[--enable-health-probe {0, 1, f, false, n, no, t, true, y, yes}]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--probe-interval-in-seconds]
[--probe-path]
[--probe-protocol {Http, Https, NotSet}]
[--probe-request-type {GET, HEAD, NotSet}]
[--sample-size]
[--session-affinity-state {Disabled, Enabled}]
[--successful-samples-required]
[--traffic-restoration-time-to-healed-or-new-endpoints-in-minutes]
Examples
Creates a new origin group within the specified profile.
az afd origin-group create -g group --origin-group-name og1 --profile-name profile --probe-request-type GET --probe-protocol Http --probe-interval-in-seconds 120 --probe-path /test1/azure.txt --sample-size 4 --successful-samples-required 3 --additional-latency-in-milliseconds 50
Required Parameters
Name of the origin group which is unique within the endpoint.
Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
The additional latency in milliseconds for probes to fall into the lowest latency bucket.
Indicates whether to enable probe on the origin group.
Do not wait for the long-running operation to finish.
The number of seconds between health probes.Default is 240sec.
The path relative to the origin that is used to determine the health of the origin.
Protocol to use for health probe.
The type of health probe request that is made.
The number of samples to consider for load balancing decisions.
Whether to allow session affinity on this host. Valid options are 'Enabled' or 'Disabled'.
The number of samples within the sample period that must succeed.
Time in minutes to shift the traffic to the endpoint gradually when an unhealthy endpoint comes healthy or a new endpoint is added. Default is 10 mins. This property is currently not supported.
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 afd origin-group delete
Delete an existing origin group within a profile.
az afd origin-group delete [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--profile-name]
[--resource-group]
[--subscription]
[--yes]
Examples
Deletes an existing origin group within a profile.
az afd origin-group delete -g group --origin-group-name og1 --profile-name profile
Optional 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 origin group which is unique within the profile.
Do not wait for the long-running operation to finish.
Name of the Azure Front Door Standard or Azure Front Door Premium 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
.
Do not prompt for confirmation.
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 afd origin-group list
List all of the existing origin groups within a profile.
az afd origin-group list --profile-name
--resource-group
[--max-items]
[--next-token]
Required Parameters
Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
Total number of items to return in the command's output. If the total number of items available is more than the value specified, a token is provided in the command's output. To resume pagination, provide the token value in --next-token
argument of a subsequent command.
Token to specify where to start paginating. This is the token value from a previously truncated response.
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 afd origin-group show
Get an existing origin group within a profile.
az afd origin-group show [--ids]
[--name]
[--profile-name]
[--resource-group]
[--subscription]
Optional 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 origin group which is unique within the endpoint.
Name of the Azure Front Door Standard or Azure Front Door Premium 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.
az afd origin-group update
Update a new origin group within the specified profile.
az afd origin-group update [--add]
[--additional-latency-in-milliseconds]
[--enable-health-probe {0, 1, f, false, n, no, t, true, y, yes}]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--probe-interval-in-seconds]
[--probe-path]
[--probe-protocol {Http, Https, NotSet}]
[--probe-request-type {GET, HEAD, NotSet}]
[--profile-name]
[--remove]
[--resource-group]
[--sample-size]
[--session-affinity-state {Disabled, Enabled}]
[--set]
[--subscription]
[--successful-samples-required]
[--traffic-restoration-time-to-healed-or-new-endpoints-in-minutes]
Examples
Update the probe setting of the specified origin group.
az afd origin-group update -g group --origin-group-name og1 --profile-name profile --probe-request-type HEAD --probe-protocol Https --probe-interval-in-seconds 120 --probe-path /test1/azure.txt
Optional Parameters
Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>
.
The additional latency in milliseconds for probes to fall into the lowest latency bucket.
Indicates whether to enable probe on the origin group.
When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
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 origin group which is unique within the endpoint.
Do not wait for the long-running operation to finish.
The number of seconds between health probes.Default is 240sec.
The path relative to the origin that is used to determine the health of the origin.
Protocol to use for health probe.
The type of health probe request that is made.
Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group.
Remove a property or an element from a list. Example: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The number of samples to consider for load balancing decisions.
Whether to allow session affinity on this host. Valid options are 'Enabled' or 'Disabled'.
Update an object by specifying a property path and value to set. Example: --set property1.property2=<value>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
The number of samples within the sample period that must succeed.
Time in minutes to shift the traffic to the endpoint gradually when an unhealthy endpoint comes healthy or a new endpoint is added. Default is 10 mins. This property is currently not supported.
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 afd origin-group wait
Place the CLI in a waiting state until a condition is met.
az afd origin-group wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--profile-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Optional Parameters
Wait until created with 'provisioningState' at 'Succeeded'.
Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Wait until deleted.
Wait until the resource exists.
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.
Polling interval in seconds.
Name of the origin group which is unique within the endpoint.
Name of the Azure Front Door Standard or Azure Front Door Premium 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
.
Maximum wait in seconds.
Wait until updated with provisioningState at 'Succeeded'.
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.