Share via

az containerapp revision label

Note

This command group has commands that are defined in both Azure CLI and at least one extension. Install each extension to benefit from its extended capabilities. Learn more about extensions.

Manage revision labels assigned to traffic weights.

Commands

Name Description Type Status
az containerapp revision label add

Set a revision label to a revision with an associated traffic weight.

 Core GA
az containerapp revision label add (containerapp extension)

Set a revision label to a revision with an associated traffic weight.

 Extension GA
az containerapp revision label remove

Remove a revision label from a revision with an associated traffic weight.

 Core GA
az containerapp revision label remove (containerapp extension)

Remove a revision label from a revision with an associated traffic weight.

 Extension GA
az containerapp revision label swap

Swap a revision label between two revisions with associated traffic weights.

 Core GA

az containerapp revision label add

Edit

Set a revision label to a revision with an associated traffic weight.

az containerapp revision label add --label
                                   --resource-group
                                   --revision
                                   [--name]
                                   [--no-prompt --yes]

Examples

Add a label to the latest revision.

az containerapp revision label add -n my-containerapp -g MyResourceGroup --label myLabel --revision latest

Add a label to a previous revision.

az containerapp revision label add -g MyResourceGroup --label myLabel --revision revisionName

Required Parameters

--label

Name of the label.

--resource-group -g

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

--revision

Name of the revision.

Optional Parameters

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

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

--no-prompt --yes -y

Do not prompt for confirmation.

Property Value
Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Property Value
Default value: False

az containerapp revision label add (containerapp extension)

Set a revision label to a revision with an associated traffic weight.

az containerapp revision label add --label
                                   --resource-group
                                   --revision
                                   [--name]
                                   [--no-prompt --yes]

Examples

Add a label to the latest revision.

az containerapp revision label add -n my-containerapp -g MyResourceGroup --label myLabel --revision latest

Add a label to a previous revision.

az containerapp revision label add -g MyResourceGroup --label myLabel --revision revisionName

Required Parameters

--label

Name of the label.

--resource-group -g

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

--revision

Name of the revision.

Optional Parameters

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

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

--no-prompt --yes -y

Do not prompt for confirmation.

Property Value
Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Property Value
Default value: False

az containerapp revision label remove

Edit

Remove a revision label from a revision with an associated traffic weight.

az containerapp revision label remove --label
                                      --name
                                      --resource-group

Examples

Remove a label.

az containerapp revision label remove -n my-containerapp -g MyResourceGroup --label myLabel

Required Parameters

--label

Name of the label.

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Property Value
Default value: False

az containerapp revision label remove (containerapp extension)

Remove a revision label from a revision with an associated traffic weight.

az containerapp revision label remove --label
                                      --name
                                      --resource-group

Examples

Remove a label.

az containerapp revision label remove -n my-containerapp -g MyResourceGroup --label myLabel

Required Parameters

--label

Name of the label.

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

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Property Value
Default value: False

az containerapp revision label swap

Edit

Swap a revision label between two revisions with associated traffic weights.

az containerapp revision label swap --name
                                    --resource-group
                                    --source
                                    --target

Examples

Swap a revision label between two revisions.

az containerapp revision label swap -n my-containerapp -g MyResourceGroup --source myLabel1 --target myLabel2

Required Parameters

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

--source

Source label to be swapped.

--target

Target label to be swapped to.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Property Value
Default value: False