DescribeInstances - Elastic Compute Service

本介面支援根據不同請求條件查詢執行個體列表，並關聯查詢執行個體的詳細資訊。

介面說明

使用須知

透過阿里雲 CLI 呼叫 API 時，不同資料類型的請求參數取值必須遵循格式要求。更多資訊，請參見CLI 參數格式說明。

使用建議

透過請求參數 DryRun 傳送預檢請求，可以檢查參數有效性和授權情況。
分頁查詢首頁時，僅需設定 MaxResults 以限制傳回資訊的筆數，傳回結果中的 NextToken 值將作為查詢後續頁的憑證。查詢後續頁時，將 NextToken 參數設定為上一次傳回結果中取得的 NextToken 值作為查詢憑證，並設定 MaxResults 限制傳回筆數。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:DescribeInstances

list

Instance

acs:ecs:{#regionId}:{#accountId}:instance/*

Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

ResourceOwner

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	執行個體所屬的地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。	cn-hangzhou
VpcId	string	否	專有網路 VPC ID。	v-bp67acfmxazb4p****
VSwitchId	string	否	交換器 ID。	vsw-bp67acfmxazb4p****
ZoneId	string	否	可用區 ID。	cn-hangzhou-g
InstanceNetworkType	string	否	執行個體網路類型。取值範圍： vpc：專有網路 VPC。 classic：傳統網路。傳統網路功能已下線，詳情請參見下線公告。	vpc
SecurityGroupId	string	否	執行個體所屬的安全性群組。	sg-bp67acfmxazb4p****
InstanceIds	string	否	執行個體 ID。取值可以由多個執行個體 ID 組成一個 JSON 陣列，最多支援 100 個 ID，ID 之間用半形逗號（,）隔開。	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", … "i-bp67acfmxazb4p**"]
PageNumber	integer	否	說明該參數即將下線，建議您使用 NextToken 與 MaxResults 完成分頁查詢操作。	1
PageSize	integer	否	說明該參數即將下線，建議您使用 NextToken 與 MaxResults 完成分頁查詢操作。	10
NextToken	string	否	查詢憑證（Token），取值為上一次 API 呼叫返回的 `NextToken` 參數值。	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	否	分頁查詢時每頁列數。最大值為 100。預設值：當不設定值或設定的值小於 10 時，預設值為 10。當設定的值大於 100 時，預設值為 100。	10
InnerIpAddresses	string	否	傳統網路類型執行個體的內網 IP 列表。當 InstanceNetworkType=classic 時生效，取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。說明傳統網路功能已下線，詳情請參見下線公告。	["10.1.1.1", "10.1.2.1", … "10.1.10.1"]
PrivateIpAddresses	string	否	VPC 網路類型執行個體的私有 IP。當 InstanceNetworkType=vpc 時生效，取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。	["172.16.1.1", "172.16.2.1", … "172.16.10.1"]
PublicIpAddresses	string	否	執行個體的公網 IP 列表。取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。	["42.1.1.", "42.1.2.", … "42.1.10.**"]
EipAddresses	string	否	執行個體的彈性公網 IP 列表。當 InstanceNetworkType=vpc 時該參數生效，取值可以由多個 IP 組成一個 JSON 陣列，最多支援 100 個 IP，IP 之間用半形逗號（,）隔開。	["42.1.1.", "42.1.2.", … "42.1.10.**"]
InstanceChargeType	string	否	執行個體的計費方式。取值範圍： PostPaid：按量付費。 PrePaid：包年包月。	PostPaid
InternetChargeType	string	否	公網頻寬計費方式。取值範圍： PayByBandwidth：按固定頻寬計費。 PayByTraffic：按使用流量計費。說明按使用流量計費模式下的出入頻寬峰值都是頻寬上限，不作為業務承諾指標。當出現資源爭搶時，頻寬峰值可能會受到限制。如果您的業務需要有頻寬的保障，請使用按固定頻寬計費模式。	PayByTraffic
InstanceName	string	否	執行個體名稱，支援使用萬用字元 * 進行模糊搜尋。	Test
ImageId	string	否	映像 ID。	m-bp67acfmxazb4p****
Status	string	否	執行個體狀態。取值範圍： Pending：建立中。 Running：執行中。 Starting：啟動中。 Stopping：停止中。 Stopped：已停止。	Running
LockReason	string	否	資源被鎖定的原因。取值範圍： financial：因欠費被鎖定。 security：因安全原因被鎖定。 Recycling：搶佔式執行個體的待釋放鎖定狀態。 dedicatedhostfinancial：因為專有宿主機欠費導致 ECS 執行個體被鎖定。 refunded：因退款被鎖定。	security
Filter.1.Key	string	否	查詢資源時的篩選鍵，取值必須為 `CreationStartTime`。同時設定 `Filter.1.Key` 和 `Filter.1.Value` 可以查詢在指定時間點後建立的資源資訊。	CreationStartTime
Filter.2.Key	string	否	查詢資源時的篩選鍵，取值必須為 `CreationEndTime`。同時設定 `Filter.2.Key` 和 `Filter.2.Value` 可以查詢在指定時間點前建立的資源資訊。	CreationEndTime
Filter.3.Key	string	否	查詢資源時的篩選鍵，取值必須為 `ExpiredStartTime`。同時設定 `Filter.3.Key` 和 `Filter.3.Value` 可以查詢在指定時間點後到期的資源資訊。	ExpiredStartTime
Filter.4.Key	string	否	查詢資源時的篩選鍵，取值必須為 `ExpiredEndTime`。同時設定 `Filter.4.Key` 和 `Filter.4.Value` 可以查詢在指定時間點前到期的資源資訊。	ExpiredEndTime
Filter.1.Value	string	否	查詢資源時的篩選值。指定該參數時必須同時指定 `Filter.1.Key` 參數，格式為：`yyyy-MM-ddTHH:mmZ`，採用 UTC +0 時區。	2017-12-05T22:40Z
Filter.2.Value	string	否	查詢資源時的篩選值。指定該參數時必須同時指定 `Filter.2.Key` 參數，格式為：`yyyy-MM-ddTHH:mmZ`，採用 UTC +0 時區。	2017-12-06T22:40Z
Filter.3.Value	string	否	查詢資源時的篩選值。指定該參數時必須同時指定 `Filter.3.Key` 參數，格式為：`yyyy-MM-ddTHH:mmZ`，採用 UTC +0 時區。	2017-12-07T22:40Z
Filter.4.Value	string	否	查詢資源時的篩選值。指定該參數時必須同時指定 `Filter.4.Key` 參數，格式為：`yyyy-MM-ddTHH:mmZ`，採用 UTC +0 時區。	2017-12-08T22:40Z
DeviceAvailable	boolean	否	說明該參數正在邀測中，暫不支援使用。	false
IoOptimized	boolean	否	是否為 I/O 最佳化型執行個體。取值範圍： true：是。 false：否。	true
NeedSaleCycle	boolean	否	說明該參數正在邀測中，暫不支援使用。	false
InstanceType	string	否	執行個體的規格。	ecs.g5.large
InstanceTypeFamily	string	否	執行個體的規格族。	ecs.g5
KeyPairName	string	否	執行個體使用的 SSH 金鑰對名稱。	KeyPairNameTest
ResourceGroupId	string	否	執行個體所在的企業資源群組 ID。使用該參數篩選資源時，資源數量不能超過 1000 個。說明不支援預設資源群組篩選。	rg-bp67acfmxazb4p****
HpcClusterId	string	否	執行個體所在的 HPC 叢集 ID。	hpc-bp67acfmxazb4p****
RdmaIpAddresses	string	否	HPC 執行個體的 RDMA 網路 IP。	10.10.10.102
DryRun	boolean	否	是否只預檢此次請求。取值範圍： true：傳送檢查請求，不會查詢資源狀況。檢查項目包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則返回對應錯誤。如果檢查通過，會返回錯誤碼 DryRunOperation。 false：傳送正常請求，通過檢查後返回 2XX HTTP 狀態碼並直接查詢資源狀況。預設值：false。	false
HttpEndpoint	string	否	是否啟用執行個體中繼資料的存取通道。取值範圍： enabled：啟用。 disabled：停用。預設值：enabled。說明有關執行個體中繼資料的更多資訊，請參見執行個體中繼資料概述。	enabled
HttpTokens	string	否	存取執行個體中繼資料時是否強制使用加固模式（IMDSv2）。取值範圍： optional：不強制使用。 required：強制使用。設定該取值後，普通模式無法存取執行個體中繼資料。預設值：optional。說明有關存取執行個體中繼資料模式的更多資訊，請參見執行個體中繼資料存取模式。	optional
HttpPutResponseHopLimit	integer	否	說明該參數暫未開放使用。	0
Ipv6Address	array	否	為彈性網卡指定的 IPv6 位址。
	string	否	彈性網卡的 IPv6 位址。N 表示可以設定多個 IPv6 位址，N 的取值範圍為 1~100。	2408:4321:180:1701:94c7:bc38:3bfa:****
Tag	array<object>	否	標籤清單。
	object	否	標籤清單。
Key	string	否	執行個體的標籤鍵。N 的取值範圍為 1~20。使用一個標籤篩選資源，查詢到該標籤下的資源數量不能超過 1000 個；使用多個標籤篩選資源，查詢到同時綁定了多個標籤的資源數量不能超過 1000 個。如果資源數量超過 1000 個，請使用 ListTagResources 介面進行查詢。	TestKey
Value	string	否	執行個體的標籤值。N 的取值範圍：1~20。	TestValue
key	string	否	標籤鍵。說明為提高相容性，建議您使用另一個 `Tag.N.Key` 參數。	keyTest
value	string	否	標籤值。說明為提高相容性，建議您使用另一個 `Tag.N.Value` 參數。	valueTest
AdditionalAttributes	array	否	執行個體其他屬性清單。	META_OPTIONS
	string	否	其他屬性值。N 的取值範圍為 1~5。取值範圍： META_OPTIONS：執行個體中繼資料。 DDH_CLUSTER：專有宿主機叢集。 NETWORK_PRIMARY_ENI_IP：主網卡輔助 IP。 PRIVATE_DNS_OPTIONS：私網網域名稱資訊。 CPU_OPTIONS_TOPOLOGY_TYPE：執行個體的 CPU 拓撲類型。 CURRENT_OS_NVME_SUPPORTED：目前作業系統是否支援透過 NVMe 協定存取磁碟。 LOGIN_AS_NON_ROOT：執行個體是否設定了 ecs-user 使用者登入。	META_OPTIONS

返回參數

名稱	類型	描述	樣本值
	object
Instances	object
Instance	array<object>	由 Instances 組成的陣列格式，回傳執行個體的資訊。
	array<object>
AdditionalInfo	object	說明該參數正在邀測中，暫不支援使用。
EnableHighDensityMode	boolean	說明該參數正在邀測中，暫不支援使用。	true
ManagedHostId	string	平台管理的主機唯一識別碼，如 mh-f2d3647ca21****。	mh-f2d3647ca21****
NodeSerialNumber	string
AutoReleaseTime	string	按量計費執行個體的自動釋放時間。	2017-12-10T04:04Z
ClockOptions	object
PtpStatus	string
ClusterId	string	執行個體所在的叢集 ID。說明該參數即將被淘汰，為提高相容性，請盡量使用其他參數。	c-bp67acfmxazb4p****
Cpu	integer	vCPU 數。	8
CpuOptions	object	CPU 組態詳情。
CoreCount	integer	實體 CPU 核心數。	2
EnableVISST	boolean
EnableVRDT	boolean
NestedVirtualization	string	是否開啟巢狀虛擬化。	enabled
Numa	string	說明該參數已淘汰。	null
ThreadsPerCore	integer	CPU 執行緒數。	2
TopologyType	string	執行個體的 CPU 拓撲類型。可能值： HT 離散模式：ContinuousCoreToHTMapping HT 連續模式：DiscreteCoreToHTMapping	DiscreteCoreToHTMapping
TurboMode	string
CreationTime	string	執行個體建立時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。	2017-12-10T04:04Z
CreditSpecification	string	突發效能執行個體的運作模式。可能值： Standard：標準模式。有關執行個體效能的更多資訊，請參見什麼是突發效能執行個體中的效能約束模式章節。 Unlimited：無效能約束模式，有關執行個體效能的更多資訊，請參見什麼是突發效能執行個體中的無效能約束模式章節。	Standard
DedicatedHostAttribute	object	由專屬主機叢集 ID（DedicatedHostClusterId）、專屬主機 ID（DedicatedHostId）和名稱（DedicatedHostName）組成的主機屬性陣列。
DedicatedHostClusterId	string	專屬主機叢集 ID。	dc-bp67acfmxazb4h****
DedicatedHostId	string	專屬主機 ID。	dh-bp67acfmxazb4p****
DedicatedHostName	string	專屬主機名稱。	testDedicatedHostName
DedicatedInstanceAttribute	object	專屬主機執行個體的屬性。
Affinity	string	專屬主機執行個體是否與專屬主機關聯。可能值： default：專屬主機執行個體不與專屬主機關聯。停機不收費執行個體重新啟動後，可能會放置在自動資源部署池中的其他專屬主機上。 host：專屬主機執行個體與專屬主機關聯。停機不收費執行個體重新啟動後，仍放置在原專屬主機上。	default
Tenancy	string	執行個體的主機類型是否為專屬主機。可能值： default：執行個體的主機類型不是專屬主機。 host：執行個體的主機類型為專屬主機。	default
DeletionProtection	boolean	執行個體釋放保護屬性，指定是否支援透過主控台或 API（DeleteInstance）釋放執行個體。 true：已開啟執行個體釋放保護。 false：未開啟執行個體釋放保護。說明該屬性僅適用於按量計費執行個體，且只能限制手動釋放操作，對系統釋放操作不生效。	false
DeploymentSetGroupNo	integer	ECS 執行個體綁定部署集分散部署時，執行個體在部署集中的分組位置。	1
DeploymentSetId	string	部署集 ID。	ds-bp67acfmxazb4p****
Description	string	執行個體描述。	testDescription
DeviceAvailable	boolean	執行個體是否可以掛載資料磁碟。 true：可以掛載資料磁碟。 false：不可以掛載資料磁碟。	true
EcsCapacityReservationAttr	object	雲端伺服器 ECS 的容量預留相關參數。
CapacityReservationId	string	容量預留 ID。	cr-bp67acfmxazb4p****
CapacityReservationPreference	string	容量預留偏好。	cr-bp67acfmxazb4p****
EipAddress	object	彈性公網 IP 綁定資訊。
AllocationId	string	彈性公網 IP 的 ID。	eip-2ze88m67qx5z****
Bandwidth	integer	彈性公網 IP 的公網頻寬限速，單位為 Mbit/s。	5
InternetChargeType	string	彈性公網 IP 的計費方式。 PayByBandwidth：按頻寬計費。 PayByTraffic：按流量計費。	PayByTraffic
IpAddress	string	彈性公網 IP。	42.112..
IsSupportUnassociate	boolean	是否可以解除綁定彈性公網 IP。	true
EnableNVS	boolean
ExpiredTime	string	過期時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。	2017-12-10T04:04Z
GPUAmount	integer	執行個體規格附帶的 GPU 數量。	4
GPUSpec	string	執行個體規格附帶的 GPU 類型。	NVIDIA V100
HibernationOptions	object	說明該參數正在邀測中，暫未開放使用。
Configured	boolean	說明該參數正在邀測中，暫未開放使用。	false
HostName	string	執行個體主機名稱。	testHostName
HpcClusterId	string	執行個體所屬的 HPC 叢集 ID。	hpc-bp67acfmxazb4p****
ISP	string	說明該參數正在邀測中，暫未開放使用。	null
ImageId	string	執行個體運行的映像 ID。	m-bp67acfmxazb4p****
ImageOptions	object	映像相關屬性資訊。
CurrentOSNVMeSupported	boolean	目前作業系統是否支援透過 NVMe 協定存取磁碟。可能值： true：是。 false：否。說明當請求參數 AdditionalAttributes 包含 CURRENT_OS_NVME_SUPPORTED 時才會回傳該參數。	true
LoginAsNonRoot	boolean	使用該映像的執行個體是否支援使用 ecs-user 使用者登入。可能值： true：是。 false：否。	false
InnerIpAddress	object
IpAddress	array	經典網路類型執行個體的內網 IP 位址清單。說明經典網路功能已下線，詳情請參見下線公告。
	string	經典網路類型執行個體的內網 IP 位址。	10.170..
InstanceChargeType	string	執行個體的計費方式。可能值： PrePaid：包年包月。 PostPaid：按量計費。	PostPaid
InstanceId	string	執行個體 ID。	i-bp67acfmxazb4p****
InstanceName	string	執行個體名稱。	InstanceNameTest
InstanceNetworkType	string	執行個體網路類型。可能值： vpc：專用網路 VPC。 classic：經典網路。經典網路功能已下線，詳情請參見下線公告。	vpc
InstanceType	string	執行個體規格。	ecs.g5.large
InstanceTypeFamily	string	執行個體規格族。	ecs.g5
InternetChargeType	string	網路計費類型。可能值： PayByBandwidth：按固定頻寬計費。 PayByTraffic：按使用流量計費。	PayByTraffic
InternetMaxBandwidthIn	integer	公網入頻寬最大值，單位：Mbit/s。	50
InternetMaxBandwidthOut	integer	公網出頻寬最大值，單位：Mbit/s。	5
IoOptimized	boolean	是否為 I/O 優化執行個體。 true：是。 false：否。	true
KeyPairName	string	金鑰對名稱。	testKeyPairName
LocalStorageAmount	integer	執行個體掛載的本機儲存數量。	2
LocalStorageCapacity	integer	執行個體掛載的本機儲存容量。單位：GiB。	1000
Memory	integer	記憶體大小，單位為 MiB。	16384
MetadataOptions	object	中繼資料選項集合。
HttpEndpoint	string	是否啟用執行個體中繼資料的存取通道。可能值： enabled：啟用。 disabled：停用。	enabled
HttpPutResponseHopLimit	integer	說明該參數暫未開放使用。	0
HttpTokens	string	存取執行個體中繼資料時是否強制使用加固模式（IMDSv2）。可能值： optional：不強制使用。 required：強制使用。	optional
InstanceMetadataTags	string
NetworkInterfaces	object
NetworkInterface	array<object>	執行個體包含的彈性網卡集合。
	array<object>	執行個體包含的彈性網卡集合。
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	彈性網卡已分配的 IPv4 首碼集合。僅當請求參數`AdditionalAttributes.N`取值為`NETWORK_PRIMARY_ENI_IP`時，才會回傳該參數值。
	object
Ipv4Prefix	string	彈性網卡已指派的 IPv4 前綴。	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	彈性網卡已分配的 IPv6 首碼集合。僅當請求參數`AdditionalAttributes.N`取值為`NETWORK_PRIMARY_ENI_IP`時，才會回傳該參數值。
	object
Ipv6Prefix	string	彈性網卡已指派的 IPv6 前綴。	2001:1111::::/80
Ipv6Sets	object
Ipv6Set	array<object>	彈性網卡已分配的 IPv6 位址集合。僅當請求參數`AdditionalAttributes.N`取值為`NETWORK_PRIMARY_ENI_IP`時，才會回傳該參數值。
	object
Ipv6Address	string	彈性網卡已分配的 IPv6 位址。	2408:4321:180:1701:94c7:bc38:3bfa:***
Primary	boolean
MacAddress	string	彈性網卡的 MAC 位址。	00:16:3e:32:b4:**
NetworkInterfaceId	string	彈性網卡的 ID。	eni-2zeh9atclduxvf1z****
PrimaryIpAddress	string	彈性網卡主私有 IP 位址。	172.17..*
PrivateIpSets	object
PrivateIpSet	array<object>	PrivateIpSet 組成的集合。
	object
Primary	boolean	是否為主私網 IP 位址，可能值： true：是。 false：否。	true
PrivateDnsName	string	執行個體的私網網域名稱。說明僅當 `HostnameType` 取值為 `IpBased` 或 `InstanceIdBased` 時，傳回固定格式的私網網域名稱。	dnsTestName
PrivateIpAddress	string	執行個體的私網 IP 位址。	172.17..
Type	string	彈性網卡類型。可能值： Primary：主要網卡。 Secondary：輔助彈性網卡。	Primary
OSName	string	執行個體的作業系統名稱。	CentOS 7.4 64 位元
OSNameEn	string	執行個體作業系統的英文名稱。	CentOS 7.4 64 bit
OSType	string	執行個體的作業系統類型，分為 Windows Server 和 Linux 兩種。可能值： windows。 linux。	linux
OperationLocks	object
LockReason	array<object>	執行個體的鎖定原因。
	object
LockMsg	string	執行個體被鎖定的描述資訊。	The specified instance is locked due to financial reason.
LockReason	string	鎖定類型。可能值： financial：因欠費被鎖定。 security：因安全原因被鎖定。 Recycling：搶占式執行個體的待釋放鎖定狀態。 dedicatedhostfinancial：因為專屬宿主機欠費導致 ECS 執行個體被鎖定。 refunded：因退款被鎖定。	Recycling
PrivateDnsNameOptions	object	執行個體的私網網域名稱設定資訊集合。關於私網網域名稱解析，請參閱 ECS 私網網域名稱解析。說明僅當請求參數 `AdditionalAttributes` 取值包含 `PRIVATE_DNS_OPTIONS` 時，傳回此參數。
EnableInstanceIdDnsAAAARecord	boolean	開啟/關閉執行個體 ID 類型的網域名稱至 IPv6 的解析。可能值： true：開啟。 false：關閉。預設值：false。	false
EnableInstanceIdDnsARecord	boolean	開啟/關閉執行個體 ID 類型的網域名稱至 IPv4 的解析。可能值： true：開啟。 false：關閉。預設值：false。	false
EnableIpDnsARecord	boolean	開啟/關閉 IP 類型的網域名稱至 IPv4 的解析。可能值： true：開啟。 false：關閉。預設值：false。	true
EnableIpDnsPtrRecord	boolean	開啟/關閉 IPv4 至 IP 類型的網域名稱解析。可能值： true：開啟。 false：關閉。預設值：false。	true
HostnameType	string	主機名稱類型，可能值： Custom：自訂。 IpBased：基於 IP 格式的主機。 InstanceIdBased：基於執行個體 ID 格式的主機名稱。預設值：Custom。	Custom
PublicIpAddress	object
IpAddress	array	執行個體公網 IP 位址清單。
	string	執行個體公網 IP 位址。	121.40..
RdmaIpAddress	object
IpAddress	array	HPC 執行個體的 RDMA 網路 IP 清單。
	string	HPC 執行個體的 RDMA 網路 IP。	10.10.10.102
Recyclable	boolean	執行個體是否可回收。	false
RegionId	string	執行個體所屬地域 ID。	cn-hangzhou
ResourceGroupId	string	執行個體所屬的企業資源群組 ID。	rg-bp67acfmxazb4p****
SaleCycle	string	說明此參數已棄用，不再傳回有意義的資料。	month
SecurityGroupIds	object
SecurityGroupId	array	執行個體所屬安全性群組 ID 清單。
	string	安全性群組 ID。	sg-bp67acfmxazb4p****
SecurityOptions	object
EnableSecureBoot	boolean	是否開啟了 UEFI 安全啟動。
SerialNumber	string	執行個體序號。	51d1353b-22bf-4567-a176-8b3e12e4****
SpotDuration	integer	搶占式執行個體的保留時長，單位為小時。可能值： 1：建立後阿里雲會保證執行個體執行 1 小時不會被自動釋放；超過 1 小時後，系統會自動比較出價與市場價格、檢查資源庫存，來決定執行個體的持有和回收。 0：建立後，阿里雲不保證執行個體執行 1 小時，系統會自動比較出價與市場價格、檢查資源庫存，來決定執行個體的持有和回收。執行個體回收前 5 分鐘阿里雲會透過 ECS 系統事件向您傳送通知。搶占式執行個體按秒計費，建議您結合具體任務執行耗時來選擇合適的保留時長。說明當 SpotStrategy 值為 SpotWithPriceLimit 或 SpotAsPriceGo 時傳回此參數。	1
SpotInterruptionBehavior	string	平台發起搶占式執行個體中斷時，搶占式執行個體的中斷模式。可能值： Terminate：釋放。 Stop：節省停機。	Terminate
SpotPriceLimit	number	執行個體的每小時最高價格。支援最多 3 位小數，參數 SpotStrategy=SpotWithPriceLimit 時，此參數生效。	0.98
SpotStrategy	string	按量執行個體的競價策略。可能值： NoSpot：正常按量付費執行個體。 SpotWithPriceLimit：設定上限價格的搶占式執行個體。 SpotAsPriceGo：系統自動出價，最高按量付費價格的搶占式執行個體。	NoSpot
StartTime	string	執行個體最近一次的啟動時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參閱 ISO 8601。	2017-12-10T04:04Z
Status	string	執行個體狀態。	Running
StoppedMode	string	執行個體停機後是否繼續收費。可能值： KeepCharging：停機後繼續收費，為您繼續保留庫存資源。 StopCharging：停機後不收費。停機後，我們釋放執行個體對應的資源，例如 vCPU、記憶體和公網 IP 等資源。重新啟動是否成功取決於目前地域中是否仍有資源庫存。 Not-applicable：此執行個體不支援停機不收費功能。	KeepCharging
Tags	object
Tag	array<object>	執行個體的標籤集合。
	object
TagKey	string	執行個體的標籤鍵。	TestKey
TagValue	string	執行個體的標籤值。	TestValue
VlanId	string	執行個體的 VLAN ID。說明此參數即將被棄用，為提高相容性，請盡量使用其他參數。	10
VpcAttributes	object	專用網路 VPC 屬性。
NatIpAddress	string	雲端產品的 IP，用於 VPC 雲端產品之間的網路互通。	172.17..
PrivateIpAddress	object
IpAddress	array	私有 IP 位址清單。
	string	私有 IP 位址。	172.17..
VSwitchId	string	虛擬交換器 ID。	vsw-2zeh0r1pabwtg6wcs****
VpcId	string	專有網路 VPC ID。	vpc-2zeuphj08tt7q3brd****
ZoneId	string	執行個體所屬可用區。	cn-hangzhou-g
NextToken	string	本次呼叫傳回的查詢憑證值。	caeba0bbb2be03f84eb48b699f0a4883
PageNumber	integer	執行個體清單的頁碼。	1
PageSize	integer	輸入時設定的每頁列數。	10
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	查詢到的執行個體總數。說明使用 `MaxResults` 和 `NextToken` 參數進行分頁查詢時，傳回的 `TotalCount` 參數值無意義。	1

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
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.
400	Throttling.PageNumberLimited	Request throttled. Please use NextToken instead of PageNumber for pagination.	目前請求已限流，請使用 NextToken 替代 PageNumber 方式進行分頁查詢。
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	InvalidFilterKey.NotFound	Invalid filter.%s.	指定的起始時間或到期時間參數錯誤。
404	InvalidFilterValue	Invalid filter.%s.
404	InvalidNetworkType.NotFound	The specified InstanceNetworkType is not found.
404	InvalidStatus.NotFound	The specified Status is not found.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。