你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az containerapp job

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展，使其受益于其扩展功能。 详细了解扩展。

用于管理容器应用作业的命令。

命令

名称	说明	类型	Status
az containerapp job create	创建容器应用作业。	核心	GA
az containerapp job create (containerapp 扩展)	创建容器应用作业。	扩展	GA
az containerapp job delete	删除容器应用作业。	核心	GA
az containerapp job delete (containerapp 扩展)	删除容器应用作业。	扩展	GA
az containerapp job execution	用于查看容器应用作业执行的命令。	核心	GA
az containerapp job execution list	获取容器应用作业的所有执行的列表。	核心	GA
az containerapp job execution show	获取容器应用作业的执行。	核心	GA
az containerapp job identity	用于管理容器应用作业的托管标识的命令。	核心	GA
az containerapp job identity assign	将托管标识分配给容器应用作业。	核心	GA
az containerapp job identity remove	从容器应用作业中删除托管标识。	核心	GA
az containerapp job identity show	显示容器应用作业的托管标识。	核心	GA
az containerapp job list	按订阅或资源组列出容器应用作业。	核心	GA
az containerapp job list (containerapp 扩展)	按订阅或资源组列出容器应用作业。	扩展	GA
az containerapp job logs	显示容器应用作业日志。	扩展	预览
az containerapp job logs show	使用 --follow 参数实时显示过去的日志和/或打印日志。 请注意，日志仅取自一个执行、副本和容器。	扩展	预览
az containerapp job registry	用于管理容器应用作业的容器注册表信息的命令。	核心	预览
az containerapp job registry list	列出容器应用作业中配置的容器注册表。	核心	预览
az containerapp job registry remove	删除容器应用作业中的容器注册表详细信息。	核心	预览
az containerapp job registry set	在容器应用作业中添加或更新容器注册表的详细信息。	核心	预览
az containerapp job registry show	显示容器应用作业中容器注册表的详细信息。	核心	预览
az containerapp job replica	管理容器应用副本。	扩展	预览
az containerapp job replica list	列出容器应用作业执行的副本。	扩展	预览
az containerapp job secret	用于管理机密的命令。	核心	GA
az containerapp job secret list	列出容器应用作业的机密。	核心	GA
az containerapp job secret remove	从容器应用作业中删除机密。	核心	GA
az containerapp job secret set	创建/更新机密。	核心	GA
az containerapp job secret show	显示机密的详细信息。	核心	GA
az containerapp job show	显示容器应用作业的详细信息。	核心	GA
az containerapp job show (containerapp 扩展)	显示容器应用作业的详细信息。	扩展	GA
az containerapp job start	启动容器应用作业执行。	核心	GA
az containerapp job stop	停止容器应用作业执行。	核心	GA
az containerapp job update	更新容器应用作业。	核心	GA
az containerapp job update (containerapp 扩展)	更新容器应用作业。	扩展	GA

az containerapp job create

创建容器应用作业。

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]

示例

使用触发器类型作为手动创建容器应用作业。

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

使用触发器类型作为计划创建容器应用作业。

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

使用触发器类型作为事件创建容器应用作业。

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

必需参数

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--args

容器启动命令参数的列表。 空格分隔的值，例如“-c”“mycommand”。 用于清除现有值的空字符串。

--command

将在启动期间执行的容器上支持的命令列表。 空格分隔的值，例如“/bin/queue”“mycommand”。 用于清除现有值的空字符串。

--container-name

容器名。

--cpu

核心中所需的 CPU（从 0.25 到 2.0），例如 0.5。

--cron-expression

Cron 表达式。 仅支持触发器类型“Schedule”。

--env-vars

容器的环境变量列表。 以“key=value”格式分隔的空间值。 用于清除现有值的空字符串。 前缀值为“secretref：”以引用机密。

--environment

容器应用环境的名称或资源 ID。

--image

容器映像，例如 publisher/image-name：tag。

--max-executions

每个轮询间隔运行的最大作业执行次数。

--memory

0.5 - 4.0 的必需内存以“Gi”结尾，例如 1.0Gi。

--mi-system-assigned

指示是否分配系统分配标识的布尔值。

默认值: False

--mi-user-assigned

