Skip to content

Commit b6089b6

Browse files
Merge pull request #209749 from mattmcinnes/patch-12
Update cli-ps-findimage.md
2 parents b6a12fd + 52539f8 commit b6089b6

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

articles/virtual-machines/linux/cli-ps-findimage.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ description: Learn how to use the Azure CLI to find image URNs and purchase plan
44
ms.service: virtual-machines
55
ms.subservice: imaging
66
ms.topic: how-to
7-
ms.date: 11/14/2022
7+
ms.date: 12/9/2022
88
author: ebolton-cyber
9-
ms.author: edewebolton
9+
ms.author: mattmcinnes
1010
ms.collection: linux
11-
ms.custom: contperf-fy21q3-portal, devx-track-azurecli
11+
ms.custom: contperf-fy21q3-portal, devx-track-azurecli, GGAL-freshness922
1212
---
1313
# Find Azure Marketplace image information using the Azure CLI
1414

@@ -29,7 +29,7 @@ A Marketplace image in Azure has the following attributes:
2929

3030
These values can be passed individually or as an image *URN*, combining the values separated by the colon (:). For example: *Publisher*:*Offer*:*Sku*:*Version*. You can replace the version number in the URN with `latest` to use the latest version of the image.
3131

32-
If the image publisher provides additional license and purchase terms, then you must accept those before you can use the image. For more information, see [Check the purchase plan information](#check-the-purchase-plan-information).
32+
If the image publisher provides extra license and purchase terms, then you must accept those terms before you can use the image. For more information, see [Check the purchase plan information](#check-the-purchase-plan-information).
3333

3434

3535

@@ -41,7 +41,7 @@ You can run the [az vm image list --all](/cli/azure/vm/image) to see all of the
4141
az vm image list --output table
4242
```
4343

44-
The output includes the image URN. You can also use the *UrnAlias* which is a shortened version created for popular images like *UbuntuLTS*.
44+
The output includes the image URN. You can also use the *UrnAlias*, which is a shortened version created for popular images like *UbuntuLTS*.
4545

4646
```output
4747
Offer Publisher Sku Urn UrnAlias Version
@@ -79,7 +79,7 @@ az vm image list --offer Debian --all --output table
7979

8080
Another way to find an image in a location is to run the [az vm image list-publishers](/cli/azure/vm/image), [az vm image list-offers](/cli/azure/vm/image), and [az vm image list-skus](/cli/azure/vm/image) commands in sequence. With these commands, you determine these values:
8181

82-
1. List the image publishers for a location. In this example, we are looking at the *West US* region.
82+
1. List the image publishers for a location. In this example, we're looking at the *West US* region.
8383

8484
```azurecli
8585
az vm image list-publishers --location westus --output table
@@ -107,20 +107,20 @@ Another way to find an image in a location is to run the [az vm image list-publi
107107
--all --output table
108108
```
109109
110-
Pass this value of the URN column with the `--image` parameter when you create a VM with the [az vm create](/cli/azure/vm) command. You can also replace the version number in the URN with "latest", to simply use the latest version of the image.
110+
Pass this value of the URN column with the `--image` parameter when you create a VM with the [az vm create](/cli/azure/vm) command. You can also replace the version number in the URN with "latest", to use the latest version of the image.
111111
112112
If you deploy a VM with a Resource Manager template, you set the image parameters individually in the `imageReference` properties. See the [template reference](/azure/templates/microsoft.compute/virtualmachines).
113113
114114
115115
## Check the purchase plan information
116116
117-
Some VM images in the Azure Marketplace have additional license and purchase terms that you must accept before you can deploy them programmatically.
117+
Some VM images in the Azure Marketplace have extra license and purchase terms that you must accept before you can deploy them programmatically.
118118
119119
To deploy a VM from such an image, you'll need to accept the image's terms the first time you use it, once per subscription. You'll also need to specify *purchase plan* parameters to deploy a VM from that image
120120
121-
To view an image's purchase plan information, run the [az vm image show](/cli/azure/image) command with the URN of the image. If the `plan` property in the output is not `null`, the image has terms you need to accept before programmatic deployment.
121+
To view an image's purchase plan information, run the [az vm image show](/cli/azure/image) command with the URN of the image. If the `plan` property in the output isn't `null`, the image has terms you need to accept before programmatic deployment.
122122
123-
For example, the Canonical Ubuntu Server 18.04 LTS image doesn't have additional terms, because the `plan` information is `null`:
123+
For example, the Canonical Ubuntu Server 18.04 LTS image doesn't have extra terms, because the `plan` information is `null`:
124124
125125
```azurecli
126126
az vm image show --location westus --urn Canonical:UbuntuServer:18.04-LTS:latest
@@ -206,7 +206,7 @@ az vm image terms accept --urn bitnami:rabbitmq:rabbitmq:latest
206206

207207
With information about the image, you can deploy it using the `az vm create` command.
208208

209-
To deploy an image that does not have plan information, like the latest Ubuntu Server 18.04 image from Canonical, pass the URN for `--image`:
209+
To deploy an image that doesn't have plan information, like the latest Ubuntu Server 18.04 image from Canonical, pass the URN for `--image`:
210210

211211
```azurecli-interactive
212212
az group create --name myURNVM --location westus
@@ -235,20 +235,20 @@ az vm create \
235235
--plan-publisher bitnami
236236
```
237237

238-
If you get a message about accepting the terms of the image, review section [Accept the terms](#accept-the-terms). Make sure the output of `az vm image accept-terms` returns the value `"accepted": true,` showing that you have accepted the terms of the image.
238+
If you get a message about accepting the terms of the image, review section [Accept the terms](#accept-the-terms). Make sure the output of `az vm image accept-terms` returns the value `"accepted": true,` showing that you've accepted the terms of the image.
239239

240240

241241
## Using an existing VHD with purchase plan information
242242

243-
If you have an existing VHD from a VM that was created using a paid Azure Marketplace image, you might need to supply the purchase plan information when you create a new VM from that VHD.
243+
If you have an existing VHD from a VM that was created using a paid Azure Marketplace image, you might need to give the purchase plan information when creating a new VM from that VHD.
244244

245245
If you still have the original VM, or another VM created using the same marketplace image, you can get the plan name, publisher, and product information from it using [az vm get-instance-view](/cli/azure/vm#az-vm-get-instance-view). This example gets a VM named *myVM* in the *myResourceGroup* resource group and then displays the purchase plan information.
246246

247247
```azurecli-interactive
248248
az vm get-instance-view -g myResourceGroup -n myVM --query plan
249249
```
250250

251-
If you didn't get the plan information before the original VM was deleted, you can file a [support request](https://portal.azure.com/#create/Microsoft.Support). They will need the VM name, subscription ID and the time stamp of the delete operation.
251+
If you didn't get the plan information before the original VM was deleted, you can file a [support request](https://portal.azure.com/#create/Microsoft.Support). They'll need the VM name, subscription ID and the time stamp of the delete operation.
252252

253253
Once you have the plan information, you can create the new VM using the `--attach-os-disk` parameter to specify the VHD.
254254

0 commit comments

Comments
 (0)