DescribeInstances - - Alibaba Cloud Dokümantasyon Merkezi

Belirtilen istek koşullarına göre örnek listesini sorgular ve örneklerle ilişkili ayrıntılı bilgileri getirir.

Operation description

Başlamadan önce

Cloud Assistant CLI kullanarak bir API işlemi çağırdığınızda, farklı veri türlerine sahip istek parametresi değerlerinin biçim gereksinimlerine uygun olduğundan emin olun. Daha fazla bilgi için CLI parametre biçimine genel bakış konusuna bakın.

Kullanım notları

Parametrelerin ve yetkilendirmenin geçerliliğini kontrol etmek için DryRun istek parametresini kullanarak bir deneme çalıştırması isteği gönderin.
Sonuçların ilk sayfası için bir sayfalama sorgusu gerçekleştirdiğinizde, döndürülecek giriş sayısını sınırlamak için yalnızca MaxResults değerini ayarlayın. Yanıttaki NextToken değeri, sonraki sayfaları sorgulamak için kimlik bilgisi olarak kullanılır. Sonraki sayfalar için bir sayfalama sorgusu gerçekleştirdiğinizde, NextToken değerini önceki yanıttan alınan NextToken değerine ayarlayın ve döndürülecek giriş sayısını sınırlamak için MaxResults değerini ayarlayın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeInstances

list

Instance

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

Instance

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