要分配的空间分隔用户标识。

--min-executions

每个轮询间隔运行的作业执行次数最少。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--parallelism

要按执行运行的最大副本数。

--polling-interval

检查每个事件源的间隔（以秒为单位）。 默认值为 30s。

--rcc --replica-completion-count

需要成功完成才能成功执行的副本数。

--registry-identity

使用注册表服务器进行身份验证的托管标识，而不是用户名/密码。 分别将资源 ID 或“系统”用于用户定义的标识和系统定义标识。 注册表必须是 ACR。 如果可能，将自动为标识创建“acrpull”角色分配。

--registry-password

登录到容器注册表的密码。 如果存储为机密，则值必须以“secretref：”开头，后跟机密名称。

--registry-server

容器注册表服务器主机名，例如 myregistry.azurecr.io。

--registry-username

要登录到容器注册表的用户名。

--replica-retry-limit

副本失败之前的最大重试次数。

--replica-timeout

副本可以执行的最大秒数。

--scale-rule-auth --sra

缩放规则身份验证参数。 身份验证参数的格式必须为“= = ...”。

--scale-rule-metadata --srm

缩放规则元数据。 元数据的格式必须为“= = ...”。

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。

--secrets -s

容器应用的机密列表。 以“key=value”格式分隔的空间值。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--trigger-type

触发器类型。 计划 |事件 |手动。

--workload-profile-name -w

工作负荷配置文件的友好名称。

--yaml

具有容器应用的配置的 .yaml 文件的路径。 将忽略所有其他参数。 有关示例，请参见 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job create (containerapp 扩展)

创建容器应用作业。

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-identity]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--secrets]
                           [--tags]
                           [--trigger-type]
                           [--workload-profile-name]
                           [--yaml]

示例

使用触发器类型作为手动创建容器应用作业。

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

使用触发器类型作为计划创建容器应用作业。

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

使用触发器类型作为事件创建容器应用作业。

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

使用标识创建使用触发器类型作为事件的容器应用作业

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 azure-queue \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength=5" "queueName=foo" \
    --scale-rule-identity myUserIdentityResourceId \
    --image imageName

创建托管在连接环境中的容器应用作业。

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

必需参数

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--args

容器启动命令参数的列表。 空格分隔的值，例如“-c”“mycommand”。 用于清除现有值的空字符串。

--command

将在启动期间执行的容器上支持的命令列表。 空格分隔的值，例如“/bin/queue”“mycommand”。 用于清除现有值的空字符串。

--container-name

容器名。

--cpu

核心中所需的 CPU（从 0.25 到 2.0），例如 0.5。

--cron-expression

Cron 表达式。 仅支持触发器类型“Schedule”。

--env-vars

容器的环境变量列表。 以“key=value”格式分隔的空间值。 用于清除现有值的空字符串。 前缀值为“secretref：”以引用机密。

--environment

容器应用环境的名称或资源 ID。

--environment-type

预览

环境类型。

接受的值: connected, managed

默认值: managed

--image

容器映像，例如 publisher/image-name：tag。

--max-executions

为触发器创建的作业执行的最大数目。

默认值: 100

--memory

0.5 - 4.0 的必需内存以“Gi”结尾，例如 1.0Gi。

--mi-system-assigned

指示是否分配系统分配标识的布尔值。

默认值: False

--mi-user-assigned

要分配的空间分隔用户标识。

--min-executions

为触发器创建的最小作业执行数。 默认值：0。

默认值: 0

--no-wait

不等待长时间运行的操作完成。

默认值: False

--parallelism

要按执行运行的最大副本数。

默认值: 1

--polling-interval

检查每个事件源的间隔（以秒为单位）。

默认值: 30

--rcc --replica-completion-count

需要成功完成才能成功执行的副本数。

默认值: 1

--registry-identity

使用注册表服务器进行身份验证的托管标识，而不是用户名/密码。 分别将资源 ID 或“系统”用于用户定义的标识和系统定义标识。 注册表必须是 ACR。 如果可能，将自动为标识创建“acrpull”角色分配。

--registry-password

登录到容器注册表的密码。 如果存储为机密，则值必须以“secretref：”开头，后跟机密名称。

--registry-server

