az containerapp env

Note

This command group has commands that are defined in both Azure CLI and at least one extension. Install each extension to benefit from its extended capabilities. Learn more about extensions.

Commands to manage Container Apps environments.

Commands

Name	Description	Type	Status
az containerapp env certificate	Commands to manage certificates for the Container Apps environment.	Core and Extension	GA
az containerapp env certificate create	Create a managed certificate.	Core	Preview
az containerapp env certificate delete	Delete a certificate from the Container Apps environment.	Core	GA
az containerapp env certificate delete (containerapp extension)	Delete a certificate from the Container Apps environment.	Extension	GA
az containerapp env certificate list	List certificates for an environment.	Core	GA
az containerapp env certificate list (containerapp extension)	List certificates for an environment.	Extension	GA
az containerapp env certificate upload	Add or update a certificate.	Core	GA
az containerapp env certificate upload (containerapp extension)	Add or update a certificate.	Extension	GA
az containerapp env create	Create a Container Apps environment.	Core	GA
az containerapp env create (containerapp extension)	Create a Container Apps environment.	Extension	GA
az containerapp env dapr-component	Commands to manage Dapr components for the Container Apps environment.	Core and Extension	GA
az containerapp env dapr-component init	Initializes Dapr components and dev services for an environment.	Extension	Preview
az containerapp env dapr-component list	List Dapr components for an environment.	Core	GA
az containerapp env dapr-component remove	Remove a Dapr component from an environment.	Core	GA
az containerapp env dapr-component resiliency	Commands to manage resiliency policies for a dapr component.	Extension	Preview
az containerapp env dapr-component resiliency create	Create resiliency policies for a dapr component.	Extension	Preview
az containerapp env dapr-component resiliency delete	Delete resiliency policies for a dapr component.	Extension	Preview
az containerapp env dapr-component resiliency list	List resiliency policies for a dapr component.	Extension	Preview
az containerapp env dapr-component resiliency show	Show resiliency policies for a dapr component.	Extension	Preview
az containerapp env dapr-component resiliency update	Update resiliency policies for a dapr component.	Extension	Preview
az containerapp env dapr-component set	Create or update a Dapr component.	Core	GA
az containerapp env dapr-component show	Show the details of a Dapr component.	Core	GA
az containerapp env delete	Delete a Container Apps environment.	Core	GA
az containerapp env delete (containerapp extension)	Delete a Container Apps environment.	Extension	GA
az containerapp env dotnet-component	Commands to manage DotNet components within the environment.	Extension	Preview
az containerapp env dotnet-component create	Command to create DotNet component to enable Aspire Dashboard. Supported DotNet component type is Aspire Dashboard.	Extension	Preview
az containerapp env dotnet-component delete	Command to delete DotNet component to disable Aspire Dashboard.	Extension	Preview
az containerapp env dotnet-component list	Command to list DotNet components within the environment.	Extension	Preview
az containerapp env dotnet-component show	Command to show DotNet component in environment.	Extension	Preview
az containerapp env http-route-config	Commands to manage environment level http routing.	Extension	Preview
az containerapp env http-route-config create	Create a new http route config.	Extension	Preview
az containerapp env http-route-config delete	Delete a http route config.	Extension	Preview
az containerapp env http-route-config list	List the http route configs in the environment.	Extension	Preview
az containerapp env http-route-config show	Show a http route config.	Extension	Preview
az containerapp env http-route-config update	Update a http route config.	Extension	Preview
az containerapp env identity	Commands to manage environment managed identities.	Extension	Preview
az containerapp env identity assign	Assign managed identity to a managed environment.	Extension	Preview
az containerapp env identity remove	Remove a managed identity from a managed environment.	Extension	Preview
az containerapp env identity show	Show managed identities of a managed environment.	Extension	Preview
az containerapp env java-component	Commands to manage Java components within the environment.	Extension	GA
az containerapp env java-component admin-for-spring	Commands to manage the Admin for Spring for the Container Apps environment.	Extension	GA
az containerapp env java-component admin-for-spring create	Command to create the Admin for Spring.	Extension	GA
az containerapp env java-component admin-for-spring delete	Command to delete the Admin for Spring.	Extension	GA
az containerapp env java-component admin-for-spring show	Command to show the Admin for Spring.	Extension	GA
az containerapp env java-component admin-for-spring update	Command to update the Admin for Spring.	Extension	GA
az containerapp env java-component config-server-for-spring	Commands to manage the Config Server for Spring for the Container Apps environment.	Extension	GA
az containerapp env java-component config-server-for-spring create	Command to create the Config Server for Spring.	Extension	GA
az containerapp env java-component config-server-for-spring delete	Command to delete the Config Server for Spring.	Extension	GA
az containerapp env java-component config-server-for-spring show	Command to show the Config Server for Spring.	Extension	GA
az containerapp env java-component config-server-for-spring update	Command to update the Config Server for Spring.	Extension	GA
az containerapp env java-component eureka-server-for-spring	Commands to manage the Eureka Server for Spring for the Container Apps environment.	Extension	GA
az containerapp env java-component eureka-server-for-spring create	Command to create the Eureka Server for Spring.	Extension	GA
az containerapp env java-component eureka-server-for-spring delete	Command to delete the Eureka Server for Spring.	Extension	GA
az containerapp env java-component eureka-server-for-spring show	Command to show the Eureka Server for Spring.	Extension	GA
az containerapp env java-component eureka-server-for-spring update	Command to update the Eureka Server for Spring.	Extension	GA
az containerapp env java-component gateway-for-spring	Commands to manage the Gateway for Spring for the Container Apps environment.	Extension	Preview
az containerapp env java-component gateway-for-spring create	Command to create the Gateway for Spring.	Extension	Preview
az containerapp env java-component gateway-for-spring delete	Command to delete the Gateway for Spring.	Extension	Preview
az containerapp env java-component gateway-for-spring show	Command to show the Gateway for Spring.	Extension	Preview
az containerapp env java-component gateway-for-spring update	Command to update the Gateway for Spring.	Extension	Preview
az containerapp env java-component list	List all Java components within the environment.	Extension	GA
az containerapp env java-component nacos	Commands to manage the Nacos for the Container Apps environment.	Extension	Preview
az containerapp env java-component nacos create	Command to create the Nacos.	Extension	Preview
az containerapp env java-component nacos delete	Command to delete the Nacos.	Extension	Preview
az containerapp env java-component nacos show	Command to show the Nacos.	Extension	Preview
az containerapp env java-component nacos update	Command to update the Nacos.	Extension	Preview
az containerapp env list	List Container Apps environments by subscription or resource group.	Core	GA
az containerapp env list (containerapp extension)	List Container Apps environments by subscription or resource group.	Extension	GA
az containerapp env list-usages	List usages of quotas for specific managed environment.	Core	GA
az containerapp env logs	Show container app environment logs.	Core	GA
az containerapp env logs show	Show past environment logs and/or print logs in real time (with the --follow parameter).	Core	GA
az containerapp env maintenance-config	Commands to manage Planned Maintenance for Container Apps.	Extension	Preview
az containerapp env maintenance-config add	Add Planned Maintenance to a Container App Environment.	Extension	Preview
az containerapp env maintenance-config list	List Planned Maintenance in a Container App Environment.	Extension	Preview
az containerapp env maintenance-config remove	Remove Planned Maintenance in a Container App Environment.	Extension	Preview
az containerapp env maintenance-config update	Update Planned Maintenance in a Container App Environment.	Extension	Preview
az containerapp env premium-ingress	Configure premium ingress settings for the environment.	Extension	Preview
az containerapp env premium-ingress add	Enable the premium ingress settings for the environment.	Extension	Preview
az containerapp env premium-ingress remove	Remove the ingress settings and restores the system to default values.	Extension	Preview
az containerapp env premium-ingress show	Show the premium ingress settings for the environment.	Extension	Preview
az containerapp env premium-ingress update	Update the premium ingress settings for the environment.	Extension	Preview
az containerapp env show	Show details of a Container Apps environment.	Core	GA
az containerapp env show (containerapp extension)	Show details of a Container Apps environment.	Extension	GA
az containerapp env storage	Commands to manage storage for the Container Apps environment.	Core and Extension	GA
az containerapp env storage list	List the storages for an environment.	Core	GA
az containerapp env storage list (containerapp extension)	List the storages for an environment.	Extension	GA
az containerapp env storage remove	Remove a storage from an environment.	Core	GA
az containerapp env storage remove (containerapp extension)	Remove a storage from an environment.	Extension	GA
az containerapp env storage set	Create or update a storage.	Core	GA
az containerapp env storage set (containerapp extension)	Create or update a storage.	Extension	GA
az containerapp env storage show	Show the details of a storage.	Core	GA
az containerapp env storage show (containerapp extension)	Show the details of a storage.	Extension	GA
az containerapp env telemetry	Commands to manage telemetry settings for the container apps environment.	Extension	Preview
az containerapp env telemetry app-insights	Commands to manage app insights settings for the container apps environment.	Extension	Preview
az containerapp env telemetry app-insights delete	Delete container apps environment telemetry app insights settings.	Extension	Preview
az containerapp env telemetry app-insights set	Create or update container apps environment telemetry app insights settings.	Extension	Preview
az containerapp env telemetry app-insights show	Show container apps environment telemetry app insights settings.	Extension	Preview
az containerapp env telemetry data-dog	Commands to manage data dog settings for the container apps environment.	Extension	Preview
az containerapp env telemetry data-dog delete	Delete container apps environment telemetry data dog settings.	Extension	Preview
az containerapp env telemetry data-dog set	Create or update container apps environment telemetry data dog settings.	Extension	Preview
az containerapp env telemetry data-dog show	Show container apps environment telemetry data dog settings.	Extension	Preview
az containerapp env telemetry otlp	Commands to manage otlp settings for the container apps environment.	Extension	Preview
az containerapp env telemetry otlp add	Add container apps environment telemetry otlp settings.	Extension	Preview
az containerapp env telemetry otlp list	List container apps environment telemetry otlp settings.	Extension	Preview
az containerapp env telemetry otlp remove	Remove container apps environment telemetry otlp settings.	Extension	Preview
az containerapp env telemetry otlp show	Show container apps environment telemetry otlp settings.	Extension	Preview
az containerapp env telemetry otlp update	Update container apps environment telemetry otlp settings.	Extension	Preview
az containerapp env update	Update a Container Apps environment.	Core	GA
az containerapp env update (containerapp extension)	Update a Container Apps environment.	Extension	GA
az containerapp env workload-profile	Manage the workload profiles of a Container Apps environment.	Core	GA
az containerapp env workload-profile add	Create a workload profile in a Container Apps environment.	Core	GA
az containerapp env workload-profile delete	Delete a workload profile from a Container Apps environment.	Core	GA
az containerapp env workload-profile list	List the workload profiles from a Container Apps environment.	Core	GA
az containerapp env workload-profile list-supported	List the supported workload profiles in a region.	Core	GA
az containerapp env workload-profile show	Show a workload profile from a Container Apps environment.	Core	GA
az containerapp env workload-profile update	Update an existing workload profile in a Container Apps environment.	Core	GA

