使用说明
describeInstances主要是用于列出一组以上云服务器的详细信息。 若没有instanceId或orderUuid的参数,则会列出所有云服务器的信息。 关于云服务器的预设帐号密码,请在进入用户入口后,点选 "下载云服务器列表预设密码",此压缩文件的密码为身证号或营业执照号后四码。
Request 参数
参数 | 说明 | 备注 |
---|---|---|
instanceId
(非必要参数) |
主机服务标识号列表 类型 : String 默认值 : 无 是否为复数型态 : 是 |
可支持多值 |
orderUuid
(非必要参数) |
订单编号列表 类型 : String 默认值 : 无 是否为复数型态 : 是 |
可支持多值 |
businessTag (非必要参数) |
业务类别 类型 : String 预设值 : 无 是否为复数型态 : 否 |
请参考 业务类别 |
vpcBusinessServiceId (非必要参数) |
软体资料中心服务识别码 类型 : String 预设值 : 无 是否为复数型态 : 否 |
Response 参数
参数 | 说明 | 备注 |
---|---|---|
requestId
(非必要参数) |
请求标识号 类型 : JSON value : string 是否为复数型态 : 否 |
系统自动生成 |
instanceList |
云服务器信息 类型 : JSON value : array 是否为复数型态 : 是(List) |
VirtualMachineEntry列表 |
businessTag (非必要参数) |
业务类别 类型 : String 预设值 : 无 是否为复数型态 : 否 |
|
vpcBusinessServiceId (非必要参数) |
软体资料中心服务识别码 类型 : String 预设值 : 无 是否为复数型态 : 否 |
Request示例
示例1: https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeInstances &chtAuthType=hwspass &version=${version} &expires=${expires} &accessKey=${accessKey} &signature=${signature} 示例2: https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=describeInstances &instanceId=BV550100010003 &instanceId=BV550100010004 &chtAuthType=hwspass &version=${version} &expires=${expires} &accessKey=${accessKey} &signature=${signature}
Response示例
[ "requestId":"xxxEXAMPLE", { "orderUuid": "75cee802-1ed4-4a2a-8078-ca0a29deeff0", "instanceId": "BV550100010003", "applyDate": "2012-01-01T01:01:01Z", "startDate": "2012-01-01T01:01:01Z", "endDate": null, "name": "myVm01", "operationStatus": "vmStart", "provisionStatus": "provisioning", "provisionMessage": null, "ipForNat": "172.10.10.1", "ipForVm": "192.168.150.1", "businessTag": "9a92f90c-532a-4a5d-9e3c-0c1805bc2583", "regionId": "region-tw-1" }, { "orderUuid": "0762e00f-df4b-48d0-93bd-4f355c85b2d8", "instanceId": "BV550100010004", "applyDate": "2012-01-01T01:01:01Z", "startDate": "2012-01-01T01:01:01Z", "endDate": null, "name": "myVm01", "operationStatus": "vmStart", "provisionStatus": "provisioning", "provisionMessage": null, "ipForNat": "172.10.10.1", "ipForVm": "192.168.150.1", "businessTag": "9a92f90c-532a-4a5d-9e3c-0c1805bc2583", "regionId": "region-tw-1" } ]