接口说明

• 请求参数的作用类似于一个过滤器，过滤器为逻辑与（AND）关系。如果某一参数为空，则过滤器不起作用。但是参数InstanceIds如果是一个空JSON数组，则视为该过滤器有效，且返回空。
• 如果您使用的是RAM用户账号或者RAM角色，当用户或者角色缺乏接口权限时，将会返回空列表。您可以在请求中加入DryRun参数，判断是否因权限问题导致的空列表现象。

通过阿里云CLI调用API时，不同数据类型的请求参数取值必须遵循格式要求，详情请参见CLI参数格式说明。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeInstances
&RegionId=cn-hangzhou
&PageSize=1
PageNumber=1
&<公共请求参数>

正常返回示例

XML 格式

<DescribeInstancesResponse>
    <PageNumber>1</PageNumber>
    <TotalCount>6</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>8EF01A45-FFFA-497B-B5C3-1DE1B74DB32D</RequestId>
    <Instances>
        <Instance>
            <InnerIpAddress></InnerIpAddress>
            <ImageId>ubuntu_16_0402_64_20G_alibase_20170818.vhd</ImageId>
            <InstanceTypeFamily>ecs.g5</InstanceTypeFamily>
            <VlanId></VlanId>
            <NetworkInterfaces>
                <NetworkInterface>
                    <MacAddress>00:16:3e:32:b4:dc</MacAddress>
                    <PrimaryIpAddress>172.17.XX.XXX</PrimaryIpAddress>
                    <NetworkInterfaceId>eni-2zeh9atclduxvf1zc***</NetworkInterfaceId>
                </NetworkInterface>
            </NetworkInterfaces>
            <InstanceId>XXXXXXXXXXX</InstanceId>
            <EipAddress>
                <IpAddress></IpAddress>
                <AllocationId></AllocationId>
                <InternetChargeType></InternetChargeType>
            </EipAddress>
            <InternetMaxBandwidthIn>1000</InternetMaxBandwidthIn>
            <ZoneId>cn-beijing-e</ZoneId>
            <InternetChargeType>PayByBandwidth</InternetChargeType>
            <SpotStrategy>NoSpot</SpotStrategy>
            <StoppedMode>Not-applicable</StoppedMode>
            <SerialNumber>d9bd1cdc-624d-4736-9da5-2ba2f741a***</SerialNumber>
            <IoOptimized>true</IoOptimized>
            <Memory>8192</Memory>
            <Cpu>2</Cpu>
            <VpcAttributes>
                <NatIpAddress></NatIpAddress>
                <PrivateIpAddress>
                    <IpAddress>172.17.XX.XXX</IpAddress>
                </PrivateIpAddress>
                <VSwitchId>vsw-2zeh0r1pabwtg6wcss***</VSwitchId>
                <VpcId>vpc-2zeuphj08tt7q3brdb***</VpcId>
            </VpcAttributes>
            <InternetMaxBandwidthOut>1</InternetMaxBandwidthOut>
            <SecurityGroupIds>
                <SecurityGroupId>sg-2ze21r9qb638hvtrv***</SecurityGroupId>
            </SecurityGroupIds>
            <SpotPriceLimit>0.0</SpotPriceLimit>
            <SaleCycle>Week</SaleCycle>
            <AutoReleaseTime></AutoReleaseTime>
            <InstanceName>ECS-BUY-2017-57-10</InstanceName>
            <Description></Description>
            <ResourceGroupId></ResourceGroupId>
            <OSType>linux</OSType>
            <OSName>Ubuntu 16.04 64</OSName>
            <InstanceNetworkType>vpc</InstanceNetworkType>
            <PublicIpAddress>
                <IpAddress>47.94.XX.XX</IpAddress>
            </PublicIpAddress>
            <HostName>iZ2zeh9atclduxvf1zxu***</HostName>
            <InstanceType>ecs.g5.large</InstanceType>
            <CreationTime>2017-12-10T04:04Z</CreationTime>
            <Tags>
                <Tag>
                    <TagValue>fqwfew</TagValue>
                    <TagKey>fefqe</TagKey>
                </Tag>
                <Tag>
                    <TagValue>weqfwq</TagValue>
                    <TagKey>fqewfwqewf</TagKey>
                </Tag>
                <Tag>
                    <TagValue>ewqffeqw</TagValue>
                    <TagKey>fqfwewfqw</TagKey>
                </Tag>
            </Tags>
            <Status>Running</Status>
            <ClusterId></ClusterId>
            <Recyclable>false</Recyclable>
            <RegionId>cn-beijing</RegionId>
            <GPUSpec></GPUSpec>
            <OperationLocks></OperationLocks>
            <GPUAmount>0</GPUAmount>
            <InstanceChargeType>PrePaid</InstanceChargeType>
            <ExpiredTime>2017-12-17T16:00Z</ExpiredTime>
        </Instance>
    </Instances>
