阿里云如何使用查詢實(shí)例列表接口
來源:技術(shù)員聯(lián)盟┆發(fā)布時(shí)間:2017-12-10 12:30┆點(diǎn)擊:
查詢實(shí)例列表
描述
查詢所有實(shí)例的詳細(xì)信息。
此接口不會(huì)校驗(yàn)參數(shù)之間的依賴關(guān)系,返回結(jié)果是所有條件的"交集"。
如果參數(shù)為空,則過濾器不起作用,但是 InstanceIds 如果是一個(gè)空 Json Array(即[]),則視為該過濾器有效,且返回空。
請(qǐng)求參數(shù)
名稱
類型
是否必須
描述
Action
String
是
系統(tǒng)規(guī)定參數(shù),取值:DescribeInstances
RegionId
String
是
地域
VpcId
String
否
專有網(wǎng)絡(luò) Id
VSwitchId
String
否
交換機(jī) Id
ZoneId
String
否
可用區(qū) Id
InstanceIds
String
否
實(shí)例的編號(hào)列表
一個(gè)帶有格式的 Json Array:[“i-xxxxxxxxx”, ”i-yyyyyyyyy”, … “i-zzzzzzzzz”],最多 100 個(gè) Id,用半角逗號(hào)字符隔開。
InstanceType
String
否
實(shí)例的規(guī)格
InstanceTypeFamily
String
否
實(shí)例的規(guī)格族
InstanceNetworkType
String
否
實(shí)例網(wǎng)絡(luò)類型
PrivateIpAddresses
String
否
VPC 類型實(shí)例的私網(wǎng) IP 列表. 當(dāng) NetworkType 為 VPC 時(shí),這個(gè)參數(shù)生效.
一個(gè)帶有格式的 Json Array:[“172.16.1.1”, ”172.16.2.1”, … “172.16.10.1”],最多 100 個(gè) IP,用半角逗號(hào)字符隔開。
InnerIpAddresses
String
否
Classic 類型實(shí)例的私網(wǎng) IP 列表. 當(dāng) NetworkType 為 Classic 時(shí),這個(gè)參數(shù)生效.
一個(gè)帶有格式的 Json Array:[“10.1.1.1”, ”10.1.2.1”, … “10.1.10.1”],最多 100 個(gè) IP,用半角逗號(hào)字符隔開。
PublicIpAddresses
String
否
Classic 類型實(shí)例的公網(wǎng) IP 列表. 當(dāng) NetworkType 為 Classic 時(shí),這個(gè)參數(shù)生效.
一個(gè)帶有格式的 Json Array:[“42.1.1.1”, ”42.1.2.1”, … “42.1.10.1”],最多 100 個(gè) IP,用半角逗號(hào)字符隔開。
SecurityGroupId
String
否
實(shí)例所屬的安全組
InstanceChargeType
String
否
實(shí)例的付費(fèi)方式。
PrePaid:預(yù)付費(fèi),即包年包月
PostPaid:后付費(fèi),即按量付費(fèi)
InternetChargeType
String
否
網(wǎng)絡(luò)計(jì)費(fèi)類型,PayByBandwidth | PayByTraffic兩個(gè)值中的一個(gè)。預(yù)付費(fèi)實(shí)例顯示PayByBandwidth(按帶寬計(jì)費(fèi))。
PayByTraffic:按流量計(jì)費(fèi)
PayByBandwidth:按帶寬計(jì)費(fèi)
InstanceName
String
否
實(shí)例名稱
ImageId
String
否
鏡像 ID
Status
String
否
實(shí)例狀態(tài),可選值:
Running
Starting
Stopping
Stopped
DeviceAvailable
String
否
實(shí)例是否還可以掛載磁盤。
True | False
IoOptimized
String
否
是否是 IO 優(yōu)化型實(shí)例
True | False
Tag.n.Key
String
否
標(biāo)簽 key,n 從 1 開始,最大為 5。
不允許為空字符串。
Tag.n.Value
String
否
標(biāo)簽 value,n 從 1 開始,最大為 5。
允許為空字符串。
PageNumber
Integer
否
實(shí)例狀態(tài)列表的頁碼,起始值為 1,默認(rèn)值為 1
PageSize
Integer
否
分頁查詢時(shí)設(shè)置的每頁行數(shù),最大值 100 行,默認(rèn)為 10