DescribeInstances - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri daftar instans berdasarkan kondisi permintaan yang ditentukan dan mengambil informasi detail terkait instans tersebut.

Deskripsi operasi

Sebelum memulai

Saat Anda memanggil operasi API menggunakan Asisten Cloud CLI, pastikan nilai parameter permintaan dari berbagai tipe data memenuhi persyaratan format. Untuk informasi selengkapnya, lihat Ikhtisar format parameter CLI.

Catatan penggunaan

Kirim permintaan dry run menggunakan parameter permintaan DryRun untuk memeriksa validitas parameter dan otorisasi.
Saat Anda melakukan kueri halaman untuk halaman pertama hasil, setel hanya MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam tanggapan digunakan sebagai kredensial untuk mengkueri halaman berikutnya. Saat Anda melakukan kueri halaman untuk halaman berikutnya, setel NextToken ke nilai NextToken yang diperoleh dari tanggapan sebelumnya dan setel MaxResults untuk membatasi jumlah entri yang dikembalikan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:DescribeInstances

list

Instans.

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

Instans.

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

ResourceOwner

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah instans. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
VpcId	string	No	ID virtual private cloud (VPC).	v-bp67acfmxazb4p****
VSwitchId	string	No	ID vSwitch.	vsw-bp67acfmxazb4p****
ZoneId	string	No	ID zona.	cn-hangzhou-g
InstanceNetworkType	string	No	Jenis jaringan instans. Nilai valid: vpc: VPC. classic: jaringan klasik. Jaringan klasik tidak lagi tersedia. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.	vpc
SecurityGroupId	string	No	ID grup keamanan tempat instans berada.	sg-bp67acfmxazb4p****
InstanceIds	string	No	ID instans. Nilainya adalah array JSON yang terdiri dari hingga 100 ID instans. Pisahkan ID instans dengan koma (,).	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", … "i-bp67acfmxazb4p**"]
PageNumber	integer	No	Catatan Parameter ini akan segera dihentikan penggunaannya. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri halaman.	1
PageSize	integer	No	Catatan Parameter ini akan segera dihentikan penggunaannya. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri halaman.	10
NextToken	string	No	Token kueri. Setel nilai ke nilai NextToken yang dikembalikan dalam pemanggilan API sebelumnya.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	No	Jumlah entri maksimum per halaman untuk kueri halaman. Nilai maksimum: 100. Nilai default: Jika Anda tidak menyetel parameter ini atau menyetelnya ke nilai kurang dari 10, nilai default adalah 10. Jika Anda menyetel parameter ini ke nilai lebih dari 100, nilai default adalah 100.	10
InnerIpAddresses	string	No	Alamat IP jaringan internal instans dengan jenis jaringan klasik. Parameter ini berlaku ketika InstanceNetworkType disetel ke classic. Nilainya adalah array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,). Catatan Fitur jaringan klasik telah dihentikan. Untuk detailnya, lihat Pemberitahuan penghentian.	["10.1.1.1", "10.1.2.1", … "10.1.10.1"]
PrivateIpAddresses	string	No	Alamat IP pribadi instans dengan jenis jaringan VPC. Parameter ini berlaku ketika InstanceNetworkType disetel ke vpc. Nilainya adalah array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).	["172.16.1.1", "172.16.2.1", … "172.16.10.1"]
PublicIpAddresses	string	No	Alamat IP publik instans. Nilainya adalah array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).	["42.1.1.", "42.1.2.", … "42.1.10.**"]
EipAddresses	string	No	elastic IP addresses (EIPs) instans. Parameter ini berlaku ketika InstanceNetworkType disetel ke vpc. Nilainya adalah array JSON yang terdiri dari hingga 100 alamat IP. Pisahkan alamat IP dengan koma (,).	["42.1.1.", "42.1.2.", … "42.1.10.**"]
InstanceChargeType	string	No	Metode penagihan instans. Nilai valid: PostPaid: pay-as-you-go. PrePaid: langganan.	PostPaid
InternetChargeType	string	No	Metode penagihan untuk bandwidth publik. Nilai valid: PayByBandwidth: pay-by-bandwidth. PayByTraffic: pay-by-traffic. Catatan Dalam mode pay-by-traffic, bandwidth puncak arah masuk dan arah keluar digunakan sebagai batas atas bandwidth dan tidak dijamin. Ketika terjadi konflik sumber daya, bandwidth puncak mungkin dibatasi. Jika Anda memerlukan bandwidth terjamin untuk beban kerja Anda, gunakan mode pay-by-bandwidth.	PayByTraffic
InstanceName	string	No	Nama instans. Pencarian fuzzy dengan wildcard tanda bintang (*) didukung.	Test
ImageId	string	No	ID image.	m-bp67acfmxazb4p****
Status	string	No	Status instans. Nilai valid: Pending: sedang dibuat. Running: berjalan. Starting: sedang dimulai. Stopping: sedang dihentikan. Stopped: dihentikan.	Running
LockReason	string	No	Alasan resource terkunci. Nilai valid: financial: Resource terkunci karena pembayaran tertunda. security: Resource terkunci karena alasan keamanan. Recycling: spot instans terkunci dan menunggu rilis. dedicatedhostfinancial: Instance ECS terkunci karena host khusus memiliki pembayaran tertunda. refunded: Resource terkunci karena pengembalian dana dilakukan.	security
Filter.1.Key	string	No	Kunci filter 1 yang digunakan untuk mengkueri resource. Setel nilai ke `CreationStartTime`. Anda dapat menentukan Filter.1.Key dan Filter.1.Value untuk mengkueri resource yang dibuat setelah waktu yang ditentukan.	CreationStartTime
Filter.2.Key	string	No	Kunci filter 2 yang digunakan untuk mengkueri resource. Setel nilai ke `CreationEndTime`. Anda dapat menentukan Filter.2.Key dan Filter.2.Value untuk mengkueri resource yang dibuat sebelum waktu yang ditentukan.	CreationEndTime
Filter.3.Key	string	No	Kunci filter 3 yang digunakan untuk mengkueri resource. Setel nilai ke `ExpiredStartTime`. Anda dapat menentukan Filter.3.Key dan Filter.3.Value untuk mengkueri resource yang kedaluwarsa setelah waktu yang ditentukan.	ExpiredStartTime
Filter.4.Key	string	No	Kunci filter 4 yang digunakan untuk mengkueri resource. Setel nilai ke `ExpiredEndTime`. Anda dapat menentukan Filter.4.Key dan Filter.4.Value untuk mengkueri resource yang kedaluwarsa sebelum waktu yang ditentukan.	ExpiredEndTime
Filter.1.Value	string	No	Nilai filter 1 yang digunakan untuk mengkueri resource. Saat Anda menentukan parameter ini, Anda juga harus menentukan `Filter.1.Key`. Tentukan waktu dalam format `yyyy-MM-ddTHH:mmZ` dalam UTC.	2017-12-05T22:40Z
Filter.2.Value	string	No	Nilai filter 2 yang digunakan untuk mengkueri resource. Saat Anda menentukan parameter ini, Anda juga harus menentukan `Filter.2.Key`. Tentukan waktu dalam format `yyyy-MM-ddTHH:mmZ` dalam UTC.	2017-12-06T22:40Z
Filter.3.Value	string	No	Nilai filter 3 yang digunakan untuk mengkueri resource. Saat Anda menentukan parameter ini, Anda juga harus menentukan `Filter.3.Key`. Tentukan waktu dalam format `yyyy-MM-ddTHH:mmZ` dalam UTC.	2017-12-07T22:40Z
Filter.4.Value	string	No	Nilai filter 4 yang digunakan untuk mengkueri resource. Saat Anda menentukan parameter ini, Anda juga harus menentukan `Filter.4.Key`. Tentukan waktu dalam format `yyyy-MM-ddTHH:mmZ` dalam UTC.	2017-12-08T22:40Z
DeviceAvailable	boolean	No	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	false
IoOptimized	boolean	No	Apakah instans dioptimalkan I/O. Nilai valid: true: Instans dioptimalkan I/O. false: Instans tidak dioptimalkan I/O.	true
NeedSaleCycle	boolean	No	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	false
InstanceType	string	No	Tipe instans.	ecs.g5.large
InstanceTypeFamily	string	No	Keluarga instans.	ecs.g5
KeyPairName	string	No	Nama pasangan kunci SSH yang terikat pada instans.	KeyPairNameTest
ResourceGroupId	string	No	ID kelompok sumber daya tempat instans berada. Saat Anda menggunakan parameter ini untuk memfilter resource, jumlah resource tidak boleh melebihi 1.000. Catatan Pemfilteran berdasarkan kelompok sumber daya default tidak didukung.	rg-bp67acfmxazb4p****
HpcClusterId	string	No	ID kluster HPC tempat instans berada.	hpc-bp67acfmxazb4p****
RdmaIpAddresses	string	No	Alamat IP RDMA instans HPC.	10.10.10.102
DryRun	boolean	No	Apakah akan menjalankan dry run saja. Nilai valid: true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk pasangan AccessKey yang tidak valid, pengguna Resource Access Management (RAM) yang tidak terotorisasi, dan nilai parameter yang hilang. Jika permintaan gagal dalam dry run, pesan error dikembalikan. Jika permintaan lulus dry run, kode kesalahan DryRunOperation dikembalikan. false: Menjalankan dry run dan mengirim permintaan. Jika permintaan lulus dry run, kode status HTTP 2XX dikembalikan dan operasi dilakukan. Nilai default: false.	false
HttpEndpoint	string	No	Apakah saluran akses untuk metadata instans diaktifkan. Nilai valid: enabled: diaktifkan. disabled: dinonaktifkan. Nilai default: enabled. Catatan Untuk informasi selengkapnya tentang metadata instans, lihat Ikhtisar metadata Instance ECS.	enabled
HttpTokens	string	No	Apakah akan menggunakan mode pengerasan (IMDSv2) secara paksa saat mengakses metadata instans. Nilai valid: optional: Mode pengerasan tidak digunakan secara paksa. required: Mode pengerasan digunakan secara paksa. Setelah Anda menyetel parameter ini ke required, Anda tidak dapat mengakses metadata instans dalam pola normal. Nilai default: optional. Catatan Untuk informasi selengkapnya tentang pola akses metadata instans, lihat Mode akses metadata instans.	optional
HttpPutResponseHopLimit	integer	No	Catatan Parameter ini belum tersedia.	0
Ipv6Address	array	No	Alamat IPv6 yang ditetapkan ke Elastic Network Interfaces (ENI).
	string	No	Alamat IPv6 dari Elastic Network Interface (ENI). N menentukan bahwa Anda dapat menyetel beberapa alamat IPv6. Nilai valid N: 1 hingga 100.	2408:4321:180:1701:94c7:bc38:3bfa:****
