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]

Examples

Accept Azure Marketplace term so that the image can be used to create VMs. (autogenerated)

az vm image accept-terms --urn publisher:offer:sku:version

Optional Parameters

--offer -f

Image offer.

--plan

Image billing plan.

--publisher -p

Image publisher.

--subscription

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

--urn

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

--all

Retrieve image list from live Azure service rather using an offline image list.

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--offer -f

Image offer name, partial name is accepted.

--publisher -p

Image publisher name, partial name is accepted.

--sku -s

Image sku name, partial name is accepted.

--subscription

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 -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--publisher -p

A valid image publisher.

value from: az vm list-publishers

Optional Parameters

--subscription

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 -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

Optional Parameters

--subscription

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 -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--offer -f

Image offer.

--publisher -p

A valid image publisher.

value from: az vm image list-publishers

Optional Parameters

--subscription

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}

Get the details for a VM image available in the Azure Marketplace. (autogenerated)

az vm image show --location westus --urn publisher:offer:sku:version

Optional Parameters

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--offer -f

Image offer.

--publisher -p

Image publisher.

--sku -s

Image sku.

--subscription

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

--urn

URN, in format of 'publisher:offer:sku:version'. If specified, other argument values can be omitted.

--version

Image sku's version.