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

背景信息

您可以调用DescribeInstances接口查询一台或多台ECS实例的详细信息。相关API文档请参见DescribeInstances

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

接口说明

  • 请求参数的作用类似于一个过滤器,过滤器为逻辑与(AND)关系。如果某一参数为空,则过滤器不起作用。但是参数InstanceIds如果是一个空JSON数组,则视为该过滤器有效,且返回空。
  • 如果您使用的是RAM用户账号或者RAM角色,当用户或者角色缺乏接口权限时,将会返回空列表。您可以在请求中加入DryRun参数,判断是否因权限问题导致的空列表现象。

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

示例一:通过实例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