az containerapp env create

Create a Container Apps environment.

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]

Examples

Create an environment with an auto-generated Log Analytics workspace.

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

Create a zone-redundant environment

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

Create an environment with an existing Log Analytics workspace.

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

Create an environment with workload profiles enabled.

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

Create an environment without workload profiles enabled.

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

Required Parameters

--name -n

Name of the Container Apps environment.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

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

The filepath of the certificate file (.pfx or .pem) for the environment's custom domain. To manage certificates for container apps, use az containerapp env certificate.

Property	Value
Parameter group:	Custom Domain Arguments

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

The certificate file password for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

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

The DNS suffix for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

--dapr-connection-string -d

Application Insights connection string used by Dapr to export service to service communication telemetry.

Property	Value
Parameter group:	Dapr Arguments

--enable-mtls

Boolean indicating if mTLS peer authentication is enabled for the environment.

Property	Value
Parameter group:	Peer Authentication Arguments
Accepted values:	false, true

--enable-peer-to-peer-encryption

Boolean indicating whether the peer-to-peer traffic encryption is enabled for the environment.

Property	Value
Parameter group:	Peer Traffic Configuration Arguments
Accepted values:	false, true

--enable-workload-profiles -w

Boolean indicating if the environment is enabled to have workload profiles.

Property	Value
Default value:	True
Accepted values:	false, true