Tag	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag instans. Nilai valid N: 1 hingga 20. Jika Anda menggunakan satu tag untuk memfilter sumber daya, jumlah sumber daya dengan tag ini tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter sumber daya, jumlah sumber daya yang dilampirkan ke semua tag yang ditentukan tidak boleh melebihi 1.000. Jika jumlah sumber daya melebihi 1.000, gunakan operasi ListTagResources untuk mengkueri sumber daya.	TestKey
Value	string	No	Nilai tag instans. Nilai valid N: 1 hingga 20.	TestValue
key	string	No	Kunci tag. Catatan Untuk meningkatkan kompatibilitas, gunakan parameter Tag.N.Key sebagai gantinya.	keyTest
value	string	No	Nilai tag. Catatan Untuk meningkatkan kompatibilitas, gunakan parameter Tag.N.Value sebagai gantinya.	valueTest
AdditionalAttributes	array	No	Daftar properti tambahan instans.	META_OPTIONS
	string	No	Nilai properti tambahan. Nilai valid N: 1 hingga 5. Nilai valid: META_OPTIONS: metadata instans. DDH_CLUSTER: kluster host khusus. NETWORK_PRIMARY_ENI_IP: alamat IP sekunder pengontrol antarmuka jaringan (NIC) utama. PRIVATE_DNS_OPTIONS: informasi nama domain jaringan pribadi. CPU_OPTIONS_TOPOLOGY_TYPE: tipe topologi CPU instans. CURRENT_OS_NVME_SUPPORTED: apakah sistem operasi saat ini mendukung akses disk melalui protokol NVMe. LOGIN_AS_NON_ROOT: apakah instans dikonfigurasi dengan logon ecs-user.	META_OPTIONS