ResourceOwner

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Örneğin bölge kimliği. En son bölge listesini sorgulamak için DescribeRegions API'sini çağırabilirsiniz.	cn-hangzhou
VpcId	string	No	Sanal özel bulutun (VPC) kimliği.	v-bp67acfmxazb4p****
VSwitchId	string	No	vSwitch kimliği.	vsw-bp67acfmxazb4p****
ZoneId	string	No	Bölge kimliği.	cn-hangzhou-g
InstanceNetworkType	string	No	Örneğin ağ türü. Geçerli değerler: vpc: VPC. classic: Klasik ağ. Klasik ağ artık kullanılamamaktadır. Daha fazla bilgi için Kullanımdan kaldırma bildirimi konusuna bakın.	vpc
SecurityGroupId	string	No	Örneğin ait olduğu güvenlik grubunun kimliği.	sg-bp67acfmxazb4p****
InstanceIds	string	No	Örneklerin kimlikleri. Değer, en fazla 100 örnek kimliğinden oluşan bir JSON dizisidir. Örnek kimliklerini virgül (,) ile ayırın.	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", … "i-bp67acfmxazb4p**"]
PageNumber	integer	No	Not Bu parametre kullanımdan kaldırılmak üzeredir. Sayfalama sorgusu işlemlerini tamamlamak için NextToken ve MaxResults parametrelerini kullanın.	1
PageSize	integer	No	Not Bu parametre kullanımdan kaldırılmak üzeredir. Sayfalama sorgusu işlemlerini tamamlamak için NextToken ve MaxResults parametrelerini kullanın.	10
NextToken	string	No	Sorgu belirteci. Değeri, önceki API çağrısında döndürülen NextToken değerine ayarlayın.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	No	Sayfalama sorgusu için sayfa başına maksimum giriş sayısı. Maksimum değer: 100. Varsayılan değer: Bu parametreyi ayarlamazsanız veya 10'dan küçük bir değere ayarlarsanız, varsayılan değer 10'dur. Bu parametreyi 100'den büyük bir değere ayarlarsanız, varsayılan değer 100'dür.	10
InnerIpAddresses	string	No	Klasik ağ türüne sahip örneklerin dahili ağ IP adresları. Bu parametre, InstanceNetworkType classic olarak ayarlandığında geçerli olur. Değer, en fazla 100 IP adresinden oluşan bir JSON dizisidir. IP adreslarını virgül (,) ile ayırın. Not Klasik ağ özelliği kullanımdan kaldırılmıştır. Ayrıntılar için Kullanımdan kaldırma bildirimi konusuna bakın.	["10.1.1.1", "10.1.2.1", … "10.1.10.1"]
PrivateIpAddresses	string	No	VPC ağ türüne sahip örneklerin özel IP adresları. Bu parametre, InstanceNetworkType vpc olarak ayarlandığında geçerli olur. Değer, en fazla 100 IP adresinden oluşan bir JSON dizisidir. IP adreslarını virgül (,) ile ayırın.	["172.16.1.1", "172.16.2.1", … "172.16.10.1"]
PublicIpAddresses	string	No	Örneklerin genel IP adresları. Değer, en fazla 100 IP adresinden oluşan bir JSON dizisidir. IP adreslarını virgül (,) ile ayırın.	["42.1.1.", "42.1.2.", … "42.1.10.**"]
EipAddresses	string	No	Örneklerin esnek IP adresları (EIP'ler). Bu parametre, InstanceNetworkType vpc olarak ayarlandığında geçerli olur. Değer, en fazla 100 IP adresinden oluşan bir JSON dizisidir. IP adreslarını virgül (,) ile ayırın.	["42.1.1.", "42.1.2.", … "42.1.10.**"]
InstanceChargeType	string	No	Örneğin faturalandırma yöntemi. Geçerli değerler: PostPaid: Kullandıkça öde. PrePaid: Abonelik.	PostPaid
InternetChargeType	string	No	Genel bant genişliği için faturalandırma yöntemi. Geçerli değerler: PayByBandwidth: Bant genişliğine göre ödeme. PayByTraffic: Trafiğe göre ödeme. Not Trafiğe göre ödeme modunda, tepe noktası gelen ve giden bant genişlikleri, bant genişliği üst sınırları olarak kullanılır ve garanti edilmez. Kaynak çekişmesi meydana geldiğinde, tepe noktası bant genişlikleri sınırlandırılabilir. İş yükleriniz için garanti edilen bant genişliğine ihtiyaç duyuyorsanız, bant genişliğine göre ödeme modunu kullanın.	PayByTraffic
InstanceName	string	No	Örneğin adı. Yıldız işareti (*) joker karakteri ile bulanık arama desteklenir.	Test
ImageId	string	No	Görüntü kimliği.	m-bp67acfmxazb4p****
Status	string	No	Örnek durumu. Geçerli değerler: Pending: Oluşturuluyor. Running: Çalışıyor. Starting: Başlatılıyor. Stopping: Durduruluyor. Stopped: Durduruldu.	Running
LockReason	string	No	Kaynağın kilitlenmesinin nedeni. Geçerli değerler: financial: Kaynak, ödenmemiş borç nedeniyle kilitlenmiştir. security: Kaynak, güvenlik nedenleriyle kilitlenmiştir. Recycling: Spot örnek kilitlenmiştir ve serbest bırakılmayı beklemektedir. dedicatedhostfinancial: ECS örneği, özel ana makinenin ödenmemiş borcu olması nedeniyle kilitlenmiştir. refunded: Kaynak, iade işlemi yapıldığı için kilitlenmiştir.	security
Filter.1.Key	string	No	Kaynakları sorgulamak için kullanılan 1 numaralı filtrenin anahtarı. Değeri `CreationStartTime` olarak ayarlayın. Belirtilen zaman noktasından sonra oluşturulan kaynakları sorgulamak için hem Filter.1.Key hem de Filter.1.Value değerlerini belirtebilirsiniz.	CreationStartTime
Filter.2.Key	string	No	Kaynakları sorgulamak için kullanılan 2 numaralı filtrenin anahtarı. Değeri `CreationEndTime` olarak ayarlayın. Belirtilen zaman noktasından önce oluşturulan kaynakları sorgulamak için hem Filter.2.Key hem de Filter.2.Value değerlerini belirtebilirsiniz.	CreationEndTime
Filter.3.Key	string	No	Kaynakları sorgulamak için kullanılan 3 numaralı filtrenin anahtarı. Değeri `ExpiredStartTime` olarak ayarlayın. Belirtilen zaman noktasından sonra sona erecek kaynakları sorgulamak için hem Filter.3.Key hem de Filter.3.Value değerlerini belirtebilirsiniz.	ExpiredStartTime
Filter.4.Key	string	No	Kaynakları sorgulamak için kullanılan 4 numaralı filtrenin anahtarı. Değeri `ExpiredEndTime` olarak ayarlayın. Belirtilen zaman noktasından önce sona erecek kaynakları sorgulamak için hem Filter.4.Key hem de Filter.4.Value değerlerini belirtebilirsiniz.	ExpiredEndTime
Filter.1.Value	string	No	Kaynakları sorgulamak için kullanılan 1 numaralı filtrenin değeri. Bu parametreyi belirttiğinizde, `Filter.1.Key` değerini de belirtmeniz gerekir. Saati UTC cinsinden `yyyy-MM-ddTHH:mmZ` biçiminde belirtin.	2017-12-05T22:40Z
Filter.2.Value	string	No	Kaynakları sorgulamak için kullanılan 2 numaralı filtrenin değeri. Bu parametreyi belirttiğinizde, `Filter.2.Key` değerini de belirtmeniz gerekir. Saati UTC cinsinden `yyyy-MM-ddTHH:mmZ` biçiminde belirtin.	2017-12-06T22:40Z
Filter.3.Value	string	No	Kaynakları sorgulamak için kullanılan 3 numaralı filtrenin değeri. Bu parametreyi belirttiğinizde, `Filter.3.Key` değerini de belirtmeniz gerekir. Saati UTC cinsinden `yyyy-MM-ddTHH:mmZ` biçiminde belirtin.	2017-12-07T22:40Z
Filter.4.Value	string	No	Kaynakları sorgulamak için kullanılan 4 numaralı filtrenin değeri. Bu parametreyi belirttiğinizde, `Filter.4.Key` değerini de belirtmeniz gerekir. Saati UTC cinsinden `yyyy-MM-ddTHH:mmZ` biçiminde belirtin.	2017-12-08T22:40Z
DeviceAvailable	boolean	No	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.	false
IoOptimized	boolean	No	Örneğin G/Ç için optimize edilip edilmediğini belirtir. Geçerli değerler: true: Örnek G/Ç için optimize edilmiştir. false: Örnek G/Ç için optimize edilmemiştir.	true
NeedSaleCycle	boolean	No	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.	false
InstanceType	string	No	Örnek türü.	ecs.g5.large
InstanceTypeFamily	string	No	Örnek ailesi.	ecs.g5
KeyPairName	string	No	Örneğe bağlı SSH anahtar çiftinin adı.	KeyPairNameTest
ResourceGroupId	string	No	Örneğin ait olduğu kaynak grubunun kimliği. Kaynakları filtrelemek için bu parametreyi kullandığınızda, kaynak sayısı 1.000'i aşamaz. Not Varsayılan kaynak grubuna göre filtreleme desteklenmez.	rg-bp67acfmxazb4p****
HpcClusterId	string	No	Örneğin ait olduğu HPC kümesinin kimliği.	hpc-bp67acfmxazb4p****
RdmaIpAddresses	string	No	HPC örneğinin RDMA IP adresları.	10.10.10.102
DryRun	boolean	No	Yalnızca deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Yalnızca deneme çalıştırması yapar. Sistem, geçersiz AccessKey çiftleri, yetkisiz Resource Access Management (RAM) kullanıcıları ve eksik parametre değerleri dahil olmak üzere olası sorunlara karşı isteği kontrol eder. İstek deneme çalıştırmasını geçemezse, bir hata mesajı döndürülür. İstek deneme çalıştırmasını geçerse, DryRunOperation hata kodu döndürülür. false: Deneme çalıştırması yapar ve isteği gönderir. İstek deneme çalıştırmasını geçerse, 2XX HTTP durum kodu döndürülür ve işlem gerçekleştirilir. Varsayılan değer: false.	false
HttpEndpoint	string	No	Örnek meta verileri için erişim kanalının etkinleştirilip etkinleştirilmediğini belirtir. Geçerli değerler: enabled: Etkin. disabled: Devre dışı. Varsayılan değer: enabled. Not Örnek meta verileri hakkında daha fazla bilgi için ECS örnek meta verilerine genel bakış konusuna bakın.	enabled
HttpTokens	string	No	Örnek meta verilerine erişirken güçlendirilmiş modun (IMDSv2) zorunlu olarak kullanılıp kullanılmayacağını belirtir. Geçerli değerler: optional: Güçlendirilmiş mod zorunlu olarak kullanılmaz. required: Güçlendirilmiş mod zorunlu olarak kullanılır. Bu parametreyi required olarak ayarladıktan sonra, örnek meta verilerine normal düzende erişemezsiniz. Varsayılan değer: optional. Not Örnek meta verileri erişim düzenleri hakkında daha fazla bilgi için Örnek meta verileri erişim modları konusuna bakın.	optional
HttpPutResponseHopLimit	integer	No	Not Bu parametre henüz kullanıma sunulmamıştır.	0
Ipv6Address	array	No	Esnek Ağ Arabirimlerine (ENI'ler) atanan IPv6 adresları.
	string	No	Esnek Ağ Arabiriminin (ENI) IPv6 adresi. N, birden fazla IPv6 adresi ayarlayabileceğinizi belirtir. N için geçerli değerler: 1 ile 100 arası.	2408:4321:180:1701:94c7:bc38:3bfa:****
Tag	array<object>	No	Etiketler.
	object	No	Etiketler.
Key	string	No	Örneğin etiket anahtarı. N için geçerli değerler: 1 ile 20 arası. Kaynakları filtrelemek için tek bir etiket kullanırsanız, bu etikete sahip kaynak sayısı 1.000'i aşamaz. Kaynakları filtrelemek için birden fazla etiket kullanırsanız, belirtilen tüm etiketlerin eklendiği kaynak sayısı 1.000'i aşamaz. Kaynak sayısı 1.000'i aşarsa, kaynakları sorgulamak için ListTagResources işlemini kullanın.	TestKey
Value	string	No	Örneğin etiket değeri. N için geçerli değerler: 1 ile 20 arası.	TestValue
key	string	No	Etiket anahtarı. Not Uyumluluğu artırmak için bunun yerine Tag.N.Key parametresini kullanın.	keyTest
value	string	No	Etiket değeri. Not Uyumluluğu artırmak için bunun yerine Tag.N.Value parametresini kullanın.	valueTest
AdditionalAttributes	array	No	Örneğin ek özelliklerinin listesi.	META_OPTIONS
	string	No	Ek özellik değeri. N için geçerli değerler: 1 ile 5 arası. Geçerli değerler: META_OPTIONS: Örnek meta verileri. DDH_CLUSTER: Özel ana makine kümesi. NETWORK_PRIMARY_ENI_IP: Birincil ağ arabirimi denetleyicisinin (NIC) ikincil IP adresları. PRIVATE_DNS_OPTIONS: Özel ağ etki alanı adı bilgileri. CPU_OPTIONS_TOPOLOGY_TYPE: Örneğin CPU topoloji türü. CURRENT_OS_NVME_SUPPORTED: Mevcut işletim sisteminin NVMe protokolü üzerinden disklere erişimi destekleyip desteklemediği. LOGIN_AS_NON_ROOT: Örneğin ecs-user oturum açması ile yapılandırılıp yapılandırılmadığı.	META_OPTIONS

Response elements

Element	Type	Description	Example
	object
Instances	object
Instance	array<object>	Örnekler hakkındaki bilgileri içeren örnek nesneleri dizisi.
	array<object>
AdditionalInfo	object	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.
EnableHighDensityMode	boolean	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.	true
ManagedHostId	string	Platform tarafından yönetilen ana bilgisayarın benzersiz kimliği, örneğin mh-f2d3647ca21****.	mh-f2d3647ca21****
NodeSerialNumber	string
AutoReleaseTime	string	Kullandıkça öde örneğinin otomatik serbest bırakılma zamanı.	2017-12-10T04:04Z
ClockOptions	object
PtpStatus	string
ClusterId	string	Örneğin ait olduğu kümenin kimliği. Not Bu parametre kullanımdan kaldırılacaktır. Uyumluluğu sağlamak için diğer parametreleri kullanın.	c-bp67acfmxazb4p****
Cpu	integer	vCPU sayısı.	8
CpuOptions	object	CPU yapılandırma ayrıntıları.
CoreCount	integer	Fiziksel CPU çekirdeği sayısı.	2
EnableVISST	boolean
EnableVRDT	boolean
NestedVirtualization	string	İç içe sanallaştırmanın etkin olup olmadığını gösterir.	enabled
Numa	string	Not Bu parametre kullanımdan kaldırılmıştır.	null
ThreadsPerCore	integer	CPU çekirdeği başına iş parçacığı sayısı.	2
TopologyType	string	Örneğin CPU topoloji türü. Geçerli değerler: ContinuousCoreToHTMapping: HT ayrık modu. DiscreteCoreToHTMapping: HT sürekli modu.	DiscreteCoreToHTMapping
TurboMode	string
CreationTime	string	Örneğin oluşturulduğu zaman. Zaman, yyyy-MM-ddTHH:mmZ formatında ISO 8601 standardını takip eder. Zaman UTC+0 olarak görüntülenir. Daha fazla bilgi için ISO 8601 sayfasına bakın.	2017-12-10T04:04Z
CreditSpecification	string	Burstable örneğin çalışma modu. Geçerli değerler: Standard: Standart mod. Örnek performansı hakkında daha fazla bilgi için Burstable örneklere genel bakış konusundaki performans kısıtlı modu bölümüne bakın. Unlimited: Sınırsız mod. Örnek performansı hakkında daha fazla bilgi için Burstable örneklere genel bakış konusundaki sınırsız mod bölümüne bakın.	Standard
DedicatedHostAttribute	object	Ayrılmış ana bilgisayar kümesi kimliği (DedicatedHostClusterId), ayrılmış ana bilgisayar kimliği (DedicatedHostId) ve ayrılmış ana bilgisayar adından (DedicatedHostName) oluşan ayrılmış ana bilgisayar öznitelikleri dizisi.
DedicatedHostClusterId	string	Ayrılmış ana bilgisayar kümesinin kimliği.	dc-bp67acfmxazb4h****
DedicatedHostId	string	Ayrılmış ana bilgisayarın kimliği.	dh-bp67acfmxazb4p****
DedicatedHostName	string	Ayrılmış ana bilgisayarın adı.	testDedicatedHostName
DedicatedInstanceAttribute	object	Ayrılmış ana bilgisayardaki örneğin öznitelikleri.
Affinity	string	Ayrılmış ana bilgisayardaki örneğin ayrılmış ana bilgisayarla ilişkilendirilip ilişkilendirilmediğini gösterir. Geçerli değerler: default: Örnek, ayrılmış ana bilgisayarla ilişkilendirilmemiştir. Durdurulan Örnekler İçin Ücret Yok durumunda olan bir örnek yeniden başlatıldığında, örnek otomatik dağıtım kaynak havuzundaki başka bir ayrılmış ana bilgisayara yerleştirilebilir. host: Örnek, ayrılmış ana bilgisayarla ilişkilendirilmiştir. Durdurulan Örnekler İçin Ücret Yok durumunda olan bir örnek yeniden başlatıldığında, örnek yine orijinal ayrılmış ana bilgisayara yerleştirilir.	default
Tenancy	string	Örneğin ana bilgisayar türünün ayrılmış ana bilgisayar olup olmadığını gösterir. Geçerli değerler: default: Örneğin ana bilgisayar türü ayrılmış ana bilgisayar değildir. host: Örneğin ana bilgisayar türü ayrılmış ana bilgisayardır.	default
DeletionProtection	boolean	Örneğin serbest bırakma koruması özniteliği. Örneğin ECS konsolundan veya DeleteInstance işlemi çağrılarak serbest bırakılıp bırakılamayacağını belirtir. true: Örnek için serbest bırakma koruması etkinleştirilmiştir. false: Örnek için serbest bırakma koruması etkinleştirilmemiştir. Not Bu öznitelik yalnızca kullandıkça öde örnekleri için geçerlidir. Yalnızca manuel serbest bırakma işlemlerini kısıtlayabilir, sistem serbest bırakma işlemlerini kısıtlayamaz.	false
DeploymentSetGroupNo	integer	ECS örneği yayılma dağıtım stratejisiyle dağıtıldığında, dağıtım kümesindeki ECS örneğinin grup numarası.	1
DeploymentSetId	string	Dağıtım kümesinin kimliği.	ds-bp67acfmxazb4p****
Description	string	Örneğin açıklaması.	testDescription
DeviceAvailable	boolean	Örneğe veri bulut disklerinin eklenebilip eklenemeyeceğini gösterir. true: Örneğe veri bulut diskleri eklenebilir. false: Örneğe veri bulut diskleri eklenemez.	true
EcsCapacityReservationAttr	object	Elastic Compute Service (ECS) kapasite rezervasyonuyla ilgili parametreler.
CapacityReservationId	string	Kapasite rezervasyonunun kimliği.	cr-bp67acfmxazb4p****
CapacityReservationPreference	string	Kapasite rezervasyonu tercihi.	cr-bp67acfmxazb4p****
EipAddress	object	Esnek IP Adresi (EIP) bağlama bilgileri.
AllocationId	string	EIP'nin kimliği.	eip-2ze88m67qx5z****
Bandwidth	integer	EIP'nin genel bant genişliği sınırı. Birim: Mbit/s.	5
InternetChargeType	string	EIP'nin İnternet kullanımı için faturalandırma yöntemi. PayByBandwidth: Bant genişliğine göre ödeme. PayByTraffic: Trafiğe göre ödeme.	PayByTraffic
IpAddress	string	EIP adresi.	42.112..
IsSupportUnassociate	boolean	İnternet EIP'si ile ilişkilendirmenin kaldırılıp kaldırılamayacağını gösterir.	true
EnableNVS	boolean
ExpiredTime	string	Son kullanma zamanı. Zaman, yyyy-MM-ddTHH:mmZ formatında ISO 8601 standardını takip eder. Zaman UTC+0 olarak görüntülenir. Daha fazla bilgi için ISO 8601 sayfasına bakın.	2017-12-10T04:04Z
GPUAmount	integer	Örnek türü için GPU sayısı.	4
GPUSpec	string	Örnek türü için GPU türü.	NVIDIA V100
HibernationOptions	object	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.
Configured	boolean	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.	false
HostName	string	Örneğin ana bilgisayar adı.	testHostName
HpcClusterId	string	Örneğin ait olduğu HPC kümesinin kimliği.	hpc-bp67acfmxazb4p****
ISP	string	Not Bu parametre davetiye önizlemesindedir ve herkese açık değildir.	null
ImageId	string	Örneğin çalıştırdığı görüntünün kimliği.	m-bp67acfmxazb4p****
ImageOptions	object	Görüntüyle ilgili öznitelik bilgileri.
CurrentOSNVMeSupported	boolean	Mevcut işletim sisteminin NVMe protokolü üzerinden bulut disklerine erişimi destekleyip desteklemediğini gösterir. Geçerli değerler: true: Desteklenir. false: Desteklenmez. Not Bu parametre yalnızca AdditionalAttributes istek parametresi CURRENT_OS_NVME_SUPPORTED içerdiğinde döndürülür.	true
LoginAsNonRoot	boolean	Bu görüntüyü kullanan örneğin ecs-user kullanıcısıyla oturum açmayı destekleyip desteklemediğini gösterir. Geçerli değerler: true: Desteklenir. false: Desteklenmez.	false
InnerIpAddress	object
IpAddress	array	Klasik ağ türündeki örneğin dahili ağ IP adreslarının listesi. Not Klasik ağ özelliği kullanımdan kaldırılmıştır. Ayrıntılar için Kullanımdan kaldırma bildirimi sayfasına bakın.
	string	Klasik ağ türündeki örneğin dahili ağ IP adresi.	10.170..
InstanceChargeType	string	Örneğin faturalandırma yöntemi. Geçerli değerler: PrePaid: Abonelik. PostPaid: Kullandıkça öde.	PostPaid
InstanceId	string	Örnek kimliği.	i-bp67acfmxazb4p****
InstanceName	string	Örnek adı.	InstanceNameTest
InstanceNetworkType	string	Örneğin ağ türü. Geçerli değerler: vpc: Sanal özel bulut (VPC). classic: Klasik ağ. Klasik ağ kullanımdan kaldırılmıştır. Daha fazla bilgi için Kullanımdan kaldırma bildirimi sayfasına bakın.	vpc
InstanceType	string	Örnek türü.	ecs.g5.large
InstanceTypeFamily	string	Örnek ailesi.	ecs.g5
InternetChargeType	string	Ağ kullanımı için faturalandırma yöntemi. Geçerli değerler: PayByBandwidth: Bant genişliğine göre ödeme. PayByTraffic: Trafiğe göre ödeme.	PayByTraffic
InternetMaxBandwidthIn	integer	Maksimum gelen genel bant genişliği. Birim: Mbit/s.	50
InternetMaxBandwidthOut	integer	Maksimum giden genel bant genişliği. Birim: Mbit/s.	5
IoOptimized	boolean	Örneğin G/Ç için optimize edilip edilmediğini gösterir. true: Örnek G/Ç için optimize edilmiştir. false: Örnek G/Ç için optimize edilmemiştir.	true
KeyPairName	string	Anahtar çiftinin adı.	testKeyPairName
LocalStorageAmount	integer	Örneğe eklenen yerel depolama aygıtlarının sayısı.	2
LocalStorageCapacity	integer	Örneğe eklenen yerel depolamanın depolama kapasitesi. Birim: GiB.	1000
Memory	integer	Bellek boyutu. Birim: MiB.	16384
MetadataOptions	object	Meta veri seçenekleri koleksiyonu.
HttpEndpoint	string	Örnek meta verileri için erişim kanalının etkin olup olmadığını gösterir. Geçerli değerler: enabled: Erişim kanalı etkindir. disabled: Erişim kanalı devre dışıdır.	enabled
HttpPutResponseHopLimit	integer	Not Bu parametre herkese açık değildir.	0
HttpTokens	string	Örnek meta verilerine erişmek için China modunun (IMDSv2) zorunlu olarak kullanılıp kullanılmadığını gösterir. Geçerli değerler: optional: China modu (IMDSv2) zorunlu olarak kullanılmaz. required: China modu (IMDSv2) zorunlu olarak kullanılır.	optional
InstanceMetadataTags	string
NetworkInterfaces	object
NetworkInterface	array<object>	Ağ arabirimi denetleyicisi (NIC) bilgileri de dahil olmak üzere örneğe eklenen Esnek Ağ Arabirimleri (ENI) koleksiyonu.
	array<object>	Ağ arabirimi denetleyicisi (NIC) bilgileri de dahil olmak üzere örneğe eklenen Esnek Ağ Arabirimleri (ENI) koleksiyonu.
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv4 ön ek kümesi. Bu parametre yalnızca `AdditionalAttributes.N` istek parametresi `NETWORK_PRIMARY_ENI_IP` olarak ayarlandığında döndürülür.
	object
Ipv4Prefix	string	The IPv4 prefix allocated to the network interface controller (NIC).	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv6 ön ek kümesi. Bu parametre yalnızca `AdditionalAttributes.N` istek parametresi `NETWORK_PRIMARY_ENI_IP` olarak ayarlandığında döndürülür.
	object
Ipv6Prefix	string	The IPv6 prefix allocated to the network interface controller (NIC).	2001:1111::::/80
Ipv6Sets	object
Ipv6Set	array<object>	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv6 adres kümesi. Bu parametre yalnızca `AdditionalAttributes.N` istek parametresi `NETWORK_PRIMARY_ENI_IP` olarak ayarlandığında döndürülür.
	object
Ipv6Address	string	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv6 adresi.	2408:4321:180:1701:94c7:bc38:3bfa:***
Primary	boolean
MacAddress	string	Ağ arabirimi denetleyicisinin (NIC) MAC adresi.	00:16:3e:32:b4:**
NetworkInterfaceId	string	Ağ arabirimi denetleyicisinin (NIC) kimliği.	eni-2zeh9atclduxvf1z****
PrimaryIpAddress	string	Ağ arabirimi denetleyicisinin (NIC) birincil özel IP adresi.	172.17..*
PrivateIpSets	object
PrivateIpSet	array<object>	PrivateIpSet nesnelerinin koleksiyonu.
	object
Primary	boolean	IP adresinin birincil özel IP adresi olup olmadığını gösterir. Geçerli değerler: true: IP adresi birincil özel IP adresidir. false: IP adresi birincil özel IP adresi değildir.	true
PrivateDnsName	string	Örneğin özel etki alanı adı. Not Sabit formatta bir özel etki alanı adı, yalnızca HostnameType değeri IpBased veya InstanceIdBased olarak ayarlandığında döndürülür.	dnsTestName
PrivateIpAddress	string	Örneğin özel IP adresi.	172.17..
Type	string	Elastik Ağ Arabiriminin (ENI) türü. Geçerli değerler: Primary: Birincil ağ arabirimi denetleyicisi (NIC). Secondary: İkincil ENI.	Primary
OSName	string	Örneğin işletim sisteminin adı.	CentOS 7.4 64 位
OSNameEn	string	Örneğin işletim sisteminin İngilizce adı.	CentOS 7.4 64 bit
OSType	string	Örneğin işletim sisteminin türü. Geçerli değerler: windows linux	linux
OperationLocks	object
LockReason	array<object>	Örneğin kilitlenmesinin nedenleri.
	object
LockMsg	string	Örnekteki kilidin açıklaması.	The specified instance is locked due to financial reason.
LockReason	string	Kilidin türü. Geçerli değerler: financial: ECS örneği, ödenmemiş borç nedeniyle kilitlenir. security: ECS örneği güvenlik nedenleriyle kilitlenir. Recycling: Spot örnek kilitlenir ve serbest bırakılmayı bekler. dedicatedhostfinancial: ECS örneği, adanmış ana makinenin ödenmemiş borcu olması nedeniyle kilitlenir. refunded: ECS örneği, iade işlemi yapıldığı için kilitlenir.	Recycling
PrivateDnsNameOptions	object	Örneğin özel etki alanı adı yapılandırması. Özel etki alanı adı çözümlemesi hakkında daha fazla bilgi için bkz. ECS özel etki alanı adı çözümlemesi. Not Bu parametre, yalnızca AdditionalAttributes istek parametresi PRIVATE_DNS_OPTIONS içerdiğinde döndürülür.
EnableInstanceIdDnsAAAARecord	boolean	Örnek kimliği tabanlı etki alanı adından IPv6'ya çözümlemenin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: true: Etkin. false: Devre dışı. Varsayılan değer: false.	false
EnableInstanceIdDnsARecord	boolean	Örnek kimliği tabanlı etki alanı adından IPv4'e çözümlemenin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: true: Etkin. false: Devre dışı. Varsayılan değer: false.	false
EnableIpDnsARecord	boolean	IP tabanlı etki alanı adından IPv4'e çözümlemenin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: true: Etkin. false: Devre dışı. Varsayılan değer: false.	true
EnableIpDnsPtrRecord	boolean	IPv4'ten IP tabanlı etki alanı adına çözümlemenin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: true: Etkin. false: Devre dışı. Varsayılan değer: false.	true
HostnameType	string	Ana makine adı türü. Geçerli değerler: Custom: Özel. IpBased: IP tabanlı ana makine adı. InstanceIdBased: Örnek kimliği tabanlı ana makine adı. Varsayılan değer: Custom.	Custom
PublicIpAddress	object
IpAddress	array	Örneğin genel IP adreslerinin listesi.
	string	Örneğin genel IP adresi.	121.40..
RdmaIpAddress	object
IpAddress	array	HPC örneğinin RDMA IP adreslerinin listesi.
	string	HPC örneğinin RDMA IP adresları.	10.10.10.102
Recyclable	boolean	Örneğin geri dönüştürülüp dönüştürülemeyeceğini gösterir.	false
RegionId	string	Örneğin bölge kimliği.	cn-hangzhou
ResourceGroupId	string	Örneğin ait olduğu kaynak grubunun kimliği.	rg-bp67acfmxazb4p****
SaleCycle	string	Not Bu parametre kullanımdan kaldırılmıştır ve artık anlamlı veriler döndürmemektedir.	month
SecurityGroupIds	object
SecurityGroupId	array	Örneğin güvenlik grubu kimliklerinin listesi.
	string	Güvenlik grubu kimliği.	sg-bp67acfmxazb4p****
SecurityOptions	object
EnableSecureBoot	boolean	UEFI Güvenli Önyüklemenin etkinleştirilip etkinleştirilmediğini gösterir.
SerialNumber	string	Örneğin seri numarası.	51d1353b-22bf-4567-a176-8b3e12e4****
SpotDuration	integer	Spot örneğin korunma süresi. Birim: saat. Geçerli değerler: 1: Spot örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat içinde otomatik olarak serbest bırakılmamasını sağlar. 1 saatin ardından sistem, teklif fiyatını piyasa fiyatıyla otomatik olarak karşılaştırır ve örneği korumaya mı yoksa iptal etmeye mi karar vereceğini belirlemek için kaynak envanterini kontrol eder. 0: Spot örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat boyunca çalışmasını garanti etmez. Sistem, teklif fiyatını piyasa fiyatıyla otomatik olarak karşılaştırır ve örneği korumaya mı yoksa iptal etmeye mi karar vereceğini belirlemek için kaynak envanterini kontrol eder. Alibaba Cloud, örnek iptal edilmeden 5 dakika önce bir ECS sistem olayı bildirimi gönderir. Spot örnekler saniye bazında faturalandırılır. Beklenen görev çalıştırma süresine göre uygun bir korunma süresi seçin. Not Bu parametre yalnızca SpotStrategy değeri SpotWithPriceLimit veya SpotAsPriceGo olarak ayarlandığında döndürülür.	1
SpotInterruptionBehavior	string	Platform bir spot örnek kesintisi başlattığında spot örneğin kesinti davranışı. Geçerli değerler: Terminate: Örnek serbest bırakılır. Stop: Örnek ekonomik modda durdurulur.	Terminate
SpotPriceLimit	number	Örneğin maksimum saatlik fiyatı. Değer en fazla üç ondalık basamağı destekler. Bu parametre SpotStrategy=SpotWithPriceLimit olduğunda geçerli olur.	0.98
SpotStrategy	string	Kullandıkça öde örneği için teklif stratejisi. Geçerli değerler: NoSpot: Örnek normal bir kullandıkça öde örneğidir. SpotWithPriceLimit: Örnek, maksimum fiyat limiti olan bir spot örnektir. SpotAsPriceGo: Örnek, sistemin kullandıkça öde fiyatına kadar otomatik olarak teklif verdiği bir spot örnektir.	NoSpot
StartTime	string	Örneğin en son başlatılma zamanı. Zaman, yyyy-MM-ddTHH:mmZ formatında ISO 8601 standardını takip eder. Zaman UTC olarak görüntülenir. Daha fazla bilgi için bkz. ISO 8601.	2017-12-10T04:04Z
Status	string	Örnek durumu.	Running
StoppedMode	string	Örneğin durdurulduktan sonra faturalandırılmaya devam edilip edilmediğini gösterir. Geçerli değerler: KeepCharging: Örnek durdurulduktan sonra faturalandırılmaya devam edilir. Envanter kaynakları örnek için ayrılır. StopCharging: Örnek durdurulduktan sonra faturalandırılmaz. Örnek durdurulduktan sonra vCPU'lar, bellek ve genel IP adresleri gibi kaynakları serbest bırakılır. Örneğin yeniden başlatılıp başlatılamayacağı, mevcut bölgedeki kaynak kullanılabilirliğine bağlıdır. Not-applicable: Örnek, Durdurulan Örnekler İçin Ücret Yok özelliğini desteklemez.	KeepCharging
Tags	object
Tag	array<object>	Örneğin etiketleri.
	object
TagKey	string	Örneğin etiket anahtarı.	TestKey
TagValue	string	Örneğin etiket değeri.	TestValue
VlanId	string	Örneğin VLAN kimliği. Not Bu parametre kullanımdan kaldırılacaktır. Daha iyi uyumluluk için diğer parametreleri kullanın.	10
VpcAttributes	object	Örneğin VPC öznitelikleri.
NatIpAddress	string	VPC tabanlı bulut hizmetleri arasındaki ağ bağlantısı için kullanılan bulut hizmetinin IP adresi.	172.17..
PrivateIpAddress	object
IpAddress	array	Özel IP adreslerinin listesi.
	string	Özel IP adresi.	172.17..
VSwitchId	string	vSwitch kimliği.	vsw-2zeh0r1pabwtg6wcs****
VpcId	string	Sanal özel bulutun (VPC) kimliği.	vpc-2zeuphj08tt7q3brd****
ZoneId	string	Örneğin bölge kimliği.	cn-hangzhou-g
NextToken	string	Bu çağrıda döndürülen sayfalama belirteci.	caeba0bbb2be03f84eb48b699f0a4883
PageNumber	integer	Sayfa numarası.	1
PageSize	integer	İstekte belirtilen sayfa başına giriş sayısı.	10
RequestId	string	İstek kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	Sorgulanan örneklerin toplam sayısı. Not Sayfalama sorgusu için MaxResults ve NextToken parametrelerini kullandığınızda, döndürülen TotalCount parametre değeri anlamsızdır.	1

Examples

Success response

JSON format

{
  "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
}

Error codes

HTTP status code	Error code	Error message
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.
400	InvalidTagCount	The specified tags are beyond the permitted range.
400	InvalidHpcClusterId.NotFound	The specified HpcClusterId is not found.
400	InvalidHpcClusterId.Creating	The specified HpcClusterId is creating.
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.
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.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.