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

az containerapp env

Note

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

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

命令

名称	说明	类型	Status
az containerapp env certificate	用于管理容器应用环境的证书的命令。	核心和扩展	GA
az containerapp env certificate create	创建托管证书。	Core	Preview
az containerapp env certificate delete	从容器应用环境中删除证书。	Core	GA
az containerapp env certificate delete (containerapp 扩展)	从容器应用环境中删除证书。	Extension	GA
az containerapp env certificate list	列出环境的证书。	Core	GA
az containerapp env certificate list (containerapp 扩展)	列出环境的证书。	Extension	GA
az containerapp env certificate upload	添加或更新证书。	Core	GA
az containerapp env certificate upload (containerapp 扩展)	添加或更新证书。	Extension	GA
az containerapp env create	创建容器应用环境。	Core	GA
az containerapp env create (containerapp 扩展)	创建容器应用环境。	Extension	GA
az containerapp env dapr-component	用于管理容器应用环境的 Dapr 组件的命令。	核心和扩展	GA
az containerapp env dapr-component init	初始化环境的 Dapr 组件和开发服务。	Extension	Preview
az containerapp env dapr-component list	列出环境的 Dapr 组件。	Core	GA
az containerapp env dapr-component remove	从环境中删除 Dapr 组件。	Core	GA
az containerapp env dapr-component resiliency	用于管理 dapr 组件的复原策略的命令。	Extension	Preview
az containerapp env dapr-component resiliency create	为 dapr 组件创建复原策略。	Extension	Preview
az containerapp env dapr-component resiliency delete	删除 dapr 组件的复原策略。	Extension	Preview
az containerapp env dapr-component resiliency list	列出 dapr 组件的复原策略。	Extension	Preview
az containerapp env dapr-component resiliency show	显示 dapr 组件的复原策略。	Extension	Preview
az containerapp env dapr-component resiliency update	更新 dapr 组件的复原策略。	Extension	Preview
az containerapp env dapr-component set	创建或更新 Dapr 组件。	Core	GA
az containerapp env dapr-component show	显示 Dapr 组件的详细信息。	Core	GA
az containerapp env delete	删除容器应用环境。	Core	GA
az containerapp env delete (containerapp 扩展)	删除容器应用环境。	Extension	GA
az containerapp env dotnet-component	用于管理环境中的 DotNet 组件的命令。	Extension	Preview
az containerapp env dotnet-component create	用于创建 DotNet 组件的命令以启用 Aspire 仪表板。支持的 DotNet 组件类型为 Aspire 仪表板。	Extension	Preview
az containerapp env dotnet-component delete	用于删除 DotNet 组件的命令以禁用 Aspire 仪表板。	Extension	Preview
az containerapp env dotnet-component list	用于列出环境中的 DotNet 组件的命令。	Extension	Preview
az containerapp env dotnet-component show	用于在环境中显示 DotNet 组件的命令。	Extension	Preview
az containerapp env http-route-config	用于管理环境级别 http 路由的命令。	Extension	Preview
az containerapp env http-route-config create	创建新的 http 路由配置。	Extension	Preview
az containerapp env http-route-config delete	删除 http 路由配置。	Extension	Preview
az containerapp env http-route-config list	列出环境中的 http 路由配置。	Extension	Preview
az containerapp env http-route-config show	显示 http 路由配置。	Extension	Preview
az containerapp env http-route-config update	更新 http 路由配置。	Extension	Preview
az containerapp env identity	用于管理环境托管标识的命令。	Extension	Preview
az containerapp env identity assign	将托管标识分配给托管环境。	Extension	Preview
az containerapp env identity remove	从托管环境中删除托管标识。	Extension	Preview
az containerapp env identity show	显示托管环境的托管标识。	Extension	Preview
az containerapp env java-component	用于管理环境中的 Java 组件的命令。	Extension	GA
az containerapp env java-component admin-for-spring	用于管理容器应用环境的 Spring 管理员的命令。	Extension	GA
az containerapp env java-component admin-for-spring create	用于创建 Spring 管理员的命令。	Extension	GA
az containerapp env java-component admin-for-spring delete	用于删除 Spring 管理员的命令。	Extension	GA
az containerapp env java-component admin-for-spring show	用于显示 Spring 管理员的命令。	Extension	GA
az containerapp env java-component admin-for-spring update	用于更新 Spring 管理员的命令。	Extension	GA
az containerapp env java-component config-server-for-spring	用于管理容器应用环境的 Spring 配置服务器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring create	用于为 Spring 创建配置服务器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring delete	用于删除 Spring 配置服务器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring show	用于显示 Spring 配置服务器的命令。	Extension	GA
az containerapp env java-component config-server-for-spring update	用于更新 Spring 的 Config Server 的命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring	用于管理容器应用环境的 Eureka Server for Spring 的命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring create	用于创建 Spring 的 Eureka Server 的命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring delete	用于删除 Spring 的 Eureka Server 的命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring show	用于显示 Spring 的 Eureka Server 的命令。	Extension	GA
az containerapp env java-component eureka-server-for-spring update	用于更新 Spring 的 Eureka Server 的命令。	Extension	GA
az containerapp env java-component gateway-for-spring	用于管理容器应用环境的 Spring 网关的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring create	用于创建 Spring 网关的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring delete	用于删除 Spring 网关的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring show	用于显示 Spring 网关的命令。	Extension	Preview
az containerapp env java-component gateway-for-spring update	用于更新 Spring 网关的命令。	Extension	Preview
az containerapp env java-component list	列出环境中的所有 Java 组件。	Extension	GA
az containerapp env java-component nacos	用于管理容器应用环境的 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos create	用于创建 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos delete	用于删除 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos show	用于显示 Nacos 的命令。	Extension	Preview
az containerapp env java-component nacos update	用于更新 Nacos 的命令。	Extension	Preview
az containerapp env list	按订阅或资源组列出容器应用环境。	Core	GA
az containerapp env list (containerapp 扩展)	按订阅或资源组列出容器应用环境。	Extension	GA
az containerapp env list-usages	列出特定托管环境的配额使用情况。	Core	GA
az containerapp env logs	显示容器应用环境日志。	Core	GA
az containerapp env logs show	使用 --follow 参数实时显示过去的环境日志和/或打印日志。	Core	GA
az containerapp env maintenance-config	用于管理容器应用的计划内维护的命令。	Extension	Preview
az containerapp env maintenance-config add	将计划内维护添加到容器应用环境。	Extension	Preview
az containerapp env maintenance-config list	列出容器应用环境中的计划内维护。	Extension	Preview
az containerapp env maintenance-config remove	删除容器应用环境中的计划内维护。	Extension	Preview
az containerapp env maintenance-config update	更新容器应用环境中的计划内维护。	Extension	Preview
az containerapp env premium-ingress	为环境配置高级入口设置。	Extension	Preview
az containerapp env premium-ingress add	为环境启用高级入口设置。	Extension	Preview
az containerapp env premium-ingress remove	删除入口设置并将系统还原为默认值。	Extension	Preview
az containerapp env premium-ingress show	显示环境的高级入口设置。	Extension	Preview
az containerapp env premium-ingress update	更新环境的高级入口设置。	Extension	Preview
az containerapp env show	显示容器应用环境的详细信息。	Core	GA
az containerapp env show (containerapp 扩展)	显示容器应用环境的详细信息。	Extension	GA
az containerapp env storage	用于管理容器应用环境的存储的命令。	核心和扩展	GA
az containerapp env storage list	列出环境的存储。	Core	GA
az containerapp env storage list (containerapp 扩展)	列出环境的存储。	Extension	GA
az containerapp env storage remove	从环境中删除存储。	Core	GA
az containerapp env storage remove (containerapp 扩展)	从环境中删除存储。	Extension	GA
az containerapp env storage set	创建或更新存储。	Core	GA
az containerapp env storage set (containerapp 扩展)	创建或更新存储。	Extension	GA
az containerapp env storage show	显示存储的详细信息。	Core	GA
az containerapp env storage show (containerapp 扩展)	显示存储的详细信息。	Extension	GA
az containerapp env telemetry	用于管理容器应用环境的遥测设置的命令。	Extension	Preview
az containerapp env telemetry app-insights	用于管理容器应用环境的应用见解设置的命令。	Extension	Preview
az containerapp env telemetry app-insights delete	删除容器应用环境遥测应用见解设置。	Extension	Preview
az containerapp env telemetry app-insights set	创建或更新容器应用环境遥测应用见解设置。	Extension	Preview
az containerapp env telemetry app-insights show	显示容器应用环境遥测应用见解设置。	Extension	Preview
az containerapp env telemetry data-dog	用于管理容器应用环境的数据狗设置的命令。	Extension	Preview
az containerapp env telemetry data-dog delete	删除容器应用环境遥测数据狗设置。	Extension	Preview
az containerapp env telemetry data-dog set	创建或更新容器应用环境遥测数据狗设置。	Extension	Preview
az containerapp env telemetry data-dog show	显示容器应用环境遥测数据狗设置。	Extension	Preview
az containerapp env telemetry otlp	用于管理容器应用环境的 otlp 设置的命令。	Extension	Preview
az containerapp env telemetry otlp add	添加容器应用环境遥测 otlp 设置。	Extension	Preview
az containerapp env telemetry otlp list	列出容器应用环境遥测 otlp 设置。	Extension	Preview
az containerapp env telemetry otlp remove	删除容器应用环境遥测 otlp 设置。	Extension	Preview
az containerapp env telemetry otlp show	显示容器应用环境遥测 otlp 设置。	Extension	Preview
az containerapp env telemetry otlp update	更新容器应用环境遥测 otlp 设置。	Extension	Preview
az containerapp env update	更新容器应用环境。	Core	GA
az containerapp env update (containerapp 扩展)	更新容器应用环境。	Extension	GA
az containerapp env workload-profile	管理容器应用环境的工作负荷配置文件。	Core	GA
az containerapp env workload-profile add	在容器应用环境中创建工作负荷配置文件。	Core	GA
az containerapp env workload-profile delete	从容器应用环境中删除工作负荷配置文件。	Core	GA
az containerapp env workload-profile list	列出容器应用环境中的工作负荷配置文件。	Core	GA
az containerapp env workload-profile list-supported	列出区域中支持的工作负荷配置文件。	Core	GA
az containerapp env workload-profile show	显示容器应用环境中的工作负荷配置文件。	Core	GA
az containerapp env workload-profile update	更新容器应用环境中的现有工作负荷配置文件。	Core	GA