Elemen respons

Element	Type	Description	Example
	object
Instances	object
Instance	array<object>	Array objek instans yang berisi informasi tentang instans.
	array<object>
AdditionalInfo	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
EnableHighDensityMode	boolean	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	true
ManagedHostId	string	ID unik host yang dikelola platform, seperti mh-f2d3647ca21****.	mh-f2d3647ca21****
NodeSerialNumber	string
AutoReleaseTime	string	Waktu pelepasan otomatis instans pay-as-you-go.	2017-12-10T04:04Z
ClockOptions	object
PtpStatus	string
ClusterId	string	ID kluster tempat instans berada. Catatan Parameter ini akan ditinggalkan. Untuk memastikan kompatibilitas, gunakan parameter lain.	c-bp67acfmxazb4p****
Cpu	integer	Jumlah vCPU.	8
CpuOptions	object	Detail konfigurasi CPU.
CoreCount	integer	Jumlah inti CPU fisik.	2
EnableVISST	boolean
EnableVRDT	boolean
NestedVirtualization	string	Apakah virtualisasi bertingkat diaktifkan.	enabled
Numa	string	Catatan Parameter ini tidak digunakan lagi.	null
ThreadsPerCore	integer	Jumlah thread per inti CPU.	2
TopologyType	string	Tipe topologi CPU instans. Nilai valid: ContinuousCoreToHTMapping: Mode diskrit HT. DiscreteCoreToHTMapping: Mode kontinu HT.	DiscreteCoreToHTMapping
TurboMode	string
CreationTime	string	Waktu pembuatan instans. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu ditampilkan dalam UTC+0. Untuk informasi selengkapnya, lihat ISO 8601.	2017-12-10T04:04Z
CreditSpecification	string	Mode berjalan instans burstable. Nilai valid: Jenis Penyimpanan Standar: mode standar. Untuk informasi selengkapnya tentang performa instans, lihat bagian mode terkendala performa di Ikhtisar instans burstable. Unlimited: mode tanpa batas. Untuk informasi selengkapnya tentang performa instans, lihat bagian mode tanpa batas di Ikhtisar instans burstable.	Jenis Penyimpanan Standar
DedicatedHostAttribute	object	Array atribut spesifikasi khusus, yang terdiri dari ID kluster spesifikasi khusus (DedicatedHostClusterId), ID spesifikasi khusus (DedicatedHostId), dan nama spesifikasi khusus (DedicatedHostName).
DedicatedHostClusterId	string	ID kluster host khusus.	dc-bp67acfmxazb4h****
DedicatedHostId	string	ID host khusus.	dh-bp67acfmxazb4p****
DedicatedHostName	string	Nama host khusus.	testDedicatedHostName
DedicatedInstanceAttribute	object	Atribut instans pada host khusus.
Affinity	string	Apakah instans pada host khusus terasosiasi dengan host khusus. Nilai valid: default: Instans tidak terasosiasi dengan host khusus. Ketika instans yang berada dalam status Tidak Ada Biaya untuk Instans yang Dihentikan dimulai ulang, instans dapat ditempatkan pada host khusus lain di kolam sumber daya penyebaran otomatis. host: Instans terasosiasi dengan host khusus. Ketika instans yang berada dalam status Tidak Ada Biaya untuk Instans yang Dihentikan dimulai ulang, instans tetap ditempatkan pada host khusus asli.	default
Tenancy	string	Apakah tipe host instans adalah host khusus. Nilai valid: default: Tipe host instans bukan host khusus. host: Tipe host instans adalah host khusus.	default
DeletionProtection	boolean	Atribut perlindungan pelepasan instans. Apakah instans dapat dilepas dari Konsol ECS atau dengan memanggil operasi DeleteInstance. true: Perlindungan pelepasan diaktifkan untuk instans. false: Perlindungan pelepasan tidak diaktifkan untuk instans. Catatan Atribut ini hanya berlaku untuk instans pay-as-you-go. Atribut ini hanya dapat membatasi operasi pelepasan manual, bukan operasi pelepasan sistem.	false
DeploymentSetGroupNo	integer	Nomor grup instans ECS dalam set penyebaran ketika instans ECS diterapkan dengan strategi penyebaran spread.	1
DeploymentSetId	string	ID set penyebaran.	ds-bp67acfmxazb4p****
Description	string	Deskripsi instans.	testDescription
DeviceAvailable	boolean	Apakah cloud disk data dapat dilampirkan ke instans. true: Cloud disk data dapat dilampirkan ke instans. false: Cloud disk data tidak dapat dilampirkan ke instans.	true
EcsCapacityReservationAttr	object	Parameter terkait reservasi kapasitas Elastic Compute Service (ECS).
CapacityReservationId	string	ID reservasi kapasitas.	cr-bp67acfmxazb4p****
CapacityReservationPreference	string	Preferensi reservasi kapasitas.	cr-bp67acfmxazb4p****
EipAddress	object	Informasi pengikatan Elastic IP Address (EIP).
AllocationId	string	ID EIP.	eip-2ze88m67qx5z****
Bandwidth	integer	Batas bandwidth publik EIP. Unit: Mbit/s.	5
InternetChargeType	string	Metode penagihan EIP untuk penggunaan Internet. PayByBandwidth: bayar berdasarkan bandwidth. PayByTraffic: bayar berdasarkan trafik.	PayByTraffic
IpAddress	string	Alamat EIP.	42.112..
IsSupportUnassociate	boolean	Apakah EIP Internet dapat dipisahkan dari instans.	true
EnableNVS	boolean
ExpiredTime	string	Waktu kedaluwarsa. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu ditampilkan dalam UTC+0. Untuk informasi selengkapnya, lihat ISO 8601.	2017-12-10T04:04Z
GPUAmount	integer	Jumlah GPU untuk tipe instans.	4
GPUSpec	string	Tipe GPU untuk tipe instans.	NVIDIA V100
HibernationOptions	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
Configured	boolean	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	false
HostName	string	Hostname instans.	testHostName
HpcClusterId	string	ID kluster HPC tempat instans berada.	hpc-bp67acfmxazb4p****
ISP	string	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	null
ImageId	string	ID image yang berjalan pada instans.	m-bp67acfmxazb4p****
ImageOptions	object	Informasi atribut terkait image.
CurrentOSNVMeSupported	boolean	Apakah sistem operasi saat ini mendukung akses ke cloud disk melalui protokol NVMe. Nilai valid: true: Didukung. false: Tidak didukung. Catatan Parameter ini hanya dikembalikan ketika parameter permintaan AdditionalAttributes berisi CURRENT_OS_NVME_SUPPORTED.	true
LoginAsNonRoot	boolean	Apakah instans yang menggunakan image ini mendukung logon dengan pengguna ecs-user. Nilai valid: true: Didukung. false: Tidak didukung.	false
InnerIpAddress	object
IpAddress	array	Daftar alamat IP jaringan internal instans pada jenis jaringan klasik. Catatan Fitur jaringan klasik telah dihentikan. Untuk detailnya, lihat Pemberitahuan penghentian.
	string	Alamat IP jaringan internal instans pada jenis jaringan klasik.	10.170..
