本文介绍如何通过阿里云CLI调用DescribeImages API查询镜像。

背景信息

您可以调用DescribeImages接口查询您可以使用的镜像资源。相关API文档请参见DescribeImages

通过阿里云CLI调用API时,不同数据类型的请求参数取值必须遵循格式要求,详情请参见参数格式说明

接口说明

  • 您可以查询的镜像资源包括您的自定义镜像、阿里云提供的公共镜像、云市场镜像以及其他阿里云用户主动共享给您的共享镜像。
  • 支持分页查询,查询结果包括可使用的镜像资源的总数和当前页的镜像资源。每页的数量默认为10条。

通过阿里云CLI调用API时,不同数据类型的请求参数取值必须遵循格式要求,详情请参见CLI参数格式说明

示例一:通过镜像ID查询信息

查询镜像m-bp1cz8on60352qnm****的信息。

aliyun ecs DescribeImages --RegionId cn-hangzhou --ImageId m-bp1cz8on60352qnm**** --output cols=ImageName,Status,OSNameEn,OSType,Progress,Usage rows=Images.Image[]

返回结果示例。

ImageName | Status    | OSNameEn           | OSType | Progress | Usage
--------- | ------    | --------           | ------ | -------- | -----
namedemo  | Available | CentOS  7.4 64 bit | linux  | 100%     | none

示例二:分页查询某种状态下的镜像信息

分页查询某种状态下的镜像的信息。例如,可用状态(Available)。

本示例中分页查询第一页的5条信息。

aliyun ecs DescribeImages --RegionId cn-hangzhou --Status Available --PageNumber 1 --PageSize 5 --output cols=ImageName,Status,OSNameEn,OSType,Progress,Usage rows=Images.Image[]

返回结果示例。

ImageName   | Status    | OSNameEn                                                       | OSType  | Progress | Usage
---------   | ------    | --------                                                       | ------  | -------- | -----
namedemo1   | Available | CentOS_64                                                      | linux   | 100%     | none
namedemo2   | Available | CentOS  7.6 64 bit                                             | linux   | 100%     | none
namedemo3   | Available | CentOS  7.4 64 bit                                             | linux   | 100%     | none
namedemo4   | Available | CentOS  7.2 64 bit                                             | linux   | 100%     | none
namedemo5   | Available | Windows Server  2016 Data Center Edition 64bit Chinese Edition | windows | 100%     | instance

示例三:查询绑定某标签的镜像信息

查询绑定了标签owner:zhangsan的镜像信息。

aliyun ecs DescribeImages --RegionId cn-hangzhou --Tag.1.Key owner --Tag.1.Value zhangsan --output cols=ImageName,Status,OSNameEn,OSType,Progress,Usage rows=Images.Image[]

返回结果示例。

ImageName | Status    | OSNameEn           | OSType | Progress | Usage
--------- | ------    | --------           | ------ | -------- | -----
namedemo  | Available | CentOS  7.6 64 bit | linux  | 100%     | none