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 dengan 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. Dalam kasus ini, node dihentikan secara langsung dan otomatis dihapus dari Konsol Container Service.
Jika kelompok node memiliki jumlah node yang diinginkan yang dikonfigurasi, kelompok node secara otomatis melakukan skala keluar instans lain berdasarkan konfigurasi yang sesuai untuk mempertahankan jumlah node pada angka yang diinginkan.
Menghapus node melibatkan migrasi Pod, yang dapat memengaruhi layanan Anda. Lakukan operasi ini selama jam di luar puncak. 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.
Periksa aturan afinitas node dan kebijakan penjadwalan Pod pada node yang akan dihapus untuk memastikan bahwa Pod tidak menjadi tidak 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 tepi. `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 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 sehat.	3
initial_nodes	integer	Jumlah node yang sedang dibuat.	0
failed_nodes	integer	Jumlah instans 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 untuk 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 dari 1.24 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 Anda yang ada.	10
min_instances	integer	Jumlah minimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans Anda yang ada.	2
eip_internet_charge_type	string	Tipe penagihan EIP. Nilai valid: `PayByBandwidth`: bayar per bandwidth. `PayByTraffic`: bayar per 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 pada 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 terdapat sejumlah besar node abnormal dalam kelompok node, parameter ini menentukan jumlah atau persentase maksimum 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 status 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 harus menetapkan parameter ini atau `surge_percentage`.	5
surge_percentage	integer	Persentase node tambahan. Anda harus menetapkan parameter ini atau `surge`. Jumlah node tambahan = Persentase node tambahan × Jumlah node. Misalnya, jika persentase node tambahan ditetapkan 50% dan terdapat 6 node yang ada, jumlah node tambahan = 50% × 6, yang berarti 3 node tambahan dibuat.	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 penyembuhan 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. Saat setiap node dibuat, sistem mencoba membeli instans dimulai dari spesifikasi pertama hingga pembuatan berhasil. Tipe instans aktual yang 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 node pool. 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 wajib diisi jika `instance_charge_type` diatur ke `PrePaid`. Nilai valid: `Month`: unit komputasi (CU) adalah bulan. `Week`: unit komputasi (CU) adalah minggu.	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 menetapkan rentang harga berbeda untuk tipe instans berbeda.
instance_type	string	Tipe spot instans.	ecs.c6.large
price_limit	string	Batas 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 yang dioptimalkan untuk kontainer Alinux3.	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. Ketika 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 berlaku 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`. Saat kelompok node adalah 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 berisi 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 saat 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	Apakah akan mengaktifkan 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 jaringan untuk alamat IP publik node. PayByBandwidth: ditagih berdasarkan bandwidth tetap. PayByTraffic: ditagih berdasarkan penggunaan trafik.	PayByBandwidth
internet_max_bandwidth_out	integer	Bandwidth keluar maksimum untuk alamat IP publik node, dalam Mbps (Mega bit per detik). Nilai valid: 1 hingga 100.	10
tags	array	Tag 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`: Melakukan penskalaan berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Saat 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. Saat konfigurasi penskalaan menetapkan metode penagihan sebagai preemptible untuk beberapa tipe instans, spot instans dibuat terlebih dahulu. Anda dapat menggunakan parameter `CompensateWithOnDemand` untuk menentukan apakah akan secara otomatis mencoba membuat instans pay-as-you-go saat spot instans tidak dapat dibuat karena persediaan tidak mencukupi. Catatan `COST_OPTIMIZED` hanya berlaku saat konfigurasi penskalaan menentukan beberapa tipe instans atau menggunakan spot instans. `BALANCE`: Mendistribusikan Instans ECS secara merata di seluruh beberapa zona 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`: Jenis Penyimpanan Standar. Melakukan penskalaan dengan membuat dan merilis Instans ECS berdasarkan penggunaan sumber daya. `recycle`: Mode cepat. Melakukan penskalaan dengan membuat, menghentikan, dan memulai instans, yang meningkatkan kecepatan operasi penskalaan berikutnya. (Sumber daya komputasi tidak dikenakan biaya selama status berhenti. Hanya biaya penyimpanan yang dikenakan, kecuali untuk tipe instans disk lokal.)	rilis
on_demand_base_capacity	integer	Jumlah minimum instans pay-as-you-go yang diperlukan dalam grup penskalaan. Nilai valid: [0,1000]. Saat 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 yang melebihi jumlah minimum instans pay-as-you-go (`on_demand_base_capacity`). Nilai valid: [0,100].	20
spot_instance_pools	integer	Jumlah tipe instans yang tersedia. Grup penskalaan membuat spot instans secara seimbang di seluruh tipe instans dengan biaya terendah. Nilai valid: [1,10].	5
spot_instance_remedy	boolean	Apakah akan mengaktifkan penambahan spot instans. Saat diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan direklaim. Nilai valid: `true`: Mengaktifkan penambahan spot instans. `false`: Tidak mengaktifkan penambahan spot instans.	false
compensate_with_on_demand	boolean	Saat `multi_az_policy` diatur ke `COST_OPTIMIZED`, tentukan apakah akan mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi persyaratan jumlah Instans ECS saat 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 saat kelompok node menggunakan tipe instans. Saat diaktifkan, jumlah total disk sistem dan disk data tidak melebihi batas 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 terbuka. Jika tidak ada kapasitas kolam pribadi yang cocok, sumber daya kolam publik digunakan untuk peluncuran. `Target`: Mode tertentu. Menggunakan kapasitas kolam pribadi tertentu untuk meluncurkan instans. Jika kapasitas kolam pribadi tertentu tidak tersedia, instans gagal diluncurkan. `None`: Tidak menggunakan kapasitas kolam pribadi untuk peluncuran instans.	Open
security_group_id	string	[Deprecated] ID grup keamanan kelompok node. Saat 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: kolam pribadi terlebih dahulu. 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 disk sistem.	sp-0jl6xnmme8v7o935****
cpu_options	object	Opsi konfigurasi CPU.
nested_virtualization	string	Apakah akan mengaktifkan virtualisasi bertingkat. Nilai valid: disabled: Virtualisasi bertingkat dinonaktifkan. enabled: Virtualisasi bertingkat 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 bersama 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 sandboxed 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 runtime 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 dijalankan setelah inisialisasi node. Untuk informasi lebih lanjut, lihat Generate instance user data.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
unschedulable	boolean	Apakah node yang diskalakan 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 dijalankan 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 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 pembelian kelompok node edge yang ditingkatkan. Unit: bulan.	1
max_nodes	integer	Jumlah maksimum node yang diizinkan dalam kelompok node tepi. Parameter ini menentukan jumlah maksimum node yang dapat ditampung oleh kelompok node dan harus lebih besar dari atau sama dengan 0. Nilai 0 menunjukkan tidak ada batas tambahan (hanya dibatasi oleh jumlah total node yang dapat ditampung kluster, tanpa batas tambahan pada kelompok node itu sendiri). Parameter ini biasanya lebih besar dari 0 untuk kelompok node tepi. Untuk kelompok node tipe ess dan kelompok node tipe tepi default, parameter ini adalah 0.	10
interconnect_mode	string	Jenis jaringan node pool edge. Parameter ini hanya berlaku untuk node pool dengan `type` berupa `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	Indikator 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": [
          "EESSD云盘"
        ],
        "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": "release",
        "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.