DescribeClusterNodePools - Container Service for Kubernetes

Mengkueri daftar semua kelompok node dalam sebuah kluster.

Deskripsi operasi

Saat menghapus node, lakukan operasi standar melalui API ini atau Konsol Container Service. Jangan hapus node secara manual menggunakan kubectl delete node.
Jangan rilis node secara langsung, hapus instans di Konsol ECS atau ESS (atau melalui API terkait), atau biarkan node dilepaskan secara pasif karena instance kedaluwarsa langganan. Dalam kasus ini, node akan dihentikan secara langsung dan dihapus otomatis dari Konsol Container Service.
Jika kelompok node memiliki jumlah node yang diinginkan yang dikonfigurasi, kelompok node akan melakukan skala keluar otomatis pada instans lain berdasarkan konfigurasi yang sesuai untuk mempertahankan jumlah node pada angka yang diinginkan.
Penghapusan node melibatkan migrasi Pod, yang dapat memengaruhi layanan Anda. Lakukan operasi ini di luar jam sibuk. Risiko tak terduga dapat terjadi selama operasi. Cadangkan data terkait sebelumnya.
Saat menghapus node, ACK menjalankan operasi drain. Pastikan node lain dalam kluster memiliki sumber daya yang cukup untuk menghindari pod aplikasi tidak dapat dijadwalkan untuk penjadwalan.
Periksa aturan afinitas node dan kebijakan penjadwalan Pod pada node yang akan dihapus untuk memastikan bahwa Pod dapat dijadwalkan pada node lain setelah node dihapus.

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

cs:DescribeClusterNodePools

get

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

None

Sintaks permintaan

GET /clusters/{ClusterId}/nodepools HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster.	cc0f87de0b8fb403f86e10e204f83****

Parameter permintaan

Parameter	Type	Required	Description	Example
NodepoolName	string	No	Nama kelompok node.	nodepool-test

Elemen respons

Element	Type	Description	Example
	object	Detail kelompok node.
nodepools	array<object>	Daftar instans kelompok node.
	array<object>	Detail instans kelompok node.
