DescribeInstances - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri daftar instans berdasarkan kondisi permintaan yang ditentukan dan mengembalikan informasi detail instans.

Deskripsi operasi

Sebelum Anda memulai

Saat memanggil operasi API menggunakan Asisten Cloud CLI, pastikan parameter permintaan dengan tipe data berbeda berada dalam format yang diperlukan. Untuk informasi lebih lanjut, lihat Format parameter CLI.

Catatan penggunaan

Kirim permintaan dry run menggunakan parameter permintaan DryRun untuk memeriksa validitas parameter dan otorisasi.
Saat melakukan kueri halaman untuk halaman pertama hasil, tetapkan hanya MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam tanggapan digunakan sebagai kredensial untuk mengkueri halaman berikutnya. Saat melakukan kueri halaman untuk halaman berikutnya, tetapkan NextToken ke nilai NextToken yang diperoleh dari tanggapan sebelumnya dan tetapkan 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

Instance

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

Instance

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 sudah tidak digunakan lagi. Untuk informasi lebih lanjut, lihat Pemberitahuan penghentian.	vpc
SecurityGroupId	string	No	Grup keamanan tempat instans berada.	sg-bp67acfmxazb4p****
InstanceIds	string	No	ID instans. Nilainya dapat berupa array JSON yang terdiri dari hingga 100 ID instans. Pisahkan ID dengan koma (,).	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", … "i-bp67acfmxazb4p**"]
PageNumber	integer	No	Catatan Parameter ini akan segera dihentikan. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri halaman.	1
PageSize	integer	No	Catatan Parameter ini akan segera dihentikan. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri halaman.	10
NextToken	string	No	Token kueri. Tetapkan nilai ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	No	Jumlah maksimum entri per halaman untuk kueri halaman. Nilai maksimum: 100. Nilai default: Jika Anda tidak menetapkan parameter ini atau menetapkannya ke nilai yang lebih kecil dari 10, nilai default adalah 10. Jika Anda menetapkan parameter ini ke nilai yang lebih besar dari 100, nilai default adalah 100.	10
InnerIpAddresses	string	No	Alamat IP jaringan internal instans jenis jaringan klasik. Parameter ini berlaku ketika InstanceNetworkType ditetapkan ke classic. Nilainya dapat berupa 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 privat instans jenis jaringan VPC. Parameter ini berlaku ketika InstanceNetworkType ditetapkan ke vpc. Nilainya dapat berupa 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 dapat berupa 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 ditetapkan ke vpc. Nilainya dapat berupa 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 keluar digunakan sebagai batas atas bandwidth dan tidak dijamin. Ketika terjadi Konflik sumber daya, bandwidth puncak mungkin dibatasi. Jika Anda memerlukan bandwidth yang dijamin, gunakan mode pay-by-bandwidth.	PayByTraffic
InstanceName	string	No	Nama instans. Pencarian fuzzy dengan wildcard * 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: berhenti.	Running
LockReason	string	No	Alasan resource terkunci. Nilai valid: financial: terkunci karena pembayaran tertunda. security: terkunci karena alasan keamanan. Recycling: spot instans menunggu rilis. dedicatedhostfinancial: instance ECS terkunci karena host khusus memiliki pembayaran tertunda. refunded: terkunci karena pengembalian dana.	security
Filter.1.Key	string	No	Kunci filter yang digunakan untuk mengkueri resource. Tetapkan nilai ke `CreationStartTime`. Tetapkan `Filter.1.Key` dan `Filter.1.Value` untuk mengkueri resource yang dibuat setelah titik waktu tertentu.	CreationStartTime
Filter.2.Key	string	No	Kunci filter yang digunakan untuk mengkueri resource. Tetapkan nilai ke `CreationEndTime`. Tetapkan `Filter.2.Key` dan `Filter.2.Value` untuk mengkueri resource yang dibuat sebelum titik waktu tertentu.	CreationEndTime
Filter.3.Key	string	No	Kunci filter yang digunakan untuk mengkueri resource. Tetapkan nilai ke `ExpiredStartTime`. Tetapkan `Filter.3.Key` dan `Filter.3.Value` untuk mengkueri resource yang kedaluwarsa setelah titik waktu tertentu.	ExpiredStartTime
Filter.4.Key	string	No	Kunci filter yang digunakan untuk mengkueri resource. Tetapkan nilai ke `ExpiredEndTime`. Tetapkan `Filter.4.Key` dan `Filter.4.Value` untuk mengkueri resource yang kedaluwarsa sebelum titik waktu tertentu.	ExpiredEndTime
Filter.1.Value	string	No	Nilai filter 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` di UTC+0.	2017-12-05T22:40Z
Filter.2.Value	string	No	Nilai filter 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` di UTC+0.	2017-12-06T22:40Z
Filter.3.Value	string	No	Nilai filter 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` di UTC+0.	2017-12-07T22:40Z
Filter.4.Value	string	No	Nilai filter 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` di UTC+0.	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	Family instans.	ecs.g5
KeyPairName	string	No	Nama pasangan kunci SSH yang digunakan oleh 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 Memfilter 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 RAM yang tidak diotorisasi, dan nilai parameter yang hilang. Jika permintaan gagal dalam dry run, Paket 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 dijalankan. Nilai default: false.	false
HttpEndpoint	string	No	Apakah akan mengaktifkan saluran akses untuk metadata instans. Nilai valid: enabled: diaktifkan. disabled: dinonaktifkan. Nilai default: enabled. Catatan Untuk informasi lebih lanjut tentang metadata instans, lihat Ikhtisar metadata instans.	enabled
HttpTokens	string	No	Apakah akan secara paksa menggunakan mode yang diperkuat keamanan (IMDSv2) untuk mengakses metadata instans. Nilai valid: optional: tidak secara paksa menggunakan mode yang diperkuat keamanan. required: secara paksa menggunakan mode yang diperkuat keamanan. Setelah Anda menetapkan nilai ini, mode normal tidak dapat digunakan untuk mengakses metadata instans. Nilai default: optional. Catatan Untuk informasi lebih lanjut tentang mode untuk mengakses metadata instans, lihat Mode akses metadata instans.	optional
HttpPutResponseHopLimit	integer	No	Catatan Parameter ini tidak tersedia secara publik.	0
Ipv6Address	array	No	Alamat IPv6 yang ditetapkan ke antarmuka jaringan.
	string	No	Alamat IPv6 dari antarmuka jaringan. N menunjukkan bahwa Anda dapat menetapkan 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. Catatan Untuk kompatibilitas yang lebih baik, gunakan `Tag.N.Key`.	keyTest
