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

az containerapp

注意

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

管理 Azure 容器应用。

命令

名称 说明 类型 Status
az containerapp add-on

用于管理环境中可用的加载项的命令。

扩展 预览
az containerapp add-on kafka

用于管理容器应用环境的 kafka 加载项的命令。

扩展 预览
az containerapp add-on kafka create

用于创建 kafka 加载项的命令。

扩展 预览
az containerapp add-on kafka delete

用于删除 kafka 加载项的命令。

扩展 预览
az containerapp add-on list

列出环境中的所有加载项。

扩展 预览
az containerapp add-on mariadb

用于管理容器应用环境的 mariadb 加载项的命令。

扩展 预览
az containerapp add-on mariadb create

用于创建 mariadb 加载项的命令。

扩展 预览
az containerapp add-on mariadb delete

用于删除 mariadb 加载项的命令。

扩展 预览
az containerapp add-on milvus

用于管理容器应用环境的 milvus 加载项的命令。

扩展 预览
az containerapp add-on milvus create

用于创建 milvus 加载项的命令。

扩展 预览
az containerapp add-on milvus delete

用于删除 milvus 服务的命令。

扩展 预览
az containerapp add-on postgres

用于管理容器应用环境的 postgres 加载项的命令。

扩展 预览
az containerapp add-on postgres create

用于创建 postgres 加载项的命令。

扩展 预览
az containerapp add-on postgres delete

用于删除 postgres 加载项的命令。

扩展 预览
az containerapp add-on qdrant

用于管理容器应用环境的 qdrant 加载项的命令。

扩展 预览
az containerapp add-on qdrant create

用于创建 qdrant 加载项的命令。

扩展 预览
az containerapp add-on qdrant delete

用于删除 qdrant 加载项的命令。

扩展 预览
az containerapp add-on redis

用于管理容器应用环境的 redis 加载项的命令。

扩展 预览
az containerapp add-on redis create

用于创建 redis 加载项的命令。

扩展 预览
az containerapp add-on redis delete

用于删除 redis 加载项的命令。

扩展 预览
az containerapp add-on weaviate

用于管理容器应用环境的 weaviate 加载项的命令。

扩展 预览
az containerapp add-on weaviate create

用于创建 weaviate 加载项的命令。

扩展 预览
az containerapp add-on weaviate delete

用于删除 weaviate 服务的命令。

扩展 预览
az containerapp auth

管理 containerapp 身份验证和授权。

核心和扩展 GA
az containerapp auth apple

管理 Apple 标识提供者的 containerapp 身份验证和授权。

核心 GA
az containerapp auth apple show

显示 Apple 标识提供者的身份验证设置。

核心 GA
az containerapp auth apple update

更新 Apple 标识提供者的客户端 ID 和客户端密码。

核心 GA
az containerapp auth facebook

管理 Facebook 标识提供者的容器应用身份验证和授权。

核心 GA
az containerapp auth facebook show

显示 Facebook 标识提供者的身份验证设置。

核心 GA
az containerapp auth facebook update

更新 Facebook 标识提供者的应用 ID 和应用机密。

核心 GA
az containerapp auth github

管理 GitHub 标识提供者的容器应用身份验证和授权。

核心 GA
az containerapp auth github show

显示 GitHub 标识提供者的身份验证设置。

核心 GA
az containerapp auth github update

更新 GitHub 标识提供者的客户端 ID 和客户端密码。

核心 GA
az containerapp auth google

管理 Google 标识提供者的 containerapp 身份验证和授权。

核心 GA
az containerapp auth google show

显示 Google 标识提供者的身份验证设置。

核心 GA
az containerapp auth google update

更新 Google 标识提供者的客户端 ID 和客户端密码。

核心 GA
az containerapp auth microsoft

管理Microsoft标识提供者的 containerapp 身份验证和授权。

核心 GA
az containerapp auth microsoft show

显示 Azure Active Directory 标识提供者的身份验证设置。

核心 GA
az containerapp auth microsoft update

更新 Azure Active Directory 标识提供者的客户端 ID 和客户端密码。

核心 GA
az containerapp auth openid-connect

管理自定义 OpenID Connect 标识提供者的容器应用身份验证和授权。

核心 GA
az containerapp auth openid-connect add

配置新的自定义 OpenID Connect 标识提供者。

核心 GA
az containerapp auth openid-connect remove

删除现有的自定义 OpenID Connect 标识提供者。

核心 GA
az containerapp auth openid-connect show

显示自定义 OpenID Connect 标识提供者的身份验证设置。

核心 GA
az containerapp auth openid-connect update

更新现有自定义 OpenID Connect 标识提供者的客户端 ID 和客户端机密设置名称。

核心 GA
az containerapp auth show

显示 containerapp 的身份验证设置。

核心 GA
az containerapp auth show (containerapp 扩展)

显示 containerapp 的身份验证设置。

扩展 GA
az containerapp auth twitter

管理 Twitter 标识提供者的 containerapp 身份验证和授权。

核心 GA
az containerapp auth twitter show

显示 Twitter 标识提供者的身份验证设置。

核心 GA
az containerapp auth twitter update

更新 Twitter 标识提供者的使用者密钥和使用者机密。

核心 GA
az containerapp auth update

更新容器应用的身份验证设置。

核心 GA
az containerapp auth update (containerapp 扩展)

更新容器应用的身份验证设置。

扩展 GA
az containerapp browse

在浏览器中打开容器应用(如果可能)。

核心 GA
az containerapp compose

用于从 Compose 规范创建 Azure 容器应用的命令。

核心和扩展 GA
az containerapp compose create

从 Compose 规范在新的或现有的容器应用环境中创建一个或多个容器应用。

核心 GA
az containerapp compose create (containerapp 扩展)

从 Compose 规范在新的或现有的容器应用环境中创建一个或多个容器应用。

扩展 GA
az containerapp connected-env

用于管理用于已启用 Arc 的容器应用的连接环境的命令。

扩展 预览
az containerapp connected-env certificate

用于管理容器应用连接环境的证书的命令。

扩展 预览
az containerapp connected-env certificate delete

从容器应用连接环境中删除证书。

扩展 预览
az containerapp connected-env certificate list

列出连接的环境的证书。

扩展 预览
az containerapp connected-env certificate upload

添加或更新证书。

扩展 预览
az containerapp connected-env create

创建容器应用连接环境。

扩展 预览
az containerapp connected-env dapr-component

用于管理容器应用连接环境的 Dapr 组件的命令。

扩展 预览
az containerapp connected-env dapr-component list

列出连接的环境的 Dapr 组件。

扩展 预览
az containerapp connected-env dapr-component remove

从连接的环境中删除 Dapr 组件。

扩展 预览
az containerapp connected-env dapr-component set

创建或更新 Dapr 组件。

扩展 预览
az containerapp connected-env dapr-component show

显示 Dapr 组件的详细信息。

扩展 预览
az containerapp connected-env delete

删除容器应用连接环境。

扩展 预览
az containerapp connected-env list

按订阅或资源组列出容器应用连接环境。

扩展 预览
az containerapp connected-env show

显示容器应用连接环境的详细信息。

扩展 预览
az containerapp connected-env storage

用于管理容器应用连接环境的存储的命令。

扩展 预览
az containerapp connected-env storage list

列出连接的环境的存储。

扩展 预览
az containerapp connected-env storage remove

从连接的环境中删除存储。

扩展 预览
az containerapp connected-env storage set

创建或更新存储。

扩展 预览
az containerapp connected-env storage show

显示存储的详细信息。

扩展 预览
az containerapp connection

用于管理容器应用连接的命令。

核心和扩展 GA
az containerapp connection create

在容器应用和目标资源之间创建连接。

核心和扩展 GA
az containerapp connection create app-insights

创建到 app-insights 的容器应用连接。

核心 GA
az containerapp connection create appconfig

创建到 appconfig 的 containerapp 连接。

核心 GA
az containerapp connection create cognitiveservices

创建到认知服务的 containerapp 连接。

核心 GA
az containerapp connection create confluent-cloud

创建到 confluent-cloud 的 containerapp 连接。

核心 GA
az containerapp connection create containerapp

创建 containerapp 到 containerapp 连接。

核心 GA
az containerapp connection create cosmos-cassandra

