Share via

az containerapp replica

  • Reference

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 container app replicas.

Commands

Name Description Type Status
az containerapp replica count

Count of a container app's replica(s).

 Extension Preview
az containerapp replica list

List a container app revision's replica.

 Core GA
az containerapp replica list (containerapp extension)

List a container app revision's replica.

 Extension GA
az containerapp replica show

Show a container app replica.

 Core GA
az containerapp replica show (containerapp extension)

Show a container app replica.

 Extension GA

az containerapp replica count

Preview

This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Count of a container app's replica(s).

az containerapp replica count --name
                              --resource-group
                              [--revision]

Examples

Count replicas of a particular revision

az containerapp replica count -n my-containerapp -g MyResourceGroup --revision MyRevision

Count replicas of the latest revision

az containerapp replica count -n my-containerapp -g MyResourceGroup

Required Parameters

--name -n

The name of the Containerapp.

--resource-group -g

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

Optional Parameters

--revision

The name of the container app revision. Defaults to the latest revision.

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 replica list

Edit

List a container app revision's replica.

az containerapp replica list --name
                             --resource-group
                             [--revision]

Examples

List a container app's replicas in the latest revision

az containerapp replica list -n my-containerapp -g MyResourceGroup

List a container app's replicas in a particular revision

az containerapp replica list -n my-containerapp -g MyResourceGroup --revision MyRevision

Required Parameters

--name -n

The name of the Containerapp.

--resource-group -g

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

Optional Parameters

--revision

The name of the container app revision. Defaults to the latest revision.

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 replica list (containerapp extension)

List a container app revision's replica.

az containerapp replica list --name
                             --resource-group
                             [--revision]

Examples

List a container app's replicas in the latest revision

az containerapp replica list -n my-containerapp -g MyResourceGroup

List a container app's replicas in a particular revision

az containerapp replica list -n my-containerapp -g MyResourceGroup --revision MyRevision

Required Parameters

--name -n

The name of the Containerapp.

--resource-group -g

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

Optional Parameters

--revision

The name of the container app revision. Defaults to the latest revision.

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 replica show

Edit

Show a container app replica.

az containerapp replica show --name
                             --replica
                             --resource-group
                             [--revision]

Examples

Show a replica from the latest revision

az containerapp replica show -n my-containerapp -g MyResourceGroup --replica MyReplica

Show a replica from the a particular revision

az containerapp replica show -n my-containerapp -g MyResourceGroup --replica MyReplica --revision MyRevision

Required Parameters

--name -n

The name of the Containerapp.

--replica

The name of the replica.

--resource-group -g

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

Optional Parameters

--revision

The name of the container app revision. Defaults to the latest revision.

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 replica show (containerapp extension)

Show a container app replica.

az containerapp replica show --name
                             --replica
                             --resource-group
                             [--revision]

Examples

Show a replica from the latest revision

az containerapp replica show -n my-containerapp -g MyResourceGroup --replica MyReplica

Show a replica from the a particular revision

az containerapp replica show -n my-containerapp -g MyResourceGroup --replica MyReplica --revision MyRevision

Required Parameters

--name -n

The name of the Containerapp.

--replica

The name of the replica.

--resource-group -g

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

Optional Parameters

--revision

The name of the container app revision. Defaults to the latest revision.

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.