InstanceChargeType	string	Metode penagihan instans. Nilai valid: PrePaid: langganan. PostPaid: bayar sesuai pemakaian.	PostPaid
InstanceId	string	ID instans.	i-bp67acfmxazb4p****
InstanceName	string	Nama instans.	InstanceNameTest
InstanceNetworkType	string	Jenis jaringan instans. Nilai valid: vpc: virtual private cloud (VPC). classic: jaringan klasik. Jaringan klasik telah dihentikan. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.	vpc
InstanceType	string	Tipe instans.	ecs.g5.large
InstanceTypeFamily	string	Keluarga instans.	ecs.g5
InternetChargeType	string	Metode penagihan untuk penggunaan jaringan. Nilai valid: PayByBandwidth: bayar berdasarkan bandwidth. PayByTraffic: bayar berdasarkan trafik.	PayByTraffic
InternetMaxBandwidthIn	integer	Bandwidth publik arah masuk maksimum. Unit: Mbit/s.	50
InternetMaxBandwidthOut	integer	Bandwidth publik arah keluar maksimum. Unit: Mbit/s.	5
IoOptimized	boolean	Apakah instans dioptimalkan I/O. true: Instans dioptimalkan I/O. false: Instans tidak dioptimalkan I/O.	true
KeyPairName	string	Nama key pair.	testKeyPairName
LocalStorageAmount	integer	Jumlah perangkat penyimpanan lokal yang dilampirkan ke instans.	2
LocalStorageCapacity	integer	Kapasitas penyimpanan lokal yang dilampirkan ke instans. Unit: GiB.	1000
Memory	integer	Ukuran memori. Unit: MiB.	16384
MetadataOptions	object	Kumpulan opsi metadata.
HttpEndpoint	string	Apakah saluran akses untuk metadata instans diaktifkan. Nilai valid: enabled: Saluran akses diaktifkan. disabled: Saluran akses dinonaktifkan.	enabled
HttpPutResponseHopLimit	integer	Catatan Parameter ini tidak tersedia secara publik.	0
HttpTokens	string	Apakah mode wajib (IMDSv2) digunakan secara paksa untuk mengakses metadata instans. Nilai valid: optional: Mode wajib (IMDSv2) tidak digunakan secara paksa. required: Mode wajib (IMDSv2) digunakan secara paksa.	optional
InstanceMetadataTags	string
NetworkInterfaces	object
NetworkInterface	array<object>	Kumpulan Elastic Network Interfaces (ENI) yang dilampirkan ke instans, termasuk informasi pengontrol antarmuka jaringan (NIC).
	array<object>	Kumpulan Elastic Network Interfaces (ENI) yang dilampirkan ke instans, termasuk informasi pengontrol antarmuka jaringan (NIC).
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Set awalan IPv4 yang dialokasikan ke pengontrol antarmuka jaringan (NIC). Parameter ini hanya dikembalikan ketika parameter permintaan `AdditionalAttributes.N` diatur ke `NETWORK_PRIMARY_ENI_IP`.
	object