--infrastructure-subnet-resource-id -s

Resource ID of a subnet for infrastructure components and user app containers.

Property	Value
Parameter group:	Virtual Network Arguments

--internal-only

Boolean indicating the environment only has an internal load balancer. These environments do not have a public static IP resource, therefore must provide infrastructureSubnetResourceId if enabling this property.

Property	Value
Parameter group:	Virtual Network Arguments
Default value:	False
Accepted values:	false, true

--location -l

Location of resource. Examples: eastus2, northeurope.

--logs-destination

Logs destination.

Property	Value
Parameter group:	Monitoring Arguments
Default value:	log-analytics
Accepted values:	azure-monitor, log-analytics, none

--logs-workspace-id

Workspace ID of the Log Analytics workspace to send diagnostics logs to. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace create" to create one. Extra billing may apply.

Property	Value
Parameter group:	Monitoring Arguments

--logs-workspace-key

Log Analytics workspace key to configure your Log Analytics workspace. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace get-shared-keys" to retrieve the key.

Property	Value
Parameter group:	Monitoring Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--platform-reserved-cidr

IP range in CIDR notation that can be reserved for environment infrastructure IP addresses. It must not overlap with any other Subnet IP ranges.

Property	Value
Parameter group:	Virtual Network Arguments

--platform-reserved-dns-ip