nodepool_info	object	Informasi kelompok node.
nodepool_id	string	ID kelompok node.	np615c0e0966124216a0412e10afe0****
name	string	Nama kelompok node.	default-nodepool
type	string	Tipe kelompok node. Nilai valid: `ess`: kelompok node standar (termasuk fitur terkelola dan skalabilitas elastis). `edge`: kelompok node edge. `lingjun`: kelompok node Lingjun.	ess
is_default	boolean	Menunjukkan apakah ini adalah kelompok node default. Sebuah kluster biasanya hanya memiliki satu kelompok node default. Nilai valid: `true`: Kelompok node default. `false`: Kelompok node non-default.	true
resource_group_id	string	ID kelompok sumber daya.	rg-acfmyvw3wjm****
region_id	string	ID wilayah.	cn-beijing
created	string	Pengatur waktu ketika kelompok node dibuat.	2025-04-15T16:33:29.362888807+08:00
updated	string	Pengatur waktu ketika kelompok node terakhir kali diperbarui.	2025-04-15T16:33:32.823+08:00
status	object	Status kelompok node.
state	string	Status kelompok node. Nilai valid: `active`: Diaktifkan. `scaling`: Sedang melakukan penskalaan. `removing`: Node sedang dihapus. `deleting`: Sedang dihapus. `updating`: Sedang diperbarui.	active
healthy_nodes	integer	Jumlah instans yang sehat.	3
initial_nodes	integer	Jumlah node yang sedang dibuat.	0
failed_nodes	integer	Jumlah instans yang gagal.	0
offline_nodes	integer	Jumlah node offline.	0
removing_nodes	integer	Jumlah node yang sedang dihapus.	0
serving_nodes	integer	Jumlah node dalam status melayani.	3
total_nodes	integer	Jumlah total node dalam kelompok node.	3
auto_scaling	object	Konfigurasi penskalaan otomatis.
enable	boolean	Apakah akan mengaktifkan skalabilitas elastis. Nilai valid: `true`: Mengaktifkan fitur skalabilitas elastis kelompok node. Ketika perencanaan kapasitas kluster tidak dapat memenuhi persyaratan penjadwalan pod aplikasi, ACK secara otomatis menskalakan Sumber daya node berdasarkan jumlah instans minimum dan maksimum yang dikonfigurasi. Kluster versi 1.24 atau lebih baru menggunakan penskalaan node instan secara default. Kluster versi sebelumnya menggunakan penskalaan otomatis node secara default. Untuk informasi selengkapnya, lihat Penskalaan node. `false`: Menonaktifkan skalabilitas elastis. ACK menyesuaikan jumlah node dalam kelompok node berdasarkan jumlah node yang diinginkan yang dikonfigurasi dan mempertahankan jumlah node pada nilai yang diinginkan. Ketika parameter ini diatur ke false, parameter konfigurasi lain dalam `auto_scaling` tidak berlaku.	true
type	string	Tipe penskalaan otomatis, dikategorikan berdasarkan tipe instans. Nilai valid: `cpu`: tipe instans standar. `gpu`: tipe instans GPU. `gpushare`: tipe berbagi GPU. `spot`: tipe spot instans.	cpu
max_instances	integer	Jumlah maksimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada.	10
min_instances	integer	Jumlah minimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada.	2
eip_internet_charge_type	string	Tipe penagihan EIP. Nilai valid: `PayByBandwidth`: bayar berdasarkan bandwidth. `PayByTraffic`: bayar berdasarkan trafik.	PayByBandwidth
is_bond_eip	boolean	Apakah akan mengasosiasikan EIP. Nilai valid: `true`: Asosiasikan EIP. `false`: Jangan asosiasikan EIP.	true
eip_bandwidth	integer	Bandwidth puncak EIP. Nilai valid: [1,100]. Unit: Mbit/s.	5
management	object	Konfigurasi kelompok node terkelola. Konfigurasi ini hanya berlaku untuk kluster terkelola profesional.
enable	boolean	Apakah akan mengaktifkan kelompok node terkelola. Nilai valid: `true`: Aktifkan kelompok node terkelola. `false`: Nonaktifkan kelompok node terkelola. Konfigurasi terkait lainnya hanya berlaku ketika `enable=true`.	true
auto_repair	boolean	Apakah akan mengaktifkan perbaikan otomatis. Parameter ini hanya berlaku ketika `enable=true`. `true`: Aktifkan perbaikan otomatis. `false`: Nonaktifkan perbaikan otomatis.	true
auto_repair_policy	object	Kebijakan node perbaikan otomatis.
restart_node	boolean	Apakah akan mengizinkan restart node. Parameter ini hanya berlaku ketika `auto_repair=true`. `true`: Izinkan restart node. `false`: Jangan izinkan restart node.	true
approval_required	boolean	Menunjukkan apakah persetujuan manual diperlukan untuk perbaikan node.	false
auto_repair_policy_id	string	ID kebijakan perbaikan otomatis.	r-xxxxxxxxx
max_parallel_repairing_nodes	string	Jumlah maksimum perbaikan paralel. Ketika sejumlah besar node abnormal ada dalam kelompok node, ini menentukan jumlah maksimum atau persentase node yang dapat diperbaiki secara bersamaan.	1
max_unhealthy_nodes_threshold	string	Kondisi pemutus sirkuit penyembuhan mandiri. Ketika jumlah atau persentase node rusak melebihi ambang batas ini, penyembuhan mandiri memasuki keadaan pemutus sirkuit dan berhenti memulai tindakan perbaikan baru.	10%
auto_vul_fix	boolean	Apakah akan memperbaiki CVE secara otomatis. Parameter ini hanya berlaku ketika `enable=true`. `true`: Izinkan perbaikan CVE otomatis. `false`: Jangan izinkan perbaikan CVE otomatis.	true
auto_vul_fix_policy	object	Kebijakan perbaikan CVE otomatis.
restart_node	boolean	Apakah akan mengizinkan restart node. Parameter ini hanya berlaku jika `auto_vul_fix=true`. Nilai valid: `true`: Restart node diizinkan. `false`: Restart node tidak diizinkan.	true
vul_level	string	Tingkat kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan dengan koma. Nilai valid: `asap`: tinggi `later`: Menengah `nntf`: rendah	asap,nntf
exclude_packages	string	Paket yang dikecualikan selama perbaikan kerentanan.	kernel
auto_upgrade	boolean	Apakah akan mengaktifkan peningkatan otomatis untuk node. Parameter ini hanya berlaku jika `enable=true`. Nilai valid: `true`: Peningkatan otomatis diaktifkan. `false`: Peningkatan otomatis tidak diaktifkan.	true
auto_upgrade_policy	object	Kebijakan peningkatan otomatis.
auto_upgrade_kubelet	boolean	Apakah akan mengizinkan peningkatan otomatis kubelet. Parameter ini hanya berlaku jika `auto_upgrade=true`. Nilai valid: `true`: Peningkatan otomatis kubelet diizinkan. `false`: Peningkatan otomatis kubelet tidak diizinkan.	true
upgrade_config	object	Konfigurasi peningkatan otomatis. Parameter ini hanya berlaku jika `enable=true`.
auto_upgrade	boolean	Apakah akan mengaktifkan peningkatan otomatis. Nilai valid: `true`: Peningkatan otomatis diaktifkan. `false`: Peningkatan otomatis tidak diaktifkan.	true
surge	integer	Jumlah node tambahan. Anda dapat mengatur parameter ini atau `surge_percentage`.	5
surge_percentage	integer	Persentase node tambahan. Anda dapat mengatur parameter ini atau `surge`. Jumlah node tambahan = Persentase node tambahan × Jumlah node. Misalnya, jika persentase node tambahan diatur ke 50% dan terdapat 6 node yang ada, jumlah node tambahan = 50% × 6 = 3.	50
max_unavailable	integer	Jumlah maksimum node yang tidak tersedia. Nilai valid: [1,1000]. Nilai default: 1.	1
auto_fault_diagnosis	boolean	Apakah akan mengaktifkan deteksi fault ECS untuk pemulihan mandiri node.
drift_enabled	boolean	Apakah akan mengaktifkan rotasi node. Hanya kelompok node yang dikelola secara cerdas yang mendukung fitur ini, dan fitur ini diaktifkan secara default. Kelompok node umum tidak mendukung fitur ini.
scaling_group	object	Konfigurasi grup penskalaan kelompok node.
scaling_group_id	string	ID grup penskalaan.	asg-2ze8n5qw4atggut8****
vswitch_ids	array	Daftar ID vSwitch.
	string	ID vSwitch.	vsw-2ze3ds0mdip0hdz8i****
