调用DescribeInstances查询ECS实例的详细信息_云服务器 ECS-阿里云帮助中心

接口说明

请求参数的作用类似于一个过滤器，过滤器为逻辑与（AND）关系。如果某一参数为空，则过滤器不起作用。但是参数InstanceIds如果是一个空JSON数组，则视为该过滤器有效，且返回空。
如果您使用的是RAM用户账号或者RAM角色，当用户或者角色缺乏接口权限时，将会返回空列表。您可以在请求中加入DryRun参数，判断是否因权限问题导致的空列表现象。
通过阿里云CLI调用API时，不同数据类型的请求参数取值必须遵循格式要求。更多信息，请参见CLI参数格式说明。
支持以下两种方式查看返回数据：
- 方式一：分页查询首页时，仅需设置MaxResults以限制返回信息的条目数，返回结果中的NextToken将作为查询后续页的凭证。查询后续页时，将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证，并设置MaxResults限制返回条目数。
- 方式二：通过PageSize设置单页返回的条目数，再通过PageNumber设置页码。
  
  以上两种方式只能任选其中之一。当返回的条目数较多时，推荐使用方式一。如果设置了MaxResults或NextToken参数，则请求参数PageSize和PageNumber将失效，且返回数据中的TotalCount无效。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeInstances	系统规定参数。取值：DescribeInstances。