Key	string	No	Kunci tag instans. Nilai valid N: 1 hingga 20. Jika Anda menggunakan satu tag untuk memfilter resource, jumlah resource dengan tag tersebut tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter resource, jumlah resource dengan semua tag yang ditentukan terpasang tidak boleh melebihi 1.000. Jika jumlah resource melebihi 1.000, panggil operasi ListTagResources.	TestKey
Value	string	No	Nilai tag instans. Nilai valid N: 1 hingga 20.	TestValue
value	string	No	Nilai tag. Catatan Untuk kompatibilitas yang lebih baik, gunakan `Tag.N.Value`.	valueTest
AdditionalAttributes	array	No	Daftar atribut tambahan instans.	META_OPTIONS
	string	No	Nilai atribut 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 dari ENI primer. PRIVATE_DNS_OPTIONS: informasi nama domain privat. CPU_OPTIONS_TOPOLOGY_TYPE: tipe topologi CPU instans. CURRENT_OS_NVME_SUPPORTED: apakah sistem operasi saat ini mendukung akses ke cloud disk melalui protokol NVMe. LOGIN_AS_NON_ROOT: apakah instans dikonfigurasi untuk memungkinkan login sebagai pengguna ecs-user.	META_OPTIONS

Elemen respons

Element	Type	Description	Example
	object
