az containerapp env
注意
此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。
管理容器應用程式環境的命令。
命令
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]
範例
使用自動產生的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 configure --defaults group=<name>
來設定預設群組。
選擇性參數
環境自定義網域之憑證檔案的 filepath (.pfx 或 .pem)。 若要管理容器應用程式的憑證,請使用 az containerapp env certificate
。
環境自定義網域的憑證檔案密碼。
環境自定義網域的 DNS 後綴。
Dapr 用來將服務導出至服務通訊遙測的 Application Insights 連接字串。
Dapr 用來將服務匯出至服務通訊遙測的 Application Insights 檢測密鑰。
指派給 Docker 網橋的 CIDR 表示法 IP 範圍。 如果已定義,它不得與任何子網IP範圍或平臺保留CIDR中定義的IP範圍重疊。
布爾值,指出是否為環境啟用 mTLS 對等驗證。
布爾值,指出是否為環境啟用點對點流量加密。
布爾值,指出環境是否已啟用工作負載配置檔。
基礎結構元件和使用者應用程式容器之子網的資源標識碼。
布爾值,表示環境只有內部負載平衡器。 這些環境沒有公用靜態 IP 資源,因此如果啟用此屬性,則必須提供 infrastructureSubnetResourceId。
資源的位置。 範例:eastus2、northeurope。
記錄目的地。
要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。
用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。
請勿等候長時間執行的作業完成。
CIDR 表示法中的IP範圍,可以保留給環境基礎結構IP位址。 它不得與任何其他子網IP範圍重疊。
平臺保留 CIDR 所定義的 IP 位址,將保留給內部 DNS 伺服器。
用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值,則會自動建立 Azure 監視器診斷設定。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
在環境中啟用區域備援。 如果沒有 --infrastructure-subnet-resource-id,就無法使用。如果搭配 --location 使用,子網的位置必須相符。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --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-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
必要參數
容器應用程式環境的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
選擇性參數
指向保存憑證的 Azure 金鑰保存庫 秘密的 URL。
環境自定義網域之憑證檔案的 filepath (.pfx 或 .pem)。 若要管理容器應用程式的憑證,請使用 az containerapp env certificate
。
要向 Azure 金鑰保存庫 進行驗證的受控識別資源識別碼,或使用系統指派的身分識別。
環境自定義網域的憑證檔案密碼。
環境自定義網域的 DNS 後綴。
Dapr 用來將服務匯出至服務通訊遙測的 Application Insights 檢測密鑰。
指派給 Docker 網橋的 CIDR 表示法 IP 範圍。 如果已定義,它不得與任何子網IP範圍或平臺保留CIDR中定義的IP範圍重疊。
布爾值,指出環境是否已啟用專用 gpu。
布爾值,指出是否為環境啟用 mTLS 對等驗證。
布爾值,指出是否為環境啟用點對點流量加密。
布爾值,指出環境是否已啟用工作負載配置檔。
將包含基礎結構資源的資源組名。 如果未提供,將會產生資源組名。
基礎結構元件和使用者應用程式容器之子網的資源標識碼。
布爾值,表示環境只有內部負載平衡器。 這些環境沒有公用靜態 IP 資源,因此如果啟用此屬性,則必須提供 infrastructureSubnetResourceId。
資源的位置。 範例:eastus2、northeurope。
記錄目的地。
布爾值,指出是否要將 json 字串記錄剖析為動態 json 數據行。 僅適用於目的地記錄分析。
要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。
用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。
布爾值,指出是否指派系統指派的身分識別。
要指派的空間分隔使用者身分識別。
請勿等候長時間執行的作業完成。
CIDR 表示法中的IP範圍,可以保留給環境基礎結構IP位址。 它不得與任何其他子網IP範圍重疊。
平臺保留 CIDR 所定義的 IP 位址,將保留給內部 DNS 伺服器。
允許或封鎖所有公用流量。
用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值,則會自動建立 Azure 監視器診斷設定。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
在環境中啟用區域備援。 如果沒有 --infrastructure-subnet-resource-id,就無法使用。如果搭配 --location 使用,子網的位置必須相符。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --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 或其他「資源識別碼」引數。
Container Apps 環境的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --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 或其他「資源識別碼」引數。
Container Apps 環境的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az containerapp env list
依訂用帳戶或資源群組列出容器應用程式環境。
az containerapp env list [--resource-group]
範例
列出目前訂用帳戶中的環境。
az containerapp env list
依資源群組列出環境。
az containerapp env list -g MyResourceGroup
選擇性參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az containerapp env list (containerapp 擴充功能)
依訂用帳戶或資源群組列出容器應用程式環境。
az containerapp env list [--resource-group]
範例
列出目前訂用帳戶中的環境。
az containerapp env list
依資源群組列出環境。
az containerapp env list -g MyResourceGroup
選擇性參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --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 或其他「資源識別碼」引數。
容器應用程式環境的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az containerapp env show
顯示容器應用程式環境的詳細數據。
az containerapp env show [--ids]
[--name]
[--resource-group]
[--subscription]
範例
顯示環境的詳細數據。
az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
Container Apps 環境的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az containerapp env show (containerapp 擴充功能)
顯示容器應用程式環境的詳細數據。
az containerapp env show [--ids]
[--name]
[--resource-group]
[--subscription]
範例
顯示環境的詳細數據。
az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
Container Apps 環境的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az containerapp env update
更新容器應用程式環境。
az containerapp env update [--certificate-file]
[--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-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
選擇性參數
環境自定義網域之憑證檔案的 filepath (.pfx 或 .pem)。 若要管理容器應用程式的憑證,請使用 az containerapp env certificate
。
環境自定義網域的憑證檔案密碼。
環境自定義網域的 DNS 後綴。
布爾值,指出是否為環境啟用 mTLS 對等驗證。
布爾值,指出是否為環境啟用點對點流量加密。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
記錄目的地。
要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。
用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。
此工作負載配置檔所需的節點上限 --workload-profile-name。
此工作負載配置檔所需的最小節點 --workload-profile-name。
容器應用程式環境的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值,則會自動建立 Azure 監視器診斷設定。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
工作負載配置檔的易記名稱。
要在此環境中新增或更新的工作負載配置檔類型,需要 --workload-profile-name。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --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
選擇性參數
指向保存憑證之 Azure 金鑰保存庫 秘密的 URL。
環境自定義網域之憑證檔案的 filepath (.pfx 或 .pem)。 若要管理容器應用程式的憑證,請使用 az containerapp env certificate
。
要向 Azure 金鑰保存庫 進行驗證的受控識別資源識別碼,或使用系統指派的身分識別。
環境自定義網域的憑證檔案密碼。
環境自定義網域的 DNS 後綴。
布爾值,指出是否為環境啟用 mTLS 對等驗證。
布爾值,指出是否為環境啟用點對點流量加密。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
記錄目的地。
布爾值,指出是否要將 json 字串記錄剖析為動態 json 數據行。 僅適用於目的地記錄分析。
要傳送診斷記錄的Log Analytics工作區工作區標識碼。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。
用來設定Log Analytics工作區的Log Analytics工作區密鑰。 僅適用於記錄目的地 「log-analytics」。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。
此工作負載配置檔所需的節點上限 --workload-profile-name。
此工作負載配置檔所需的最小節點 --workload-profile-name。
容器應用程式環境的名稱。
請勿等候長時間執行的作業完成。
允許或封鎖所有公用流量。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
用於 Azure 監視器的記憶體帳戶名稱或資源識別碼。 如果提供此值,則會自動建立 Azure 監視器診斷設定。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
工作負載配置檔的易記名稱。
要在此環境中新增或更新的工作負載配置檔類型,需要 --workload-profile-name。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。