Share via


az containerapp ingress traffic

Commands to manage traffic-splitting.

Commands

Name Description Type Status
az containerapp ingress traffic set

Configure traffic-splitting for a container app.

Core GA
az containerapp ingress traffic show

Show traffic-splitting configuration for a container app.

Core GA

az containerapp ingress traffic set

Configure traffic-splitting for a container app.

az containerapp ingress traffic set [--ids]
                                    [--label-weight]
                                    [--name]
                                    [--resource-group]
                                    [--revision-weight]
                                    [--subscription]
                                    [--traffic-weight]

Examples

Route 100% of a container app's traffic to its latest revision.

az containerapp ingress traffic set -n my-containerapp -g MyResourceGroup --revision-weight latest=100

Split a container app's traffic between two revisions.

az containerapp ingress traffic set -n my-containerapp -g MyResourceGroup --revision-weight latest=80 MyRevisionName=20

Split a container app's traffic between two labels.

az containerapp ingress traffic set -n my-containerapp -g MyResourceGroup --label-weight myLabel=80 myLabel2=20

Split a container app's traffic between a label and a revision.

az containerapp ingress traffic set -n my-containerapp -g MyResourceGroup --revision-weight latest=80 --label-weight myLabel=20

Optional Parameters

--ids

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.

--label-weight

A list of label weight(s) for the container app. Space-separated values in 'label_name=weight' format.

--name -n

The name of the Containerapp. A name must consist of lower case alphanumeric characters or '-', start with a letter, end with an alphanumeric character, cannot have '--', and must be less than 32 characters.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--revision-weight

A list of revision weight(s) for the container app. Space-separated values in 'revision_name=weight' format. For latest revision, use 'latest=weight'.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--traffic-weight
Deprecated

Option '--traffic-weight' has been deprecated and will be removed in a future release. Use '--revision-weight' instead.

A list of revision weight(s) for the container app. Space-separated values in 'revision_name=weight' format. For latest revision, use 'latest=weight'.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az containerapp ingress traffic show

Show traffic-splitting configuration for a container app.

az containerapp ingress traffic show [--ids]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]

Examples

Show a container app's ingress traffic configuration.

az containerapp ingress traffic show -n my-containerapp -g MyResourceGroup

Optional Parameters

--ids

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

The name of the Containerapp. A name must consist of lower case alphanumeric characters or '-', start with a letter, end with an alphanumeric character, cannot have '--', and must be less than 32 characters.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.