NextToken	string	Token kueri yang dikembalikan dalam panggilan ini.	caeba0bbb2be03f84eb48b699f0a4883
PageSize	integer	Jumlah entri per halaman.	10
PageNumber	integer	Nomor halaman.	1
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 halaman, nilai parameter `TotalCount` yang dikembalikan tidak memiliki arti.	1
Instances	object
Instance	array<object>	Array instans.
	array<object>
CreationTime	string	Waktu saat instance dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.	2017-12-10T04:04Z
SerialNumber	string	Nomor seri dari instance.	51d1353b-22bf-4567-a176-8b3e12e4****
Status	string	Status dari instance.	Running
DeploymentSetId	string	ID dari deployment set.	ds-bp67acfmxazb4p****
KeyPairName	string	Nama dari key pair.	testKeyPairName
SaleCycle	string	Catatan Parameter ini tidak digunakan lagi dan tidak lagi mengembalikan data yang bermakna.	month
SpotStrategy	string	Kebijakan bidding dari instance pay-as-you-go. Nilai yang valid: NoSpot: instance pay-as-you-go reguler. SpotWithPriceLimit: instance preemptible dengan harga maksimum per jam yang ditentukan pengguna. SpotAsPriceGo: instance preemptible yang sistemnya secara otomatis melakukan bidding berdasarkan harga pasar saat ini hingga harga pay-as-you-go.	NoSpot
DeviceAvailable	boolean	Menunjukkan apakah data disk dapat dilampirkan ke instance. true: Data disk dapat dilampirkan. false: Data disk tidak dapat dilampirkan.	true
LocalStorageCapacity	integer	Kapasitas penyimpanan lokal yang terlampir pada instance. Unit: GiB.	1000
Description	string	Deskripsi dari instance.	testDescription
SpotDuration	integer	Periode perlindungan dari instance preemptible. Unit: jam. Nilai yang valid: 1: Setelah instance preemptible dibuat, Alibaba Cloud memastikan bahwa instance tidak dilepaskan secara otomatis dalam 1 jam. Setelah periode perlindungan 1 jam berakhir, sistem membandingkan harga bid dengan harga pasar dan memeriksa inventaris sumber daya untuk menentukan apakah akan mempertahankan atau melepaskan instance. 0: Setelah instance preemptible dibuat, Alibaba Cloud tidak memastikan bahwa instance berjalan selama 1 jam. Sistem membandingkan harga bid dengan harga pasar dan memeriksa inventaris sumber daya untuk menentukan apakah akan mempertahankan atau melepaskan instance. Alibaba Cloud mengirim event sistem ECS untuk memberi tahu Anda 5 menit sebelum instance dilepaskan. Instance preemptible ditagih per detik. Kami merekomendasikan Anda untuk menentukan periode perlindungan berdasarkan durasi tugas Anda. Catatan Parameter ini dikembalikan ketika SpotStrategy disetel ke SpotWithPriceLimit atau SpotAsPriceGo.	1
InstanceNetworkType	string	Tipe jaringan dari instance. Nilai yang valid: classic: classic network. vpc: VPC.	vpc
InstanceName	string	Nama dari instance.	InstanceNameTest
OSNameEn	string	Nama bahasa Inggris dari sistem operasi instance.	CentOS 7.4 64 bit
HpcClusterId	string	ID dari cluster HPC tempat instance berada.	hpc-bp67acfmxazb4p****
SpotPriceLimit	number	Harga maksimum per jam dari instance. Maksimum tiga tempat desimal didukung. Parameter ini berlaku ketika SpotStrategy disetel ke SpotWithPriceLimit.	0.98
Memory	integer	Ukuran memori. Unit: MiB.	16384
OSName	string	Nama dari sistem operasi instance.	CentOS 7.4 64 位
DeploymentSetGroupNo	integer	Posisi grup dari instance dalam deployment set saat instance ECS terikat pada deployment set dengan kebijakan dispersed deployment.	1
ImageId	string	ID dari image yang digunakan oleh instance.	m-bp67acfmxazb4p****
VlanId	string	ID VLAN dari instance. Catatan Parameter ini akan tidak digunakan lagi. Untuk meningkatkan kompatibilitas, gunakan parameter lain bila memungkinkan.	10
ClusterId	string	ID dari cluster tempat instance berada. Catatan Parameter ini akan tidak digunakan lagi. Untuk meningkatkan kompatibilitas, gunakan parameter lain bila memungkinkan.	c-bp67acfmxazb4p****
ClockOptions	object
PtpStatus	string
GPUSpec	string	Kategori GPU yang terlampir pada tipe instance.	NVIDIA V100
AutoReleaseTime	string	Waktu auto-release dari instance pay-as-you-go.	2017-12-10T04:04Z
DeletionProtection	boolean	Menunjukkan apakah release protection diaktifkan untuk instance, yang menentukan apakah instance dapat dilepaskan menggunakan konsol atau dengan memanggil operasi DeleteInstance. true: Release protection diaktifkan untuk instance. false: Release protection tidak diaktifkan untuk instance. Catatan Atribut ini hanya berlaku untuk instance pay-as-you-go dan dapat digunakan untuk membatasi hanya operasi rilis manual. Atribut ini tidak berlaku pada operasi rilis yang dilakukan oleh sistem.	false
StoppedMode	string	Menunjukkan apakah instance terus ditagih setelah dihentikan. Nilai yang valid: KeepCharging: Instance terus ditagih setelah dihentikan, dan sumber dayanya dipertahankan. StopCharging: Instance tidak ditagih setelah dihentikan. Setelah instance dihentikan, sumber daya instance, seperti vCPU, memori, dan alamat IP publik, dilepaskan. Apakah instance dapat berhasil dimulai ulang bergantung pada apakah sumber daya masih tersedia di region saat ini. Not-applicable: Fitur No Fees for Stopped Instances tidak didukung untuk instance.	KeepCharging
GPUAmount	integer	Jumlah GPU yang terlampir pada tipe instance.	4
HostName	string	Hostname dari instance.	testHostName
InstanceId	string	ID dari instance.	i-bp67acfmxazb4p****
InternetMaxBandwidthOut	integer	Bandwidth publik keluar maksimum. Unit: Mbit/s.	5
InternetMaxBandwidthIn	integer	Bandwidth publik masuk maksimum. Unit: Mbit/s.	50
InstanceType	string	Tipe instance.	ecs.g5.large
InstanceChargeType	string	Metode penagihan dari instance. Nilai yang valid: PrePaid: berlangganan. PostPaid: pay-as-you-go.	PostPaid
RegionId	string	ID region dari instance.	cn-hangzhou
IoOptimized	boolean	Menunjukkan apakah instance dioptimalkan I/O. true: ya. false: tidak.	true
StartTime	string	Waktu saat instance terakhir dimulai. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.	2017-12-10T04:04Z
Cpu	integer	Jumlah vCPU.	8
LocalStorageAmount	integer	Jumlah local disk yang terlampir pada instance.	2
ExpiredTime	string	Waktu kedaluwarsa. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mmZ. Waktu dalam UTC. Untuk informasi selengkapnya, lihat ISO 8601.	2017-12-10T04:04Z
ResourceGroupId	string	ID dari resource group tempat instance berada.	rg-bp67acfmxazb4p****
InternetChargeType	string	Metode penagihan untuk penggunaan jaringan. Nilai yang valid: PayByBandwidth: pay-by-bandwidth. PayByTraffic: pay-by-traffic.	PayByTraffic
ZoneId	string	ID zona dari instance.	cn-hangzhou-g
Recyclable	boolean	Menunjukkan apakah instance dapat didaur ulang.	false
ISP	string	Catatan Parameter ini dalam pratinjau undangan dan tidak tersedia untuk publik.	null
CreditSpecification	string	Mode performa dari instance burstable. Nilai yang valid: Standard: mode standar. Untuk informasi selengkapnya tentang performa instance, lihat bagian "Performance constraint mode" di Ikhtisar instance burstable. Unlimited: mode unlimited. Untuk informasi selengkapnya tentang performa instance, lihat bagian "Unlimited mode" di Ikhtisar instance burstable.	Standard
InstanceTypeFamily	string	Keluarga instance.	ecs.g5
OSType	string	Tipe sistem operasi dari instance, yang dapat berupa Windows Server atau Linux. Nilai yang valid: windows linux	linux
NetworkInterfaces	object
NetworkInterface	array<object>	Koleksi ENI yang terlampir pada instance.
	array<object>	Koleksi ENI yang terlampir pada instance.
