通过阿里云CLI调用DescribeInstances API查询一台或多台ECS实例的详细信息。

背景信息

您可以调用DescribeInstances接口查询一台或多台ECS实例的详细信息。调用接口前建议您仔细阅读接口的相关说明，具体请参见DescribeInstances。

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

示例一：通过实例ID查询ECS实例

查询实例ID为i-bp14a7xie8erwsvo****的实例信息。

aliyun ecs DescribeInstances --RegionId cn-hangzhou --InstanceIds '["i-bp14a7xie8erwsvo****"]' --output cols=InstanceId,InstanceName,Description,ImageId,Status rows=Instances.Instance[]

返回结果示例。

InstanceId             | InstanceName | Description | ImageId                | Status
----------             | ------------ | ----------- | -------                | ------
i-bp14a7xie8erwsvo**** | wpdemo       | wp          | m-bp12qhgxbmp5eh02**** | Running

示例二：查询绑定指定标签的ECS实例

查询绑定owner:zhangsan标签的ECS实例信息。

aliyun ecs DescribeInstances --RegionId cn-hangzhou --Tag.1.Key owner --Tag.1.Value zhangsan --output cols=InstanceId,InstanceName,Description,ImageId,Status rows=Instances.Instance[]

返回结果示例。

InstanceId             | InstanceName            | Description | ImageId                                 | Status
----------             | ------------            | ----------- | -------                                 | ------
i-bp1aq39j2yul5y01**** | namedemo01              | demo01      | m-bp12qhgxbmp5eh02****                  | Stopped
i-bp1dpvr406hq1jnw**** | namedemo02              |  demo01     | centos_7_06_64_20G_alibase_20190711.vhd | Running

示例三：查询指定镜像ID的ECS实例

查询镜像为m-bp12qhgxbmp5eh02****标签的ECS实例信息。

aliyun ecs DescribeInstances --RegionId cn-hangzhou --ImageId m-bp12qhgxbmp5eh02**** --output cols=InstanceId,InstanceName,Description,ImageId,Status rows=Instances.Instance[]

返回结果示例。

InstanceId             | InstanceName | Description | ImageId                | Status
----------             | ------------ | ----------- | -------                | ------
i-bp14a7xie8erwsvo**** | demo01       | desc01      | m-bp12qhgxbmp5eh02**** | Running
i-bp1aq39j2yul5y01**** | demo02       | desc02      | m-bp12qhgxbmp5eh02**** | Stopped

示例四：查询指定VPC内的ECS实例

查询专有网络VPC IDvpc-bp1vwnn14rqpyiczj****和交换机IDvsw-bp1ddbrxdlrcbim46****的ECS实例信息。

aliyun ecs DescribeInstances --RegionId cn-hangzhou --VpcId vpc-bp1vwnn14rqpyiczj**** --VSwitchId vsw-bp1ddbrxdlrcbim46**** --output cols=InstanceId,InstanceName,ImageId,Status rows=Instances.Instance[]

返回结果示例。

InstanceId             | InstanceName                      | ImageId                                 | Status
----------             | ------------                      | -------                                 | ------
i-bp14a7xie8erwsvo**** | namedemo01                        | m-bp12qhgxbmp5eh02****                  | Running
i-bp1c271nqm264lwj**** | namedemo02                        | P2VSImageLnx125                         | Running
i-bp18a6ub0vt1tvn1**** | namedemo03                        | centos_7_02_64_20G_alibase_20170818.vhd | Running
i-bp1aq39j2yul5y01**** | namedemo04                        | m-bp12qhgxbmp5eh02****                  | Stopped

示例五：分页查询ECS实例

分页查询第二页的ECS实例信息，每页展示5条信息。

aliyun ecs DescribeInstances --RegionId cn-hangzhou --PageNumber 2 --PageSize 5 --output cols=InstanceId,InstanceName,ImageId,Status rows=Instances.Instance[]

返回结果示例。

InstanceId             | InstanceName        | ImageId                                 | Status
----------             | ------------        | -------                                 | ------
i-bp1akazu9o0rm7q0**** | demoname01          | centos_8_0_x64_20G_alibase_20191225.vhd | Running
i-bp134jm1g6kqyiqu**** | demoname02          | m-bp1bc3g3b032o0ja****                  | Running
i-bp17qwke5y0v7hk2**** | demoname03          | centos_7_02_64_20G_alibase_20170818.vhd | Running
i-bp18a6ub0vt1tvn1**** | demoname04          | centos_7_02_64_20G_alibase_20170818.vhd | Running
i-bp1aq39j2yul5y01**** | demoname05          | m-bp12qhgxbmp5eh02****                  | Stopped