创建到 cosmos-cassandra 的 containerapp 连接。

核心 GA
az containerapp connection create cosmos-gremlin

创建到 cosmos-gremlin 的 containerapp 连接。

核心 GA
az containerapp connection create cosmos-mongo

创建与 cosmos-mongo 的容器应用连接。

核心 GA
az containerapp connection create cosmos-sql

创建到 cosmos-sql 的 containerapp 连接。

核心 GA
az containerapp connection create cosmos-table

创建到 cosmos-table 的 containerapp 连接。

核心 GA
az containerapp connection create eventhub

创建到 eventhub 的 containerapp 连接。

核心 GA
az containerapp connection create keyvault

创建到 keyvault 的 containerapp 连接。

核心 GA
az containerapp connection create mysql

创建到 mysql 的 containerapp 连接。

核心 已放弃
az containerapp connection create mysql-flexible

创建与 mysql 灵活连接的 containerapp 连接。

核心 GA
az containerapp connection create mysql-flexible (serviceconnector-passwordless 扩展)

创建与 mysql 灵活连接的 containerapp 连接。

扩展 GA
az containerapp connection create postgres

创建到 postgres 的容器应用连接。

核心 已放弃
az containerapp connection create postgres (serviceconnector-passwordless 扩展)

创建到 postgres 的容器应用连接。

扩展 已放弃
az containerapp connection create postgres-flexible

创建到 postgres 灵活部署的容器应用连接。

核心 GA
az containerapp connection create postgres-flexible (serviceconnector-passwordless 扩展)

创建到 postgres 灵活部署的容器应用连接。

扩展 GA
az containerapp connection create redis

创建到 redis 的 containerapp 连接。

核心 GA
az containerapp connection create redis-enterprise

创建与 redis-enterprise 的容器应用连接。

核心 GA
az containerapp connection create servicebus

创建到 servicebus 的 containerapp 连接。

核心 GA
az containerapp connection create signalr

创建到 signalr 的 containerapp 连接。

核心 GA
az containerapp connection create sql

创建到 sql 的 containerapp 连接。

核心 GA
az containerapp connection create sql (serviceconnector-passwordless 扩展)

创建到 sql 的 containerapp 连接。

扩展 GA
az containerapp connection create storage-blob

创建与 storage-blob 的容器应用连接。

核心 GA
az containerapp connection create storage-file

创建到存储文件的容器应用连接。

核心 GA
az containerapp connection create storage-queue

创建到存储队列的 containerapp 连接。

核心 GA
az containerapp connection create storage-table

创建到 storage-table 的 containerapp 连接。

核心 GA
az containerapp connection create webpubsub

创建到 webpubsub 的 containerapp 连接。

核心 GA
az containerapp connection delete

删除容器应用连接。

核心 GA
az containerapp connection list

列出容器应用的连接。

核心 GA
az containerapp connection list-configuration

列出容器应用连接的源配置。

核心 GA
az containerapp connection list-support-types

列出容器应用连接支持的客户端类型和身份验证类型。

核心 GA
az containerapp connection show

获取容器应用连接的详细信息。

核心 GA
az containerapp connection update

更新 containerapp 连接。

核心 GA
az containerapp connection update app-insights

将 containerapp 更新到 app-insights 连接。

核心 GA
az containerapp connection update appconfig

将 containerapp 更新为 appconfig 连接。

核心 GA
az containerapp connection update cognitiveservices

将 containerapp 更新为认知服务连接。

核心 GA
az containerapp connection update confluent-cloud

将 containerapp 更新为 confluent-cloud 连接。

核心 GA
az containerapp connection update containerapp

更新 containerapp 到 containerapp 连接。

核心 GA
az containerapp connection update cosmos-cassandra

将 containerapp 更新为 cosmos-cassandra 连接。

核心 GA
az containerapp connection update cosmos-gremlin

将 containerapp 更新为 cosmos-gremlin 连接。

核心 GA
az containerapp connection update cosmos-mongo

将 containerapp 更新为 cosmos-mongo 连接。

核心 GA
az containerapp connection update cosmos-sql

将 containerapp 更新为 cosmos-sql 连接。

核心 GA
az containerapp connection update cosmos-table

将 containerapp 更新为 cosmos-table 连接。

核心 GA
az containerapp connection update eventhub

将 containerapp 更新为 eventhub 连接。

核心 GA
az containerapp connection update keyvault

将 containerapp 更新为 keyvault 连接。

核心 GA
az containerapp connection update mysql

将 containerapp 更新到 mysql 连接。

核心 已放弃
az containerapp connection update mysql-flexible

将 containerapp 更新为 mysql 灵活连接。

核心 GA
az containerapp connection update postgres

将 containerapp 更新为 postgres 连接。

核心 已放弃
az containerapp connection update postgres-flexible

将 containerapp 更新为 postgres 灵活连接。

核心 GA
az containerapp connection update redis

将 containerapp 更新为 redis 连接。

核心 GA
az containerapp connection update redis-enterprise

将 containerapp 更新为 redis-enterprise 连接。

核心 GA
az containerapp connection update servicebus

将 containerapp 更新到 servicebus 连接。

核心 GA
az containerapp connection update signalr

将 containerapp 更新为信号器连接。

核心 GA
az containerapp connection update sql

将 containerapp 更新到 sql 连接。

核心 GA
az containerapp connection update storage-blob

将 containerapp 更新到 storage-blob 连接。

核心 GA
az containerapp connection update storage-file

将 containerapp 更新为存储文件连接。

核心 GA
az containerapp connection update storage-queue

将 containerapp 更新为存储队列连接。

核心 GA
az containerapp connection update storage-table

将 containerapp 更新到存储表连接。

核心 GA
az containerapp connection update webpubsub

将 containerapp 更新到 webpubsub 连接。

核心 GA
az containerapp connection validate

验证容器应用连接。

核心 GA
az containerapp connection wait

将 CLI 置于等待状态,直到满足连接条件。

核心 GA
az containerapp create

创建容器应用。

核心 GA
az containerapp create (containerapp 扩展)

创建容器应用。

扩展 GA
az containerapp dapr

用于管理 Dapr 的命令。 若要管理 Dapr 组件,请参阅 az containerapp env dapr-component

核心 GA
az containerapp dapr disable

为容器应用禁用 Dapr。 删除现有值。

核心 GA
az containerapp dapr enable

为容器应用启用 Dapr。 更新现有值。

核心 GA
az containerapp delete

删除容器应用。

核心 GA
az containerapp delete (containerapp 扩展)

删除容器应用。

扩展 GA
az containerapp env

用于管理容器应用环境的命令。

核心和扩展 GA
az containerapp env certificate

用于管理容器应用环境的证书的命令。

核心和扩展 GA
az containerapp env certificate create

创建托管证书。

核心 预览
az containerapp env certificate delete

从容器应用环境中删除证书。

核心 GA
az containerapp env certificate delete (containerapp 扩展)

从容器应用环境中删除证书。

扩展 GA
az containerapp env certificate list

列出环境的证书。

核心 GA
az containerapp env certificate list (containerapp 扩展)

列出环境的证书。

扩展 GA
az containerapp env certificate upload

添加或更新证书。

核心 GA
az containerapp env certificate upload (containerapp 扩展)

添加或更新证书。

扩展 GA
az containerapp env create

创建容器应用环境。

核心 GA
az containerapp env create (containerapp 扩展)

创建容器应用环境。

扩展 GA
az containerapp env dapr-component

用于管理容器应用环境的 Dapr 组件的命令。

核心和扩展 GA
az containerapp env dapr-component init

初始化环境的 Dapr 组件和开发服务。

扩展 预览
az containerapp env dapr-component list

列出环境的 Dapr 组件。

核心 GA
az containerapp env dapr-component remove

从环境中删除 Dapr 组件。

核心 GA
az containerapp env dapr-component resiliency

用于管理 dapr 组件的复原策略的命令。

扩展 预览
az containerapp env dapr-component resiliency create

为 dapr 组件创建复原策略。

扩展 预览
az containerapp env dapr-component resiliency delete

删除 dapr 组件的复原策略。

扩展 预览
az containerapp env dapr-component resiliency list

列出 dapr 组件的复原策略。

扩展 预览
az containerapp env dapr-component resiliency show