Type	string	Tipe dari ENI. Nilai yang valid: Primary: ENI primer. Secondary: ENI sekunder.	Primary
MacAddress	string	Alamat MAC dari ENI.	00:16:3e:32:b4:**
PrimaryIpAddress	string	Alamat IP private primer dari ENI.	172.17..*
NetworkInterfaceId	string	ID dari ENI.	eni-2zeh9atclduxvf1z****
PrivateIpSets	object
PrivateIpSet	array<object>	Koleksi dari PrivateIpSet.
	object
PrivateIpAddress	string	Alamat IP private dari instance.	172.17..
Primary	boolean	Menunjukkan apakah alamat IP merupakan alamat IP private primer. Nilai yang valid: true: ya. false: tidak.	true
PrivateDnsName	string	Nama DNS private dari instance. Catatan Nama DNS private dalam format tetap hanya dikembalikan ketika `HostnameType` disetel ke `IpBased` atau `InstanceIdBased`.	dnsTestName
Ipv6Sets	object
Ipv6Set	array<object>	Koleksi alamat IPv6 yang ditetapkan ke ENI. Parameter ini hanya dikembalikan ketika `AdditionalAttributes.N` disetel ke `NETWORK_PRIMARY_ENI_IP` dalam permintaan.
	object
Ipv6Address	string	Alamat IPv6 yang ditetapkan ke ENI.	2408:4321:180:1701:94c7:bc38:3bfa:***
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Koleksi prefiks IPv4 yang ditetapkan ke ENI. Parameter ini hanya dikembalikan ketika `AdditionalAttributes.N` disetel ke `NETWORK_PRIMARY_ENI_IP` dalam permintaan.
	object