az containerapp env create

编辑

创建容器应用环境。

az containerapp env create --name
                           --resource-group
                           [--certificate-file --custom-domain-certificate-file]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--dapr-connection-string]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--enable-workload-profiles {false, true}]
                           [--infrastructure-subnet-resource-id]
                           [--internal-only {false, true}]
                           [--location]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--no-wait]
                           [--platform-reserved-cidr]
                           [--platform-reserved-dns-ip]
                           [--storage-account]
                           [--tags]
                           [--zone-redundant]

示例

使用自动生成的 Log Analytics 工作区创建环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2

创建区域冗余环境

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --zone-redundant

使用现有的 Log Analytics 工作区创建环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --logs-workspace-id myLogsWorkspaceID \
    --logs-workspace-key myLogsWorkspaceKey \
    --location eastus2

创建启用了工作负荷配置文件的环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles

在没有启用工作负荷配置文件的情况下创建环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles false

必需参数

--name -n

容器应用环境的名称。

--resource-group -g

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

可选参数

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

--certificate-file --custom-domain-certificate-file

环境自定义域的证书文件（.pfx 或 .pem）的文件路径。若要管理容器应用的证书，请使用 az containerapp env certificate。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

环境的自定义域的证书文件密码。

属性	值
Parameter group:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

环境的自定义域的 DNS 后缀。

