DescribeInstances

使用说明

• 单用户调用频率：20秒/次。
• 请求参数的作用类似于一个过滤器，过滤器为逻辑与（AND）关系。如果某一参数为空，则过滤器不起作用。但是参数InstanceIds如果是一个空JSON数组，则视为该过滤器有效，且返回空。

请求参数

返回数据

示例

请求示例

http(s)://ens.aliyuncs.com/?Action=DescribeInstances
&EnsRegionId=cn-beijing-cmcc
&InstanceId=i-5iqczfxps7csjrxeca****
&EnsRegionIds=["cn-suzhou-telecom","cn-chengdu-telecom"]
&InstanceIds=["i-5iqczfxps7csjrxeca07****", "i-5iqczfxps7csjrxeca07****"]]
&InstanceName=TestName
&ImageId=centos_6_08_64_20G_alibase_****
&PageNumber=1
&PageSize=10
&Status=Running
&OrderByParams={"InstanceNameSort":"asc","ExpireTimeSort":"asc","CreationTimeSort":"desc"}}
&EnsServiceId=ens-20190730202316s****
&InstanceResourceType=EnsService
&SearchKey=Joshua
&NetworkId=n-2zeuphj08tt7q3brd****
&VSwitchId=vsw-2zeh0r1pabwtg6wcs****
&SecurityGroupId=sg-5kyicq2kfcapxrdds6tar7jqb
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInstancesResponse>
    <Code>0</Code>
    <PageSize>60</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TotalCount>2</TotalCount>
    <Instances>
        <CreationTime>2019-07-26T06:40:43Z</CreationTime>
        <Status>Running</Status>
        <SpecName>ens.sn1.stiny</SpecName>
        <InstanceResourceType>EnsService</InstanceResourceType>
        <HostName>testHostName</HostName>
        <InstanceId>i-instanc****</InstanceId>
        <InternetMaxBandwidthIn>40</InternetMaxBandwidthIn>
        <InternetMaxBandwidthOut>100</InternetMaxBandwidthOut>
        <EnsRegionId>cn-hangzhou-telecom</EnsRegionId>
        <Cpu>2</Cpu>
        <ExpiredTime>2119-07-13T02:38:57Z</ExpiredTime>
        <InstanceName>i-5itef0f28t17bcdw9deu6meub</InstanceName>
        <Disk>71680</Disk>
        <OSName>centos 6.8 x86_64</OSName>
        <Memory>2048</Memory>
        <ImageId>m-****</ImageId>
        <DataDisk>
            <device_type>pangu</device_type>
            <disk_type>system</disk_type>
            <Size>51200</Size>
            <DiskName>DiskName</DiskName>
            <uuid>d-5itef1wtxj961mbff8xe9****</uuid>
            <storage>20480</storage>
            <DiskId>d-5ip4c2dhmas0vjd5u1r****</DiskId>
            <Category>file</Category>
            <name>name</name>
        </DataDisk>
        <PublicIpAddresses>
            <Ip>119.147.xx.xx</Ip>
            <GateWay>119.147.xx.xx</GateWay>
            <Isp>unicom</Isp>
        </PublicIpAddresses>
        <PrivateIpAddresses>
            <Ip>119.147.xx.xx</Ip>
            <GateWay>119.147.xx.xx</GateWay>
            <Isp>cmcc</Isp>
        </PrivateIpAddresses>
        <SecurityGroupIds>sg-5kyicq2kfcapxrdds6ta****</SecurityGroupIds>
        <InnerIpAddress>10.170.xx.xx</InnerIpAddress>
        <PublicIpAddress>119.147.xx.xx</PublicIpAddress>
        <SystemDisk>
            <device_type>pangu</device_type>
            <disk_type>system</disk_type>
            <Size>51200</Size>
            <DiskName>DiskName</DiskName>
            <uuid>d-5ip4c2dhmas0rn7rt0p96****</uuid>
            <storage>20480</storage>
            <DiskId>d-5ip4c2dhmas0rn7rt0p9****</DiskId>
            <Category>file</Category>
            <name>DiskName</name>
        </SystemDisk>
        <NetworkAttributes>
            <NetworkId>n-2zeuphj08tt7q3brd****</NetworkId>
            <VSwitchId>vsw-2zeh0r1pabwtg6wcs****</VSwitchId>
            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
        </NetworkAttributes>
    </Instances>
</DescribeInstancesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Code" : 0,
  "PageSize" : 60,
  "PageNumber" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount" : 2,
  "Instances" : [ {
    "CreationTime" : "2019-07-26T06:40:43Z",
    "Status" : "Running",
    "SpecName" : "ens.sn1.stiny",
    "InstanceResourceType" : "EnsService",
    "HostName" : "testHostName",
    "InstanceId" : "i-instanc****",
    "InternetMaxBandwidthIn" : 40,
    "InternetMaxBandwidthOut" : 100,
    "EnsRegionId" : "cn-hangzhou-telecom",
    "Cpu" : "2",
    "ExpiredTime" : "2119-07-13T02:38:57Z",
    "InstanceName" : "i-5itef0f28t17bcdw9deu6meub",
    "Disk" : 71680,
    "OSName" : "centos 6.8 x86_64",
    "Memory" : 2048,
    "ImageId" : "m-****",
    "DataDisk" : [ {
      "device_type" : "pangu",
      "disk_type" : "system",
      "Size" : 51200,
      "DiskName" : "DiskName",
      "uuid" : "d-5itef1wtxj961mbff8xe9****",
      "storage" : 20480,
      "DiskId" : "d-5ip4c2dhmas0vjd5u1r****",
      "Category" : "file",
      "name" : "name"
    } ],
    "PublicIpAddresses" : [ {
      "Ip" : "119.147.xx.xx",
      "GateWay" : "119.147.xx.xx",
      "Isp" : "unicom"
    } ],
    "PrivateIpAddresses" : [ {
      "Ip" : "119.147.xx.xx",
      "GateWay" : "119.147.xx.xx",
      "Isp" : "cmcc"
    } ],
    "SecurityGroupIds" : [ "sg-5kyicq2kfcapxrdds6ta****" ],
    "InnerIpAddress" : [ "10.170.xx.xx" ],
    "PublicIpAddress" : [ "119.147.xx.xx" ],
    "SystemDisk" : {
      "device_type" : "pangu",
      "disk_type" : "system",
      "Size" : 51200,
      "DiskName" : "DiskName",
      "uuid" : "d-5ip4c2dhmas0rn7rt0p96****",
      "storage" : 20480,
      "DiskId" : "d-5ip4c2dhmas0rn7rt0p9****",
      "Category" : "file",
      "name" : "DiskName"
    },
    "NetworkAttributes" : {
      "NetworkId" : "n-2zeuphj08tt7q3brd****",
      "VSwitchId" : "vsw-2zeh0r1pabwtg6wcs****",
      "PrivateIpAddress" : [ "172.17.**.**" ]
    }
  } ]
}

错误码

访问错误中心查看更多错误码。