An IP address from the IP range defined by Platform Reserved CIDR that will be reserved for the internal DNS server.

Property	Value
Parameter group:	Virtual Network Arguments

--storage-account

Name or resource ID of the storage account used for Azure Monitor. If this value is provided, Azure Monitor Diagnostic Settings will be created automatically.

Property	Value
Parameter group:	Monitoring Arguments

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--zone-redundant -z

Enable zone redundancy on the environment. Cannot be used without --infrastructure-subnet-resource-id. If used with --location, the subnet's location must match.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env create (containerapp extension)

Create a Container Apps environment.

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]

Examples

Create an environment with an auto-generated Log Analytics workspace.

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

Create a zone-redundant environment

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

Create an environment with an existing Log Analytics workspace.

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

Create an environment with workload profiles enabled.

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

Create an environment without workload profiles enabled.

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

Create an environment with system assigned and user assigned identity.

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

Required Parameters

--name -n

Name of the Container Apps environment.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

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

Preview

The URL pointing to the Azure Key Vault secret that holds the certificate.

Property	Value
Parameter group:	Custom Domain Arguments

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

The filepath of the certificate file (.pfx or .pem) for the environment's custom domain. To manage certificates for container apps, use az containerapp env certificate.

Property	Value
Parameter group:	Custom Domain Arguments

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

Preview

Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity.

Property	Value
Parameter group:	Custom Domain Arguments

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

The certificate file password for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

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

The DNS suffix for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

--dapr-connection-string -d

Application Insights connection string used by Dapr to export service to service communication telemetry.

Property	Value
Parameter group:	Dapr Arguments

--enable-dedicated-gpu

Preview

Boolean indicating if the environment is enabled to have dedicated gpu.

Property	Value
Default value:	False
Accepted values:	false, true

--enable-mtls

Boolean indicating if mTLS peer authentication is enabled for the environment.

Property	Value
Parameter group:	Peer Authentication Arguments
Accepted values:	false, true

--enable-peer-to-peer-encryption

Boolean indicating whether the peer-to-peer traffic encryption is enabled for the environment.

Property	Value
Parameter group:	Peer Traffic Configuration Arguments
Accepted values:	false, true

--enable-workload-profiles -w

Boolean indicating if the environment is enabled to have workload profiles.

Property	Value
Default value:	True
Accepted values:	false, true

--infrastructure-resource-group -i

Preview

Name for resource group that will contain infrastructure resources. If not provided, a resource group name will be generated.

Property	Value
Parameter group:	Virtual Network Arguments

--infrastructure-subnet-resource-id -s

Resource ID of a subnet for infrastructure components and user app containers.

Property	Value
Parameter group:	Virtual Network Arguments

--internal-only

Boolean indicating the environment only has an internal load balancer. These environments do not have a public static IP resource, therefore must provide infrastructureSubnetResourceId if enabling this property.