RegionId	String	是	cn-hangzhou	实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
VpcId	String	否	v-bp67acfmxazb4p****	专有网络VPC ID。
VSwitchId	String	否	vsw-bp67acfmxazb4p****	交换机ID。
ZoneId	String	否	cn-hangzhou-g	可用区ID。
InstanceNetworkType	String	否	vpc	实例网络类型。取值范围： classic：经典网络。 vpc：专有网络VPC。
SecurityGroupId	String	否	sg-bp67acfmxazb4p****	实例所属的安全组。
InstanceIds	String	否	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", … "i-bp67acfmxazb4p**"]	实例ID。取值可以由多个实例ID组成一个JSON数组，最多支持100个ID，ID之间用半角逗号（,）隔开。
PageNumber	Integer	否	1	实例状态列表的页码。起始值：1。默认值：1。
PageSize	Integer	否	10	分页查询时设置的每页行数。最大值为100。默认值为10。
NextToken	String	否	caeba0bbb2be03f84eb48b699f0a4883	查询凭证（Token），取值为上一次API调用返回的`NextToken`参数值。
MaxResults	Integer	否	10	分页查询时每页行数。最大值为100。默认值：当不设置值或设置的值小于10时，默认值为10。当设置的值大于100时，默认值为100。
InnerIpAddresses	String	否	["10.1.1.1", "10.1.2.1", … "10.1.10.1"]	经典网络类型实例的内网IP列表。当InstanceNetworkType=classic时生效，取值可以由多个IP组成一个JSON数组，最多支持100个IP，IP之间用半角逗号（,）隔开。
PrivateIpAddresses	String	否	["172.16.1.1", "172.16.2.1", … "172.16.10.1"]	VPC网络类型实例的私有IP。当InstanceNetworkType=vpc时生效，取值可以由多个IP组成一个JSON数组，最多支持100个IP，IP之间用半角逗号（,）隔开。
PublicIpAddresses	String	否	["42.1.1.", "42.1.2.", … "42.1.10.**"]	实例的公网IP列表。取值可以由多个IP组成一个JSON数组，最多支持100个IP，IP之间用半角逗号（,）隔开。
EipAddresses	String	否	["42.1.1.", "42.1.2.", … "42.1.10.**"]	实例的弹性公网IP列表。当InstanceNetworkType=vpc时该参数生效，取值可以由多个IP组成一个JSON数组，最多支持100个IP，IP之间用半角逗号（,）隔开。
InstanceChargeType	String	否	PostPaid	实例的计费方式。取值范围： PostPaid：按量付费。 PrePaid：包年包月。
InternetChargeType	String	否	PayByTraffic	公网带宽计费方式。取值范围： PayByBandwidth：按固定带宽计费。 PayByTraffic：按使用流量计费。说明按使用流量计费模式下的出入带宽峰值都是带宽上限，不作为业务承诺指标。当出现资源争抢时，带宽峰值可能会受到限制。如果您的业务需要有带宽的保障，请使用按固定带宽计费模式。
InstanceName	String	否	Test	实例名称，支持使用通配符*进行模糊搜索。
ImageId	String	否	m-bp67acfmxazb4p****	镜像ID。
Status	String	否	Running	实例状态。取值范围： Pending：创建中。 Running：运行中。 Starting：启动中。 Stopping：停止中。 Stopped：已停止。
LockReason	String	否	security	资源被锁定的原因。取值范围： financial：因欠费被锁定。 security：因安全原因被锁定。 Recycling：抢占式实例的待释放锁定状态。 dedicatedhostfinancial：因为专有宿主机欠费导致ECS实例被锁定。 refunded：因退款被锁定。
Filter.1.Key	String	否	CreationStartTime	查询资源时的筛选键，取值必须为`CreationStartTime`。同时设置`Filter.1.Key`和`Filter.1.Value`可以查询在指定时间点后创建的资源信息。
Filter.2.Key	String	否	CreationEndTime	查询资源时的筛选键，取值必须为`CreationEndTime`。同时设置`Filter.2.Key`和`Filter.2.Value`可以查询在指定时间点前创建的资源信息。
Filter.3.Key	String	否	ExpiredStartTime	查询资源时的筛选键，取值必须为`ExpiredStartTime`。同时设置`Filter.3.Key`和`Filter.3.Value`可以查询在指定时间点后到期的资源信息。
Filter.4.Key	String	否	ExpiredEndTime	查询资源时的筛选键，取值必须为`ExpiredEndTime`。同时设置`Filter.4.Key`和`Filter.4.Value`可以查询在指定时间点前到期的资源信息。
Filter.1.Value	String	否	2017-12-05T22:40Z	查询资源时的筛选值。指定该参数时必须同时指定`Filter.1.Key`参数，格式为：`yyyy-MM-ddTHH:mmZ`，采用UTC +0时区。
Filter.2.Value	String	否	2017-12-06T22:40Z	查询资源时的筛选值。指定该参数时必须同时指定`Filter.2.Key`参数，格式为：`yyyy-MM-ddTHH:mmZ`，采用UTC +0时区。
Filter.3.Value	String	否	2017-12-07T22:40Z	查询资源时的筛选值。指定该参数时必须同时指定`Filter.3.Key`参数，格式为：`yyyy-MM-ddTHH:mmZ`，采用UTC +0时区。
Filter.4.Value	String	否	2017-12-08T22:40Z	查询资源时的筛选值。指定该参数时必须同时指定`Filter.4.Key`参数，格式为：`yyyy-MM-ddTHH:mmZ`，采用UTC +0时区。
DeviceAvailable	Boolean	否	false	说明该参数正在邀测中，暂不支持使用。
IoOptimized	Boolean	否	true	是否是I/O优化型实例。取值范围： true：是。 false：否。
NeedSaleCycle	Boolean	否	false	说明该参数正在邀测中，暂不支持使用。
InstanceType	String	否	ecs.g5.large	实例的规格。
InstanceTypeFamily	String	否	ecs.g5	实例的规格族。
KeyPairName	String	否	KeyPairNameTest	实例使用的SSH密钥对名称。
ResourceGroupId	String	否	rg-bp67acfmxazb4p****	实例所在的企业资源组ID。使用该参数过滤资源时，资源数量不能超过1000个。说明不支持默认资源组过滤。
HpcClusterId	String	否	hpc-bp67acfmxazb4p****	实例所在的HPC集群ID。
RdmaIpAddresses	String	否	10.10.10.102	HPC实例的Rdma网络IP。
DryRun	Boolean	否	false	是否只预检此次请求。取值范围： true：发送检查请求，不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过，则返回对应错误。如果检查通过，会返回错误码DryRunOperation。 false：发送正常请求，通过检查后返回2XX HTTP状态码并直接查询资源状况。默认值：false。
HttpEndpoint	String	否	enabled	是否启用实例元数据的访问通道。取值范围： enabled：启用。 disabled：禁用。默认值：enabled。说明有关实例元数据的更多信息，请参见实例元数据概述。
HttpTokens	String	否	optional	访问实例元数据时是否强制使用加固模式（IMDSv2）。取值范围： optional：不强制使用。 required：强制使用。设置该取值后，普通模式无法访问实例元数据。默认值：optional。说明有关访问实例元数据模式的更多信息，请参见实例元数据访问模式。
HttpPutResponseHopLimit	Integer	否	0	说明该参数正在邀测中，暂不支持使用。
Ipv6Address.N	String	否	2408:4321:180:1701:94c7:bc38:3bfa:****	弹性网卡的IPv6地址。N表示可以设置多个IPv6地址，N的取值范围为1~100。
Tag.N.key	String	否	keyTest	标签键。说明为提高兼容性，建议您使用另一个`Tag.N.Key`参数。
Tag.N.Key	String	否	TestKey	实例的标签键。N的取值范围为1~20。使用一个标签过滤资源，查询到该标签下的资源数量不能超过1000个；使用多个标签过滤资源，查询到同时绑定了多个标签的资源数量不能超过1000个。如果资源数量超过1000个，请使用ListTagResources接口进行查询。
Tag.N.Value	String	否	TestValue	实例的标签值。N的取值范围：1~20。
Tag.N.value	String	否	valueTest	标签值。说明为提高兼容性，建议您使用另一个`Tag.N.Value`参数。
AdditionalAttributes.N	String	否	META_OPTIONS	其他属性值。N的取值范围为1~20。取值范围： META_OPTIONS：实例元数据。 DDH_CLUSTER：专有宿主机集群。 NETWORK_PRIMARY_ENI_IP ：主网卡辅助IP。