显示 dapr 组件的复原策略。

扩展 预览
az containerapp env dapr-component resiliency update

更新 dapr 组件的复原策略。

扩展 预览
az containerapp env dapr-component set

创建或更新 Dapr 组件。

核心 GA
az containerapp env dapr-component show

显示 Dapr 组件的详细信息。

核心 GA
az containerapp env delete

删除容器应用环境。

核心 GA
az containerapp env delete (containerapp 扩展)

删除容器应用环境。

扩展 GA
az containerapp env dotnet-component

用于管理环境中的 DotNet 组件的命令。

扩展 预览
az containerapp env dotnet-component create

用于创建 DotNet 组件的命令以启用 Aspire 仪表板。 支持的 DotNet 组件类型为 Aspire 仪表板。

扩展 预览
az containerapp env dotnet-component delete

用于删除 DotNet 组件的命令以禁用 Aspire 仪表板。

扩展 预览
az containerapp env dotnet-component list

用于列出环境中的 DotNet 组件的命令。

扩展 预览
az containerapp env dotnet-component show

用于在环境中显示 DotNet 组件的命令。

扩展 预览
az containerapp env identity

用于管理环境托管标识的命令。

扩展 预览
az containerapp env identity assign

将托管标识分配给托管环境。

扩展 预览
az containerapp env identity remove

从托管环境中删除托管标识。

扩展 预览
az containerapp env identity show

显示托管环境的托管标识。

扩展 预览
az containerapp env java-component

用于管理环境中的 Java 组件的命令。

扩展 预览
az containerapp env java-component admin-for-spring

用于管理容器应用环境的 Spring 管理员的命令。

扩展 预览
az containerapp env java-component admin-for-spring create

用于创建 Spring 管理员的命令。

扩展 预览
az containerapp env java-component admin-for-spring delete

用于删除 Spring 管理员的命令。

扩展 预览
az containerapp env java-component admin-for-spring show

用于显示 Spring 管理员的命令。

扩展 预览
az containerapp env java-component admin-for-spring update

用于更新 Spring 管理员的命令。

扩展 预览
az containerapp env java-component config-server-for-spring

用于管理容器应用环境的 Spring 配置服务器的命令。

扩展 预览
az containerapp env java-component config-server-for-spring create

用于为 Spring 创建配置服务器的命令。

扩展 预览
az containerapp env java-component config-server-for-spring delete

用于删除 Spring 配置服务器的命令。

扩展 预览
az containerapp env java-component config-server-for-spring show

用于显示 Spring 配置服务器的命令。

扩展 预览
az containerapp env java-component config-server-for-spring update

用于更新 Spring 的 Config Server 的命令。

扩展 预览
az containerapp env java-component eureka-server-for-spring

用于管理容器应用环境的 Eureka Server for Spring 的命令。

扩展 预览
az containerapp env java-component eureka-server-for-spring create

用于创建 Spring 的 Eureka Server 的命令。

扩展 预览
az containerapp env java-component eureka-server-for-spring delete

用于删除 Spring 的 Eureka Server 的命令。

扩展 预览
az containerapp env java-component eureka-server-for-spring show

用于显示 Spring 的 Eureka Server 的命令。

扩展 预览
az containerapp env java-component eureka-server-for-spring update

用于更新 Spring 的 Eureka Server 的命令。

扩展 预览
az containerapp env java-component list

列出环境中的所有 Java 组件。

扩展 预览
az containerapp env java-component nacos

用于管理容器应用环境的 Nacos 的命令。

扩展 预览
az containerapp env java-component nacos create

用于创建 Nacos 的命令。

扩展 预览
az containerapp env java-component nacos delete

用于删除 Nacos 的命令。

扩展 预览
az containerapp env java-component nacos show

用于显示 Nacos 的命令。

扩展 预览
az containerapp env java-component nacos update

用于更新 Nacos 的命令。

扩展 预览
az containerapp env java-component spring-cloud-config

用于管理容器应用环境的 Spring 配置服务器的命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-config create

用于创建 Spring Cloud 配置命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-config delete

用于删除 Spring Cloud 配置命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-config show

用于显示 Spring Cloud 配置命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-config update

用于更新 Spring Cloud 配置命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-eureka

用于管理容器应用环境的 Spring Cloud Eureka 的命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-eureka create

用于创建 Spring Cloud Eureka 的命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-eureka delete

用于删除 Spring Cloud Eureka 的命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-eureka show

用于显示 Spring Cloud Eureka 的命令。

扩展 预览和弃用
az containerapp env java-component spring-cloud-eureka update

用于更新 Spring Cloud Eureka 的命令。

扩展 预览和弃用
az containerapp env list

按订阅或资源组列出容器应用环境。

核心 GA
az containerapp env list (containerapp 扩展)

按订阅或资源组列出容器应用环境。

扩展 GA
az containerapp env list-usages

列出特定托管环境的配额使用情况。

核心 GA
az containerapp env logs

显示容器应用环境日志。

核心 GA
az containerapp env logs show

使用 --follow 参数实时显示过去的环境日志和/或打印日志。

核心 GA
az containerapp env show

显示容器应用环境的详细信息。

核心 GA
az containerapp env show (containerapp 扩展)

显示容器应用环境的详细信息。

扩展 GA
az containerapp env storage

用于管理容器应用环境的存储的命令。

核心和扩展 GA
az containerapp env storage list

列出环境的存储。

核心 GA
az containerapp env storage list (containerapp 扩展)

列出环境的存储。

扩展 GA
az containerapp env storage remove

从环境中删除存储。

核心 GA
az containerapp env storage remove (containerapp 扩展)

从环境中删除存储。

扩展 GA
az containerapp env storage set

创建或更新存储。

核心 GA
az containerapp env storage set (containerapp 扩展)

创建或更新存储。

扩展 GA
az containerapp env storage show

显示存储的详细信息。

核心 GA
az containerapp env storage show (containerapp 扩展)

显示存储的详细信息。

扩展 GA
az containerapp env telemetry

用于管理容器应用环境的遥测设置的命令。

扩展 预览
az containerapp env telemetry app-insights

用于管理容器应用环境的应用见解设置的命令。

扩展 预览
az containerapp env telemetry app-insights delete

删除容器应用环境遥测应用见解设置。

扩展 预览
az containerapp env telemetry app-insights set

创建或更新容器应用环境遥测应用见解设置。

扩展 预览
az containerapp env telemetry app-insights show

显示容器应用环境遥测应用见解设置。

扩展 预览
az containerapp env telemetry data-dog

用于管理容器应用环境的数据狗设置的命令。

扩展 预览
az containerapp env telemetry data-dog delete

删除容器应用环境遥测数据狗设置。

扩展 预览
az containerapp env telemetry data-dog set

创建或更新容器应用环境遥测数据狗设置。

扩展 预览
az containerapp env telemetry data-dog show

显示容器应用环境遥测数据狗设置。

扩展 预览
az containerapp env telemetry otlp

用于管理容器应用环境的 otlp 设置的命令。

扩展 预览
az containerapp env telemetry otlp add

添加容器应用环境遥测 otlp 设置。

扩展 预览
az containerapp env telemetry otlp list

列出容器应用环境遥测 otlp 设置。

扩展 预览
az containerapp env telemetry otlp remove

删除容器应用环境遥测 otlp 设置。

扩展 预览
az containerapp env telemetry otlp show

显示容器应用环境遥测 otlp 设置。

扩展 预览
az containerapp env telemetry otlp update

更新容器应用环境遥测 otlp 设置。

扩展 预览
az containerapp env update

更新容器应用环境。

核心 GA
az containerapp env update (containerapp 扩展)

更新容器应用环境。

扩展 GA
az containerapp env workload-profile

管理容器应用环境的工作负荷配置文件。

核心和扩展 GA
az containerapp env workload-profile add

在容器应用环境中创建工作负荷配置文件。

核心 GA
az containerapp env workload-profile delete

从容器应用环境中删除工作负荷配置文件。

核心 GA
az containerapp env workload-profile list

列出容器应用环境中的工作负荷配置文件。

核心 GA
az containerapp env workload-profile list-supported

列出区域中支持的工作负荷配置文件。

核心 GA
az containerapp env workload-profile set

在容器应用环境中创建或更新现有工作负荷配置文件。

