az containerapp job

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.

Commands to manage Container Apps jobs.

Commands

Name	Description	Type	Status
az containerapp job create	Create a container apps job.	Core	GA
az containerapp job create (containerapp extension)	Create a container apps job.	Extension	GA
az containerapp job delete	Delete a Container Apps Job.	Core	GA
az containerapp job delete (containerapp extension)	Delete a Container Apps Job.	Extension	GA
az containerapp job execution	Commands to view executions of a Container App Job.	Core	GA
az containerapp job execution list	Get list of all executions of a Container App Job.	Core	GA
az containerapp job execution show	Get execution of a Container App Job.	Core	GA
az containerapp job identity	Commands to manage managed identities for container app job.	Core	GA
az containerapp job identity assign	Assign managed identity to a container app job.	Core	GA
az containerapp job identity remove	Remove a managed identity from a container app job.	Core	GA
az containerapp job identity show	Show managed identities of a container app job.	Core	GA
az containerapp job list	List Container Apps Job by subscription or resource group.	Core	GA
az containerapp job list (containerapp extension)	List Container Apps Job by subscription or resource group.	Extension	GA
az containerapp job secret	Commands to manage secrets.	Core	GA
az containerapp job secret list	List the secrets of a container app job.	Core	GA
az containerapp job secret remove	Remove secrets from a container app job.	Core	GA
az containerapp job secret set	Create/update secrets.	Core	GA
az containerapp job secret show	Show details of a secret.	Core	GA
az containerapp job show	Show details of a Container Apps Job.	Core	GA
az containerapp job show (containerapp extension)	Show details of a Container Apps Job.	Extension	GA
az containerapp job start	Start a Container Apps Job execution.	Core	GA
az containerapp job stop	Stops a Container Apps Job execution.	Core	GA
az containerapp job update	Update a Container Apps Job.	Core	GA

az containerapp job create

Create a container apps job.

az containerapp job create --name
                           --resource-group
                           [--args]
                           [--command]
                           [--container-name]
                           [--cpu]
                           [--cron-expression]
                           [--env-vars]
                           [--environment]
                           [--image]
                           [--max-executions]
                           [--memory]
                           [--mi-system-assigned]
                           [--mi-user-assigned]
                           [--min-executions]
                           [--no-wait]
                           [--parallelism]
                           [--polling-interval]
                           [--rcc]
                           [--registry-identity]
                           [--registry-password]
                           [--registry-server]
                           [--registry-username]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--scale-rule-auth]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--secrets]
                           [--tags]
                           [--trigger-type]
                           [--workload-profile-name]
                           [--yaml]

Examples

Create a container apps job with Trigger Type as Manual.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --trigger-type Manual \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image imageName \
    --workload-profile-name my-wlp

Create a container apps job with Trigger Type as Schedule.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --trigger-type Schedule \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --cron-expression "*/1 * * * *" \
    --image imageName

Create a container apps job with Trigger Type as Event.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --trigger-type Event \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --polling-interval 30 \
    --min-executions 0 \
    --max-executions 1 \
    --scale-rule-name queueJob \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength": "5" "queueName": "foo" \
    --scale-rule-auth "connection=my-connection-string-secret-name" \
    --image imageName

Required Parameters

--name -n

The name of the Container Apps Job. 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>.

Optional Parameters

--args

A list of container startup command argument(s). Space-separated values e.g. "-c" "mycommand". Empty string to clear existing values.

--command

A list of supported commands on the container that will executed during startup. Space-separated values e.g. "/bin/queue" "mycommand". Empty string to clear existing values.

--container-name

Name of the container.

--cpu

Required CPU in cores from 0.25 - 2.0, e.g. 0.5.

--cron-expression

Cron expression. Only supported for trigger type "Schedule".

--env-vars

A list of environment variable(s) for the container. Space-separated values in 'key=value' format. Empty string to clear existing values. Prefix value with 'secretref:' to reference a secret.

--environment

Name or resource ID of the container app's environment.

--image

Container image, e.g. publisher/image-name:tag.

--max-executions

Maximum number of job executions to run per polling interval.

--memory

Required memory from 0.5 - 4.0 ending with "Gi", e.g. 1.0Gi.

--mi-system-assigned

Boolean indicating whether to assign system-assigned identity.

default value: False

--mi-user-assigned

Space-separated user identities to be assigned.

--min-executions

Minimum number of job executions to run per polling interval.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--parallelism

Maximum number of replicas to run per execution.