返回数据

名称	类型	示例值	描述
NextToken	String	caeba0bbb2be03f84eb48b699f0a4883	本次调用返回的查询凭证值。
PageSize	Integer	10	输入时设置的每页行数。
PageNumber	Integer	1	实例列表的页码。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。
TotalCount	Integer	1	查询到的实例总数。说明使用`MaxResults`和`NextToken`参数进行分页查询时，返回的`TotalCount`参数值无意义。
Instances	Array of Instance		由Instances组成的数组格式，返回实例的信息。
Instance
CreationTime	String	2017-12-10T04:04Z	实例创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyy-MM-ddTHH:mmZ。更多信息，请参见ISO 8601。
SerialNumber	String	51d1353b-22bf-4567-a176-8b3e12e4****	实例序列号。
Status	String	Running	实例状态。
DeploymentSetId	String	ds-bp67acfmxazb4p****	部署集ID。
KeyPairName	String	testKeyPairName	密钥对名称。
SaleCycle	String	month	说明该参数已弃用，不再返回有意义的数据。
SpotStrategy	String	NoSpot	按量实例的竞价策略。可能值： NoSpot：正常按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，最高按量付费价格的抢占式实例。
DeviceAvailable	Boolean	true	实例是否可以挂载数据盘。 true：可以挂载数据盘。 false：不可以挂载数据盘。
LocalStorageCapacity	Long	1000	实例挂载的本地存储容量。单位：GiB。
Description	String	testDescription	实例描述。
SpotDuration	Integer	1	抢占式实例的保留时长，单位为小时。可能值：0~6。保留时长2~6正在邀测中，如需开通请提交工单。值为0，则为无保护期模式。说明当SpotStrategy值为SpotWithPriceLimit或SpotAsPriceGo时返回该参数。
InstanceNetworkType	String	vpc	实例网络类型。可能值： classic：经典网络。 vpc：专有网络VPC。
InstanceName	String	InstanceNameTest	实例名称。
OSNameEn	String	CentOS 7.4 64 bit	实例操作系统的英文名称。
HpcClusterId	String	hpc-bp67acfmxazb4p****	实例所属的HPC集群ID。
SpotPriceLimit	Float	0.98	实例的每小时最高价格。支持最大3位小数，参数SpotStrategy=SpotWithPriceLimit时，该参数生效。
Memory	Integer	16384	内存大小，单位为MiB。
OSName	String	CentOS 7.4 64 位	实例的操作系统名称。
DeploymentSetGroupNo	Integer	1	ECS实例绑定部署集分散部署时，实例在部署集中的分组位置。
ImageId	String	m-bp67acfmxazb4p****	实例运行的镜像ID。
VlanId	String	10	实例的VLAN ID。说明该参数即将被弃用，为提高兼容性，请尽量使用其他参数。
ClusterId	String	c-bp67acfmxazb4p****	实例所在的集群ID。说明该参数即将被弃用，为提高兼容性，请尽量使用其他参数。
GPUSpec	String	NVIDIA V100	实例规格附带的GPU类型。
AutoReleaseTime	String	2017-12-10T04:04Z	按量付费实例的自动释放时间。
DeletionProtection	Boolean	false	实例释放保护属性，指定是否支持通过控制台或API（DeleteInstance）释放实例。 true：已开启实例释放保护。 false：未开启实例释放保护。说明该属性仅适用于按量付费实例，且只能限制手动释放操作，对系统释放操作不生效。
StoppedMode	String	KeepCharging	实例停机后是否继续收费。可能值： KeepCharging：停机后继续收费，为您继续保留库存资源。 StopCharging：停机后不收费。停机后，我们释放实例对应的资源，例如vCPU、内存和公网IP等资源。重启是否成功依赖于当前地域中是否仍有资源库存。 Not-applicable：本实例不支持停机不收费功能。
GPUAmount	Integer	4	实例规格附带的GPU数量。
HostName	String	testHostName	实例主机名。
InstanceId	String	i-bp67acfmxazb4p****	实例ID。
InternetMaxBandwidthOut	Integer	5	公网出带宽最大值，单位：Mbit/s。
InternetMaxBandwidthIn	Integer	50	公网入带宽最大值，单位：Mbit/s。
InstanceType	String	ecs.g5.large	实例规格。
InstanceChargeType	String	PostPaid	实例的计费方式。可能值： PrePaid：包年包月。 PostPaid：按量付费。
RegionId	String	cn-hangzhou	实例所属地域ID。
IoOptimized	Boolean	true	是否为I/O优化型实例。 true：是。 false：否。
StartTime	String	2017-12-10T04:04Z	实例最近一次的启动时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyy-MM-ddTHH:mmZ。更多信息，请参见ISO 8601。
Cpu	Integer	8	vCPU数。
LocalStorageAmount	Integer	2	实例挂载的本地存储数量。
ExpiredTime	String	2017-12-10T04:04Z	过期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyy-MM-ddTHH:mmZ。更多信息，请参见ISO 8601。
ResourceGroupId	String	rg-bp67acfmxazb4p****	实例所属的企业资源组ID。
InternetChargeType	String	PayByTraffic	网络计费类型。可能值： PayByBandwidth：按固定带宽计费。 PayByTraffic：按使用流量计费。
ZoneId	String	cn-hangzhou-g	实例所属可用区。
Recyclable	Boolean	false	实例是否可以回收。
ISP	String	null	说明该参数正在邀测中，暂未开放使用。
CreditSpecification	String	Standard	修改突发性能实例的运行模式。可能值： Standard：标准模式。有关实例性能的更多信息，请参见什么是突发性能实例中的性能约束模式章节。 Unlimited：无性能约束模式，有关实例性能的更多信息，请参见什么是突发性能实例中的无性能约束模式章节。
InstanceTypeFamily	String	ecs.g5	实例规格族。
OSType	String	linux	实例的操作系统类型，分为Windows Server和Linux两种。可能值： windows。 linux。
NetworkInterfaces	Array of NetworkInterface		实例包含的弹性网卡集合。
NetworkInterface
Type	String	Primary	弹性网卡类型。可能值： Primary：主网卡。 Secondary：辅助弹性网卡。
MacAddress	String	00:16:3e:32:b4:**	弹性网卡的MAC地址。
PrimaryIpAddress	String	172.17..*	弹性网卡主私有IP地址。
NetworkInterfaceId	String	eni-2zeh9atclduxvf1z****	弹性网卡的ID。
PrivateIpSets	Array of PrivateIpSet		PrivateIpSet组成的集合。
PrivateIpSet
PrivateIpAddress	String	172.17..	实例的私网IP地址。
Primary	Boolean	true	是否是主私网IP地址。 true：是。 false：否。
Ipv6Sets	Array of Ipv6Set		弹性网卡已分配的IPv6地址集合。仅当请求参数`AdditionalAttributes.N`取值为`NETWORK_PRIMARY_ENI_IP`时，才会返回该参数值。
Ipv6Set
Ipv6Address	String	2408:4321:180:1701:94c7:bc38:3bfa:***	弹性网卡已分配的IPv6地址。
Ipv4PrefixSets	Array of Ipv4PrefixSet		弹性网卡已分配的IPv4前缀集合。仅当请求参数`AdditionalAttributes.N`取值为`NETWORK_PRIMARY_ENI_IP`时，才会返回该参数值。
Ipv4PrefixSet
Ipv4Prefix	String	192.168../28	弹性网卡已分配的IPv4前缀。
Ipv6PrefixSets	Array of Ipv6PrefixSet		弹性网卡已分配的IPv6前缀集合。仅当请求参数`AdditionalAttributes.N`取值为`NETWORK_PRIMARY_ENI_IP`时，才会返回该参数值。
Ipv6PrefixSet
Ipv6Prefix	String	2001:1111::::/80	弹性网卡已分配的IPv6前缀。
OperationLocks	Array of LockReason		实例的锁定原因。
LockReason
LockMsg	String	The specified instance is locked due to financial reason.	实例被锁定的描述信息。
LockReason	String	Recycling	锁定类型。可能值： financial：因欠费被锁定。 security：因安全原因被锁定。 Recycling：抢占式实例的待释放锁定状态。 dedicatedhostfinancial：因为专有宿主机欠费导致ECS实例被锁定。 refunded：因退款被锁定。
Tags	Array of Tag		实例的标签集合。
Tag
TagValue	String	TestValue	实例的标签值。
TagKey	String	TestKey	实例的标签键。
RdmaIpAddress	Array of String	10.10.10.102	HPC实例的Rdma网络IP。
SecurityGroupIds	Array of String	sg-bp67acfmxazb4p****	安全组ID。
PublicIpAddress	Array of String	121.40..	实例公网IP地址。
InnerIpAddress	Array of String	10.170..	经典网络类型实例的内网IP地址。
VpcAttributes	Object		专有网络VPC属性。
VpcId	String	vpc-2zeuphj08tt7q3brd****	专有网络VPC ID。
NatIpAddress	String	172.17..	云产品的IP，用于VPC云产品之间的网络互通。
VSwitchId	String	vsw-2zeh0r1pabwtg6wcs****	虚拟交换机ID。
PrivateIpAddress	Array of String	172.17..	私有IP地址。
EipAddress	Object		弹性公网IP绑定信息。
IsSupportUnassociate	Boolean	true	是否可以解绑弹性公网IP。
InternetChargeType	String	PayByTraffic	弹性公网IP的计费方式。 PayByBandwidth：按带宽计费。 PayByTraffic：按流量计费。
IpAddress	String	42.112..	弹性公网IP。
Bandwidth	Integer	5	弹性公网IP的公网带宽限速，单位为Mbit/s。
AllocationId	String	eip-2ze88m67qx5z****	弹性公网IP的ID。
HibernationOptions	Object		说明该参数正在邀测中，暂未开放使用。
Configured	Boolean	false	说明该参数正在邀测中，暂未开放使用。
DedicatedHostAttribute	Object		由专有宿主机集群ID（DedicatedHostClusterId）、专有宿主机ID（DedicatedHostId）和名称（DedicatedHostName）组成的宿主机属性数组。
DedicatedHostId	String	dh-bp67acfmxazb4p****	专有宿主机ID。
DedicatedHostName	String	testDedicatedHostName	专有宿主机名称。
DedicatedHostClusterId	String	dc-bp67acfmxazb4h****	专有宿主机集群ID。
EcsCapacityReservationAttr	Object		云服务器ECS的容量预留相关参数。
CapacityReservationPreference	String	cr-bp67acfmxazb4p****	容量预留偏好。
CapacityReservationId	String	cr-bp67acfmxazb4p****	容量预留ID。
DedicatedInstanceAttribute	Object		专有宿主机实例的属性。
Affinity	String	default	专有宿主机实例是否与专有宿主机关联。可能值： default：专有宿主机实例不与专有宿主机关联。停机不收费实例重启后，可能会放置在自动资源部署池中的其它专有宿主机上。 host：专有宿主机实例与专有宿主机关联。停机不收费实例重启后，仍放置在原专有宿主机上。
Tenancy	String	default	实例的宿主机类型是否为专有宿主机。可能值： default：实例的宿主机类型不是专有宿主机。 host：实例的宿主机类型为专有宿主机。
CpuOptions	Object		CPU配置详情。
Numa	String	2	分配的线程数。可能值：2。
CoreCount	Integer	2	物理CPU核心数。
ThreadsPerCore	Integer	4	CPU线程数。
MetadataOptions	Object		元数据选项集合。
HttpEndpoint	String	enabled	是否启用实例元数据的访问通道。可能值： enabled：启用。 disabled：禁用。
HttpPutResponseHopLimit	Integer	0	说明该参数暂未开放使用。
HttpTokens	String	optional	访问实例元数据时是否强制使用加固模式（IMDSv2）。可能值： optional：不强制使用。 required：强制使用。
ImageOptions	Object		镜像相关属性信息。
LoginAsNonRoot	Boolean	false	使用该镜像的实例是否支持使用ecs-user用户登录。可能值： true：是。 false：否。