属性	值
Parameter group:	Custom Domain Arguments

--dapr-connection-string -d

Dapr 用于将服务导出到服务通信遥测的 Application Insights 连接字符串。

属性	值
Parameter group:	Dapr Arguments

--enable-mtls

指示是否为环境启用了 mTLS 对等身份验证的布尔值。

属性	值
Parameter group:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

指示是否为环境启用对等流量加密的布尔值。

属性	值
Parameter group:	Peer Traffic Configuration Arguments
接受的值:	false, true

--enable-workload-profiles -w

指示环境是否启用了工作负荷配置文件的布尔值。

属性	值
默认值:	True
接受的值:	false, true

--infrastructure-subnet-resource-id -s

基础结构组件和用户应用容器的子网的资源 ID。

属性	值
Parameter group:	Virtual Network Arguments

--internal-only

指示环境只有内部负载均衡器的布尔值。这些环境没有公共静态 IP 资源，因此，如果启用此属性，则必须提供 infrastructureSubnetResourceId。

属性	值
Parameter group:	Virtual Network Arguments
默认值:	False
接受的值:	false, true

--location -l

资源的位置。示例：eastus2、northeurope。

--logs-destination

日志目标。

属性	值
Parameter group:	Monitoring Arguments
默认值:	log-analytics
接受的值:	azure-monitor, log-analytics, none