--polling-interval

Interval to check each event source in seconds. Defaults to 30s.

--rcc --replica-completion-count

Number of replicas that need to complete successfully for execution to succeed.

--registry-identity

A Managed Identity to authenticate with the registry server instead of username/password. Use a resource ID or 'system' for user-defined and system-defined identities, respectively. The registry must be an ACR. If possible, an 'acrpull' role assignemnt will be created for the identity automatically.

--registry-password

The password to log in to container registry. If stored as a secret, value must start with 'secretref:' followed by the secret name.

--registry-server

The container registry server hostname, e.g. myregistry.azurecr.io.

--registry-username

The username to log in to container registry.

--replica-retry-limit

Maximum number of retries before the replica fails.

--replica-timeout

Maximum number of seconds a replica can execute.

--scale-rule-auth --sra

Scale rule auth parameters. Auth parameters must be in format "= = ...".

--scale-rule-metadata --srm

Scale rule metadata. Metadata must be in format "= = ...".

--scale-rule-name --srn

The name of the scale rule.

--scale-rule-type --srt

The type of the scale rule.

--secrets -s

A list of secret(s) for the container app. Space-separated values in 'key=value' format.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--trigger-type

Trigger type. Schedule | Event | Manual.

--workload-profile-name -w

The friendly name for the workload profile.

--yaml

Path to a .yaml file with the configuration of a container app. All other parameters will be ignored. For an example, see https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples.

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 job create (containerapp extension)

Create a container apps job.

az containerapp job create --name
                           --resource-group
                           [--args]
                           [--command]
                           [--container-name]
                           [--cpu]
                           [--cron-expression]
                           [--env-vars]
                           [--environment]
                           [--environment-type {connected, managed}]
                           [--image]
                           [--max-executions]
                           [--memory]
                           [--mi-system-assigned]
                           [--mi-user-assigned]
                           [--min-executions]
                           [--no-wait]
                           [--parallelism]
                           [--polling-interval]
                           [--rcc]
                           [--registry-identity]
                           [--registry-password]
                           [--registry-server]
                           [--registry-username]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--scale-rule-auth]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--secrets]
                           [--tags]
                           [--trigger-type]
                           [--workload-profile-name]
                           [--yaml]

Examples

Create a container apps job with Trigger Type as Manual.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappEnv
    --trigger-type Manual \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image imageName \
    --workload-profile-name my-wlp

Create a container apps job with Trigger Type as Schedule.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappEnv
    --trigger-type Schedule \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --cron-expression "*/1 * * * *" \
    --image imageName

Create a container apps job with Trigger Type as Event.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappEnv
    --trigger-type Event \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --polling-interval 30 \
    --min-executions 0 \
    --max-executions 1 \
    --scale-rule-name queueJob \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength": "5" "queueName": "foo" \
    --scale-rule-auth "connection=my-connection-string-secret-name" \
    --image imageName

Create a container apps job hosted on a Connected Environment.

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappConnectedEnv
    --environment-type connected
    --trigger-type Manual \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image imageName \
    --workload-profile-name my-wlp

Required Parameters

--name -n

The name of the Container Apps Job. 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>.

Optional Parameters

--args

A list of container startup command argument(s). Space-separated values e.g. "-c" "mycommand". Empty string to clear existing values.

--command

A list of supported commands on the container that will executed during startup. Space-separated values e.g. "/bin/queue" "mycommand". Empty string to clear existing values.

--container-name

Name of the container.

--cpu

Required CPU in cores from 0.25 - 2.0, e.g. 0.5.

--cron-expression

Cron expression. Only supported for trigger type "Schedule".

--env-vars

A list of environment variable(s) for the container. Space-separated values in 'key=value' format. Empty string to clear existing values. Prefix value with 'secretref:' to reference a secret.

--environment

Name or resource ID of the container app's environment.

--environment-type

Preview

Type of environment.

accepted values: connected, managed

default value: managed

--image

Container image, e.g. publisher/image-name:tag.

--max-executions

Maximum number of job executions that are created for a trigger.

default value: 100

--memory

Required memory from 0.5 - 4.0 ending with "Gi", e.g. 1.0Gi.

--mi-system-assigned

Boolean indicating whether to assign system-assigned identity.

default value: False

--mi-user-assigned

Space-separated user identities to be assigned.

--min-executions

Minimum number of job executions that are created for a trigger. Default: 0.

default value: 0

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--parallelism

Maximum number of replicas to run per execution.