容器注册表服务器主机名，例如 myregistry.azurecr.io。

--registry-username

要登录到容器注册表的用户名。

--replica-retry-limit

副本失败之前的最大重试次数。 默认值：0。

默认值: 0

--replica-timeout

副本可以执行的最大秒数。

默认值: 1800

--scale-rule-auth --sra

缩放规则身份验证参数。 身份验证参数的格式必须为“= = ...”。

--scale-rule-identity --sri

预览

使用 Azure 缩放程序资源（存储帐户/事件中心或其他）或系统进行身份验证的托管标识的资源 ID，或者使用系统分配的标识。

--scale-rule-metadata --srm

缩放规则元数据。 元数据的格式必须为“= = ...”。

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。

--secrets -s

容器应用的机密列表。 以“key=value”格式分隔的空间值。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--trigger-type

触发器类型。 计划 |事件 |手动。

--workload-profile-name -w

工作负荷配置文件的友好名称。

--yaml

具有容器应用的配置的 .yaml 文件的路径。 将忽略所有其他参数。 有关示例，请参见 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job delete

删除容器应用作业。

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

示例

删除作业。

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

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job delete (containerapp 扩展)

删除容器应用作业。

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

示例

删除作业。

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

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job list

按订阅或资源组列出容器应用作业。

az containerapp job list [--resource-group]

示例

列出当前订阅中的作业。

az containerapp job list

按资源组列出环境。

az containerapp job list -g MyResourceGroup

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job list (containerapp 扩展)

按订阅或资源组列出容器应用作业。

az containerapp job list [--resource-group]

示例

列出当前订阅中的作业。

az containerapp job list

按资源组列出环境。

az containerapp job list -g MyResourceGroup

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job show

显示容器应用作业的详细信息。

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

示例

显示作业的详细信息。

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

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job show (containerapp 扩展)

显示容器应用作业的详细信息。

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

示例

显示作业的详细信息。

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

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job start

启动容器应用作业执行。

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

示例

启动作业执行。

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

使用不同的映像和配置启动作业。

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

可选参数

--args

容器启动命令参数的列表。 空格分隔的值，例如“-c”“mycommand”。 用于清除现有值的空字符串。

--command

将在启动期间执行的容器上支持的命令列表。 空格分隔的值，例如“/bin/queue”“mycommand”。 用于清除现有值的空字符串。

--container-name

容器名。

--cpu

核心中所需的 CPU（从 0.25 到 2.0），例如 0.5。

--env-vars

容器的环境变量列表。 以“key=value”格式分隔的空间值。 用于清除现有值的空字符串。 前缀值为“secretref：”以引用机密。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--image

容器映像，例如 publisher/image-name：tag。

--memory

0.5 - 4.0 的必需内存以“Gi”结尾，例如 1.0Gi。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--registry-identity

使用注册表服务器进行身份验证的托管标识，而不是用户名/密码。 分别将资源 ID 或“系统”用于用户定义的标识和系统定义标识。 注册表必须是 ACR。 如果可能，将自动为标识创建“acrpull”角色分配。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--yaml

具有容器应用的配置的 .yaml 文件的路径。 将忽略所有其他参数。 有关示例，请参见 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job stop

停止容器应用作业执行。

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

示例

停止作业执行。

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

停止提供特定作业执行名称的作业执行。

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

停止多个作业执行，提供执行名称列表。

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

可选参数

--execution-name-list

作业执行名称的逗号分隔列表。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--job-execution-name

需要停止的特定作业执行的名称。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job update

更新容器应用作业。

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]

示例

更新作业的副本超时。

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

可选参数

--args

容器启动命令参数的列表。 空格分隔的值，例如“-c”“mycommand”。 用于清除现有值的空字符串。

--command

将在启动期间执行的容器上支持的命令列表。 空格分隔的值，例如“/bin/queue”“mycommand”。 用于清除现有值的空字符串。

--container-name

容器名。

--cpu

核心中所需的 CPU（从 0.25 到 2.0），例如 0.5。

--cron-expression

Cron 表达式。 仅支持触发器类型“Schedule”。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--image

容器映像，例如 publisher/image-name：tag。

--max-executions

每个轮询间隔运行的最大作业执行次数。