Ipv4Prefix	string	Awalan IPv4 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Set awalan IPv6 yang dialokasikan ke pengontrol antarmuka jaringan (NIC). Parameter ini hanya dikembalikan ketika parameter permintaan `AdditionalAttributes.N` diatur ke `NETWORK_PRIMARY_ENI_IP`.
	object
Ipv6Prefix	string	Awalan IPv6 yang ditetapkan ke pengontrol antarmuka jaringan (NIC).	2001:1111::::/80
Ipv6Sets	object
Ipv6Set	array<object>	Set alamat IPv6 yang dialokasikan ke pengontrol antarmuka jaringan (NIC). Parameter ini hanya dikembalikan ketika parameter permintaan `AdditionalAttributes.N` diatur ke `NETWORK_PRIMARY_ENI_IP`.
	object
Ipv6Address	string	Alamat IPv6 yang dialokasikan ke pengontrol antarmuka jaringan (NIC).	2408:4321:180:1701:94c7:bc38:3bfa:***
Primary	boolean
MacAddress	string	Alamat MAC pengontrol antarmuka jaringan (NIC).	00:16:3e:32:b4:**
NetworkInterfaceId	string	ID pengontrol antarmuka jaringan (NIC).	eni-2zeh9atclduxvf1z****
PrimaryIpAddress	string	Alamat IP privat utama pengontrol antarmuka jaringan (NIC).	172.17..*
PrivateIpSets	object
PrivateIpSet	array<object>	Kumpulan objek PrivateIpSet.
	object