示例

请求示例

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

正常返回示例

XML格式

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

<DescribeInstancesResponse>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TotalCount>1</TotalCount>
    <Instances>
        <Instance>
            <CreationTime>2017-12-10T04:04Z</CreationTime>
            <SerialNumber>51d1353b-22bf-4567-a176-8b3e12e4****</SerialNumber>
            <Status>Running</Status>
            <DeploymentSetId>ds-bp67acfmxazb4p****</DeploymentSetId>
            <KeyPairName>testKeyPairName</KeyPairName>
            <SaleCycle>month</SaleCycle>
            <SpotStrategy>NoSpot</SpotStrategy>
            <DeviceAvailable>true</DeviceAvailable>
            <LocalStorageCapacity>1000</LocalStorageCapacity>
            <Description>testDescription</Description>
            <SpotDuration>1</SpotDuration>
            <InstanceNetworkType>vpc</InstanceNetworkType>
            <InstanceName>InstanceNameTest</InstanceName>
            <OSNameEn>CentOS  7.4 64 bit</OSNameEn>
            <HpcClusterId>hpc-bp67acfmxazb4p****</HpcClusterId>
            <SpotPriceLimit>0.98</SpotPriceLimit>
            <Memory>16384</Memory>
            <OSName>CentOS  7.4 64 位</OSName>
            <DeploymentSetGroupNo>1</DeploymentSetGroupNo>
            <ImageId>m-bp67acfmxazb4p****</ImageId>
            <VlanId>10</VlanId>
            <ClusterId>c-bp67acfmxazb4p****</ClusterId>
            <GPUSpec>NVIDIA V100</GPUSpec>
            <AutoReleaseTime>2017-12-10T04:04Z</AutoReleaseTime>
            <DeletionProtection>false</DeletionProtection>
            <StoppedMode>KeepCharging</StoppedMode>
            <GPUAmount>4</GPUAmount>
            <HostName>testHostName</HostName>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <InternetMaxBandwidthOut>5</InternetMaxBandwidthOut>
            <InternetMaxBandwidthIn>50</InternetMaxBandwidthIn>
            <InstanceType>ecs.g5.large</InstanceType>
            <InstanceChargeType>PostPaid</InstanceChargeType>
            <RegionId>cn-hangzhou</RegionId>
            <IoOptimized>true</IoOptimized>
            <StartTime>2017-12-10T04:04Z</StartTime>
            <Cpu>8</Cpu>
            <LocalStorageAmount>2</LocalStorageAmount>
            <ExpiredTime>2017-12-10T04:04Z</ExpiredTime>
            <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
            <InternetChargeType>PayByTraffic</InternetChargeType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Recyclable>false</Recyclable>
            <ISP>null</ISP>
            <CreditSpecification>Standard</CreditSpecification>
            <InstanceTypeFamily>ecs.g5</InstanceTypeFamily>
            <OSType>linux</OSType>
            <NetworkInterfaces>
                <NetworkInterface>
                    <Type>Primary</Type>
                    <MacAddress>00:16:3e:32:b4:**</MacAddress>
                    <PrimaryIpAddress>172.17.**.***</PrimaryIpAddress>
                    <NetworkInterfaceId>eni-2zeh9atclduxvf1z****</NetworkInterfaceId>
                    <PrivateIpSets>
                        <PrivateIpSet>
                            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
                            <Primary>true</Primary>
                        </PrivateIpSet>
                    </PrivateIpSets>
                    <Ipv6Sets>
                        <Ipv6Set>
                            <Ipv6Address>2408:4321:180:1701:94c7:bc38:3bfa:***</Ipv6Address>
                        </Ipv6Set>
                    </Ipv6Sets>
                    <Ipv4PrefixSets>
                        <Ipv4PrefixSet>
                            <Ipv4Prefix>192.168.*.*/28</Ipv4Prefix>
                        </Ipv4PrefixSet>
                    </Ipv4PrefixSets>
                    <Ipv6PrefixSets>
                        <Ipv6PrefixSet>
                            <Ipv6Prefix>2001:1111:*:*::/80</Ipv6Prefix>
                        </Ipv6PrefixSet>
                    </Ipv6PrefixSets>
                    <OperationLocks>
                        <OperationLock>
                            <LockMsg>The specified instance is locked due to financial reason.</LockMsg>
                            <LockReason>Recycling</LockReason>
                        </OperationLock>
                    </OperationLocks>
                    <Tags>
                        <Tag>
                            <TagValue>TestValue</TagValue>
                            <TagKey>TestKey</TagKey>
                        </Tag>
                    </Tags>
                    <RdmaIpAddresses>
                        <RdmaIpAddress>10.10.10.102</RdmaIpAddress>
                    </RdmaIpAddresses>
                    <SecurityGroupIds>
                        <SecurityGroupId>sg-bp67acfmxazb4p****</SecurityGroupId>
                    </SecurityGroupIds>
                    <PublicIpAddress>
                        <PublicIpAddres>121.40.**.**</PublicIpAddres>
                    </PublicIpAddress>
                    <InnerIpAddress>
                        <InnerIpAddres>10.170.**.**</InnerIpAddres>
                    </InnerIpAddress>
                    <VpcAttributes>
                        <VpcId>vpc-2zeuphj08tt7q3brd****</VpcId>
                        <NatIpAddress>172.17.**.**</NatIpAddress>
                        <VSwitchId>vsw-2zeh0r1pabwtg6wcs****</VSwitchId>
                        <PrivateIpAddress>
                            <PrivateIpAddres>172.17.**.**</PrivateIpAddres>
                        </PrivateIpAddress>
                    </VpcAttributes>
                    <EipAddress>
                        <IsSupportUnassociate>true</IsSupportUnassociate>
                        <InternetChargeType>PayByTraffic</InternetChargeType>
                        <IpAddress>42.112.**.**</IpAddress>
                        <Bandwidth>5</Bandwidth>
                        <AllocationId>eip-2ze88m67qx5z****</AllocationId>
                    </EipAddress>
                    <HibernationOptions>
                        <Configured>false</Configured>
                    </HibernationOptions>
                    <DedicatedHostAttribute>
                        <DedicatedHostId>dh-bp67acfmxazb4p****</DedicatedHostId>
                        <DedicatedHostName>testDedicatedHostName</DedicatedHostName>
                        <DedicatedHostClusterId>dc-bp67acfmxazb4h****</DedicatedHostClusterId>
                    </DedicatedHostAttribute>
                    <EcsCapacityReservationAttr>
                        <CapacityReservationPreference>cr-bp67acfmxazb4p****</CapacityReservationPreference>
                        <CapacityReservationId>cr-bp67acfmxazb4p****</CapacityReservationId>
                    </EcsCapacityReservationAttr>
                    <DedicatedInstanceAttribute>
                        <Affinity>default</Affinity>
                        <Tenancy>default</Tenancy>
                    </DedicatedInstanceAttribute>
                    <CpuOptions>
                        <Numa>2</Numa>
                        <CoreCount>2</CoreCount>
                        <ThreadsPerCore>4</ThreadsPerCore>
                    </CpuOptions>
                    <MetadataOptions>
                        <HttpEndpoint>enabled</HttpEndpoint>
                        <HttpPutResponseHopLimit>0</HttpPutResponseHopLimit>
                        <HttpTokens>optional</HttpTokens>
                    </MetadataOptions>
                    <ImageOptions>
                        <LoginAsNonRoot>false</LoginAsNonRoot>
                    </ImageOptions>
                </NetworkInterface>
            </NetworkInterfaces>
        </Instance>
    </Instances>