--logs-workspace-id

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

属性	值
Parameter group:	Monitoring Arguments

--logs-workspace-key

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

属性	值
Parameter group:	Monitoring Arguments

--no-wait

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

属性	值
默认值:	False

--platform-reserved-cidr

CIDR 表示法中的 IP 范围，可为环境基础结构 IP 地址保留。它不得与任何其他子网 IP 范围重叠。

属性	值
Parameter group:	Virtual Network Arguments

--platform-reserved-dns-ip

平台保留 CIDR 定义的 IP 地址，将为内部 DNS 服务器保留。

属性	值
Parameter group:	Virtual Network Arguments

--storage-account

用于 Azure Monitor 的存储帐户的名称或资源 ID。如果提供此值，将自动创建 Azure Monitor 诊断设置。

属性	值
Parameter group:	Monitoring Arguments

--tags

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

--zone-redundant -z

在环境中启用区域冗余。不能在没有 --infrastructure-subnet-resource-id 的情况下使用。如果与 --location 一起使用，则子网的位置必须匹配。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az containerapp env create (containerapp 扩展)

创建容器应用环境。

az containerapp env create --name
                           --resource-group
                           [--certificate-akv-url --custom-domain-certificate-akv-url]
                           [--certificate-file --custom-domain-certificate-file]
                           [--certificate-identity --custom-domain-certificate-identity]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--dapr-connection-string]
                           [--enable-dedicated-gpu {false, true}]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--enable-workload-profiles {false, true}]
                           [--infrastructure-resource-group]
                           [--infrastructure-subnet-resource-id]
                           [--internal-only {false, true}]
                           [--location]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-dynamic-json-columns {false, true}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--mi-system-assigned]
                           [--mi-user-assigned]
                           [--no-wait]
                           [--platform-reserved-cidr]
                           [--platform-reserved-dns-ip]
                           [--public-network-access {Disabled, Enabled}]
                           [--storage-account]
                           [--tags]
                           [--zone-redundant]

示例

使用自动生成的 Log Analytics 工作区创建环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2

创建区域冗余环境

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --zone-redundant

使用现有的 Log Analytics 工作区创建环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --logs-workspace-id myLogsWorkspaceID \
    --logs-workspace-key myLogsWorkspaceKey \
    --location eastus2

创建启用了工作负荷配置文件的环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles

在没有启用工作负荷配置文件的情况下创建环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --enable-workload-profiles false

创建具有系统分配标识和用户分配标识的环境。