instance_types	array	Daftar tipe instans node. Anda dapat memilih beberapa tipe instans sebagai alternatif. Selama pembuatan node, sistem mencoba membeli instans dimulai dari spesifikasi pertama hingga berhasil. Tipe instans yang sebenarnya dibeli dapat bervariasi tergantung pada ketersediaan inventaris.	ecs.n4.large
	string	Tipe instans node.	ecs.n4.large
instance_charge_type	string	Metode penagihan node dalam kelompok node. Nilai valid: `PrePaid`: langganan. `PostPaid`: bayar sesuai pemakaian.	PostPaid
period	integer	Durasi langganan node. Parameter ini berlaku dan wajib diisi hanya jika `instance_charge_type` diatur ke `PrePaid`. Jika `period_unit=Week`, nilai valid `period`: {1, 2, 3, 4}. Jika `period_unit=Month`, nilai valid `period`: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.	1
period_unit	string	Epoch penagihan node. Parameter ini harus ditentukan jika `instance_charge_type` diatur ke `PrePaid`. Nilai valid: `Month`: ditagih bulanan sebagai unit komputasi (CU). `Week`: ditagih mingguan sebagai unit komputasi (CU).	Month
auto_renew	boolean	Apakah akan mengaktifkan perpanjangan otomatis untuk node. Parameter ini hanya berlaku jika `instance_charge_type` diatur ke `PrePaid`. Nilai valid: `true`: Perpanjangan otomatis diaktifkan. `false`: Perpanjangan otomatis tidak diaktifkan.	false
auto_renew_period	integer	Durasi setiap siklus perpanjangan otomatis. Nilai valid: PeriodUnit=Week: 1, 2, 3. PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 60.	0
spot_strategy	string	Tipe spot instans. Nilai valid: NoSpot: non-spot instans. SpotWithPriceLimit: spot instans dengan batas harga. SpotAsPriceGo: sistem secara otomatis menawar pada harga pasar saat ini. Untuk informasi lebih lanjut, lihat Spot instans.	NoSpot
spot_price_limit	array<object>	Konfigurasi rentang harga untuk spot instans.
	object	Konfigurasi rentang harga untuk spot instans. Anda dapat mengatur rentang harga yang berbeda untuk tipe instans yang berbeda.
instance_type	string	Tipe spot instans.	ecs.c6.large
price_limit	string	Rentang harga untuk satu instans. Unit: USD/jam.	0.39
image_type	string	Tipe image sistem operasi. Nilai valid: `AliyunLinux`: Image Alinux2. `AliyunLinuxSecurity`: Image UEFI Alinux2. `AliyunLinux3`: Image Alinux3. `AliyunLinux3Arm64`: Image ARM Alinux3. `AliyunLinux3Security`: Image UEFI Alinux3. `CentOS`: Image CentOS. `Windows`: Image Windows. `WindowsCore`: Image WindowsCore. `ContainerOS`: Image yang dioptimalkan untuk kontainer. `AliyunLinux3ContainerOptimized`: Image Alinux3 yang dioptimalkan untuk kontainer.	AliyunLinux3
image_id	string	ID gambar kustom. Anda dapat memanggil `DescribeKubernetesVersionMetadata` untuk mengkueri image yang didukung oleh sistem.	aliyun_3_x64_20G_alibase_20241218.vhd
system_disk_category	string	Tipe cloud disk sistem node. Nilai valid: `cloud_efficiency`: ultra cloud disk. `cloud_ssd`: SSD standar. `cloud_essd`: ESSD. `cloud_auto`: Cloud disk ESSD AutoPL. `cloud_essd_entry`: Cloud disk ESSD Entry.	cloud_efficiency
system_disk_categories	array	Beberapa tipe disk untuk cloud disk sistem. Jika tipe disk dengan prioritas lebih tinggi tidak tersedia, sistem secara otomatis mencoba tipe disk dengan prioritas berikutnya untuk membuat cloud disk sistem.
	string	Tipe cloud disk sistem node. Nilai valid: `cloud_efficiency`: ultra cloud disk. `cloud_ssd`: SSD standar. `cloud_essd`: ESSD. `cloud_auto`: Cloud disk ESSD AutoPL. `cloud_essd_entry`: Cloud disk ESSD Entry.	SSD standar
system_disk_size	integer	Ukuran cloud disk sistem node, dalam GiB. Nilai valid: [20,2048].	120
system_disk_performance_level	string	Tingkat kinerja cloud disk sistem node. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja terkait dengan ukuran cloud disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD. Nilai valid: PL0: kinerja I/O konkuren maksimum sedang dengan latensi baca/tulis yang relatif stabil. PL1: kinerja I/O konkuren maksimum sedang dengan latensi baca/tulis yang relatif stabil. PL2: kinerja I/O konkuren maksimum tinggi dengan latensi baca/tulis yang stabil. PL3: kinerja I/O konkuren maksimum sangat tinggi dengan latensi baca/tulis yang sangat stabil.	PL1
system_disk_encrypted	boolean	Apakah akan mengenkripsi cloud disk sistem. Nilai valid: true: Terenkripsi. false: Tidak terenkripsi.	false
system_disk_kms_key_id	string	ID kunci KMS yang digunakan untuk cloud disk sistem.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	Algoritma enkripsi yang digunakan untuk cloud disk sistem. Nilai valid: aes-256.	aes-256
system_disk_bursting_enabled	boolean	Apakah akan mengaktifkan Burst (lonjakan performa) untuk cloud disk sistem node. Nilai valid: true: Diaktifkan. Saat diaktifkan, cloud disk sementara meningkatkan performa selama tekanan baca/tulis data mendadak dari beban kerja yang berfluktuasi hingga beban kerja stabil. false: Tidak diaktifkan. Parameter ini hanya didukung jika `system_disk_category` diatur ke `cloud_auto`. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.	true
system_disk_provisioned_iops	integer	IOPS baca/tulis yang disediakan untuk cloud disk sistem node. Parameter ini dikonfigurasi ketika tipe disk adalah cloud_auto.	1000
data_disks	array	Konfigurasi cloud disk data node, termasuk tipe dan ukuran.
	data_disk	Konfigurasi cloud disk data node.
