DescribeInstances

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

请求参数

返回数据

示例

请求示例

https://ens.aliyuncs.com?Action=DescribeInstances
&Version=2017-11-10
&<公共请求参数>

正常返回示例

XML 格式

<DescribeInstancesResponse>
  <Instances>
        <Instance>
              <Status>Running</Status>
              <PrivateIpAddresses>
                    <PrivateIpAddress>
                          <GateWay></GateWay>
                          <Ip>10.0.xx.xx</Ip>
                          <Isp>telecom</Isp>
                    </PrivateIpAddress>
              </PrivateIpAddresses>
              <InstanceId>i-5l4re50zpy1ecu8uy4pa0****</InstanceId>
              <Memory>8192</Memory>
              <Cpu>4</Cpu>
              <SpecName>ens.sn1.small</SpecName>
              <OSName>centos 7.4 x86_64</OSName>
              <SecurityGroupIds>
        </SecurityGroupIds>
              <InstanceName></InstanceName>
              <PublicIpAddress>
                    <IpAddress>110.185.xx.xx</IpAddress>
              </PublicIpAddress>
              <SystemDisk>
                    <Category>pangu</Category>
                    <Size>30720</Size>
                    <disk_type>system</disk_type>
                    <name></name>
                    <device_type>pangu</device_type>
                    <storage>30720</storage>
                    <DiskName></DiskName>
                    <uuid>d-5l4re63k5i9c46riy75****</uuid>
                    <DiskId>d-5l4re63k5i9c46riy75****</DiskId>
              </SystemDisk>
              <InnerIpAddress>
                    <IpAddress>10.0.xx.xx</IpAddress>
              </InnerIpAddress>
              <DataDisk>
                    <DataDisk>
                          <Category>pangu</Category>
                          <Size>51200</Size>
                          <disk_type>data</disk_type>
                          <name></name>
                          <device_type>pangu</device_type>
                          <storage>51200</storage>
                          <DiskName></DiskName>
                          <uuid>d-5l4re63k5i9c82wwz88****</uuid>
                          <DiskId>d-5l4re63k5i9c82wwz881****</DiskId>
                    </DataDisk>
              </DataDisk>
              <InternetMaxBandwidthOut>1500</InternetMaxBandwidthOut>
              <InternetMaxBandwidthIn>0</InternetMaxBandwidthIn>
              <ExpiredTime>2020-04-04T16:00:00Z</ExpiredTime>
              <CreationTime>2020-03-04T01:56:26Z</CreationTime>
              <ImageId>centos_7_04_64_20G_alibase_20171211</ImageId>
              <PublicIpAddresses>
                    <PublicIpAddress>
                          <GateWay></GateWay>
                          <Ip>110.185.xx.xx</Ip>
                          <Isp>telecom</Isp>
                    </PublicIpAddress>
              </PublicIpAddresses>
              <EnsRegionId>cn-chengdu-telecom-4</EnsRegionId>
              <Disk>81920</Disk>
              <InstanceResourceType>EnsInstance</InstanceResourceType>
        </Instance>
  </Instances>
  <TotalCount>1</TotalCount>
  <RequestId>92577D88-9E1A-4B6E-9541-D380AD7D4B36</RequestId>
  <PageSize>10</PageSize>
  <PageNumber>1</PageNumber>
  <Code>0</Code>
</DescribeInstancesResponse>

JSON 格式

{
	"Instances": {
		"Instance": [
			{
				"Status": "Running",
				"PrivateIpAddresses": {
					"PrivateIpAddress": [
						{
							"GateWay": "",
							"Ip": "10.0.xx.xx",
							"Isp": "telecom"
						}
					]
				},
				"InstanceId": "i-5l4re50zpy1ecu8uy4pa0****",
				"Memory": 8192,
				"Cpu": 4,
				"SpecName": "ens.sn1.small",
				"OSName": "centos 7.4 x86_64",
				"SecurityGroupIds": {
					"SecurityGroupId": []
				},
				"InstanceName": "",
				"PublicIpAddress": {
					"IpAddress": [
						"110.185.xx.xx"
					]
				},
				"SystemDisk": {
					"Category": "pangu",
					"Size": 30720,
					"disk_type": "system",
					"name": "",
					"device_type": "pangu",
					"storage": 30720,
					"DiskName": "",
					"uuid": "d-5l4re63k5i9c46riy75****",
					"DiskId": "d-5l4re63k5i9c46riy75****"
				},
				"InnerIpAddress": {
					"IpAddress": [
						"10.0.xx.xx"
					]
				},
				"DataDisk": {
					"DataDisk": [
						{
							"Category": "pangu",
							"Size": 51200,
							"disk_type": "data",
							"name": "",
							"device_type": "pangu",
							"storage": 51200,
							"DiskName": "",
							"uuid": "d-5l4re63k5i9c82wwz88****",
							"DiskId": "d-5l4re63k5i9c82wwz881****"
						}
					]
				},
				"InternetMaxBandwidthOut": 1500,
				"InternetMaxBandwidthIn": 0,
				"ExpiredTime": "2020-04-04T16:00:00Z",
				"CreationTime": "2020-03-04T01:56:26Z",
				"ImageId": "centos_7_04_64_20G_alibase_20171211",
				"PublicIpAddresses": {
					"PublicIpAddress": [
						{
							"GateWay": "",
							"Ip": "110.185.xx.xx",
							"Isp": "telecom"
						}
					]
				},
				"EnsRegionId": "cn-chengdu-telecom-4",
				"Disk": 81920,
				"InstanceResourceType": "EnsInstance"
			}
		]
	},
	"TotalCount": 1,
	"RequestId": "92577D88-9E1A-4B6E-9541-D380AD7D4B36",
	"PageSize": 10,
	"PageNumber": 1,
	"Code": 0
}

错误码

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