az vm image
Information on available virtual machine images.
Commands
az vm image accept-terms | Accept Azure Marketplace term so that the image can be used to create VMs. |
az vm image list | List the VM/VMSS images available in the Azure Marketplace. |
az vm image list-offers | List the VM image offers available in the Azure Marketplace. |
az vm image list-publishers | List the VM image publishers available in the Azure Marketplace. |
az vm image list-skus | List the VM image SKUs available in the Azure Marketplace. |
az vm image show | Get the details for a VM image available in the Azure Marketplace. |
az vm image accept-terms
Accept Azure Marketplace term so that the image can be used to create VMs.
az vm image accept-terms [--offer]
[--plan]
[--publisher]
[--subscription]
[--urn]
Optional Parameters
Image offer.
Image billing plan.
Image publisher.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
URN, in format of 'publisher:offer:sku:version'. If specified, other argument values can be omitted.
az vm image list
List the VM/VMSS images available in the Azure Marketplace.
az vm image list [--all]
[--location]
[--offer]
[--publisher]
[--sku]
[--subscription]
Examples
List all available images.
az vm image list --all
List all offline cached CentOS images.
az vm image list -f CentOS
List all CentOS images.
az vm image list -f CentOS --all
Optional Parameters
Retrieve image list from live Azure service rather using an offline image list.
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
Image offer name, partial name is accepted.
Image publisher name, partial name is accepted.
Image sku name, partial name is accepted.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
az vm image list-offers
List the VM image offers available in the Azure Marketplace.
az vm image list-offers --location
--publisher
[--subscription]
Examples
List all offers from Microsoft in the West US region.
az vm image list-offers -l westus -p MicrosoftWindowsServer
List all offers from OpenLocic in the West US region.
az vm image list-offers -l westus -p OpenLogic
Required Parameters
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
A valid image publisher.
Optional Parameters
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
az vm image list-publishers
List the VM image publishers available in the Azure Marketplace.
az vm image list-publishers --location
[--subscription]
Examples
List all publishers in the West US region.
az vm image list-publishers -l westus
List all publishers with names starting with "Open" in westus.
az vm image list-publishers -l westus --query "[?starts_with(name, 'Open')]"
Required Parameters
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
Optional Parameters
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
az vm image list-skus
List the VM image SKUs available in the Azure Marketplace.
az vm image list-skus --location
--offer
--publisher
[--subscription]
Examples
List all skus available for CentOS published by OpenLogic in the West US region.
az vm image list-skus -l westus -f CentOS -p OpenLogic
Required Parameters
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
Image offer.
A valid image publisher.
Optional Parameters
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
az vm image show
Get the details for a VM image available in the Azure Marketplace.
az vm image show [--location]
[--offer]
[--publisher]
[--sku]
[--subscription]
[--urn]
[--version]
Examples
Show information for the latest available CentOS image from OpenLogic.
latest=$(az vm image list -p OpenLogic -s 7.3 --all --query \
"[?offer=='CentOS'].version" -o tsv | sort -u | tail -n 1)
az vm image show -l westus -f CentOS -p OpenLogic --sku 7.3 --version {latest}
Optional Parameters
Location. Values from: az account list-locations
. You can configure the default location using az configure --defaults location=<location>
.
Image offer.
Image publisher.
Image sku.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
URN, in format of 'publisher:offer:sku:version'. If specified, other argument values can be omitted.
Image sku's version.
Feedback
Would you like to provide feedback?
Our feedback system is built on GitHub Issues. Read more on our blog.
Loading feedback...