az containerapp env create -n MyContainerappEnvironment -g MyResourceGroup \
    --location eastus2 --mi-system-assigned --mi-user-assigned MyUserIdentityResourceId

必需参数

--name -n

容器应用环境的名称。

--resource-group -g

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

可选参数

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

--certificate-akv-url --custom-domain-certificate-akv-url

预览

指向保存证书的 Azure Key Vault 机密的 URL。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-file --custom-domain-certificate-file

环境自定义域的证书文件（.pfx 或 .pem）的文件路径。若要管理容器应用的证书，请使用 az containerapp env certificate。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-identity --custom-domain-certificate-identity

预览

使用 Azure Key Vault 进行身份验证的托管标识的资源 ID，或使用系统分配的标识。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

环境的自定义域的证书文件密码。

属性	值
Parameter group:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

环境的自定义域的 DNS 后缀。

属性	值
Parameter group:	Custom Domain Arguments

--dapr-connection-string -d

Dapr 用于将服务导出到服务通信遥测的 Application Insights 连接字符串。

属性	值
Parameter group:	Dapr Arguments

--enable-dedicated-gpu

预览

指示环境是否启用了专用 gpu 的布尔值。

属性	值
默认值:	False
接受的值:	false, true

--enable-mtls

指示是否为环境启用了 mTLS 对等身份验证的布尔值。

属性	值
Parameter group:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

指示是否为环境启用对等流量加密的布尔值。

属性	值
Parameter group:	Peer Traffic Configuration Arguments
接受的值:	false, true

--enable-workload-profiles -w

指示环境是否启用了工作负荷配置文件的布尔值。

属性	值
默认值:	True
接受的值:	false, true

--infrastructure-resource-group -i

预览

将包含基础结构资源的资源组的名称。如果未提供，将生成资源组名称。

属性	值
Parameter group:	Virtual Network Arguments

--infrastructure-subnet-resource-id -s

基础结构组件和用户应用容器的子网的资源 ID。

属性	值
Parameter group:	Virtual Network Arguments

--internal-only

指示环境只有内部负载均衡器的布尔值。这些环境没有公共静态 IP 资源，因此，如果启用此属性，则必须提供 infrastructureSubnetResourceId。

属性	值
Parameter group:	Virtual Network Arguments
默认值:	False
接受的值:	false, true

--location -l

资源的位置。示例：eastus2、northeurope。

--logs-destination

日志目标。

属性	值
Parameter group:	Monitoring Arguments
默认值:	log-analytics
接受的值:	azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

预览

指示是否分析 json 字符串日志到动态 json 列的布尔值。仅适用于目标 log-analytics。

属性	值
Parameter group:	Monitoring Arguments
默认值:	False
接受的值:	false, true

--logs-workspace-id

属性	值
Parameter group:	Monitoring Arguments

--logs-workspace-key

属性	值
Parameter group:	Monitoring Arguments

--mi-system-assigned

预览

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

属性	值
Parameter group:	Identity Arguments
默认值:	False

--mi-user-assigned

预览

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

属性	值
Parameter group:	Identity Arguments

--no-wait

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

属性	值
默认值:	False

--platform-reserved-cidr

CIDR 表示法中的 IP 范围，可为环境基础结构 IP 地址保留。它不得与任何其他子网 IP 范围重叠。

属性	值
Parameter group:	Virtual Network Arguments

--platform-reserved-dns-ip

平台保留 CIDR 定义的 IP 地址，将为内部 DNS 服务器保留。

属性	值
Parameter group:	Virtual Network Arguments

--public-network-access

预览

允许或阻止所有公共流量。

属性	值
接受的值:	Disabled, Enabled

--storage-account

用于 Azure Monitor 的存储帐户的名称或资源 ID。如果提供此值，将自动创建 Azure Monitor 诊断设置。

属性	值
Parameter group:	Monitoring Arguments

--tags

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

--zone-redundant -z

在环境中启用区域冗余。不能在没有 --infrastructure-subnet-resource-id 的情况下使用。如果与 --location 一起使用，则子网的位置必须匹配。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az containerapp env delete

