DescribeInstances

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

请求参数

返回数据

示例

请求示例

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

正常返回示例

XML格式

<Instances>
    <Instance>
        <Status>Running</Status>
        <InstanceId>i-instanc****</InstanceId>
        <Memory>2048</Memory>
        <Cpu>2</Cpu>
        <OSName>centos 6.8 x86_64</OSName>
        <SpecName>ens.sn1.stiny</SpecName>
        <InstanceName>Finance****</InstanceName>
        <InternetMaxBandwidthOut>100</InternetMaxBandwidthOut>
        <InternetMaxBandwidthIn>40</InternetMaxBandwidthIn>
        <ExpiredTime>2017-12-10T04:04:00Z</ExpiredTime>
        <ImageId>m-****</ImageId>
        <CreationTime>2019-12-13T03:04:31Z</CreationTime>
        <EnsRegionId>cn-hangzhou-telecom</EnsRegionId>
        <Disk>71680</Disk>
        <HostName/>
        <InstanceResourceType>EnsService</InstanceResourceType>
        <PrivateIpAddresses>
            <PrivateIpAddress>
                <GateWay>119.147.XX.XX</GateWay>
                <Isp>cmcc</Isp>
                <Ip>119.147.XX.XX</Ip>
            </PrivateIpAddress>
        </PrivateIpAddresses>
        <PublicIpAddresses>
            <PublicIpAddress>
                <GateWay>119.147.XX.XX</GateWay>
                <Isp>unicom</Isp>
                <Ip>119.147.XX.XX</Ip>
            </PublicIpAddress>
        </PublicIpAddresses>
        <DataDisk>
            <DataDisk>
                <Category>file</Category>
                <Size>51200</Size>
                <disk_type>pangu</disk_type>
                <name>name</name>
                <device_type>system</device_type>
                <storage>20480</storage>
                <DiskName>DiskName</DiskName>
                <uuid>d-5itef1wtxj961mbff8xe9****</uuid>
                <DiskId>d-5ip4c2dhmas0vjd5u1r****</DiskId>
            </DataDisk>
        </DataDisk>
        <SecurityGroupIds>
            <SecurityGroupId>sg-5kyicq2kfcapxrdds6ta****</SecurityGroupId>
        </SecurityGroupIds>
        <InnerIpAddress>
            <IpAddress>10.170.XX.XX</IpAddress>
        </InnerIpAddress>
        <PublicIpAddress>
            <IpAddress>119.147.XX.XX</IpAddress>
        </PublicIpAddress>
        <SystemDisk>
            <Category>file</Category>
            <Size>20480</Size>
            <disk_type>system</disk_type>
            <name>DiskName</name>
            <device_type>file</device_type>
            <storage>20480</storage>
            <DiskName>DiskName</DiskName>
            <uuid>d-5ip4c2dhmas0rn7rt0p96****</uuid>
            <DiskId>d-5ip4c2dhmas0rn7rt0p9****</DiskId>
        </SystemDisk>
        <NetworkAttributes>
            <VSwitchId>vsw-2zeh0r1pabwtg6wcs****</VSwitchId>
            <NetworkId>n-2zeuphj08tt7q3brd****</NetworkId>
            <PrivateIpAddress>
                <IpAddress>172.17.XX.XX</IpAddress>
            </PrivateIpAddress>
        </NetworkAttributes>
    </Instance>
</Instances>
<TotalCount>6</TotalCount>
<PageSize>10</PageSize>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<PageNumber>10</PageNumber>
<Code>0</Code>

JSON格式

{
    "Instances": {
        "Instance": {
            "Status": "Running",
            "InstanceId": "i-instanc****",
            "Memory": 2048,
            "Cpu": 2,
            "OSName": "centos 6.8 x86_64",
            "SpecName": "ens.sn1.stiny",
            "InstanceName": "Finance****",
            "InternetMaxBandwidthOut": 100,
            "InternetMaxBandwidthIn": 40,
            "ExpiredTime": "2017-12-10T04:04:00Z",
            "ImageId": "m-****",
            "CreationTime": "2019-12-13T03:04:31Z",
            "EnsRegionId": "cn-hangzhou-telecom",
            "Disk": 71680,
            "HostName": "",
            "InstanceResourceType": "EnsService",
            "PrivateIpAddresses": {
                "PrivateIpAddress": {
                    "GateWay": "119.147.XX.XX",
                    "Isp": "cmcc",
                    "Ip": "119.147.XX.XX"
                }
            },
            "PublicIpAddresses": {
                "PublicIpAddress": {
                    "GateWay": "119.147.XX.XX",
                    "Isp": "unicom",
                    "Ip": "119.147.XX.XX"
                }
            },
            "DataDisk": {
                "DataDisk": {
                    "Category": "file",
                    "Size": 51200,
                    "disk_type": "pangu",
                    "name": "name",
                    "device_type": "system",
                    "storage": 20480,
                    "DiskName": "DiskName",
                    "uuid": "d-5itef1wtxj961mbff8xe9****",
                    "DiskId": "d-5ip4c2dhmas0vjd5u1r****"
                }
            },
            "SecurityGroupIds": {
                "SecurityGroupId": "sg-5kyicq2kfcapxrdds6ta****"
            },
            "InnerIpAddress": {
                "IpAddress": "10.170.XX.XX"
            },
            "PublicIpAddress": {
                "IpAddress": "119.147.XX.XX"
            },
            "SystemDisk": {
                "Category": "file",
                "Size": 20480,
                "disk_type": "system",
                "name": "DiskName",
                "device_type": "file",
                "storage": 20480,
                "DiskName": "DiskName",
                "uuid": "d-5ip4c2dhmas0rn7rt0p96****",
                "DiskId": "d-5ip4c2dhmas0rn7rt0p9****"
            },
            "NetworkAttributes": {
                "VSwitchId": "vsw-2zeh0r1pabwtg6wcs****",
                "NetworkId": "n-2zeuphj08tt7q3brd****",
                "PrivateIpAddress": {
                    "IpAddress": "172.17.XX.XX"
                }
            }
        }
    },
    "TotalCount": 6,
    "PageSize": 10,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "PageNumber": 10,
    "Code": 0
}

错误码

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