Primary	boolean	Apakah alamat IP merupakan alamat IP privat utama. Nilai valid: true: Alamat IP merupakan alamat IP privat utama. false: Alamat IP bukan alamat IP privat utama.	true
PrivateDnsName	string	Nama domain privat instans. Catatan Nama domain privat dalam format tetap hanya dikembalikan jika `HostnameType` diatur ke `IpBased` atau `InstanceIdBased`.	dnsTestName
PrivateIpAddress	string	Alamat IP privat instans.	172.17..
Type	string	Tipe Elastic Network Interface (ENI). Nilai valid: Primary: pengontrol antarmuka jaringan (NIC) utama. Secondary: ENI sekunder.	Primary
OSName	string	Nama sistem operasi instans.	CentOS 7.4 64-bit
OSNameEn	string	Nama bahasa Inggris sistem operasi instans.	CentOS 7.4 64 bit
OSType	string	Tipe sistem operasi instans. Nilai valid: windows linux	linux
OperationLocks	object
LockReason	array<object>	Alasan instans terkunci.
	object
LockMsg	string	Deskripsi penguncian pada instans.	Instans tertentu terkunci karena alasan keuangan
LockReason	string	Tipe penguncian. Nilai valid: financial: Instans ECS terkunci karena pembayaran tertunda. security: Instans ECS terkunci karena alasan keamanan. Recycling: Spot instans terkunci dan menunggu rilis. dedicatedhostfinancial: Instans ECS terkunci karena host khusus memiliki pembayaran tertunda. refunded: Instans ECS terkunci karena pengembalian dana telah dilakukan.	Recycling
PrivateDnsNameOptions	object	Konfigurasi nama domain privat instans. Untuk informasi selengkapnya tentang resolusi domain privat, lihat Resolusi domain privat ECS. Catatan Parameter ini hanya dikembalikan jika parameter permintaan `AdditionalAttributes` berisi `PRIVATE_DNS_OPTIONS`.
EnableInstanceIdDnsAAAARecord	boolean	Apakah resolusi nama domain berbasis ID instans ke IPv6 diaktifkan. Nilai valid: true: Diaktifkan. false: Dinonaktifkan. Nilai default: false.	false
EnableInstanceIdDnsARecord	boolean	Apakah resolusi nama domain berbasis ID instans ke IPv4 diaktifkan. Nilai valid: true: Diaktifkan. false: Dinonaktifkan. Nilai default: false.	false
EnableIpDnsARecord	boolean	Apakah resolusi nama domain berbasis IP ke IPv4 diaktifkan. Nilai valid: true: Diaktifkan. false: Dinonaktifkan. Nilai default: false.	true
EnableIpDnsPtrRecord	boolean	Apakah resolusi nama domain berbasis IP dari IPv4 diaktifkan. Nilai valid: true: Diaktifkan. false: Dinonaktifkan. Nilai default: false.	true
HostnameType	string	Tipe hostname. Nilai valid: Custom: kustom. IpBased: hostname berbasis IP. InstanceIdBased: hostname berbasis ID instans. Nilai default: Custom.	Custom
PublicIpAddress	object
IpAddress	array	Daftar alamat IP publik instans.
	string	Alamat IP publik instans.	121.40..