扩展 已放弃
az containerapp env workload-profile show

显示容器应用环境中的工作负荷配置文件。

核心 GA
az containerapp env workload-profile update

更新容器应用环境中的现有工作负荷配置文件。

核心 GA
az containerapp exec

在容器应用副本中打开类似于 SSH 的交互式 shell。

核心 GA
az containerapp github-action

用于管理 GitHub Actions 的命令。

核心和扩展 GA
az containerapp github-action add

将 GitHub Actions 工作流添加到存储库以部署容器应用。

核心 GA
az containerapp github-action add (containerapp 扩展)

将 GitHub Actions 工作流添加到存储库以部署容器应用。

扩展 GA
az containerapp github-action delete

从存储库中删除以前配置的容器应用 GitHub Actions 工作流。

核心 GA
az containerapp github-action show

在容器应用上显示 GitHub Actions 配置。

核心 GA
az containerapp hostname

用于管理容器应用的主机名的命令。

核心和扩展 GA
az containerapp hostname add

将主机名添加到容器应用而不绑定。

核心 GA
az containerapp hostname bind

使用证书添加或更新主机名和绑定。

核心 GA
az containerapp hostname bind (containerapp 扩展)

使用证书添加或更新主机名和绑定。

扩展 GA
az containerapp hostname delete

从容器应用中删除主机名。

核心 GA
az containerapp hostname list

列出容器应用的主机名。

核心 GA
az containerapp identity

用于管理托管标识的命令。

核心 GA
az containerapp identity assign

将托管标识分配给容器应用。

核心 GA
az containerapp identity remove

从容器应用中删除托管标识。

核心 GA
az containerapp identity show

显示容器应用的托管标识。

核心 GA
az containerapp ingress

用于管理入口和流量拆分的命令。

核心 GA
az containerapp ingress access-restriction

用于管理 IP 访问限制的命令。

核心 GA
az containerapp ingress access-restriction list

列出容器应用的 IP 访问限制。

核心 GA
az containerapp ingress access-restriction remove

从容器应用中删除 IP 访问限制。

核心 GA
az containerapp ingress access-restriction set

为容器应用配置 IP 访问限制。

核心 GA
az containerapp ingress cors

用于管理容器应用的 CORS 策略的命令。

核心 GA
az containerapp ingress cors disable

为容器应用禁用 CORS 策略。

核心 GA
az containerapp ingress cors enable

为容器应用启用 CORS 策略。

核心 GA
az containerapp ingress cors show

显示容器应用的 CORS 策略。

核心 GA
az containerapp ingress cors update

更新容器应用的 CORS 策略。

核心 GA
az containerapp ingress disable

禁用容器应用的入口。

核心 GA
az containerapp ingress enable

为容器应用启用或更新入口。

核心 GA
az containerapp ingress show

显示容器应用的入口的详细信息。

核心 GA
az containerapp ingress sticky-sessions

用于为容器应用设置粘滞会话相关性的命令。

核心 GA
az containerapp ingress sticky-sessions set

为容器应用配置粘滞会话。

核心 GA
az containerapp ingress sticky-sessions show

显示容器应用的相关性。

核心 GA
az containerapp ingress traffic

用于管理流量拆分的命令。

核心 GA
az containerapp ingress traffic set

为容器应用配置流量拆分。

核心 GA
az containerapp ingress traffic show

显示容器应用的流量拆分配置。

核心 GA
az containerapp ingress update

更新容器应用的入口。

核心 GA
az containerapp java

用于管理 Java 工作负荷的命令。

扩展 GA
az containerapp java logger

动态更改 Java 工作负荷的日志级别。

扩展 预览
az containerapp java logger delete

删除 Java 工作负载的记录器。

扩展 预览
az containerapp java logger set

为 Java 工作负荷创建或更新记录器。

扩展 预览
az containerapp java logger show

显示 Java 工作负载的记录器设置。

扩展 预览
az containerapp job

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

核心和扩展 GA
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 list

列出容器应用。

核心 GA
az containerapp list (containerapp 扩展)

列出容器应用。

扩展 GA
az containerapp list-usages

列出特定区域中订阅级别配额的使用情况。

核心 GA
az containerapp logs

显示容器应用日志。

核心 GA
az containerapp logs show

使用 --follow 参数实时显示过去的日志和/或打印日志。 请注意,日志仅取自一个修订版、副本和容器(对于非系统日志)。

核心 GA
az containerapp patch

修补 Azure 容器应用。 修补仅适用于使用源到云功能生成的应用。 请参阅 https://aka.ms/aca-local-source-to-cloud

扩展 预览
az containerapp patch apply

列出并应用要修补的容器应用。 修补仅适用于使用源到云功能生成的应用。 请参阅 https://aka.ms/aca-local-source-to-cloud

扩展 预览
az containerapp patch interactive

列出并选择要以交互方式修补的容器应用。 修补仅适用于使用源到云功能生成的应用。 请参阅 https://aka.ms/aca-local-source-to-cloud

扩展 预览
az containerapp patch list

列出可修补的容器应用。 修补仅适用于使用源到云功能生成的应用。 请参阅 https://aka.ms/aca-local-source-to-cloud

扩展 预览
az containerapp registry

用于管理容器注册表信息的命令。

核心 GA
az containerapp registry list

列出容器应用中配置的容器注册表。

核心 GA
az containerapp registry remove

删除容器注册表的详细信息。

核心 GA
az containerapp registry set

添加或更新容器注册表的详细信息。

核心 GA
az containerapp registry show

显示容器注册表的详细信息。

核心 GA
az containerapp replica

管理容器应用副本。

核心和扩展 GA
az containerapp replica count

容器应用的副本计数。

扩展 预览
az containerapp replica list

列出容器应用修订的副本。

核心 GA
az containerapp replica list (containerapp 扩展)

列出容器应用修订的副本。

扩展 GA
az containerapp replica show

显示容器应用副本。

核心 GA
az containerapp replica show (containerapp 扩展)

显示容器应用副本。

扩展 GA
az containerapp resiliency

用于管理容器应用的复原策略的命令。

扩展 预览
az containerapp resiliency create

为容器应用创建复原策略。

扩展 预览
az containerapp resiliency delete

删除容器应用的复原策略。

扩展 预览
az containerapp resiliency list

列出容器应用的复原策略。

扩展 预览
az containerapp resiliency show

显示容器应用的复原策略。

扩展 预览
az containerapp resiliency update

更新容器应用的复原策略。

扩展 预览
az containerapp revision

用于管理修订的命令。

核心 GA
az containerapp revision activate

激活修订。

核心 GA
az containerapp revision copy

基于以前的修订创建修订。

核心 GA
az containerapp revision deactivate

停用修订。

核心 GA
az containerapp revision label

管理分配给流量权重的修订标签。

核心 GA
az containerapp revision label add

将修订标签设置为具有关联流量权重的修订。

核心 GA
az containerapp revision label remove

从具有关联流量权重的修订中删除修订标签。

核心 GA
az containerapp revision label swap

在具有关联流量权重的两个修订之间交换修订标签。

核心 GA
az containerapp revision list

列出容器应用的修订。

核心 GA
az containerapp revision restart

重启修订。

核心 GA
az containerapp revision set-mode

设置容器应用的修订模式。

核心 GA
az containerapp revision show

显示修订的详细信息。

核心 GA
az containerapp secret

用于管理机密的命令。

核心 GA
az containerapp secret list

列出容器应用的机密。

核心 GA
az containerapp secret remove

从容器应用中删除机密。

核心 GA
az containerapp secret set

创建/更新机密。

核心 GA
az containerapp secret show

显示机密的详细信息。

核心 GA
az containerapp session

用于管理会话的命令。若要详细了解每个子组下的各个命令,请运行 containerapp 会话 [子组名称] --help。

扩展 GA
az containerapp session code-interpreter

用于与代码解释器会话交互和管理的命令。

扩展 预览
az containerapp session code-interpreter delete-file

删除上传到代码解释器会话的文件。

扩展 预览
az containerapp session code-interpreter execute

在代码解释器会话中执行代码。

扩展 预览
az containerapp session code-interpreter list-files

列出上传到代码解释器会话的文件。

扩展 预览
az containerapp session code-interpreter show-file-content

