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

az containerapp env

注意

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

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

命令

名称 说明 类型 Status
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 组件的命令。

分机 GA
az containerapp env java-component admin-for-spring

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

分机 GA
az containerapp env java-component admin-for-spring create

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

分机 GA
az containerapp env java-component admin-for-spring delete

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

分机 GA
az containerapp env java-component admin-for-spring show

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

分机 GA
az containerapp env java-component admin-for-spring update

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

分机 GA
az containerapp env java-component config-server-for-spring

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

分机 GA
az containerapp env java-component config-server-for-spring create

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

分机 GA
az containerapp env java-component config-server-for-spring delete

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

分机 GA
az containerapp env java-component config-server-for-spring show

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

分机 GA
az containerapp env java-component config-server-for-spring update

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

分机 GA
az containerapp env java-component eureka-server-for-spring

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

分机 GA
az containerapp env java-component eureka-server-for-spring create

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

分机 GA
az containerapp env java-component eureka-server-for-spring delete

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

分机 GA
az containerapp env java-component eureka-server-for-spring show

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

分机 GA
az containerapp env java-component eureka-server-for-spring update

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

分机 GA
az containerapp env java-component gateway-for-spring

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

分机 预览
az containerapp env java-component gateway-for-spring create

用于创建 Spring 网关的命令。

分机 预览
az containerapp env java-component gateway-for-spring delete

用于删除 Spring 网关的命令。

分机 预览
az containerapp env java-component gateway-for-spring show

用于显示 Spring 网关的命令。

分机 预览
az containerapp env java-component gateway-for-spring update

用于更新 Spring 网关的命令。

分机 预览
az containerapp env java-component list

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

分机 GA
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 maintenance-config

用于管理容器应用的计划内维护的命令。

分机 预览
az containerapp env maintenance-config add

将计划内维护添加到容器应用环境。

分机 预览
az containerapp env maintenance-config list

列出容器应用环境中的计划内维护。

分机 预览
az containerapp env maintenance-config remove

删除容器应用环境中的计划内维护。

分机 预览
az containerapp env maintenance-config update

更新容器应用环境中的计划内维护。

分机 预览
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-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]

示例

使用自动生成的日志分析工作区创建环境。

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
已放弃

参数“instrumentation_key”已弃用,将在将来的版本中删除。

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

--docker-bridge-cidr
已放弃

选项“--docker-bridge-cidr”已弃用,并将在 Ignite 2024 中删除

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

--enable-mtls

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

接受的值: false, true
--enable-peer-to-peer-encryption

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

接受的值: 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-connection-string]
                           [--dapr-instrumentation-key]
                           [--docker-bridge-cidr]
                           [--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]

示例

使用自动生成的日志分析工作区创建环境。

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-connection-string -d

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

--dapr-instrumentation-key
已放弃

参数“instrumentation_key”已弃用,将在将来的版本中删除。

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

--docker-bridge-cidr
已放弃

选项“--docker-bridge-cidr”已弃用,并将在 Ignite 2024 中删除

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

--enable-dedicated-gpu
预览

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

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

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

接受的值: false, true
--enable-peer-to-peer-encryption

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

接受的值: 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 服务器保留。

--public-network-access
预览

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

接受的值: Disabled, Enabled
--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

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

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]
                           [--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

可选参数

--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 连接字符串。 使用“none”将其删除。

--enable-mtls

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

接受的值: false, true
--enable-peer-to-peer-encryption

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

接受的值: 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}]
                           [--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

可选参数

--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
--enable-peer-to-peer-encryption

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

接受的值: 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
--public-network-access
预览

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

接受的值: Disabled, Enabled
--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 获取完整的调试日志。