RdmaIpAddress	object
IpAddress	array	Daftar alamat IP RDMA instans HPC.
	string	Alamat IP RDMA instans HPC.	10.10.10.102
Recyclable	boolean	Apakah instans dapat didaur ulang.	false
RegionId	string	ID wilayah instans.	cn-hangzhou
ResourceGroupId	string	ID kelompok sumber daya tempat instans berada.	rg-bp67acfmxazb4p****
SaleCycle	string	Catatan Parameter ini tidak digunakan lagi dan tidak lagi mengembalikan data yang bermakna.	month
SecurityGroupIds	object
SecurityGroupId	array	Daftar ID grup keamanan instans.
	string	ID grup keamanan.	sg-bp67acfmxazb4p****
SecurityOptions	object
EnableSecureBoot	boolean	Apakah UEFI Secure Boot diaktifkan.
SerialNumber	string	Nomor seri instans.	51d1353b-22bf-4567-a176-8b3e12e4****
SpotDuration	integer	Periode perlindungan spot instans. Unit: jam. Nilai valid: 1: Setelah spot instans dibuat, Alibaba Cloud memastikan bahwa instans tidak akan mengalami pelepasan otomatis dalam 1 jam. Setelah 1 jam, sistem secara otomatis membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris sumber daya untuk menentukan apakah instans akan dipertahankan atau dicabut. 0: Setelah spot instans dibuat, Alibaba Cloud tidak memastikan bahwa instans berjalan selama 1 jam. Sistem secara otomatis membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris sumber daya untuk menentukan apakah instans akan dipertahankan atau dicabut. Alibaba Cloud mengirimkan notifikasi peristiwa sistem ECS 5 menit sebelum instans dicabut. Spot instans ditagih per detik. Pilih periode perlindungan yang sesuai berdasarkan durasi eksekusi tugas yang diharapkan. Catatan Parameter ini hanya dikembalikan jika SpotStrategy diatur ke SpotWithPriceLimit atau SpotAsPriceGo.	1
SpotInterruptionBehavior	string	Pola interupsi spot instans saat platform memulai interupsi spot instans. Nilai valid: Terminate: Instans dirilis. Stop: Instans dihentikan dalam mode hemat.	Terminate
SpotPriceLimit	number	Harga maksimum per jam instans. Nilai mendukung hingga tiga tempat desimal. Parameter ini berlaku saat SpotStrategy=SpotWithPriceLimit.	0.98
SpotStrategy	string	Strategi penawaran untuk instans pay-as-you-go. Nilai valid: NoSpot: Instans merupakan instans pay-as-you-go reguler. SpotWithPriceLimit: Instans merupakan spot instans dengan batas harga maksimum. SpotAsPriceGo: Instans merupakan spot instans yang penawarannya dilakukan secara otomatis oleh sistem hingga harga pay-as-you-go.	NoSpot
StartTime	string	Waktu mulai terbaru instans. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu ditampilkan dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.	2017-12-10T04:04Z
Status	string	Status instans.	Running
StoppedMode	string	Apakah instans terus ditagih setelah dihentikan. Nilai valid: KeepCharging: Instans terus ditagih setelah dihentikan. Sumber daya inventaris dicadangkan untuk instans. StopCharging: Instans tidak ditagih setelah dihentikan. Setelah instans dihentikan, sumber dayanya seperti vCPU, memori, dan alamat IP publik dirilis. Apakah instans dapat dimulai ulang bergantung pada ketersediaan sumber daya di wilayah saat ini. Not-applicable: Instans tidak mendukung fitur Tanpa Biaya untuk Instans yang Dihentikan.	KeepCharging
Tags	object
Tag	array<object>	Tag instans.
	object