显示上传到代码解释器会话的文件的内容。

扩展 预览
az containerapp session code-interpreter show-file-metadata

显示上传到代码解释器会话的文件的元数据内容。

扩展 预览
az containerapp session code-interpreter upload-file

将文件上传到代码解释器会话。

扩展 预览
az containerapp sessionpool

用于管理会话池的命令。

扩展 预览
az containerapp sessionpool create

创建或更新会话池。

扩展 预览
az containerapp sessionpool delete

删除会话池。

扩展 预览
az containerapp sessionpool list

按订阅或资源组列出会话池。

扩展 预览
az containerapp sessionpool show

显示会话池的详细信息。

扩展 预览
az containerapp sessionpool update

更新会话池。

扩展 预览
az containerapp show

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

核心 GA
az containerapp show (containerapp 扩展)

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

扩展 GA
az containerapp show-custom-domain-verification-id

显示绑定应用或环境自定义域的验证 ID。

核心 GA
az containerapp ssl

将证书上传到托管环境,将主机名添加到该环境中的应用,并将证书绑定到主机名。

核心 GA
az containerapp ssl upload

将证书上传到托管环境,将主机名添加到该环境中的应用,并将证书绑定到主机名。

核心 GA
az containerapp up

创建或更新容器应用以及任何关联的资源(ACR、资源组、容器应用环境、GitHub Actions 等)。

核心 GA
az containerapp up (containerapp 扩展)

创建或更新容器应用以及任何关联的资源(ACR、资源组、容器应用环境、GitHub Actions 等)。

扩展 GA
az containerapp update

更新容器应用。 在多个修订模式下,基于最新修订创建新的修订。

核心 GA
az containerapp update (containerapp 扩展)

更新容器应用。 在多个修订模式下,基于最新修订创建新的修订。

扩展 GA

az containerapp browse

在浏览器中打开容器应用(如果可能)。

az containerapp browse [--ids]
                       [--name]
                       [--resource-group]
                       [--subscription]

示例

在浏览器中打开容器应用

az containerapp browse -n my-containerapp -g MyResourceGroup

可选参数

--ids

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

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 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 create

创建容器应用。

az containerapp create --name
                       --resource-group
                       [--allow-insecure {false, true}]
                       [--args]
                       [--command]
                       [--container-name]
                       [--cpu]
                       [--dal]
                       [--dapr-app-id]
                       [--dapr-app-port]
                       [--dapr-app-protocol {grpc, http}]
                       [--dapr-http-max-request-size]
                       [--dapr-http-read-buffer-size]
                       [--dapr-log-level {debug, error, info, warn}]
                       [--enable-dapr {false, true}]
                       [--env-vars]
                       [--environment]
                       [--exposed-port]
                       [--image]
                       [--ingress {external, internal}]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--no-wait]
                       [--registry-identity]
                       [--registry-password]
                       [--registry-server]
                       [--registry-username]
                       [--revision-suffix]
                       [--revisions-mode {multiple, single}]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--secrets]
                       [--system-assigned]
                       [--tags]
                       [--target-port]
                       [--termination-grace-period]
                       [--transport {auto, http, http2, tcp}]
                       [--user-assigned]
                       [--workload-profile-name]
                       [--yaml]

示例

创建容器应用并检索其完全限定的域名。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v1.0 --environment MyContainerappEnv \
    --ingress external --target-port 80 \
    --registry-server myregistry.azurecr.io --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --query properties.configuration.ingress.fqdn

创建具有资源要求和副本计数限制的容器应用。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image nginx --environment MyContainerappEnv \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

使用机密和环境变量创建容器应用。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret

使用 YAML 配置创建容器应用。 示例 YAML 配置 - https://aka.ms/azure-container-apps-yaml

az containerapp create -n my-containerapp -g MyResourceGroup \
    --environment MyContainerappEnv \
    --yaml "path/to/yaml/file.yml"

使用 http 缩放规则创建容器应用

az containerapp create -n myapp -g mygroup --environment myenv --image nginx \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自定义缩放规则创建容器应用

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-queue-processor --environment MyContainerappEnv \
    --min-replicas 4 --max-replicas 8 \
    --scale-rule-name queue-based-autoscaling \
    --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"

创建包含机密的容器应用,并将其装载到卷中。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --secret-volume-mount "mnt/secrets"

必需参数

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

--resource-group -g

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

可选参数

--allow-insecure

允许入口流量的不安全连接。

接受的值: false, true
默认值: False
--args

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

--command

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

--container-name

容器名。

--cpu

核心中所需的 CPU(从 0.25 到 2.0),例如 0.5。

--dal --dapr-enable-api-logging

为 Dapr sidecar 启用 API 日志记录。

默认值: False
--dapr-app-id

Dapr 应用程序标识符。

--dapr-app-port

Dapr 端口用于与应用程序通信。

--dapr-app-protocol

Dapr 用于与应用程序通信的协议。

接受的值: grpc, http
--dapr-http-max-request-size --dhmrs

增加请求正文 http 和 grpc 服务器参数的最大大小(以 MB 为单位)以处理大文件的上传。

--dapr-http-read-buffer-size --dhrbs

发送多 KB 标头时要处理的 http 标头读取缓冲区的最大大小(以 KB 为单位)。

--dapr-log-level

设置 Dapr sidecar 的日志级别。

接受的值: debug, error, info, warn
--enable-dapr

指示 Dapr 侧车是否已启用的布尔值。

接受的值: false, true
默认值: False
--env-vars

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

--environment

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

--exposed-port

其他公开端口。 仅受 tcp 传输协议支持。 如果应用入口为外部,则每个环境必须是唯一的。

--image -i

容器映像,例如 publisher/image-name:tag。

--ingress

入口类型。

接受的值: external, internal
--max-replicas

最大副本数。

--memory

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

--min-replicas

副本的最小数目。

--no-wait

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

默认值: False
--registry-identity

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

--registry-password

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

--registry-server

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

--registry-username

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

--revision-suffix

追加到修订名称的用户友好后缀。

--revisions-mode

容器应用的活动修订模式。

接受的值: multiple, single
默认值: single
--scale-rule-auth --sra

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

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

横向扩展前的最大并发请求数。仅支持 http 和 tcp 缩放规则。

--scale-rule-metadata --srm

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

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。 默认值:http。 有关详细信息,请访问 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

装载所有机密的路径,例如 mnt/secrets。

--secrets -s

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

--system-assigned

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

默认值: False
--tags

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

--target-port

用于入口流量的应用程序端口。

--termination-grace-period --tgp

副本在强制终止前正常关闭副本的持续时间(以秒为单位)。 (默认值:30)。

--transport

用于入口流量的传输协议。

接受的值: auto, http, http2, tcp
默认值: auto
--user-assigned

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

--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 create (containerapp 扩展)

创建容器应用。

az containerapp create --name
                       --resource-group
                       [--allow-insecure {false, true}]
                       [--args]
                       [--artifact]
                       [--bind]
                       [--branch]
                       [--build-env-vars]
                       [--command]
                       [--container-name]
                       [--context-path]
                       [--cpu]
                       [--customized-keys]
                       [--dal]
                       [--dapr-app-id]
                       [--dapr-app-port]
                       [--dapr-app-protocol {grpc, http}]
                       [--dapr-http-max-request-size]
                       [--dapr-http-read-buffer-size]
                       [--dapr-log-level {debug, error, info, warn}]
                       [--enable-dapr {false, true}]
                       [--enable-java-agent {false, true}]
                       [--enable-java-metrics {false, true}]
                       [--env-vars]
                       [--environment]
                       [--environment-type {connected, managed}]
                       [--exposed-port]
                       [--image]
                       [--ingress {external, internal}]
                       [--max-inactive-revisions]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--no-wait]
                       [--registry-identity]
                       [--registry-password]
                       [--registry-server]
                       [--registry-username]
                       [--repo]
                       [--revision-suffix]
                       [--revisions-mode {multiple, single}]
                       [--runtime {generic, java}]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-identity]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--secrets]
                       [--service-principal-client-id]
                       [--service-principal-client-secret]
                       [--service-principal-tenant-id]
                       [--source]
                       [--system-assigned]
                       [--tags]
                       [--target-port]
                       [--termination-grace-period]
                       [--token]
                       [--transport {auto, http, http2, tcp}]
                       [--user-assigned]
                       [--workload-profile-name]
                       [--yaml]

