az container
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.
Manage Azure Container Instances.
Commands
Name | Description | Type | Status |
---|---|---|---|
az container app |
Commands to Manage Azure Container Instances App. |
Extension | Preview |
az container app up |
Deploy to Azure Container Instances using GitHub Actions. |
Extension | Preview |
az container attach |
Attach local standard output and error streams to a container in a container group. This command provides diagnostic information during container startup. Once the container has started, it streams STDOUT and STDERR to your local console. |
Core | GA |
az container container-group-profile |
Manage Azure Container Instance Container Group Profile. |
Core | GA |
az container container-group-profile create |
Create a container group profile. |
Core | GA |
az container container-group-profile delete |
Delete a container group profile. |
Core | GA |
az container container-group-profile list |
List all container group profiles in a resource group. |
Core | GA |
az container container-group-profile list-revisions |
List all revisions for a container group profile. |
Core | GA |
az container container-group-profile show |
Get a container group profile. |
Core | GA |
az container container-group-profile show-revision |
Show a container group profile revision. |
Core | GA |
az container create |
Create a container group. |
Core | GA |
az container delete |
Delete a container group. |
Core | GA |
az container exec |
Execute a command from within a running container of a container group. |
Core | GA |
az container export |
Export a container group in yaml format. |
Core | GA |
az container list |
List container groups. |
Core | GA |
az container logs |
Examine the logs for a container in a container group. |
Core | GA |
az container restart |
Restarts all containers in a container group. |
Core | GA |
az container show |
Get the details of a container group. |
Core | GA |
az container start |
Starts all containers in a container group. |
Core | GA |
az container stop |
Stops all containers in a container group. |
Core | GA |
az container attach
Attach local standard output and error streams to a container in a container group. This command provides diagnostic information during container startup. Once the container has started, it streams STDOUT and STDERR to your local console.
az container attach [--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
Examples
Attach local standard output and error streams to a container in a container group. (autogenerated)
az container attach --name MyContainerGroup --resource-group MyResourceGroup
Optional Parameters
The container to attach to. If omitted, the first container in the container group will be chosen.
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.
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container create
Create a container group.
az container create --resource-group
[--acr-identity]
[--add-capabilities]
[--allow-escalation]
[--assign-identity]
[--azure-file-volume-account-key]
[--azure-file-volume-account-name]
[--azure-file-volume-mount-path]
[--azure-file-volume-share-name]
[--cce-policy]
[--command-line]
[--config-map]
[--container-group-profile-id]
[--container-group-profile-revision]
[--cpu]
[--dns-name-label]
[--drop-capabilities]
[--environment-variables]
[--fail-container-group-create-on-reuse-failure]
[--file]
[--gitrepo-dir]
[--gitrepo-mount-path]
[--gitrepo-revision]
[--gitrepo-url]
[--image]
[--ip-address {Private, Public}]
[--location]
[--log-analytics-workspace]
[--log-analytics-workspace-key]
[--memory]
[--name]
[--no-wait]
[--os-type {Linux, Windows}]
[--ports]
[--priority]
[--privileged]
[--protocol {TCP, UDP}]
[--registry-login-server]
[--registry-password]
[--registry-username]
[--restart-policy {Always, Never, OnFailure}]
[--role]
[--run-as-group]
[--run-as-user]
[--scope]
[--seccomp-profile]
[--secrets]
[--secrets-mount-path]
[--secure-environment-variables]
[--sku]
[--standby-pool-profile-id]
[--subnet]
[--subnet-address-prefix]
[--vnet]
[--vnet-address-prefix]
[--vnet-name]
[--zone]
Examples
Create a container in a container group with 1 core and 1Gb of memory.
az container create -g MyResourceGroup --name myapp --image myimage:latest --cpu 1 --memory 1
Create a container in a container group that runs Windows, with 2 cores and 3.5Gb of memory.
az container create -g MyResourceGroup --name mywinapp --image winappimage:latest --os-type Windows --cpu 2 --memory 3.5
Create a container in a container group with public IP address, ports and DNS name label.
az container create -g MyResourceGroup --name myapp --image myimage:latest --ports 80 443 --dns-name-label contoso
Create a container in a container group that invokes a script upon start.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "/bin/sh -c '/path to/myscript.sh'"
Create a container in a container group that runs a command and stop the container afterwards.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "echo hello" --restart-policy Never
Create a container in a container group with environment variables.
az container create -g MyResourceGroup --name myapp --image myimage:latest --environment-variables key1=value1 key2=value2
Create a container in a container group using container image from Azure Container Registry.
az container create -g MyResourceGroup --name myapp --image myAcrRegistry.azurecr.io/myimage:latest --registry-password password
Create a container in a container group that mounts an Azure File share as volume.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/azfile/myfile" --azure-file-volume-share-name myshare --azure-file-volume-account-name mystorageaccount --azure-file-volume-account-key mystoragekey --azure-file-volume-mount-path /mnt/azfile
Create a container in a container group that mounts a git repo as volume.
az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/gitrepo" --gitrepo-url https://github.com/user/myrepo.git --gitrepo-dir ./dir1 --gitrepo-mount-path /mnt/gitrepo
Create a container in a container group using a yaml file.
az container create -g MyResourceGroup -f containerGroup.yaml
Create a container group using Log Analytics from a workspace name.
az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace
Create a container group with a system assigned identity.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity
Create a container group with a system assigned identity. The group will have a 'Contributor' role with access to a storage account.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity --scope /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/MyResourceGroup/myRG/providers/Microsoft.Storage/storageAccounts/storage1
Create a container group with a user assigned identity.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID
Create a container group with both system and user assigned identity.
az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity [system] /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID
Required Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
The identity with access to the container registry.
A List of security context capabilities to be added.
Allow whether a process can gain more privileges than its parent process.
Space-separated list of assigned identities. Assigned identities are either user assigned identities (resource IDs) and / or the system assigned identity ('[system]'). See examples for more info.
The storage account access key used to access the Azure File share.
The name of the storage account that contains the Azure File share.
The path within the container where the azure file volume should be mounted. Must not contain colon ':'.
The name of the Azure File share to be mounted as a volume.
The CCE policy for the confidential container group.
The command line to run when the container is started, e.g. '/bin/bash -c myscript.sh'.
A list of config map key-value pairs for the container. Space-separated values in 'key=value' format.
The reference container group profile ARM resource id.
The reference container group profile revision.
The required number of CPU cores of the containers, accurate to one decimal place.
The dns name label for container group with public IP.
A List of security context capabilities to be dropped.
A list of environment variable for the container. Space-separated values in 'key=value' format.
The flag indicating whether to fail the container group creation if the standby pool reuse failed.
The path to the input file.
The target directory path in the git repository. Must not contain '..'.
The path within the container where the git repo volume should be mounted. Must not contain colon ':'.
The commit hash for the specified revision.
The URL of a git repository to be mounted as a volume.
The container image name.
The IP address type of the container group.
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
The Log Analytics workspace name or id. Use the current subscription or use --subscription flag to set the desired subscription.
The Log Analytics workspace key.
The required memory of the containers in GB, accurate to one decimal place.
The name of the container group.
Do not wait for the long-running operation to finish.
The OS type of the containers.
A list of ports to open. Space-separated list of ports.
The priority of the container group.
The flag to determine if the container permissions is elevated to Privileged.
The network protocol to use.
The container image registry login server.
The password to log in container image registry server.
The username to log in container image registry server.
Restart policy for all containers within the container group.
Role name or id the system assigned identity will have.
Set the User UID for the container.
Set the User GID for the container.
Scope that the system assigned identity can access.
A base64 encoded string containing the contents of the JSON in the seccomp profile.
Space-separated secrets in 'key=value' format.
The path within the container where the secrets volume should be mounted. Must not contain colon ':'.
A list of secure environment variable for the container. Space-separated values in 'key=value' format.
The SKU of the container group.
The standby pool profile ARM resource id from which the container will be reused.
The name of the subnet when creating a new VNET or referencing an existing one. Can also reference an existing subnet by ID.
The subnet IP address prefix to use when creating a new VNET in CIDR format.
The name of the VNET when creating a new one or referencing an existing one. Can also reference an existing vnet by ID. This allows using vnets from other resource groups.
The IP address prefix to use when creating a new VNET in CIDR format.
Argument 'vnet_name' has been deprecated and will be removed in a future release. Use '--vnet' instead.
The name of the VNET when creating a new one or referencing an existing one.
The zone to place the container group.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container delete
Delete a container group.
az container delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
Examples
Delete a container group. (autogenerated)
az container delete --name MyContainerGroup --resource-group MyResourceGroup
Optional Parameters
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.
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container exec
Execute a command from within a running container of a container group.
The most common use case is to open an interactive bash shell. See examples below.
az container exec --exec-command
[--container-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
Examples
Stream a shell from within an nginx container.
az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command "/bin/bash"
Required Parameters
The command to run from within the container.
Optional Parameters
The container name where to execute the command. Can be ommitted for container groups with only one container.
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.
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container export
Export a container group in yaml format.
az container export --file
[--ids]
[--name]
[--resource-group]
[--subscription]
Examples
Export a container group in yaml.
az container export -g MyResourceGroup --name mynginx -f output.yaml
Required Parameters
The file path to export the container group.
Optional Parameters
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.
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container list
List container groups.
az container list [--resource-group]
Optional Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container logs
Examine the logs for a container in a container group.
az container logs [--container-name]
[--follow]
[--ids]
[--name]
[--resource-group]
[--subscription]
Examples
Examine the logs for a container in a container group. (autogenerated)
az container logs --name MyContainerGroup --resource-group MyResourceGroup
Optional Parameters
The container name to tail the logs. If omitted, the first container in the container group will be chosen.
Indicate to stream the tailing logs.
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.
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container restart
Restarts all containers in a container group.
Restarts all containers in a container group in place. If container image has updates, new image will be downloaded.
az container restart --name
--resource-group
[--no-wait]
Required Parameters
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
Do not wait for the long-running operation to finish.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container show
Get the details of a container group.
az container show [--ids]
[--name]
[--resource-group]
[--subscription]
Examples
Get the details of a container group. (autogenerated)
az container show --name MyContainerGroup --resource-group MyResourceGroup
Optional Parameters
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.
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container start
Starts all containers in a container group.
Starts all containers in a container group. Compute resources will be allocated and billing will start.
az container start --name
--resource-group
[--no-wait]
Required Parameters
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Optional Parameters
Do not wait for the long-running operation to finish.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az container stop
Stops all containers in a container group.
Stops all containers in a container group. Compute resources will be deallocated and billing will stop.
az container stop --name
--resource-group
Required Parameters
The name of the container group.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.