TagKey	string	Kunci tag instans.	TestKey
TagValue	string	Nilai tag instans.	TestValue
VlanId	string	ID VLAN instans. Catatan Parameter ini akan dihapus. Untuk kompatibilitas yang lebih baik, gunakan parameter lain.	10
VpcAttributes	object	Atribut VPC instans.
NatIpAddress	string	Alamat IP layanan cloud, yang digunakan untuk konektivitas jaringan antarlayanan cloud berbasis VPC.	172.17..
PrivateIpAddress	object
IpAddress	array	Daftar alamat IP privat.
	string	Alamat IP privat.	172.17..
VSwitchId	string	ID vSwitch.	vsw-2zeh0r1pabwtg6wcs****
VpcId	string	ID virtual private cloud (VPC).	vpc-2zeuphj08tt7q3brd****
ZoneId	string	ID zona instans.	cn-hangzhou-g
NextToken	string	Token paginasi yang dikembalikan dalam panggilan ini.	caeba0bbb2be03f84eb48b699f0a4883
PageNumber	integer	Nomor halaman.	1
PageSize	integer	Jumlah entri per halaman yang ditentukan di permintaan.	10
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	Jumlah total instans yang dikueri. Catatan Saat Anda menggunakan parameter MaxResults dan NextToken untuk kueri paginasi, nilai parameter TotalCount yang dikembalikan tidak bermakna.	1

Contoh

Respons sukses

JSONformat

{
  "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": "Jenis Penyimpanan Standar",
        "DedicatedHostAttribute": {
          "DedicatedHostClusterId": "dc-bp67acfmxazb4h****",
          "DedicatedHostId": "dh-bp67acfmxazb4p****",
          "DedicatedHostName": "testspesifikasi khususHostName"
        },
        "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-bit",
        "OSNameEn": "CentOS  7.4 64 bit",
        "OSType": "linux",
        "OperationLocks": {
          "LockReason": [
            {
              "LockMsg": "Instans yang ditentukan terkunci karena alasan keuangan",
              "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
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Tag.N.Key dan Tag.N.Value yang ditentukan tidak cocok.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Tag yang ditentukan berada di luar rentang valid.
400	InvalidHpcClusterId.NotFound	The specified HpcClusterId is not found.	Parameter HpcClusterId yang ditentukan tidak ada.
400	InvalidHpcClusterId.Creating	The specified HpcClusterId is creating.	Kluster HPC yang ditentukan sedang dibuat.
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.	Permintaan saat ini telah mengalami Pengendalian aliran. Gunakan NextToken untuk mengganti PageNumber untuk paging dalam permintaan kueri berhalaman.
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.	Tipe kunci yang ditentukan tidak ada.
404	InvalidFilterKey.NotFound	Invalid filter.%s.	Parameter pengatur waktu mulai atau pengatur waktu kedaluwarsa yang ditentukan tidak valid.
404	InvalidFilterValue	Invalid filter.%s.
404	InvalidNetworkType.NotFound	The specified InstanceNetworkType is not found.
404	InvalidStatus.NotFound	The specified Status is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.