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

az containerapp env

注意

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

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

命令

名称	说明	类型	状态
az containerapp env certificate	用于管理容器应用环境的证书的命令。	核心和扩展	GA
az containerapp env certificate create	创建托管证书。	扩展	预览
az containerapp env certificate delete	从容器应用环境中删除证书。	核心	GA
az containerapp env certificate delete (containerapp 扩展)	从容器应用环境中删除证书。	扩展	预览
az containerapp env certificate list	列出环境的证书。	核心	GA
az containerapp env certificate list (containerapp 扩展)	列出环境的证书。	扩展	预览
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 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 list	列出环境中的所有 Java 组件。	扩展	预览
az containerapp env java-component spring-cloud-config	用于管理容器应用环境的 Spring Cloud 配置命令。	扩展	预览
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	列出特定托管环境的配额使用情况。	扩展	预览
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 env create

创建容器应用环境。

az containerapp env create --name
                           --resource-group
                           [--certificate-file]
                           [--certificate-password]
                           [--custom-domain-dns-suffix]
                           [--dapr-connection-string]
                           [--dapr-instrumentation-key]
                           [--docker-bridge-cidr]
                           [--enable-mtls {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> 配置默认组。

可选参数

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

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

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

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

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

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

--dapr-connection-string -d

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

--dapr-instrumentation-key

Dapr 用于将服务导出到服务通信遥测的 Application Insights 检测密钥。

--docker-bridge-cidr

分配给 Docker 网桥的 CIDR 表示法 IP 范围。 如果已定义，则它不得与平台保留 CIDR 中定义的任何子网 IP 范围或 IP 范围重叠。

--enable-mtls

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

接受的值: false, true

--enable-workload-profiles -w

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

接受的值: false, true

默认值: True

--infrastructure-subnet-resource-id -s

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

--internal-only

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

接受的值: false, true

默认值: False

--location -l

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

--logs-destination

日志目标。

接受的值: azure-monitor, log-analytics, none

默认值: log-analytics

--logs-workspace-id

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

--logs-workspace-key

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

--no-wait

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

默认值: False

--platform-reserved-cidr

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

--platform-reserved-dns-ip

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

--storage-account

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

--tags

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

--zone-redundant -z

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

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

创建容器应用环境。

az containerapp env create --name
                           --resource-group
                           [--certificate-akv-url]
                           [--certificate-file]
                           [--certificate-identity]
                           [--certificate-password]
                           [--custom-domain-dns-suffix]
                           [--dapr-instrumentation-key]
                           [--docker-bridge-cidr]
                           [--enable-dedicated-gpu {false, true}]
                           [--enable-mtls {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]
                           [--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> 配置默认组。

可选参数

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

预览

指向保存证书的 Azure 密钥库 机密的 URL。

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

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

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

预览

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

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

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

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

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

--dapr-instrumentation-key

Dapr 用于将服务导出到服务通信遥测的 Application Insights 检测密钥。

--docker-bridge-cidr

分配给 Docker 网桥的 CIDR 表示法 IP 范围。 如果已定义，则它不得与平台保留 CIDR 中定义的任何子网 IP 范围或 IP 范围重叠。

--enable-dedicated-gpu

预览

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

接受的值: false, true

默认值: False

--enable-mtls

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

接受的值: false, true

--enable-workload-profiles -w

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

接受的值: false, true

默认值: True

--infrastructure-resource-group -i

预览

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

--infrastructure-subnet-resource-id -s

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

--internal-only

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

接受的值: false, true

默认值: False

--location -l

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

--logs-destination

日志目标。

接受的值: azure-monitor, log-analytics, none

默认值: log-analytics

--logs-dynamic-json-columns -j

预览

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

接受的值: false, true

默认值: False

--logs-workspace-id

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

--logs-workspace-key

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

--mi-system-assigned

预览

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

默认值: False

--mi-user-assigned

预览

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

--no-wait

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

默认值: False

--platform-reserved-cidr

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

--platform-reserved-dns-ip

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

--storage-account

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

--tags

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

--zone-redundant -z

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

默认值: 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 env delete

删除容器应用环境。

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

示例

删除环境。

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

可选参数

--ids

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

--name -n

容器应用环境的名称。

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

删除容器应用环境。

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

示例

删除环境。

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

可选参数

--ids

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

--name -n

容器应用环境的名称。

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

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

az containerapp env list [--resource-group]

示例

列出当前订阅中的环境。

az containerapp env list

按资源组列出环境。

az containerapp env list -g MyResourceGroup

可选参数

--resource-group -g

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

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

--output -o

输出格式。

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

默认值: json

--query

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

--subscription

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

--verbose

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

az containerapp env list (containerapp 扩展)

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

az containerapp env list [--resource-group]

示例

列出当前订阅中的环境。

az containerapp env list

按资源组列出环境。

az containerapp env list -g MyResourceGroup

可选参数

--resource-group -g

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

全局参数

--debug

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

--help -h

显示此帮助消息并退出。

--only-show-errors

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

--output -o

输出格式。

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

默认值: json

--query

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

--subscription

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

--verbose

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

az containerapp env list-usages

预览

此命令处于预览阶段，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

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

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

示例

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

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

可选参数

--ids

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

--name -n

容器应用环境的名称。

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

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

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

示例

显示环境的详细信息。

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

可选参数

--ids

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

--name -n

容器应用环境的名称。

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

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

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

示例

显示环境的详细信息。

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

可选参数

--ids

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

--name -n

容器应用环境的名称。

--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 env update

更新容器应用环境。

az containerapp env update [--certificate-file]
                           [--certificate-password]
                           [--custom-domain-dns-suffix]
                           [--enable-mtls {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

可选参数

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

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

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

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

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

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

--enable-mtls

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

接受的值: false, true

--ids

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

--logs-destination

日志目标。

接受的值: azure-monitor, log-analytics, none

--logs-workspace-id

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

--logs-workspace-key

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

--max-nodes

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

--min-nodes

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

--name -n

容器应用环境的名称。

--no-wait

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

默认值: False

--resource-group -g

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

--storage-account

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

--subscription

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

--tags

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

--workload-profile-name -w

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

--workload-profile-type

在此环境中添加或更新的工作负荷配置文件的类型，需要 --workload-profile-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 env update (containerapp 扩展)

更新容器应用环境。

az containerapp env update [--certificate-akv-url]
                           [--certificate-file]
                           [--certificate-identity]
                           [--certificate-password]
                           [--custom-domain-dns-suffix]
                           [--enable-mtls {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]
                           [--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

可选参数

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

预览

指向保存证书的 Azure 密钥库 机密的 URL。

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

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

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

预览

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

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

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

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

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

--enable-mtls

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

接受的值: false, true

--ids

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

--logs-destination

日志目标。

接受的值: azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

预览

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

接受的值: false, true

--logs-workspace-id

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

--logs-workspace-key

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

--max-nodes

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

--min-nodes

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

--name -n

容器应用环境的名称。

--no-wait

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

默认值: False

--resource-group -g

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

--storage-account

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

--subscription

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

--tags

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

--workload-profile-name -w

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

--workload-profile-type

在此环境中添加或更新的工作负荷配置文件的类型，需要 --workload-profile-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 获取完整的调试日志。