</DescribeInstancesResponse>

JSON格式

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

{
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "PageSize" : 10,
  "PageNumber" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount" : 1,
  "Instances" : {
    "Instance" : [ {
      "CreationTime" : "2017-12-10T04:04Z",
      "SerialNumber" : "51d1353b-22bf-4567-a176-8b3e12e4****",
      "Status" : "Running",
      "DeploymentSetId" : "ds-bp67acfmxazb4p****",
      "KeyPairName" : "testKeyPairName",
      "SaleCycle" : "month",
      "SpotStrategy" : "NoSpot",
      "DeviceAvailable" : true,
      "LocalStorageCapacity" : 1000,
      "Description" : "testDescription",
      "SpotDuration" : 1,
      "InstanceNetworkType" : "vpc",
      "InstanceName" : "InstanceNameTest",
      "OSNameEn" : "CentOS  7.4 64 bit",
      "HpcClusterId" : "hpc-bp67acfmxazb4p****",
      "SpotPriceLimit" : 0.98,
      "Memory" : 16384,
      "OSName" : "CentOS  7.4 64 位",
      "DeploymentSetGroupNo" : 1,
      "ImageId" : "m-bp67acfmxazb4p****",
      "VlanId" : "10",
      "ClusterId" : "c-bp67acfmxazb4p****",
      "GPUSpec" : "NVIDIA V100",
      "AutoReleaseTime" : "2017-12-10T04:04Z",
      "DeletionProtection" : false,
      "StoppedMode" : "KeepCharging",
      "GPUAmount" : 4,
      "HostName" : "testHostName",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "InternetMaxBandwidthOut" : 5,
      "InternetMaxBandwidthIn" : 50,
      "InstanceType" : "ecs.g5.large",
      "InstanceChargeType" : "PostPaid",
      "RegionId" : "cn-hangzhou",
      "IoOptimized" : true,
      "StartTime" : "2017-12-10T04:04Z",
      "Cpu" : 8,
      "LocalStorageAmount" : 2,
      "ExpiredTime" : "2017-12-10T04:04Z",
      "ResourceGroupId" : "rg-bp67acfmxazb4p****",
      "InternetChargeType" : "PayByTraffic",
      "ZoneId" : "cn-hangzhou-g",
      "Recyclable" : false,
      "ISP" : "null",
      "CreditSpecification" : "Standard",
      "InstanceTypeFamily" : "ecs.g5",
      "OSType" : "linux",
      "NetworkInterfaces" : {
        "NetworkInterface" : [ {
          "Type" : "Primary",
          "MacAddress" : "00:16:3e:32:b4:**",
          "PrimaryIpAddress" : "172.17.**.***",
          "NetworkInterfaceId" : "eni-2zeh9atclduxvf1z****",
          "PrivateIpSets" : {
            "PrivateIpSet" : [ {
              "PrivateIpAddress" : "172.17.**.**",
              "Primary" : true
            } ]
          },
          "Ipv6Sets" : {
            "Ipv6Set" : [ {
              "Ipv6Address" : "2408:4321:180:1701:94c7:bc38:3bfa:***"
            } ]
          },
          "Ipv4PrefixSets" : {
            "Ipv4PrefixSet" : [ {
              "Ipv4Prefix" : "192.168.*.*/28"
            } ]
          },
          "Ipv6PrefixSets" : {
            "Ipv6PrefixSet" : [ {
              "Ipv6Prefix" : "2001:1111:*:*::/80"
            } ]
          },
          "OperationLocks" : {
            "OperationLock" : [ {
              "LockMsg" : "The specified instance is locked due to financial reason.",
              "LockReason" : "Recycling"
            } ]
          },
          "Tags" : {
            "Tag" : [ {
              "TagValue" : "TestValue",
              "TagKey" : "TestKey"
            } ]
          },
          "RdmaIpAddresses" : {
            "RdmaIpAddress" : [ "10.10.10.102" ]
          },
          "SecurityGroupIds" : {
            "SecurityGroupId" : [ "sg-bp67acfmxazb4p****" ]
          },
          "PublicIpAddress" : {
            "PublicIpAddres" : [ "121.40.**.**" ]
          },
          "InnerIpAddress" : {
            "InnerIpAddres" : [ "10.170.**.**" ]
          },
          "VpcAttributes" : {
            "VpcId" : "vpc-2zeuphj08tt7q3brd****",
            "NatIpAddress" : "172.17.**.**",
            "VSwitchId" : "vsw-2zeh0r1pabwtg6wcs****",
            "PrivateIpAddress" : {
              "PrivateIpAddres" : [ "172.17.**.**" ]
            }
          },
          "EipAddress" : {
            "IsSupportUnassociate" : true,
            "InternetChargeType" : "PayByTraffic",
            "IpAddress" : "42.112.**.**",
            "Bandwidth" : 5,
            "AllocationId" : "eip-2ze88m67qx5z****"
          },
          "HibernationOptions" : {
            "Configured" : false
          },
          "DedicatedHostAttribute" : {
            "DedicatedHostId" : "dh-bp67acfmxazb4p****",
            "DedicatedHostName" : "testDedicatedHostName",
            "DedicatedHostClusterId" : "dc-bp67acfmxazb4h****"
          },
          "EcsCapacityReservationAttr" : {
            "CapacityReservationPreference" : "cr-bp67acfmxazb4p****",
            "CapacityReservationId" : "cr-bp67acfmxazb4p****"
          },
          "DedicatedInstanceAttribute" : {
            "Affinity" : "default",
            "Tenancy" : "default"
          },
          "CpuOptions" : {
            "Numa" : "2",
            "CoreCount" : 2,
            "ThreadsPerCore" : 4
          },
          "MetadataOptions" : {
            "HttpEndpoint" : "enabled",
            "HttpPutResponseHopLimit" : 0,
            "HttpTokens" : "optional"
          },
          "ImageOptions" : {
            "LoginAsNonRoot" : false
          }
        } ]
      }
    } ]
  }
}

错误码

HttpCode	错误码	错误信息	描述
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	指定的 Tag.N.Key 和 Tag.N.Value 不匹配。
400	InvalidTagCount	The specified tags are beyond the permitted range.	指定的标记超出取值范围。
400	InvalidHpcClusterId.NotFound	The specified HpcClusterId is not found.	指定的参数 HpcClusterId 不存在。
400	InvalidHpcClusterId.Creating	The specified HpcClusterId is creating.	指定的 HPC 集群正在创建中。
400	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误，请重试。
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	指定的实例计费方式不存在。
404	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	暂不支持指定的网络付费类型的实例，请确认相关参数是否正确。
404	InvalidLockReason.NotFound	The specified LockReason is not found.	所指定的锁定原因不存在
404	InvalidStatus.NotFound	The specified Status is not found.	指定的资源状态不存在。

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