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

Edit

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

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

Edit

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

Edit

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

Edit

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

Edit

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

Edit

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