本文介绍如何通过阿里云CLI调用DescribeImages API查询镜像。
背景信息
调用接口前建议您仔细阅读接口的相关说明,具体请参见DescribeImages。
通过阿里云CLI调用API时,不同数据类型的请求参数取值必须遵循格式要求,详情请参见参数格式说明。
示例一:通过镜像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