default value: 1

--polling-interval

Interval to check each event source in seconds.

default value: 30

--rcc --replica-completion-count

Number of replicas that need to complete successfully for execution to succeed.

default value: 1

--registry-identity

A Managed Identity to authenticate with the registry server instead of username/password. Use a resource ID or 'system' for user-defined and system-defined identities, respectively. The registry must be an ACR. If possible, an 'acrpull' role assignemnt will be created for the identity automatically.

--registry-password

The password to log in to container registry. If stored as a secret, value must start with 'secretref:' followed by the secret name.

--registry-server

The container registry server hostname, e.g. myregistry.azurecr.io.

--registry-username

The username to log in to container registry.

--replica-retry-limit

Maximum number of retries before the replica fails. Default: 0.

default value: 0

--replica-timeout

Maximum number of seconds a replica can execute.

default value: 1800

--scale-rule-auth --sra

Scale rule auth parameters. Auth parameters must be in format "= = ...".

--scale-rule-metadata --srm

Scale rule metadata. Metadata must be in format "= = ...".

--scale-rule-name --srn

The name of the scale rule.

--scale-rule-type --srt

The type of the scale rule.

--secrets -s

A list of secret(s) for the container app. Space-separated values in 'key=value' format.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--trigger-type

Trigger type. Schedule | Event | Manual.

--workload-profile-name -w

The friendly name for the workload profile.

--yaml

Path to a .yaml file with the configuration of a container app. All other parameters will be ignored. For an example, see https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples.

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 job delete

Delete a Container Apps Job.

az containerapp job delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--yes]

Examples

Delete a job.

az containerapp job delete -n my-containerapp-job -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 Container Apps Job. 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-wait

Do not wait for the long-running operation to finish.

default value: False

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

--yes -y

Do not prompt for confirmation.

default value: False

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 job delete (containerapp extension)

Delete a Container Apps Job.

az containerapp job delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--yes]

Examples

Delete a job.

az containerapp job delete -n my-containerapp-job -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 Container Apps Job. 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-wait

Do not wait for the long-running operation to finish.

default value: False

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

--yes -y

Do not prompt for confirmation.

default value: False

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

List Container Apps Job by subscription or resource group.

az containerapp job list [--resource-group]

Examples

List jobs in the current subscription.

az containerapp job list

List environments by resource group.

az containerapp job list -g MyResourceGroup

Optional Parameters

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

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

List Container Apps Job by subscription or resource group.

az containerapp job list [--resource-group]

Examples

List jobs in the current subscription.

az containerapp job list

List environments by resource group.

az containerapp job list -g MyResourceGroup

Optional Parameters

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

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

Show details of a Container Apps Job.