编辑

删除容器应用环境。

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

示例

删除环境。

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

可选参数

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

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--no-wait

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

属性	值
默认值:	False

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--yes -y

不要提示确认。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az containerapp env delete (containerapp 扩展)

删除容器应用环境。

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

示例

删除环境。

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

可选参数

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

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--no-wait

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

属性	值
默认值:	False

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--yes -y

不要提示确认。

属性	值
默认值:	False

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az containerapp env list

编辑

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

az containerapp env list [--resource-group]

示例

列出当前订阅中的环境。

az containerapp env list

按资源组列出环境。

az containerapp env list -g MyResourceGroup

可选参数

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

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az containerapp env list (containerapp 扩展)

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

az containerapp env list [--resource-group]

示例

列出当前订阅中的环境。

az containerapp env list

按资源组列出环境。

az containerapp env list -g MyResourceGroup

可选参数

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

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az containerapp env list-usages

编辑

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

az containerapp env list-usages [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

示例

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

az containerapp env list-usages -n MyEnv -g MyResourceGroup

可选参数

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

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az containerapp env show

编辑

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

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

示例

显示环境的详细信息。

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

可选参数

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

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az containerapp env show (containerapp 扩展)

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

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

示例

显示环境的详细信息。

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

可选参数

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

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az containerapp env update

编辑

更新容器应用环境。

az containerapp env update [--certificate-file --custom-domain-certificate-file]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--dapr-connection-string]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--ids]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--max-nodes]
                           [--min-nodes]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--workload-profile-type]

示例

更新环境的自定义域配置。

az containerapp env update -n MyContainerappEnvironment -g MyResourceGroup \
    --dns-suffix my-suffix.net --certificate-file MyFilePath \
    --certificate-password MyCertPass

可选参数

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

--certificate-file --custom-domain-certificate-file

环境自定义域的证书文件（.pfx 或 .pem）的文件路径。若要管理容器应用的证书，请使用 az containerapp env certificate。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

环境的自定义域的证书文件密码。

属性	值
Parameter group:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

环境的自定义域的 DNS 后缀。

属性	值
Parameter group:	Custom Domain Arguments

--dapr-connection-string -d

Dapr 用于将服务导出到服务通信遥测的 Application Insights 连接字符串。使用“none”将其删除。

属性	值
Parameter group:	Dapr Arguments

--enable-mtls

指示是否为环境启用了 mTLS 对等身份验证的布尔值。

属性	值
Parameter group:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

指示是否为环境启用对等流量加密的布尔值。

属性	值
Parameter group:	Peer Traffic Configuration Arguments
接受的值:	false, true

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--logs-destination

日志目标。

属性	值
Parameter group:	Monitoring Arguments
接受的值:	azure-monitor, log-analytics, none

--logs-workspace-id

属性	值
Parameter group:	Monitoring Arguments

--logs-workspace-key

属性	值
Parameter group:	Monitoring Arguments

--max-nodes

此工作负荷配置文件所需的最大节点 --workload-profile-name。

--min-nodes

此工作负荷配置文件所需的最小节点 --workload-profile-name。

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--no-wait

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

属性	值
默认值:	False

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--storage-account

用于 Azure Monitor 的存储帐户的名称或资源 ID。如果提供此值，将自动创建 Azure Monitor 诊断设置。

属性	值
Parameter group:	Monitoring Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--tags

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

--workload-profile-name -w

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

--workload-profile-type

在此环境中添加或更新的工作负荷配置文件的类型，需要 --workload-profile-name。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

az containerapp env update (containerapp 扩展)

更新容器应用环境。