示例

创建容器应用并检索其完全限定的域名。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v1.0 --environment MyContainerappEnv \
    --ingress external --target-port 80 \
    --registry-server myregistry.azurecr.io --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --query properties.configuration.ingress.fqdn

创建具有资源要求和副本计数限制的容器应用。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image nginx --environment MyContainerappEnv \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

使用机密和环境变量创建容器应用。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret

使用 YAML 配置创建容器应用。 示例 YAML 配置 - https://aka.ms/azure-container-apps-yaml

az containerapp create -n my-containerapp -g MyResourceGroup \
    --environment MyContainerappEnv \
    --yaml "path/to/yaml/file.yml"

使用 http 缩放规则创建容器应用

az containerapp create -n myapp -g mygroup --environment myenv --image nginx \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自定义缩放规则创建容器应用

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-queue-processor --environment MyContainerappEnv \
    --min-replicas 4 --max-replicas 8 \
    --scale-rule-name queue-based-autoscaling \
    --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"

使用标识通过自定义缩放规则创建容器应用以进行身份验证

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-queue-processor --environment MyContainerappEnv \
    --user-assigned myUserIdentityResourceId --min-replicas 4 --max-replicas 8 \
    --scale-rule-name queue-based-autoscaling \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength=5" "queueName=foo" \
    --scale-rule-identity myUserIdentityResourceId

创建包含机密的容器应用,并将其装载到卷中。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --secret-volume-mount "mnt/secrets"

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

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappConnectedEnv \
    --environment-type connected

从提供的 GitHub 存储库中的新 GitHub Actions 工作流创建容器应用

az containerapp create -n my-containerapp -g MyResourceGroup \
--environment MyContainerappEnv --registry-server MyRegistryServer \
--registry-user MyRegistryUser --registry-pass MyRegistryPass \
--repo https://github.com/myAccount/myRepo

从提供的应用程序源创建容器应用

az containerapp create -n my-containerapp -g MyResourceGroup \
--environment MyContainerappEnv --registry-server MyRegistryServer \
--registry-user MyRegistryUser --registry-pass MyRegistryPass \
--source .

创建启用了 java 指标的容器应用

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --enable-java-metrics

创建启用了 java 代理的容器应用

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --enable-java-agent

必需参数

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

--resource-group -g

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

可选参数

--allow-insecure

允许入口流量的不安全连接。

接受的值: false, true
默认值: False
--args

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

--artifact
预览

用于生成容器映像的应用程序项目的本地路径。 请参阅此处支持的项目: https://aka.ms/SourceToCloudSupportedArtifacts

--bind
预览

要连接到此应用的服务、绑定或 Java 组件的空间分隔列表。 例如,SVC_NAME1[:BIND_NAME1] SVC_NAME2[:BIND_NAME2]...

--branch -b
预览

提供的 GitHub 存储库中的分支。 假定为 GitHub 存储库的默认分支(如果未指定)。

--build-env-vars
预览

生成的环境变量列表。 以“key=value”格式分隔的空间值。

--command

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

--container-name

容器名。

--context-path
预览

用于运行 docker 生成的存储库中的路径。 默认值为“./”。 假定 Dockerfile 名为“Dockerfile”,在此目录中。

--cpu

核心中所需的 CPU(从 0.25 到 2.0),例如 0.5。

--customized-keys
预览

用于更改默认配置名称的自定义密钥。 键是原始名称,值为自定义名称。

--dal --dapr-enable-api-logging

为 Dapr sidecar 启用 API 日志记录。

默认值: False
--dapr-app-id

Dapr 应用程序标识符。

--dapr-app-port

Dapr 端口用于与应用程序通信。

--dapr-app-protocol

Dapr 用于与应用程序通信的协议。

接受的值: grpc, http
--dapr-http-max-request-size --dhmrs

增加请求正文 http 和 grpc 服务器参数的最大大小(以 MB 为单位)以处理大文件的上传。

--dapr-http-read-buffer-size --dhrbs

发送多 KB 标头时要处理的 http 标头读取缓冲区的最大大小(以 KB 为单位)。

--dapr-log-level

设置 Dapr sidecar 的日志级别。

接受的值: debug, error, info, warn
--enable-dapr

指示 Dapr 侧车是否已启用的布尔值。

接受的值: false, true
默认值: False
--enable-java-agent
预览

指示是否为应用启用 Java 代理的布尔值。 仅适用于 Java 运行时。

接受的值: false, true
--enable-java-metrics
预览

指示是否为应用启用 Java 指标的布尔值。 仅适用于 Java 运行时。

接受的值: false, true
--env-vars

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

--environment

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

--environment-type
预览

环境类型。

接受的值: connected, managed
默认值: managed
--exposed-port

其他公开端口。 仅受 tcp 传输协议支持。 如果应用入口为外部,则每个环境必须是唯一的。

--image -i

容器映像,例如 publisher/image-name:tag。

--ingress

入口类型。

接受的值: external, internal
--max-inactive-revisions
预览

容器应用可以拥有的最大非活动修订。

--max-replicas

最大副本数。

--memory

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

--min-replicas

副本的最小数目。

--no-wait

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

默认值: False
--registry-identity

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

--registry-password

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

--registry-server

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

--registry-username

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

--repo
预览

通过 GitHub Actions 以以下格式创建应用: https://github.com//或 /。

--revision-suffix

追加到修订名称的用户友好后缀。

--revisions-mode

容器应用的活动修订模式。

接受的值: multiple, single
默认值: single
--runtime
预览

容器应用的运行时。

接受的值: generic, java
--scale-rule-auth --sra

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

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

横向扩展前的最大并发请求数。仅支持 http 和 tcp 缩放规则。

--scale-rule-identity --sri
预览

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

--scale-rule-metadata --srm

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

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。 默认值:http。 有关详细信息,请访问 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

装载所有机密的路径,例如 mnt/secrets。

--secrets -s

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

--service-principal-client-id --sp-cid
预览

服务主体客户端 ID。 由 GitHub Actions 用来向 Azure 进行身份验证。

--service-principal-client-secret --sp-sec
预览

服务主体客户端机密。 由 GitHub Actions 用来向 Azure 进行身份验证。

--service-principal-tenant-id --sp-tid
预览

服务主体租户 ID。 由 GitHub Actions 用来向 Azure 进行身份验证。

--source
预览

包含用于生成容器映像的应用程序源和 Dockerfile 的本地目录路径。 预览:如果没有 Dockerfile,则使用 buildpack 生成容器映像。 如果 Docker 未运行或生成包无法使用,Oryx 将用于生成映像。 请参阅此处支持的 Oryx 运行时: https://aka.ms/SourceToCloudSupportedVersions

--system-assigned

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

默认值: False
--tags

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

--target-port

用于入口流量的应用程序端口。

--termination-grace-period --tgp

副本在强制终止前正常关闭副本的持续时间(以秒为单位)。 (默认值:30)。

--token
预览

具有对指定存储库的写入访问权限的个人访问令牌。 有关详细信息,请参阅 https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line。 如果未在缓存中提供或未找到 (并使用 --repo),则会打开浏览器页面,以便通过 Github 进行身份验证。

--transport

用于入口流量的传输协议。

接受的值: auto, http, http2, tcp
默认值: auto
--user-assigned

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

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

删除容器应用。

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

示例

删除容器应用。

az containerapp delete -g MyResourceGroup -n MyContainerapp

可选参数

--ids

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

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 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 delete (containerapp 扩展)

删除容器应用。

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

示例

删除容器应用。

az containerapp delete -g MyResourceGroup -n MyContainerapp

可选参数

--ids

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

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 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 exec

在容器应用副本中打开类似于 SSH 的交互式 shell。

az containerapp exec --name
                     --resource-group
                     [--command]
                     [--container]
                     [--replica]
                     [--revision]

示例

exec 进入容器应用

az containerapp exec -n my-containerapp -g MyResourceGroup

执行到特定的容器应用副本和修订

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

在 containerapp 中打开 bash shell

az containerapp exec -n my-containerapp -g MyResourceGroup --command bash

必需参数

--name -n

Containerapp 的名称。