az containerapp job show [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

Examples

Show the details of a job.

az containerapp job show -n my-containerapp-job -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 Container Apps Job. 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.

az containerapp job show (containerapp extension)

Show details of a Container Apps Job.

az containerapp job show [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

Examples

Show the details of a job.

az containerapp job show -n my-containerapp-job -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 Container Apps Job. 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.

az containerapp job start

Start a Container Apps Job execution.

az containerapp job start [--args]
                          [--command]
                          [--container-name]
                          [--cpu]
                          [--env-vars]
                          [--ids]
                          [--image]
                          [--memory]
                          [--name]
                          [--no-wait]
                          [--registry-identity]
                          [--resource-group]
                          [--subscription]
                          [--yaml]

Examples

Start a job execution.

az containerapp job start -n my-containerapp-job -g MyResourceGroup

Start a job with different image and configurations.

az containerapp job start -n my-containerapp-job -g MyResourceGroup --image MyImageName --cpu 0.5 --memory 1.0Gi

Optional Parameters

--args

A list of container startup command argument(s). Space-separated values e.g. "-c" "mycommand". Empty string to clear existing values.

--command

A list of supported commands on the container that will executed during startup. Space-separated values e.g. "/bin/queue" "mycommand". Empty string to clear existing values.

--container-name

Name of the container.

--cpu

Required CPU in cores from 0.25 - 2.0, e.g. 0.5.

--env-vars

A list of environment variable(s) for the container. Space-separated values in 'key=value' format. Empty string to clear existing values. Prefix value with 'secretref:' to reference a secret.

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

--image

Container image, e.g. publisher/image-name:tag.

--memory

Required memory from 0.5 - 4.0 ending with "Gi", e.g. 1.0Gi.

--name -n

The name of the Container Apps Job. 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-wait

Do not wait for the long-running operation to finish.

default value: False

--registry-identity

A Managed Identity to authenticate with the registry server instead of username/password. Use a resource ID or 'system' for user-defined and system-defined identities, respectively. The registry must be an ACR. If possible, an 'acrpull' role assignemnt will be created for the identity automatically.

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

--yaml

Path to a .yaml file with the configuration of a container app. All other parameters will be ignored. For an example, see https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples.

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 job stop

Stops a Container Apps Job execution.

az containerapp job stop [--execution-name-list]
                         [--ids]
                         [--job-execution-name]
                         [--name]
                         [--no-wait]
                         [--resource-group]
                         [--subscription]

Examples

Stop a job execution.

az containerapp job stop -n my-containerapp-job -g MyResourceGroup

Stop a job execution giving a specific job execution name.

az containerapp job stop -n my-containerapp-job -g MyResourceGroup --job-execution-name MyContainerAppJob-66v9xh0

Stop multiple job executions giving a list of execution names.

az containerapp job stop -n my-containerapp-job -g MyResourceGroup --execution-name-list MyContainerAppJob-66v9xh0,MyContainerAppJob-66v9xh1

Optional Parameters

--execution-name-list

Comma separated list of job execution names.

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

--job-execution-name

Name of the specific job execution which needs to be stopped.

--name -n

The name of the Container Apps Job. 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-wait

Do not wait for the long-running operation to finish.

default value: False

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

az containerapp job update

Update a Container Apps Job.

az containerapp job update [--args]
                           [--command]
                           [--container-name]
                           [--cpu]
                           [--cron-expression]
                           [--ids]
                           [--image]
                           [--max-executions]
                           [--memory]
                           [--min-executions]
                           [--name]
                           [--no-wait]
                           [--parallelism]
                           [--polling-interval]
                           [--rcc]
                           [--remove-all-env-vars]
                           [--remove-env-vars]
                           [--replace-env-vars]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--resource-group]
                           [--scale-rule-auth]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--set-env-vars]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--yaml]

Examples

Update a job's replica timeout.

az containerapp job update -n my-containerapp-job -g MyResourceGroup \
    --replica-timeout 10

Optional Parameters

--args

A list of container startup command argument(s). Space-separated values e.g. "-c" "mycommand". Empty string to clear existing values.

--command

A list of supported commands on the container that will executed during startup. Space-separated values e.g. "/bin/queue" "mycommand". Empty string to clear existing values.

--container-name

Name of the container.

--cpu

Required CPU in cores from 0.25 - 2.0, e.g. 0.5.

--cron-expression

Cron expression. Only supported for trigger type "Schedule".

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

--image

Container image, e.g. publisher/image-name:tag.

--max-executions

Maximum number of job executions to run per polling interval.

--memory

Required memory from 0.5 - 4.0 ending with "Gi", e.g. 1.0Gi.

--min-executions

Minimum number of job executions to run per polling interval.

--name -n

The name of the Container Apps Job. 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-wait

Do not wait for the long-running operation to finish.

default value: False

--parallelism

Maximum number of replicas to run per execution.

--polling-interval

Interval to check each event source in seconds. Defaults to 30s.

--rcc --replica-completion-count

Number of replicas that need to complete successfully for execution to succeed.

--remove-all-env-vars

Remove all environment variable(s) from container..

default value: False

--remove-env-vars

Remove environment variable(s) from container. Space-separated environment variable names.

--replace-env-vars

Replace environment variable(s) in container. Other existing environment variables are removed. Space-separated values in 'key=value' format. If stored as a secret, value must start with 'secretref:' followed by the secret name.

--replica-retry-limit

Maximum number of retries before the replica fails.

--replica-timeout

Maximum number of seconds a replica can execute.

--resource-group -g

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

--scale-rule-auth --sra

Scale rule auth parameters. Auth parameters must be in format "= = ...".

--scale-rule-metadata --srm

Scale rule metadata. Metadata must be in format "= = ...".

--scale-rule-name --srn

The name of the scale rule.

--scale-rule-type --srt

The type of the scale rule.

--set-env-vars

Add or update environment variable(s) in container. Existing environment variables are not modified. Space-separated values in 'key=value' format. If stored as a secret, value must start with 'secretref:' followed by the secret name.

--subscription

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

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--workload-profile-name -w

The friendly name for the workload profile.

--yaml

Path to a .yaml file with the configuration of a container app. All other parameters will be ignored. For an example, see https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples.

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.