</DescribeInstancesResponse>

JSON 格式

{
	"PageNumber": 1,
	"TotalCount": 58,
	"PageSize": 1,
	"RequestId": "97935DF1-0289-4AA2-9DD1-72377838B16B",
	"Instances": {
		"Instance": [
			{
				"ImageId": "centos_7_06_64_20G_alibase_20190711.vhd",
				"VlanId": "",
				"EipAddress": {
					"IpAddress": "",
					"AllocationId": "",
					"InternetChargeType": ""
				},
				"ZoneId": "cn-hangzhou-f",
				"IoOptimized": true,
				"SerialNumber": "51d1353b-22bf-4567-a176-8b3e12e43***",
				"Cpu": 2,
				"Memory": 8192,
				"DeviceAvailable": true,
				"SecurityGroupIds": {
					"SecurityGroupId": [
						"sg-bp17zljqpohu6j2io***"
					]
				},
				"SaleCycle": "",
				"AutoReleaseTime": "",
				"ResourceGroupId": "",
				"OSType": "linux",
				"OSName": "CentOS  7.6 64位",
				"InstanceNetworkType": "classic",
				"HostName": "iZbp1j4i2jdf3owlhebz***",
				"CreationTime": "2019-11-11T08:35Z",
				"Tags": {
					"Tag": [
						{
							"TagValue": "asg-bp1d8uuut40f4qc40***",
							"TagKey": "acs:autoscaling:scalingGroupId"
						},
						{
							"TagValue": "ESS",
							"TagKey": "ESS"
						}
					]
				},
				"EcsCapacityReservationAttr": {
					"CapacityReservationPreference": "none",
					"CapacityReservationId": ""
				},
				"RegionId": "cn-hangzhou",
				"DeletionProtection": false,
				"OperationLocks": {
					"LockReason": []
				},
				"ExpiredTime": "2099-12-31T15:59Z",
				"CpuOptions": {
					"Numa": "",
					"ThreadsPerCore": 2,
					"CoreCount": 1
				},
				"InnerIpAddress": {
					"IpAddress": [
						"10.80.61.42"
					]
				},
				"InstanceTypeFamily": "ecs.mn4",
				"InstanceId": "i-bp1j4i2jdf3owlheb***",
				"InternetMaxBandwidthIn": 500,
				"CreditSpecification": "",
				"InternetChargeType": "PayByTraffic",
				"SpotStrategy": "NoSpot",
				"StoppedMode": "Not-applicable",
				"InternetMaxBandwidthOut": 1,
				"VpcAttributes": {
					"NatIpAddress": "",
					"PrivateIpAddress": {
						"IpAddress": []
					},
					"VSwitchId": "",
					"VpcId": ""
				},
				"SpotPriceLimit": 0,
				"StartTime": "2019-11-11T08:35Z",
				"InstanceName": "ECS-asg-MyFirstScalingGroup",
				"Description": "ECS",
				"OSNameEn": "CentOS  7.6 64 bit",
				"PublicIpAddress": {
					"IpAddress": [
						"121.40.77.XXX"
					]
				},
				"InstanceType": "ecs.mn4.large",
				"Status": "Running",
				"Recyclable": false,
				"ClusterId": "",
				"GPUSpec": "",
				"InstanceChargeType": "PostPaid",
				"GPUAmount": 0,
				"DedicatedHostAttribute": {
					"DedicatedHostId": "",
					"DedicatedHostName": ""
				},
				"DedicatedInstanceAttribute": {
					"Affinity": "",
					"Tenancy": ""
				},
				"DeploymentSetId": ""
			}
		]
	}
}

错误码

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