--memory

0.5 - 4.0 的必需内存以“Gi”结尾，例如 1.0Gi。

--min-executions

每个轮询间隔运行的作业执行次数最少。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--parallelism

要按执行运行的最大副本数。

--polling-interval

检查每个事件源的间隔（以秒为单位）。 默认值为 30s。

--rcc --replica-completion-count

需要成功完成才能成功执行的副本数。

--remove-all-env-vars

从 container 中删除所有环境变量。。

默认值: False

--remove-env-vars

从容器中删除环境变量。 空格分隔的环境变量名称。

--replace-env-vars

替换容器中的环境变量。 将删除其他现有环境变量。 以“key=value”格式分隔的空间值。 如果存储为机密，则值必须以“secretref：”开头，后跟机密名称。

--replica-retry-limit

副本失败之前的最大重试次数。

--replica-timeout

副本可以执行的最大秒数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--scale-rule-auth --sra

缩放规则身份验证参数。 身份验证参数的格式必须为“= = ...”。

--scale-rule-metadata --srm

缩放规则元数据。 元数据的格式必须为“= = ...”。

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。

--set-env-vars

在容器中添加或更新环境变量。 不会修改现有环境变量。 以“key=value”格式分隔的空间值。 如果存储为机密，则值必须以“secretref：”开头，后跟机密名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--workload-profile-name -w

工作负荷配置文件的友好名称。

--yaml

具有容器应用的配置的 .yaml 文件的路径。 将忽略所有其他参数。 有关示例，请参见 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az containerapp job update (containerapp 扩展)

更新容器应用作业。

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-identity]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--set-env-vars]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--yaml]

示例

更新作业的副本超时。

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

可选参数

--args

容器启动命令参数的列表。 空格分隔的值，例如“-c”“mycommand”。 用于清除现有值的空字符串。

--command

将在启动期间执行的容器上支持的命令列表。 空格分隔的值，例如“/bin/queue”“mycommand”。 用于清除现有值的空字符串。

--container-name

容器名。

--cpu

核心中所需的 CPU（从 0.25 到 2.0），例如 0.5。

--cron-expression

Cron 表达式。 仅支持触发器类型“Schedule”。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--image

容器映像，例如 publisher/image-name：tag。

--max-executions

每个轮询间隔运行的最大作业执行次数。

--memory

0.5 - 4.0 的必需内存以“Gi”结尾，例如 1.0Gi。

--min-executions

每个轮询间隔运行的作业执行次数最少。

--name -n

容器应用作业的名称。 名称必须包含小写字母数字字符或“-”，以字母开头，以字母数字字符结尾，不能有“--”，并且必须小于 32 个字符。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--parallelism

要按执行运行的最大副本数。

--polling-interval

检查每个事件源的间隔（以秒为单位）。 默认值为 30s。

--rcc --replica-completion-count

需要成功完成才能成功执行的副本数。

--remove-all-env-vars

从 container 中删除所有环境变量。。

默认值: False

--remove-env-vars

从容器中删除环境变量。 空格分隔的环境变量名称。

--replace-env-vars

替换容器中的环境变量。 将删除其他现有环境变量。 以“key=value”格式分隔的空间值。 如果存储为机密，则值必须以“secretref：”开头，后跟机密名称。

--replica-retry-limit

副本失败之前的最大重试次数。

--replica-timeout

副本可以执行的最大秒数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--scale-rule-auth --sra

缩放规则身份验证参数。 身份验证参数的格式必须为“= = ...”。

--scale-rule-identity --sri

预览

使用 Azure 缩放程序资源（存储帐户/事件中心或其他）或系统进行身份验证的托管标识的资源 ID，或者使用系统分配的标识。

--scale-rule-metadata --srm

缩放规则元数据。 元数据的格式必须为“= = ...”。

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。

--set-env-vars

在容器中添加或更新环境变量。 不会修改现有环境变量。 以“key=value”格式分隔的空间值。 如果存储为机密，则值必须以“secretref：”开头，后跟机密名称。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--workload-profile-name -w

工作负荷配置文件的友好名称。

--yaml

具有容器应用的配置的 .yaml 文件的路径。 将忽略所有其他参数。 有关示例，请参见 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。