Ipv4Prefix	string	Prefiks IPv4 yang ditetapkan ke ENI.	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Koleksi prefiks IPv6 yang ditetapkan ke ENI. Parameter ini hanya dikembalikan ketika `AdditionalAttributes.N` disetel ke `NETWORK_PRIMARY_ENI_IP` dalam permintaan.
	object
Ipv6Prefix	string	Prefiks IPv6 yang ditetapkan ke ENI.	2001:1111::::/80
OperationLocks	object
LockReason	array<object>	Alasan mengapa instance dikunci.
	object
LockMsg	string	Deskripsi mengapa instance dikunci.	The specified instance is locked due to financial reason.
LockReason	string	Tipe kunci. Nilai yang valid: financial: Instance dikunci karena pembayaran terlambat. security: Instance dikunci karena alasan keamanan. Recycling: Instance preemptible berada dalam status pending-release. dedicatedhostfinancial: Instance ECS dikunci karena dedicated host memiliki pembayaran terlambat. refunded: Instance dikunci karena pengembalian dana.	Recycling
Tags	object
Tag	array<object>	Koleksi tag dari instance.
	object
TagValue	string	Nilai tag dari instance.	TestValue
TagKey	string	Kunci tag dari instance.	TestKey
RdmaIpAddress	object
IpAddress	array	Daftar alamat IP jaringan RDMA dari instance HPC.
	string	Alamat IP jaringan RDMA dari instance HPC.	10.10.10.102