Property	Value
Parameter group:	Virtual Network Arguments
Default value:	False
Accepted values:	false, true

--location -l

Location of resource. Examples: eastus2, northeurope.

--logs-destination

Logs destination.

Property	Value
Parameter group:	Monitoring Arguments
Default value:	log-analytics
Accepted values:	azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

Preview

Boolean indicating whether to parse json string log into dynamic json columns. Only work for destination log-analytics.

Property	Value
Parameter group:	Monitoring Arguments
Default value:	False
Accepted values:	false, true

--logs-workspace-id

Workspace ID of the Log Analytics workspace to send diagnostics logs to. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace create" to create one. Extra billing may apply.

Property	Value
Parameter group:	Monitoring Arguments

--logs-workspace-key

Log Analytics workspace key to configure your Log Analytics workspace. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace get-shared-keys" to retrieve the key.

Property	Value
Parameter group:	Monitoring Arguments

--mi-system-assigned

Preview

Boolean indicating whether to assign system-assigned identity.

Property	Value
Parameter group:	Identity Arguments
Default value:	False

--mi-user-assigned

Preview

Space-separated user identities to be assigned.

Property	Value
Parameter group:	Identity Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--platform-reserved-cidr

IP range in CIDR notation that can be reserved for environment infrastructure IP addresses. It must not overlap with any other Subnet IP ranges.

Property	Value
Parameter group:	Virtual Network Arguments

--platform-reserved-dns-ip

An IP address from the IP range defined by Platform Reserved CIDR that will be reserved for the internal DNS server.

Property	Value
Parameter group:	Virtual Network Arguments

--public-network-access

Preview

Allow or block all public traffic.

Property	Value
Accepted values:	Disabled, Enabled

--storage-account

Name or resource ID of the storage account used for Azure Monitor. If this value is provided, Azure Monitor Diagnostic Settings will be created automatically.

Property	Value
Parameter group:	Monitoring Arguments

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--zone-redundant -z

Enable zone redundancy on the environment. Cannot be used without --infrastructure-subnet-resource-id. If used with --location, the subnet's location must match.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env delete

Delete a Container Apps environment.

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

Examples

Delete an environment.

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

Optional Parameters

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

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

Name of the Container Apps Environment.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env delete (containerapp extension)

Delete a Container Apps environment.

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

Examples

Delete an environment.

az containerapp env delete -n MyContainerappEnvironment -g MyResourceGroup

Optional Parameters

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

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

Name of the Container Apps Environment.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env list

List Container Apps environments by subscription or resource group.

az containerapp env list [--resource-group]

Examples

List environments in the current subscription.

az containerapp env list

List environments by resource group.

az containerapp env list -g MyResourceGroup

Optional Parameters

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

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env list (containerapp extension)

List Container Apps environments by subscription or resource group.

az containerapp env list [--resource-group]

Examples

List environments in the current subscription.

az containerapp env list

List environments by resource group.

az containerapp env list -g MyResourceGroup

Optional Parameters

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

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env list-usages

List usages of quotas for specific managed environment.

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

Examples

List usages of quotas for specific managed environment.

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

Optional Parameters

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

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

Name of the Container Apps environment.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env show

Show details of a Container Apps environment.

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

Examples

Show the details of an environment.

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

Optional Parameters

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

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

Name of the Container Apps Environment.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env show (containerapp extension)

Show details of a Container Apps environment.

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

Examples

Show the details of an environment.

az containerapp env show -n MyContainerappEnvironment -g MyResourceGroup

Optional Parameters

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

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

Name of the Container Apps Environment.

Property	Value
Parameter group:	Resource Id Arguments

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env update

Update a Container Apps environment.

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]

Examples

Update an environment's custom domain configuration.

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

Optional Parameters

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

The filepath of the certificate file (.pfx or .pem) for the environment's custom domain. To manage certificates for container apps, use az containerapp env certificate.

Property	Value
Parameter group:	Custom Domain Arguments

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

The certificate file password for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

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

The DNS suffix for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

--dapr-connection-string -d

Application Insights connection string used by Dapr to export service to service communication telemetry. Use "none" to remove it.

