Description

This API queries details of all instances.

This API does not verify the dependency between parameters. The return results are the intersection of all criteria.

A parameter with the value of null does not play the role of a filter. However, if the InstanceIds parameter is an empty JSON array (that is, “[]”), it is regarded as a valid filter and the returned value is null.

Request parameters

Return parameters

Error codes

Example

Request example

https://ecs.aliyuncs.com/?Action=DescribeInstances
&RegionId=cn-hangzhou
&<Public Request Parameters>

Return Example

XML format

<DescribeInstancesResponse>
    <CreationTime>2014-09-21T01:12:35Z</CreationTime> 
    <DeviceAvailable>true</DeviceAvailable>
    <Description></Description>
    <EipAddress>
          <AllocationId></AllocationId>
        <InternetChargeType></InternetChargeType>
        <IpAddress></IpAddress>
    </EipAddress>
    <ExpiredTime>2011-09-08T16:00Z</ExpiredTime>
    <HostName>iZ25skktcp4Z</HostName>
       <ImageId>ubuntu1404_64_20G_aliaegis_20140703.vhd</ImageId>
    <InnerIpAddress></InnerIpAddress>
    <InstanceChargeType>PostPaid</InstanceChargeType>
    <IpAddress></IpAddress>
    <InstanceId>i-25skktcp4</InstanceId> 
    <InstanceName>iZ25skktcp4Z</InstanceName>
    <InstanceNetworkType>vpc</InstanceNetworkType>
    <InstanceType>ecs.t1.xsmall</InstanceType>
    <InternetChargeType></InternetChargeType>
    <InternetMaxBandwidthIn>-1</InternetMaxBandwidthIn>
    <InternetMaxBandwidthOut></InternetMaxBandwidthOut>
    <IoOptimized>false</IoOptimized>
    <OperationLocks>
           <LockReason></LockReason>
    </OperationLocks>
    <PublicIpAddress>
        <IpAddress></IpAddress>
    </PublicIpAddress>
    <RegionId>cn-beijing</RegionId>
    <SecurityGroupIds>
           <SecurityGroupId>sg-25am0n4q0</SecurityGroupId>
    </SecurityGroupIds>
    <SerialNumber>51d1353b-22bf-4567-a176-8b3e12e43135</SerialNumber>
    <Status>Running</Status> 
    <VlanId></VlanId>
    <VpcAttributes>
        <NatIpAddress>10.175.68.212</NatIpAddress> 
        <PrivateIpAddress>
            <IpAddress>192.168.2.3</IpAddress>
           </PrivateIpAddress>
        <VSwitchId>vsw-25gbsqby3</VSwitchId>
        <VpcId>vpc-25onv3oi4</VpcId>
    </VpcAttributes>
    <ZoneId>cn-beijing-a</ZoneId>
</DescribeInstancesResponse>

JSON format

{
  "Instances": {
    "Instance": [
      {
        "CreationTime": "2015-07-27T07:08Z",
        "DeviceAvailable": true,
        "EipAddress": {},
        "ExpiredTime": "2011-09-08T16:00Z",
        "HostName": "iZ94t3s0jxkZ",
        "ImageId": "centos6u5_64_20G_aliaegis_20150130.vhd",
        "InnerIpAddress": {
          "IpAddress": [
            "10.170.106.80"
          ]
        },
        "InstanceChargeType": "PostPaid",
        "InstanceId": "i-94t3s0jxk",
        "InstanceName": "dd\u6027\u80fd\u6d4b\u8bd5",
        "InstanceNetworkType": "classic",
        "InstanceType": "ecs.s2.large",
        "InternetChargeType": "PayByTraffic",
        "InternetMaxBandwidthIn": -1,
        "InternetMaxBandwidthOut": 1,
        "IoOptimized": false,
        "OperationLocks": {
          "LockReason": []
        },
        "PublicIpAddress": {
          "IpAddress": [
            "120.25.13.106"
          ]
        },
        "RegionId": "cn-shenzhen",
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-94kd0cyg0"
          ]
        },
        "SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e43135",
        "Status": "Running",
        "VpcAttributes": {
          "PrivateIpAddress": {
            "IpAddress": []
          }
        },
        "ZoneId": "cn-shenzhen-a"
      }
    ]
  },
  "PageNumber": 1, 
  "PageSize": 10, 
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A", 
  "TotalCount": 1
}