SecurityGroupIds	object
SecurityGroupId	array	Daftar ID security group tempat instance berada.
	string	ID dari security group.	sg-bp67acfmxazb4p****
PublicIpAddress	object
IpAddress	array	Daftar alamat IP publik dari instance.
	string	Alamat IP publik dari instance.	121.40..
InnerIpAddress	object
IpAddress	array	Daftar alamat IP internal dari instance pada classic network.
	string	Alamat IP internal dari instance pada classic network.	10.170..
VpcAttributes	object	Atribut VPC.
VpcId	string	ID VPC.	vpc-2zeuphj08tt7q3brd****
NatIpAddress	string	Alamat IP dari layanan cloud, yang digunakan untuk komunikasi jaringan antara layanan cloud VPC.	172.17..
VSwitchId	string	ID vSwitch.	vsw-2zeh0r1pabwtg6wcs****
PrivateIpAddress	object
IpAddress	array	Daftar alamat IP private.
	string	Alamat IP private.	172.17..
EipAddress	object	Informasi tentang EIP yang terikat pada instance.
IsSupportUnassociate	boolean	Menunjukkan apakah EIP dapat dilepas.	true
InternetChargeType	string	Metode penagihan dari EIP. PayByBandwidth: pay-by-bandwidth. PayByTraffic: pay-by-traffic.	PayByTraffic
IpAddress	string	EIP.	42.112..
Bandwidth	integer	Bandwidth publik maksimum dari EIP. Unit: Mbit/s.	5
AllocationId	string	ID dari EIP.	eip-2ze88m67qx5z****
HibernationOptions	object	Catatan Parameter ini dalam pratinjau undangan dan tidak tersedia untuk publik.
Configured	boolean	Catatan Parameter ini dalam pratinjau undangan dan tidak tersedia untuk publik.	false
DedicatedHostAttribute	object	Atribut dari dedicated host, termasuk ID (DedicatedHostClusterId) dari cluster dedicated host, ID (DedicatedHostId) dan nama (DedicatedHostName) dari dedicated host.
DedicatedHostId	string	ID dari dedicated host.	dh-bp67acfmxazb4p****
DedicatedHostName	string	Nama dari dedicated host.	testDedicatedHostName
DedicatedHostClusterId	string	ID dari cluster dedicated host.	dc-bp67acfmxazb4h****
EcsCapacityReservationAttr	object	Parameter capacity reservation dari instance ECS.
CapacityReservationPreference	string	Preferensi capacity reservation.	cr-bp67acfmxazb4p****
CapacityReservationId	string	ID capacity reservation.	cr-bp67acfmxazb4p****
DedicatedInstanceAttribute	object	Atribut dari instance pada dedicated host.
Affinity	string	Menunjukkan apakah instance pada dedicated host terkait dengan dedicated host. Nilai yang valid: default: Instance pada dedicated host tidak terkait dengan dedicated host. Jika instance dengan No Fees for Stopped Instances yang diaktifkan dimulai ulang, instance mungkin ditempatkan pada dedicated host lain dalam pool sumber daya automatic deployment. host: Instance pada dedicated host terkait dengan dedicated host. Jika instance dengan No Fees for Stopped Instances yang diaktifkan dimulai ulang, instance tetap ditempatkan pada dedicated host asli.	default
Tenancy	string	Menunjukkan apakah tipe host dari instance merupakan dedicated host. Nilai yang valid: default: Tipe host dari instance bukan dedicated host. host: Tipe host dari instance adalah dedicated host.	default
CpuOptions	object	Detail konfigurasi CPU.
Numa	string	Catatan Parameter ini tidak digunakan lagi.	null
CoreCount	integer	Jumlah core CPU fisik.	2
ThreadsPerCore	integer	Jumlah thread CPU.	2
TopologyType	string	Tipe topologi CPU dari instance. Nilai yang valid: Mode HT discrete: ContinuousCoreToHTMapping Mode HT continuous: DiscreteCoreToHTMapping	DiscreteCoreToHTMapping
EnableVISST	boolean
TurboMode	string
EnableVRDT	boolean
NestedVirtualization	string	Apakah nested virtualization diaktifkan	enabled
MetadataOptions	object	Koleksi opsi metadata.
HttpEndpoint	string	Menunjukkan apakah saluran akses untuk metadata instance diaktifkan. Nilai yang valid: enabled disabled	enabled
HttpPutResponseHopLimit	integer	Catatan Parameter ini tidak tersedia untuk publik.	0
HttpTokens	string	Menunjukkan apakah mode security-enhanced (IMDSv2) secara paksa digunakan untuk mengakses metadata instance. Nilai yang valid: optional: Mode security-enhanced (IMDSv2) tidak secara paksa digunakan. required: Mode security-enhanced (IMDSv2) secara paksa digunakan.	optional
InstanceMetadataTags	string
ImageOptions	object	Atribut yang terkait image.
LoginAsNonRoot	boolean	Menunjukkan apakah instance yang menggunakan image mendukung login sebagai pengguna ecs-user. Nilai yang valid: true: ya. false: tidak.	false
CurrentOSNVMeSupported	boolean	Menunjukkan apakah sistem operasi saat ini mendukung akses disk melalui protokol NVMe. Nilai yang valid: true: ya. false: tidak. Catatan Parameter ini hanya dikembalikan ketika AdditionalAttributes dalam permintaan menyertakan CURRENT_OS_NVME_SUPPORTED.	true
SpotInterruptionBehavior	string	Mode interupsi dari instance preemptible saat platform memulai interupsi instance preemptible. Nilai yang valid: Terminate: Instance dilepaskan. Stop: Fitur No Fees for Stopped Instances diaktifkan.	Terminate
PrivateDnsNameOptions	object	Koleksi konfigurasi nama DNS private dari instance. Untuk informasi selengkapnya tentang resolusi nama DNS private, lihat Resolusi nama DNS private ECS. Catatan Parameter ini hanya dikembalikan ketika `AdditionalAttributes` dalam permintaan menyertakan `PRIVATE_DNS_OPTIONS`.
EnableInstanceIdDnsARecord	boolean	Menunjukkan apakah mengaktifkan atau menonaktifkan resolusi nama DNS berbasis ID instance ke alamat IPv4. Nilai yang valid: true: mengaktifkan resolusi. false: menonaktifkan resolusi. Nilai default: false.	false
EnableInstanceIdDnsAAAARecord	boolean	Menunjukkan apakah mengaktifkan atau menonaktifkan resolusi nama DNS berbasis ID instance ke alamat IPv6. Nilai yang valid: true: mengaktifkan resolusi. false: menonaktifkan resolusi. Nilai default: false.	false
EnableIpDnsARecord	boolean	Menunjukkan apakah mengaktifkan atau menonaktifkan resolusi nama DNS berbasis IP ke alamat IPv4. Nilai yang valid: true: mengaktifkan resolusi. false: menonaktifkan resolusi. Nilai default: false.	true
EnableIpDnsPtrRecord	boolean	Menunjukkan apakah mengaktifkan atau menonaktifkan resolusi nama DNS IPv4-ke-berbasis-IP. Nilai yang valid: true: mengaktifkan resolusi. false: menonaktifkan resolusi. Nilai default: false.	true
HostnameType	string	Tipe hostname. Nilai yang valid: Custom: kustom. IpBased: hostname berbasis IP. InstanceIdBased: hostname berbasis ID instance. Nilai default: Custom.	Custom
AdditionalInfo	object	Catatan Parameter ini dalam pratinjau undangan dan tidak tersedia untuk digunakan.
EnableHighDensityMode	boolean	Catatan Parameter ini dalam pratinjau undangan dan tidak tersedia untuk digunakan.	true
NodeSerialNumber	string
EnableNVS	boolean

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.