阿里云如何使用查询实例列表接口
来源:技术员联盟┆发布时间:2017-12-10 12:30┆点击:
查询实例列表
描述
查询所有实例的详细信息。
此接口不会校验参数之间的依赖关系,返回结果是所有条件的"交集"。
如果参数为空,则过滤器不起作用,但是 InstanceIds 如果是一个空 Json Array(即[]),则视为该过滤器有效,且返回空。
请求参数
名称
类型
是否必须
描述
Action
String
是
系统规定参数,取值:DescribeInstances
RegionId
String
是
地域
VpcId
String
否
专有网络 Id
VSwitchId
String
否
交换机 Id
ZoneId
String
否
可用区 Id
InstanceIds
String
否
实例的编号列表
一个带有格式的 Json Array:[“i-xxxxxxxxx”, ”i-yyyyyyyyy”, … “i-zzzzzzzzz”],最多 100 个 Id,用半角逗号字符隔开。
InstanceType
String
否
实例的规格
InstanceTypeFamily
String
否
实例的规格族
InstanceNetworkType
String
否
实例网络类型
PrivateIpAddresses
String
否
VPC 类型实例的私网 IP 列表. 当 NetworkType 为 VPC 时,这个参数生效.
一个带有格式的 Json Array:[“172.16.1.1”, ”172.16.2.1”, … “172.16.10.1”],最多 100 个 IP,用半角逗号字符隔开。
InnerIpAddresses
String
否
Classic 类型实例的私网 IP 列表. 当 NetworkType 为 Classic 时,这个参数生效.
一个带有格式的 Json Array:[“10.1.1.1”, ”10.1.2.1”, … “10.1.10.1”],最多 100 个 IP,用半角逗号字符隔开。
PublicIpAddresses
String
否
Classic 类型实例的公网 IP 列表. 当 NetworkType 为 Classic 时,这个参数生效.
一个带有格式的 Json Array:[“42.1.1.1”, ”42.1.2.1”, … “42.1.10.1”],最多 100 个 IP,用半角逗号字符隔开。
SecurityGroupId
String
否
实例所属的安全组
InstanceChargeType
String
否
实例的付费方式。
PrePaid:预付费,即包年包月
PostPaid:后付费,即按量付费
InternetChargeType
String
否
网络计费类型,PayByBandwidth | PayByTraffic两个值中的一个。预付费实例显示PayByBandwidth(按带宽计费)。
PayByTraffic:按流量计费
PayByBandwidth:按带宽计费
InstanceName
String
否
实例名称
ImageId
String
否
镜像 ID
Status
String
否
实例状态,可选值:
Running
Starting
Stopping
Stopped
DeviceAvailable
String
否
实例是否还可以挂载磁盘。
True | False
IoOptimized
String
否
是否是 IO 优化型实例
True | False
Tag.n.Key
String
否
标签 key,n 从 1 开始,最大为 5。
不允许为空字符串。
Tag.n.Value
String
否
标签 value,n 从 1 开始,最大为 5。
允许为空字符串。
PageNumber
Integer
否
实例状态列表的页码,起始值为 1,默认值为 1
PageSize
Integer
否
分页查询时设置的每页行数,最大值 100 行,默认为 10