Property	Value
Parameter group:	Dapr Arguments

--enable-mtls

Boolean indicating if mTLS peer authentication is enabled for the environment.

Property	Value
Parameter group:	Peer Authentication Arguments
Accepted values:	false, true

--enable-peer-to-peer-encryption

Boolean indicating whether the peer-to-peer traffic encryption is enabled for the environment.

Property	Value
Parameter group:	Peer Traffic Configuration Arguments
Accepted values:	false, true

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--logs-destination

Logs destination.

Property	Value
Parameter group:	Monitoring Arguments
Accepted values:	azure-monitor, log-analytics, none

--logs-workspace-id

Workspace ID of the Log Analytics workspace to send diagnostics logs to. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace create" to create one. Extra billing may apply.

Property	Value
Parameter group:	Monitoring Arguments

--logs-workspace-key

Log Analytics workspace key to configure your Log Analytics workspace. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace get-shared-keys" to retrieve the key.

Property	Value
Parameter group:	Monitoring Arguments

--max-nodes

The maximum nodes for this workload profile, --workload-profile-name required.

--min-nodes

The minimum nodes for this workload profile, --workload-profile-name required.

--name -n

Name of the Container Apps environment.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--storage-account

Name or resource ID of the storage account used for Azure Monitor. If this value is provided, Azure Monitor Diagnostic Settings will be created automatically.

Property	Value
Parameter group:	Monitoring Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--workload-profile-name -w

The friendly name for the workload profile.

--workload-profile-type

The type of workload profile to add or update in this environment, --workload-profile-name required.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az containerapp env update (containerapp extension)

Update a Container Apps environment.

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]

Examples

Update an environment's custom domain configuration.

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

Optional Parameters

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

Preview

The URL pointing to the Azure Key Vault secret that holds the certificate.

Property	Value
Parameter group:	Custom Domain Arguments

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

The filepath of the certificate file (.pfx or .pem) for the environment's custom domain. To manage certificates for container apps, use az containerapp env certificate.

Property	Value
Parameter group:	Custom Domain Arguments

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

Preview

Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity.

Property	Value
Parameter group:	Custom Domain Arguments

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

The certificate file password for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

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

The DNS suffix for the environment's custom domain.

Property	Value
Parameter group:	Custom Domain Arguments

--enable-mtls

Boolean indicating if mTLS peer authentication is enabled for the environment.

Property	Value
Parameter group:	Peer Authentication Arguments
Accepted values:	false, true

--enable-peer-to-peer-encryption

Boolean indicating whether the peer-to-peer traffic encryption is enabled for the environment.

Property	Value
Parameter group:	Peer Traffic Configuration Arguments
Accepted values:	false, true

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--logs-destination

Logs destination.

Property	Value
Parameter group:	Monitoring Arguments
Accepted values:	azure-monitor, log-analytics, none

--logs-dynamic-json-columns -j

Preview

Boolean indicating whether to parse json string log into dynamic json columns. Only work for destination log-analytics.

Property	Value
Parameter group:	Monitoring Arguments
Accepted values:	false, true

--logs-workspace-id

Workspace ID of the Log Analytics workspace to send diagnostics logs to. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace create" to create one. Extra billing may apply.

Property	Value
Parameter group:	Monitoring Arguments

--logs-workspace-key

Log Analytics workspace key to configure your Log Analytics workspace. Only works with logs destination "log-analytics". You can use "az monitor log-analytics workspace get-shared-keys" to retrieve the key.

Property	Value
Parameter group:	Monitoring Arguments

--max-nodes

The maximum nodes for this workload profile, --workload-profile-name required.

--min-nodes

The minimum nodes for this workload profile, --workload-profile-name required.

--name -n

Name of the Container Apps environment.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--public-network-access

Preview

Allow or block all public traffic.

Property	Value
Accepted values:	Disabled, Enabled

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--storage-account

Name or resource ID of the storage account used for Azure Monitor. If this value is provided, Azure Monitor Diagnostic Settings will be created automatically.

Property	Value
Parameter group:	Monitoring Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--workload-profile-name -w

The friendly name for the workload profile.

--workload-profile-type

The type of workload profile to add or update in this environment, --workload-profile-name required.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False