az containerapp env update [--certificate-akv-url --custom-domain-certificate-akv-url]
                           [--certificate-file --custom-domain-certificate-file]
                           [--certificate-identity --custom-domain-certificate-identity]
                           [--certificate-password --custom-domain-certificate-password]
                           [--custom-domain-dns-suffix --dns-suffix]
                           [--enable-mtls {false, true}]
                           [--enable-peer-to-peer-encryption {false, true}]
                           [--ids]
                           [--logs-destination {azure-monitor, log-analytics, none}]
                           [--logs-dynamic-json-columns {false, true}]
                           [--logs-workspace-id]
                           [--logs-workspace-key]
                           [--max-nodes]
                           [--min-nodes]
                           [--name]
                           [--no-wait]
                           [--public-network-access {Disabled, Enabled}]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--workload-profile-type]

示例

更新环境的自定义域配置。

az containerapp env update -n MyContainerappEnvironment -g MyResourceGroup \
    --dns-suffix my-suffix.net --certificate-file MyFilePath \
    --certificate-password MyCertPass

可选参数

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

--certificate-akv-url --custom-domain-certificate-akv-url

预览

指向保存证书的 Azure Key Vault 机密的 URL。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-file --custom-domain-certificate-file

环境自定义域的证书文件（.pfx 或 .pem）的文件路径。若要管理容器应用的证书，请使用 az containerapp env certificate。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-identity --custom-domain-certificate-identity

预览

使用 Azure Key Vault 进行身份验证的托管标识的资源 ID，或使用系统分配的标识。

属性	值
Parameter group:	Custom Domain Arguments

--certificate-password --custom-domain-certificate-password

环境的自定义域的证书文件密码。

属性	值
Parameter group:	Custom Domain Arguments

--custom-domain-dns-suffix --dns-suffix

环境的自定义域的 DNS 后缀。

属性	值
Parameter group:	Custom Domain Arguments

--enable-mtls

指示是否为环境启用了 mTLS 对等身份验证的布尔值。

属性	值
Parameter group:	Peer Authentication Arguments
接受的值:	false, true

--enable-peer-to-peer-encryption

指示是否为环境启用对等流量加密的布尔值。

属性	值
Parameter group:	Peer Traffic Configuration Arguments
接受的值:	false, true

--ids

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

属性	值
Parameter group:	Resource Id Arguments

--logs-destination

日志目标。

属性	值
Parameter group:	Monitoring Arguments
接受的值:	azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

预览

指示是否分析 json 字符串日志到动态 json 列的布尔值。仅适用于目标 log-analytics。

属性	值
Parameter group:	Monitoring Arguments
接受的值:	false, true

--logs-workspace-id

属性	值
Parameter group:	Monitoring Arguments

--logs-workspace-key

属性	值
Parameter group:	Monitoring Arguments

--max-nodes

此工作负荷配置文件所需的最大节点 --workload-profile-name。

--min-nodes

此工作负荷配置文件所需的最小节点 --workload-profile-name。

--name -n

容器应用环境的名称。

属性	值
Parameter group:	Resource Id Arguments

--no-wait

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

属性	值
默认值:	False

--public-network-access

预览

允许或阻止所有公共流量。

属性	值
接受的值:	Disabled, Enabled

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--storage-account

用于 Azure Monitor 的存储帐户的名称或资源 ID。如果提供此值，将自动创建 Azure Monitor 诊断设置。

属性	值
Parameter group:	Monitoring Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--tags

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

--workload-profile-name -w

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

--workload-profile-type

在此环境中添加或更新的工作负荷配置文件的类型，需要 --workload-profile-name。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

属性	值
默认值:	False

反馈

此页面是否有帮助？

通过

az containerapp env

命令

az containerapp env create

示例

必需参数

可选参数

az containerapp env create (containerapp 扩展)

示例

必需参数

可选参数

az containerapp env delete

示例

可选参数

az containerapp env delete (containerapp 扩展)

示例

可选参数

az containerapp env list

示例

可选参数

az containerapp env list (containerapp 扩展)

示例

可选参数

az containerapp env list-usages

示例

可选参数

az containerapp env show

示例

可选参数

az containerapp env show (containerapp 扩展)

示例

可选参数

az containerapp env update

示例

可选参数

az containerapp env update (containerapp 扩展)

示例

可选参数

反馈