--resource-group -g

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

可选参数

--command

启动命令(bash、zsh、sh 等)。

默认值: sh
--container

要通过 SSH 连接到的容器的名称。

--replica

要通过 SSH 连接到的副本的名称。 使用“az containerapp replica list”列出副本。 如果应用没有流量,则副本可能不存在。

--revision

要通过 ssh 连接到的容器应用修订版的名称。 默认为最新修订。

全局参数
--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 list

列出容器应用。

az containerapp list [--environment]
                     [--resource-group]

示例

列出当前订阅中的容器应用。

az containerapp list

按资源组列出容器应用。

az containerapp list -g MyResourceGroup

可选参数

--environment

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

--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 list (containerapp 扩展)

列出容器应用。

az containerapp list [--environment]
                     [--environment-type {connected, managed}]
                     [--resource-group]

示例

列出当前订阅中的容器应用。

az containerapp list

按资源组列出容器应用。

az containerapp list -g MyResourceGroup

按环境类型列出容器应用。

az containerapp list --environment-type connected

可选参数

--environment

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

--environment-type
预览

环境类型。

接受的值: connected, managed
默认值: all
--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 list-usages

列出特定区域中订阅级别配额的使用情况。

az containerapp list-usages --location

示例

列出特定区域中配额的使用情况。

az containerapp list-usages -l eastus

必需参数

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

全局参数
--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 show

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

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

示例

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

az containerapp show -n my-containerapp -g MyResourceGroup

可选参数

--ids

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

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

--resource-group -g

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

--show-secrets

显示 Containerapp 机密。

默认值: False
--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 show (containerapp 扩展)

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

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

示例

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

az containerapp show -n my-containerapp -g MyResourceGroup

可选参数

--ids

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

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

--resource-group -g

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

--show-secrets

显示 Containerapp 机密。

默认值: False
--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 show-custom-domain-verification-id

显示绑定应用或环境自定义域的验证 ID。

az containerapp show-custom-domain-verification-id

示例

获取验证 ID,需要将其添加为应用自定义域的 TXT 记录来验证域所有权

az containerapp show-custom-domain-verification-id

获取验证 ID,需要将其添加为自定义环境 DNS 后缀的 TXT 记录来验证域所有权

az containerapp show-custom-domain-verification-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 up

创建或更新容器应用以及任何关联的资源(ACR、资源组、容器应用环境、GitHub Actions 等)。

az containerapp up --name
                   [--branch]
                   [--browse]
                   [--context-path]
                   [--env-vars]
                   [--environment]
                   [--image]
                   [--ingress {external, internal}]
                   [--location]
                   [--logs-workspace-id]
                   [--logs-workspace-key]
                   [--registry-password]
                   [--registry-server]
                   [--registry-username]
                   [--repo]
                   [--resource-group]
                   [--service-principal-client-id]
                   [--service-principal-client-secret]
                   [--service-principal-tenant-id]
                   [--source]
                   [--target-port]
                   [--token]
                   [--workload-profile-name]

示例

从 GitHub 存储库中的 dockerfile 创建容器应用(设置 github 操作)

az containerapp up -n my-containerapp --repo https://github.com/myAccount/myRepo

从本地目录中的 dockerfile 创建容器应用(如果未找到 dockerfile,则自动生成容器)

az containerapp up -n my-containerapp --source .

从注册表中的映像创建容器应用

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag

从注册表中启用了入口的映像和指定的环境创建容器应用

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --ingress external --target-port 80 --environment MyEnv

必需参数

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

可选参数

--branch -b

Github 存储库的分支。 假定为 Github 存储库的默认分支(如果未指定)。

--browse

在创建和部署后,在 Web 浏览器中打开应用(如果可能)。

默认值: False
--context-path

从中运行 docker 生成的存储库中的路径。 默认值为“./”。 假定 Dockerfile 名为“Dockerfile”,在此目录中。

--env-vars

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

--environment

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

--image -i

容器映像,例如 publisher/image-name:tag。

--ingress

入口类型。

接受的值: external, internal
--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--logs-workspace-id

要向其发送诊断日志的 Log Analytics 工作区的工作区 ID。 可以使用“az monitor log-analytics workspace create”创建一个。 可能会应用额外的计费。

--logs-workspace-key

用于配置 Log Analytics 工作区的 Log Analytics 工作区密钥。 可以使用“az monitor log-analytics workspace get-shared-keys”检索密钥。

--registry-password

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

--registry-server

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

--registry-username

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

--repo

通过 Github Actions 创建应用。 采用以下格式: https://github.com//或 /。

--resource-group -g

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

--service-principal-client-id --sp-cid

服务主体客户端 ID。 由 Github Actions 用来向 Azure 进行身份验证。

--service-principal-client-secret --sp-sec

服务主体客户端机密。 由 Github Actions 用来向 Azure 进行身份验证。

--service-principal-tenant-id --sp-tid

服务主体租户 ID。 由 Github Actions 用来向 Azure 进行身份验证。

--source

包含用于生成容器映像的应用程序源和 Dockerfile 的本地目录路径。 预览:如果没有 Dockerfile,则使用 buildpack 生成容器映像。 如果 Docker 未运行或生成包无法使用,Oryx 将用于生成映像。 请参阅此处支持的 Oryx 运行时: https://github.com/microsoft/Oryx/blob/main/doc/supportedRuntimeVersions.md

--target-port

用于入口流量的应用程序端口。

--token

具有对指定存储库的写入访问权限的个人访问令牌。 有关详细信息,请参阅 https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line。 如果未在缓存中提供或未找到 (并使用 --repo),则会打开浏览器页面,以便通过 Github 进行身份验证。

--workload-profile-name -w

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

全局参数
--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 up (containerapp 扩展)

创建或更新容器应用以及任何关联的资源(ACR、资源组、容器应用环境、GitHub Actions 等)。

az containerapp up --name
                   [--artifact]
                   [--branch]
                   [--browse]
                   [--build-env-vars]
                   [--connected-cluster-id]
                   [--context-path]
                   [--custom-location]
                   [--env-vars]
                   [--environment]
                   [--image]
                   [--ingress {external, internal}]
                   [--location]
                   [--logs-workspace-id]
                   [--logs-workspace-key]
                   [--registry-password]
                   [--registry-server]
                   [--registry-username]
                   [--repo]
                   [--resource-group]
                   [--service-principal-client-id]
                   [--service-principal-client-secret]
                   [--service-principal-tenant-id]
                   [--source]
                   [--target-port]
                   [--token]
                   [--workload-profile-name]

示例

从 GitHub 存储库中的 dockerfile 创建容器应用(设置 github 操作)

az containerapp up -n my-containerapp --repo https://github.com/myAccount/myRepo

从本地目录中的 dockerfile 创建容器应用(如果未找到 dockerfile,则自动生成容器)

az containerapp up -n my-containerapp --source .

从注册表中的映像创建容器应用

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag

从注册表中启用了入口的映像和指定的环境创建容器应用

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --ingress external --target-port 80 --environment MyEnv

从连接的群集上的注册表中的映像创建容器应用

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --connected-cluster-id MyConnectedClusterResourceId

从连接的环境中的注册表中的映像创建容器应用

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --environment MyConnectedEnvironmentId

必需参数

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

可选参数

--artifact
预览

用于生成容器映像的应用程序项目的本地路径。 请参阅此处支持的项目: https://aka.ms/SourceToCloudSupportedArtifacts

--branch -b

Github 存储库的分支。 假定为 Github 存储库的默认分支(如果未指定)。

--browse

在创建和部署后,在 Web 浏览器中打开应用(如果可能)。

默认值: False
--build-env-vars
预览

生成的环境变量列表。 以“key=value”格式分隔的空间值。

--connected-cluster-id
预览

已连接的群集的资源 ID。 使用“az connectedk8s list”列出。

--context-path

从中运行 docker 生成的存储库中的路径。 默认值为“./”。 假定 Dockerfile 名为“Dockerfile”,在此目录中。

--custom-location
预览

自定义位置的资源 ID。 使用“az customlocation list”列出。

--env-vars

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

--environment

容器应用的托管环境或连接环境的名称或资源 ID。

--image -i

容器映像,例如 publisher/image-name:tag。

--ingress

入口类型。

