Find an image

Methods

Find an image by using the console

You can find the image that you want to use on the Images page in the ECS console.

1. Log on to the ECS console.
2. In the left-side navigation pane, choose Instances & Images > Images.
3. In the top navigation bar, select a region.
4. Select an image type.
5. Optional:Select an image family.
   Note You can select an image family only for custom images. By default, all images are displayed.
6. Select a search item from the drop-down list.
   Note

   You can select the image name, image ID, or snapshot ID as the search item.

7. Enter the corresponding value in the search bar.
8. Click Search to search for the image.

Example 1

Example 1: Find a Windows public image in the China (Beijing) region

Perform the following operations on the Images page:

1. In the upper-left corner, select China (Beijing) from the drop-down list.
2. Click the Public Image tab.
3. Select Image Name from the drop-down list in the search bar.
4. Enter win in the search bar.
5. Click Search to search for the image.

Example 2

Example 2: Find a shared image whose name contains mysql in the China (Hangzhou) region

Perform the following operations on the Images page:

1. In the upper-left corner, select China (Hangzhou) from the drop-down list.
2. Click the Shared Images tab.
3. Select Image Name from the drop-down list in the search bar.
4. Enter mysql in the search bar.
5. Click Search to search for the image.

Example 3

Example 3: Find a custom image whose snapshot ID is s-2xxxxxxxxxxxxxxxxxxx in the China (Shenzhen) region

Perform the following operations on the Images page:

1. In the upper-left corner, select China (Shenzhen) from the drop-down list.
2. Click the Custom Images tab.
3. Select Snapshot ID from the drop-down list in the search bar.
4. Enter s-2xxxxxxxxxxxxxxxxxxx in the search bar.
5. Click Search to search for the image.

Find an image by calling an API operation

You can use OpenAPI Explorer or Alibaba Cloud CLI to call the DescribeImages operation to find a specific image. For more information about Alibaba Cloud CLI, see What is Alibaba Cloud CLI?. This section describes how to use OpenAPI Explorer to call the API operation to find a specific image.

1. Go to OpenAPI Explorer.
2. Select a region from the RegionId drop-down list.
3. Optional:Set other parameters such as ImageName and ImageId.
   Note Image IDs are named in accordance with the following rules:

   • IDs of public images are named after the operating system version numbers, architectures, languages, and release dates. For example, win2008r2_64_ent_sp1_en-us_40G_alibase_20190318.vhd indicates that the image runs Windows Server 2008 R2 Enterprise 64-bit (English).
   • IDs of custom images and Alibaba Cloud Marketplace images start with m.
   • IDs of shared images are the same as those of the source custom images.
4. Click Submit Request.
5. Click the Debugging Result tab.

   If the image is found, image information such as the image ID, description, and operating system is displayed on the Debugging Result tab. For more information, see DescribeImages.