disk_init	array	Konfigurasi inisialisasi perangkat blok.
	DiskInit	Konfigurasi DiskInit.
security_group_ids	array	Daftar ID grup keamanan untuk kelompok node.
	string	Daftar ID grup keamanan untuk kelompok node.	sg-2ze1iuk12m2sb4c4****
key_pair	string	Nama pasangan kunci, saling eksklusif dengan `login_password`. Untuk kelompok node terkelola, hanya `key_pair` yang didukung.	pro-nodepool
login_password	string	Kata sandi logon SSH, saling eksklusif dengan `key_pair`. Panjang kata sandi harus 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Untuk tujuan keamanan, kata sandi yang dikembalikan dalam hasil kueri dienkripsi.	******
login_as_non_root	boolean	Apakah Instans ECS yang diskalakan keluar menggunakan pengguna non-root untuk logon. true: Logon sebagai pengguna non-root (ecs-user). false: Logon sebagai pengguna root.	true
cis_enabled `deprecated`	boolean	[Deprecated] Gunakan parameter security_hardening_os sebagai gantinya.	false
soc_enabled	boolean	Apakah akan mengaktifkan penguatan keamanan MLPS 2.0. Anda hanya dapat mengaktifkan fitur ini ketika image sistem adalah Alibaba Cloud Linux 2 atau Alibaba Cloud Linux 3. Alibaba Cloud menyediakan standar Pemeriksaan baseline kepatuhan perlindungan berklasifikasi dan program pemindaian untuk image MLPS 2.0 Level 3 Alibaba Cloud Linux 2 dan Alibaba Cloud Linux 3.	false
security_hardening_os	boolean	Penguatan keamanan OS Alibaba Cloud. Nilai valid: `true`: Mengaktifkan penguatan keamanan OS Alibaba Cloud. `false`: Tidak mengaktifkan penguatan keamanan OS Alibaba Cloud. Nilai default: `false`.	false
internet_charge_type	string	Metode penagihan untuk alamat IP publik node. PayByBandwidth: ditagih berdasarkan bandwidth tetap. PayByTraffic: ditagih berdasarkan penggunaan trafik.	PayByBandwidth
internet_max_bandwidth_out	integer	Bandwidth publik arah keluar maksimum untuk node, dalam Mbps (Mega bit per detik). Nilai valid: 1 hingga 100.	10
tags	array	Label Instans ECS.
	tag	Tag node.	[{\"key\":\"pkg.E2EClient.ClusterId\",\"value\":\"troopers-\"}]
desired_size	integer	Jumlah node yang diinginkan dalam kelompok node.	2
multi_az_policy	string	Kebijakan penskalaan multi-zona untuk Instans ECS dalam grup penskalaan. Nilai valid: `PRIORITY`: Penskalaan berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Ketika Instans ECS tidak dapat dibuat di zona vSwitch dengan prioritas tertinggi, sistem secara otomatis menggunakan vSwitch dengan prioritas berikutnya untuk membuat Instans ECS. `COST_OPTIMIZED`: Mencoba membuat instans sesuai urutan harga satuan vCPU dari terendah ke tertinggi. Ketika konfigurasi penskalaan menetapkan beberapa tipe instans dengan metode penagihan spot, spot instans dibuat terlebih dahulu. Anda dapat menggunakan parameter `CompensateWithOnDemand` untuk menentukan apakah akan secara otomatis mencoba membuat instans pay-as-you-go ketika spot instans tidak dapat dibuat karena persediaan tidak mencukupi. Catatan `COST_OPTIMIZED` hanya berlaku ketika beberapa tipe instans ditentukan dalam konfigurasi penskalaan atau spot instans dipilih. `BALANCE`: Mendistribusikan Instans ECS secara merata di seluruh zona aktif yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena persediaan tidak mencukupi, Anda dapat memanggil operasi API RebalanceInstances untuk menyeimbangkan ulang sumber daya.	COST_OPTIMIZED
scaling_policy	string	Mode grup penskalaan. Nilai valid: `release`: Mode standar. Melakukan penskalaan dengan membuat dan merilis instans ECS berdasarkan penggunaan sumber daya. `recycle`: Mode cepat. Melakukan penskalaan dengan membuat, menghentikan, dan memulai instans untuk meningkatkan kecepatan operasi penskalaan berikutnya. Instans yang dihentikan tidak dikenai biaya untuk sumber daya komputasi, tetapi biaya penyimpanan tetap berlaku. Tipe instans dengan disk lokal dikecualikan.	rilis
on_demand_base_capacity	integer	Jumlah minimum instans pay-as-you-go yang diperlukan dalam grup penskalaan. Nilai valid: [0,1000]. Ketika jumlah instans pay-as-you-go kurang dari nilai ini, instans pay-as-you-go dibuat terlebih dahulu.	0
on_demand_percentage_above_base_capacity	integer	Persentase instans pay-as-you-go di antara instans berlebih setelah jumlah minimum instans pay-as-you-go (`on_demand_base_capacity`) terpenuhi. Nilai valid: [0,100].	20
spot_instance_pools	integer	Jumlah tipe instans yang tersedia. Grup penskalaan membuat spot instans di seluruh tipe instans berbiaya terendah secara seimbang. Nilai valid: [1,10].	5
spot_instance_remedy	boolean	Apakah akan mengaktifkan penggantian spot instans. Ketika diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan direklamasi. Nilai valid: `true`: Mengaktifkan penggantian spot instans. `false`: Tidak mengaktifkan penggantian spot instans.	false
compensate_with_on_demand	boolean	Ketika `multi_az_policy` diatur ke `COST_OPTIMIZED`, tentukan apakah mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi persyaratan jumlah Instans ECS ketika spot instans tidak dapat dibuat karena alasan harga atau persediaan. Nilai valid: `true`: Mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi persyaratan jumlah Instans ECS. `false`: Tidak mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi persyaratan jumlah Instans ECS.	true
enable_high_density_mode	boolean	Apakah akan mengaktifkan mode cloud disk kerapatan tinggi. Ini hanya didukung ketika kelompok node menggunakan tipe instans. Ketika diaktifkan, jumlah total disk sistem dan disk data tidak melebihi jumlah maksimum cloud disk kerapatan tinggi yang didukung oleh tipe instans.	false
deploymentset_id	string	ID set penyebaran.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Jika instans RDS ditentukan, Instans ECS dalam kelompok node kluster secara otomatis ditambahkan ke daftar putih RDS.
	string	Instans RDS.	rm-xxx
private_pool_options	object	Opsi kolam pribadi.
id	string	ID kolam pribadi, yaitu ID jaminan elastisitas atau ID reservasi kapasitas.	eap-bp67acfmxazb4****
match_criteria	string	Opsi kapasitas kolam pribadi untuk peluncuran instans. Setelah jaminan elastisitas atau reservasi kapasitas berlaku, kolam pribadi dihasilkan untuk peluncuran instans. Nilai valid: `Open`: Mode terbuka. Secara otomatis mencocokkan kapasitas kolam pribadi tipe terbuka. Jika tidak ada kapasitas kolam pribadi yang cocok, sumber daya kolam publik digunakan. `Target`: Mode tertentu. Menggunakan kapasitas kolam pribadi tertentu untuk meluncurkan instans. Jika kapasitas kolam pribadi tidak tersedia, peluncuran instans gagal. `None`: Tidak digunakan. Peluncuran instans tidak menggunakan kapasitas kolam pribadi.	Open
security_group_id	string	[Deprecated] ID grup keamanan kelompok node. Ketika kelompok node diasosiasikan dengan beberapa grup keamanan, ini adalah nilai pertama dalam `security_group_ids`.	sg-2ze1iuk12m2sb4c4****
platform	string	[Deprecated] Distribusi sistem operasi. Nilai valid: `CentOS` `AliyunLinux` `Windows` `WindowsCore`	AliyunLinux
ram_policy	string	Bidang ini sudah tidak digunakan lagi. Gunakan ram_role_name sebagai gantinya.	KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
instance_patterns	array	Konfigurasi atribut instans.
	instance_patterns	Atribut instans.
ram_role_name	string	Nama peran RAM worker.	KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
resource_pool_options	object	Kolam sumber daya dan kebijakan kolam sumber daya yang digunakan saat membuat instans.
strategy	string	Kebijakan kolam sumber daya yang digunakan saat membuat instans. Nilai valid: PrivatePoolFirst: prioritas kolam pribadi. PrivatePoolOnly: hanya kolam pribadi. None: tanpa kebijakan kolam sumber daya.	PrivatePoolFirst
private_pool_ids	array	Daftar ID kolam pribadi.
	string	ID kolam pribadi.	eap-bp1c1fohub5jccwi****
system_disk_snapshot_policy_id	string	Kebijakan snapshot cloud disk sistem.	sp-0jl6xnmme8v7o935****
cpu_options	object	Opsi konfigurasi CPU.
nested_virtualization	string	Apakah akan mengaktifkan virtualisasi bersarang. Nilai valid: disabled: Virtualisasi bersarang dinonaktifkan. enabled: Virtualisasi bersarang diaktifkan.	enabled
node_config	object	Konfigurasi node.
kubelet_configuration	kubelet_config	Pengaturan parameter Kubelet.
node_os_config	object	Konfigurasi Sistem Operasi Node.
hugepage	Hugepage	Konfigurasi Hugepage.
kubernetes_config	object	Konfigurasi terkait kluster.
labels	array	Tag node.
	tag	Konfigurasi label.	{}
taints	array	Informasi taint node. Taint dan Toleransi bekerja sama untuk mencegah Pod dijadwalkan ke node yang tidak sesuai. Untuk informasi lebih lanjut, lihat taint-and-toleration.
	taint	Informasi taint node.
runtime	string	Nama runtime kontainer. ACK mendukung tiga runtime kontainer berikut: containerd: Direkomendasikan. Mendukung semua versi kluster. Sandboxed-Container.runv: Kontainer sandbox yang menyediakan isolasi lebih tinggi. Mendukung kluster versi 1.31 dan sebelumnya. docker: Tidak lagi dipelihara. Mendukung kluster versi 1.22 dan sebelumnya.	containerd
runtime_version	string	Versi waktu proses kontainer.	1.6.38
cpu_policy	string	Kebijakan manajemen CPU node. Dua kebijakan berikut didukung untuk kluster versi 1.12.6 dan yang lebih baru: `static`: Memungkinkan Pod dengan karakteristik Sumber daya tertentu pada node diberikan afinitas CPU yang ditingkatkan dan eksklusivitas. `none`: Mengaktifkan skema afinitas CPU default yang ada.	none
user_data	string	Data kustom kelompok node, yaitu skrip yang berjalan setelah inisialisasi node. Untuk informasi lebih lanjut, lihat Generate instance user data.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
unschedulable	boolean	Apakah node yang ditambahkan selama scale-out tidak dapat dijadwalkan. true: Tidak dapat dijadwalkan. false: Dapat dijadwalkan.	true
cms_enabled	boolean	Apakah akan menginstal agen CloudMonitor pada node ECS. Setelah instalasi, Anda dapat melihat tampilan informasi pemantauan Instance ECS yang dibuat di konsol CloudMonitor. Kami menyarankan Anda mengaktifkan fitur ini. Nilai valid: `true`: Menginstal agen CloudMonitor pada node ECS. `false`: Tidak menginstal agen CloudMonitor pada node ECS.	true
node_name_mode	string	Nama node kustom. Nama node terdiri dari tiga bagian: awalan + substring alamat IP node + akhiran: Baik awalan maupun akhiran dapat terdiri dari satu atau beberapa bagian yang dipisahkan oleh ".". Setiap bagian dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama node harus dimulai dan diakhiri dengan huruf kecil atau angka. Panjang segmen alamat IP menentukan jumlah digit yang diekstrak dari akhir alamat IP node. Nilai valid: 5 hingga 12. Sebagai contoh, jika alamat IP node adalah 192.168.0.55, awalan adalah aliyun.com, panjang segmen alamat IP adalah 5, dan akhiran adalah test, maka nama node adalah aliyun.com00055test.	aliyun.com192.XX.YY.55test
pre_user_data	string	Data pra-kustom kelompok node, yaitu skrip yang berjalan sebelum inisialisasi node. Untuk informasi lebih lanjut, lihat Generate instance user data.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
tee_config	object	Konfigurasi komputasi rahasia.
tee_enable	boolean	Apakah akan mengaktifkan komputasi rahasia untuk kluster. Nilai valid: `true`: Diaktifkan. `false`: Tidak diaktifkan.	false
interconnect_config	object	[Deprecated] Konfigurasi jaringan kelompok node pool edge. Nilai ini hanya bermakna kelompok node pool tipe edge.
cen_id	string	[Deprecated] ID instans Cloud Enterprise Network (CEN) yang terikat pada kelompok node edge yang ditingkatkan.	cen-ey9k9nfhz0f*******
ccn_id	string	[Deprecated] ID instans Cloud Connect Network (CCN) yang terikat pada kelompok node edge yang ditingkatkan.	ccn-qm5i0i0q9yi*******
ccn_region_id	string	[Deprecated] Wilayah instans Cloud Connect Network (CCN) yang terikat pada kelompok node edge yang ditingkatkan.	cn-shanghai
bandwidth	integer	[Deprecated] Lebar pita jaringan kelompok node edge yang ditingkatkan. Unit: Mbps.	10
improved_period	string	[Deprecated] Durasi langganan kelompok node edge yang ditingkatkan. Unit: bulan.	1
max_nodes	integer	Jumlah maksimum node yang diizinkan dalam kelompok node edge. Parameter ini menentukan jumlah maksimum node yang dapat dimuat oleh kelompok node dan harus lebih besar dari atau sama dengan 0. Nilai 0 menunjukkan tidak ada batas tambahan (hanya dibatasi oleh kapasitas node kluster secara keseluruhan, tanpa batas tambahan pada kelompok node itu sendiri). Nilai ini biasanya lebih besar dari 0 untuk kelompok node edge. Untuk kelompok node tipe ESS dan kelompok node tipe edge default, nilai ini adalah 0.	10
interconnect_mode	string	Jenis jaringan node pool edge. Parameter ini hanya berlaku untuk node pool yang `type`-nya `edge`. Nilai valid: `basic`: Jaringan publik. Node kelompok node pool cloud berinteraksi dengan node cloud melalui jaringan publik. Aplikasi kelompok node pool cloud tidak dapat mengakses langsung jaringan internal VPC cloud. `private`: Jaringan pribadi. Node kelompok node pool cloud terhubung ke cloud melalui Express Connect, VPN, atau CEN, menyediakan kualitas komunikasi cloud-edge yang lebih tinggi dan keamanan yang lebih efektif.	basic
auto_mode	object	Konfigurasi pengelolaan cerdas.
enable	boolean	Menunjukkan apakah mode pengelolaan cerdas diaktifkan.	true
node_components	array<object>	Daftar komponen node.
	array<object>	Komponen node.
name	string	Nama komponen node.	kubelet
version	string	Versi komponen node.	1.33.3-aliyun.1
config	object	Konfigurasi komponen node.
custom_config	object	Konfigurasi kustom komponen node.	{"cpuManagerPolicy":"static"}
	any	String konfigurasi kustom komponen node.	cpuManagerPolicy
envs	array<object>	Variabel lingkungan komponen node.
	object
name	string	Nama variabel lingkungan.	LOG_LEVEL
value	string	Nilai variabel lingkungan.	info
config_revision	string	Nomor versi konfigurasi kustom komponen node.	1
eflo_node_group	object	Informasi kelompok node Lingjun.
cluster_id	string	ID kluster Lingjun.	i113790071760688002461
group_id	string	ID kelompok Lingjun.	i128147721760688002463
auto_attach_enabled	boolean	Apakah penambahan node otomatis diaktifkan untuk kelompok node Lingjun (tidak efektif).
worker_ram_role_name	string	Peran RAM worker yang digunakan oleh kelompok node Lingjun.

Contoh

Respons sukses

JSONformat

{
  "nodepools": [
    {
      "nodepool_info": {
        "nodepool_id": "np615c0e0966124216a0412e10afe0****",
        "name": "default-nodepool",
        "type": "ess",
        "is_default": true,
        "resource_group_id": "rg-acfmyvw3wjm****",
        "region_id": "cn-beijing",
        "created": "2025-04-15T16:33:29.362888807+08:00",
        "updated": "2025-04-15T16:33:32.823+08:00"
      },
      "status": {
        "state": "active",
        "healthy_nodes": 3,
        "initial_nodes": 0,
        "failed_nodes": 0,
        "offline_nodes": 0,
        "removing_nodes": 0,
        "serving_nodes": 3,
        "total_nodes": 3
      },
      "auto_scaling": {
        "enable": true,
        "type": "cpu",
        "max_instances": 10,
        "min_instances": 2,
        "eip_internet_charge_type": "PayByBandwidth",
        "is_bond_eip": true,
        "eip_bandwidth": 5
      },
      "management": {
        "enable": true,
        "auto_repair": true,
        "auto_repair_policy": {
          "restart_node": true,
          "approval_required": false,
          "auto_repair_policy_id": "r-xxxxxxxxx",
          "max_parallel_repairing_nodes": "1",
          "max_unhealthy_nodes_threshold": "10%"
        },
        "auto_vul_fix": true,
        "auto_vul_fix_policy": {
          "restart_node": true,
          "vul_level": "asap,nntf",
          "exclude_packages": "kernel"
        },
        "auto_upgrade": true,
        "auto_upgrade_policy": {
          "auto_upgrade_kubelet": true
        },
        "upgrade_config": {
          "auto_upgrade": true,
          "surge": 5,
          "surge_percentage": 50,
          "max_unavailable": 1
        },
        "auto_fault_diagnosis": false,
        "drift_enabled": false
      },
      "scaling_group": {
        "scaling_group_id": "asg-2ze8n5qw4atggut8****",
        "vswitch_ids": [
          "vsw-2ze3ds0mdip0hdz8i****"
        ],
        "instance_types": [
          "ecs.n4.large"
        ],
        "instance_charge_type": "PostPaid",
        "period": 1,
        "period_unit": "Month",
        "auto_renew": false,
        "auto_renew_period": 0,
        "spot_strategy": "NoSpot",
        "spot_price_limit": [
          {
            "instance_type": "ecs.c6.large",
            "price_limit": "0.39"
          }
        ],
        "image_type": "AliyunLinux3",
        "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
        "system_disk_category": "cloud_efficiency",
        "system_disk_categories": [
          "SSD standar"
        ],
        "system_disk_size": 120,
        "system_disk_performance_level": "PL1",
        "system_disk_encrypted": false,
        "system_disk_kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "system_disk_encrypt_algorithm": "aes-256",
        "system_disk_bursting_enabled": true,
        "system_disk_provisioned_iops": 1000,
        "data_disks": [
          {
            "category": "cloud_ssd",
            "size": 40,
            "encrypted": "true",
            "kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
            "auto_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
            "performance_level": "PL1",
            "provisioned_iops": 1000,
            "bursting_enabled": true,
            "auto_format": true,
            "file_system": "ext4",
            "mount_target": "/mnt/path1",
            "disk_name": "DataDiskName",
            "device": "/dev/xvdb",
            "snapshot_id": "s-280s7****"
          }
        ],
        "disk_init": [
          {
            "disk_name": "disk0",
            "mkfs_type": "ext4",
            "mount_target": "/mnt/disk0",
            "mount_for_runtime": false,
            "local_disk": false
          }
        ],
        "security_group_ids": [
          "sg-2ze1iuk12m2sb4c4****"
        ],
        "key_pair": "pro-nodepool",
        "login_password": "******",
        "login_as_non_root": true,
        "cis_enabled": false,
        "soc_enabled": false,
        "security_hardening_os": false,
        "internet_charge_type": "PayByBandwidth",
        "internet_max_bandwidth_out": 10,
        "tags": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "desired_size": 2,
        "multi_az_policy": "COST_OPTIMIZED",
        "scaling_policy": "rilis",
        "on_demand_base_capacity": 0,
        "on_demand_percentage_above_base_capacity": 20,
        "spot_instance_pools": 5,
        "spot_instance_remedy": false,
        "compensate_with_on_demand": true,
        "enable_high_density_mode": false,
        "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
        "rds_instances": [
          "rm-xxx"
        ],
        "private_pool_options": {
          "id": "eap-bp67acfmxazb4****",
          "match_criteria": "Open"
        },
        "security_group_id": "sg-2ze1iuk12m2sb4c4****",
        "platform": "AliyunLinux",
        "ram_policy": "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
        "instance_patterns": [
          {
            "cores": 4,
            "memory": 8,
            "instance_family_level": "EnterpriseLevel",
            "excluded_instance_types": [
              "ecs.c6.large"
            ],
            "min_cpu_cores": 4,
            "max_cpu_cores": 8,
            "min_memory_size": 8,
            "max_memory_size": 16,
            "instance_categories": [
              "General-purpose"
            ],
            "cpu_architectures": [
              "X86"
            ],
            "core": 4,
            "max_price": 2,
            "architectures": [
              "X86"
            ],
            "burst_performance_option": "Exclude",
            "instance_type_families": [
              "ecs.c6"
            ],
            "minimum_eni_quantity": 3,
            "minimum_eni_private_ip_address_quantity": 10,
            "minimum_eni_ipv6_address_quantity": 1,
            "maximum_gpu_amount": 8
          }
        ],
        "ram_role_name": "KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****",
        "resource_pool_options": {
          "strategy": "PrivatePoolFirst",
          "private_pool_ids": [
            "eap-bp1c1fohub5jccwi****"
          ]
        },
        "system_disk_snapshot_policy_id": "sp-0jl6xnmme8v7o935****",
        "cpu_options": {
          "nested_virtualization": "enabled"
        }
      },
      "node_config": {
        "kubelet_configuration": {
          "registryPullQPS": 5,
          "registryBurst": 10,
          "eventRecordQPS": 5,
          "eventBurst": 10,
          "kubeAPIQPS": 5,
          "kubeAPIBurst": 10,
          "serializeImagePulls": true,
          "cpuManagerPolicy": "none",
          "evictionHard": {
            "test": "test",
            "test2": 1
          },
          "evictionSoft": {
            "test": "test",
            "test2": 1
          },
          "evictionSoftGracePeriod": {
            "test": "test",
            "test2": 1
          },
          "systemReserved": {
            "test": "test",
            "test2": 1
          },
          "kubeReserved": {
            "test": "test",
            "test2": 1
          },
          "readOnlyPort": 0,
          "maxPods": 110,
          "containerLogMaxSize": "10Mi",
          "containerLogMaxFiles": 5,
          "featureGates": {
            "test": "test",
            "test2": 1
          },
          "allowedUnsafeSysctls": [
            "net.core.somaxconn"
          ],
          "reservedMemory": [
            {
              "numaNode": 0,
              "limits": {
                "memory": "1Gi"
              }
            }
          ],
          "memoryManagerPolicy": "none",
          "cpuCFSQuota": true,
          "cpuCFSQuotaPeriod": "100ms",
          "imageGCHighThresholdPercent": 85,
          "imageGCLowThresholdPercent": 80,
          "podPidsLimit": -1,
          "topologyManagerPolicy": "restricted",
          "clusterDNS": [
            "127.0.xx.xx"
          ],
          "tracing": {
            "endpoint": "localhost:4317",
            "samplingRatePerMillion": 200000
          },
          "containerLogMaxWorkers": 1,
          "containerLogMonitorInterval": "10s",
          "serverTLSBootstrap": true
        },
        "node_os_config": {
          "hugepage": {
            "transparentEnabled": "",
            "transparentDefrag": "",
            "khugepagedDefrag": 0,
            "khugepagedAllocSleepMillisecs": 0,
            "khugepagedScanSleepMillisecs": 0,
            "khugepagedPagesToScan": 0
          }
        }
      },
      "kubernetes_config": {
        "labels": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "taints": [
          {
            "key": "key",
            "value": "value",
            "effect": "NoSchedule"
          }
        ],
        "runtime": "containerd",
        "runtime_version": "1.6.38",
        "cpu_policy": "none",
        "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****",
        "unschedulable": true,
        "cms_enabled": true,
        "node_name_mode": "aliyun.com192.XX.YY.55test",
        "pre_user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD"
      },
      "tee_config": {
        "tee_enable": false
      },
      "interconnect_config": {
        "cen_id": "cen-ey9k9nfhz0f*******",
        "ccn_id": "ccn-qm5i0i0q9yi*******",
        "ccn_region_id": "cn-shanghai",
        "bandwidth": 10,
        "improved_period": "1"
      },
      "max_nodes": 10,
      "interconnect_mode": "basic",
      "auto_mode": {
        "enable": true
      },
      "node_components": [
        {
          "name": "kubelet",
          "version": "1.33.3-aliyun.1",
          "config": {
            "custom_config": {
              "key": "cpuManagerPolicy"
            },
            "envs": [
              {
                "name": "LOG_LEVEL",
                "value": "info"
              }
            ]
          },
          "config_revision": "1"
        }
      ],
      "eflo_node_group": {
        "cluster_id": "i113790071760688002461",
        "group_id": "i128147721760688002463",
        "auto_attach_enabled": false,
        "worker_ram_role_name": ""
      }
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.