接受的值: external, internal
--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--logs-workspace-id

要向其发送诊断日志的 Log Analytics 工作区的工作区 ID。 可以使用“az monitor log-analytics workspace create”创建一个。 可能会应用额外的计费。

--logs-workspace-key

用于配置 Log Analytics 工作区的 Log Analytics 工作区密钥。 可以使用“az monitor log-analytics workspace get-shared-keys”检索密钥。

--registry-password

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

--registry-server

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

--registry-username

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

--repo

通过 Github Actions 创建应用。 采用以下格式: https://github.com//或 /。

--resource-group -g

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

--service-principal-client-id --sp-cid

服务主体客户端 ID。 由 Github Actions 用来向 Azure 进行身份验证。

--service-principal-client-secret --sp-sec

服务主体客户端机密。 由 Github Actions 用来向 Azure 进行身份验证。

--service-principal-tenant-id --sp-tid

服务主体租户 ID。 由 Github Actions 用来向 Azure 进行身份验证。

--source

包含用于生成容器映像的应用程序源和 Dockerfile 的本地目录路径。 预览:如果没有 Dockerfile,则使用 buildpack 生成容器映像。 如果 Docker 未运行或生成包无法使用,Oryx 将用于生成映像。 请参阅此处支持的 Oryx 运行时: https://github.com/microsoft/Oryx/blob/main/doc/supportedRuntimeVersions.md

--target-port

用于入口流量的应用程序端口。

--token

具有对指定存储库的写入访问权限的个人访问令牌。 有关详细信息,请参阅 https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line。 如果未在缓存中提供或未找到 (并使用 --repo),则会打开浏览器页面,以便通过 Github 进行身份验证。

--workload-profile-name -w

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

全局参数
--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 update

更新容器应用。 在多个修订模式下,基于最新修订创建新的修订。

az containerapp update [--args]
                       [--command]
                       [--container-name]
                       [--cpu]
                       [--ids]
                       [--image]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--name]
                       [--no-wait]
                       [--remove-all-env-vars]
                       [--remove-env-vars]
                       [--replace-env-vars]
                       [--resource-group]
                       [--revision-suffix]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--set-env-vars]
                       [--subscription]
                       [--tags]
                       [--termination-grace-period]
                       [--workload-profile-name]
                       [--yaml]

示例

更新容器应用的容器映像。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v2.0

更新容器应用的资源要求和缩放限制。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

使用 http 缩放规则更新容器应用

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自定义缩放规则更新容器应用

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-custom-rule \
    --scale-rule-type my-custom-type \
    --scale-rule-metadata key=value key2=value2 \
    --scale-rule-auth triggerparam=secretref triggerparam=secretref

可选参数

--args

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

--command

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

--container-name

容器名。

--cpu

核心中所需的 CPU(从 0.25 到 2.0),例如 0.5。

--ids

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

--image -i

容器映像,例如 publisher/image-name:tag。

--max-replicas

最大副本数。

--memory

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

--min-replicas

副本的最小数目。

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

--no-wait

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

默认值: False
--remove-all-env-vars

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

默认值: False
--remove-env-vars

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

--replace-env-vars

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

--resource-group -g

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

--revision-suffix

追加到修订名称的用户友好后缀。

--scale-rule-auth --sra

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

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

横向扩展前的最大并发请求数。仅支持 http 和 tcp 缩放规则。

--scale-rule-metadata --srm

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

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。 默认值:http。 有关详细信息,请访问 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

装载所有机密的路径,例如 mnt/secrets。

--set-env-vars

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

--subscription

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

--tags

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

--termination-grace-period --tgp

副本在强制终止前正常关闭副本的持续时间(以秒为单位)。 (默认值:30)。

--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 update (containerapp 扩展)

更新容器应用。 在多个修订模式下,基于最新修订创建新的修订。

az containerapp update [--args]
                       [--artifact]
                       [--bind]
                       [--build-env-vars]
                       [--command]
                       [--container-name]
                       [--cpu]
                       [--customized-keys]
                       [--enable-java-agent {false, true}]
                       [--enable-java-metrics {false, true}]
                       [--ids]
                       [--image]
                       [--max-inactive-revisions]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--name]
                       [--no-wait]
                       [--remove-all-env-vars]
                       [--remove-env-vars]
                       [--replace-env-vars]
                       [--resource-group]
                       [--revision-suffix]
                       [--runtime {generic, java}]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-identity]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--set-env-vars]
                       [--source]
                       [--subscription]
                       [--tags]
                       [--termination-grace-period]
                       [--unbind]
                       [--workload-profile-name]
                       [--yaml]

示例

更新容器应用的容器映像。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v2.0

更新容器应用的资源要求和缩放限制。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

使用 http 缩放规则更新容器应用

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自定义缩放规则更新容器应用

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-custom-rule \
    --scale-rule-type my-custom-type \
    --scale-rule-metadata key=value key2=value2 \
    --scale-rule-auth triggerparam=secretref triggerparam=secretref

从提供的应用程序源更新容器应用

az containerapp update -n my-containerapp -g MyResourceGroup --source .

使用已启用 java 指标更新容器应用

az containerapp update -n my-containerapp -g MyResourceGroup \
    --enable-java-metrics

使用启用 java 代理更新容器应用

az containerapp update -n my-containerapp -g MyResourceGroup \
    --enable-java-agent

更新容器应用以擦除 java 增强功能,例如 java 指标、java 代理等。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --runtime generic

可选参数

--args

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

--artifact
预览

用于生成容器映像的应用程序项目的本地路径。 请参阅此处支持的项目: https://aka.ms/SourceToCloudSupportedArtifacts

--bind
预览

要连接到此应用的服务、绑定或 Java 组件的空间分隔列表。 例如,SVC_NAME1[:BIND_NAME1] SVC_NAME2[:BIND_NAME2]...

--build-env-vars
预览

生成的环境变量列表。 以“key=value”格式分隔的空间值。

--command

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

--container-name

容器名。

--cpu

核心中所需的 CPU(从 0.25 到 2.0),例如 0.5。

--customized-keys
预览

用于更改默认配置名称的自定义密钥。 键是原始名称,值为自定义名称。

--enable-java-agent
预览

指示是否为应用启用 Java 代理的布尔值。 仅适用于 Java 运行时。

接受的值: false, true
--enable-java-metrics
预览

指示是否为应用启用 Java 指标的布尔值。 仅适用于 Java 运行时。

接受的值: false, true
--ids

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

--image -i

容器映像,例如 publisher/image-name:tag。

--max-inactive-revisions
预览

容器应用可以拥有的最大非活动修订。

--max-replicas

最大副本数。

--memory

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

--min-replicas

副本的最小数目。

--name -n

Containerapp 的名称。 名称必须包含小写字母数字字符或“-”,以字母开头,以字母数字字符结尾,不能有“--”,并且必须小于 32 个字符。

--no-wait

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

默认值: False
--remove-all-env-vars

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

默认值: False
--remove-env-vars

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

--replace-env-vars

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

--resource-group -g

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

--revision-suffix

追加到修订名称的用户友好后缀。

--runtime
预览

容器应用的运行时。

接受的值: generic, java
--scale-rule-auth --sra

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

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

横向扩展前的最大并发请求数。仅支持 http 和 tcp 缩放规则。

--scale-rule-identity --sri
预览

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

--scale-rule-metadata --srm

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

--scale-rule-name --srn

缩放规则的名称。

--scale-rule-type --srt

缩放规则的类型。 默认值:http。 有关详细信息,请访问 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

装载所有机密的路径,例如 mnt/secrets。

--set-env-vars

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

--source
预览

包含用于生成容器映像的应用程序源和 Dockerfile 的本地目录路径。 预览:如果没有 Dockerfile,则使用 buildpack 生成容器映像。 如果 Docker 未运行或生成包无法使用,Oryx 将用于生成映像。 请参阅此处支持的 Oryx 运行时: https://aka.ms/SourceToCloudSupportedVersions

--subscription

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

--tags

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

--termination-grace-period --tgp

副本在强制终止前正常关闭副本的持续时间(以秒为单位)。 (默认值:30)。

--unbind
预览

要从此应用中删除的服务、绑定或 Java 组件的空间分隔列表。 例如BIND_NAME1...

--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 获取完整的调试日志。