DescribeClusterNodePools - Container Service for Kubernetes

Mengkueri semua kelompok node dalam sebuah kluster.

Deskripsi operasi

Saat menghapus node, lakukan operasi terstandarisasi melalui API ini atau Konsol Container Service. Jangan menghapus node secara manual menggunakan kubectl delete node.
Jangan langsung merilis node, menghapus instans, atau membiarkan node dilepaskan secara pasif karena masa berlaku Instans langganan habis di konsol ECS atau ESS (atau melalui API terkait). Dalam kasus tersebut, node akan langsung dihentikan dan otomatis dihapus dari Konsol Container Service.
Jika kelompok node memiliki jumlah node yang diinginkan (desired node count) yang dikonfigurasi, kelompok node akan secara otomatis melakukan skala keluar (scale out) 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 non-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 yang tidak dapat dijadwalkan.
Periksa aturan afinitas node dan kebijakan penjadwalan Pod pada node yang akan dihapus untuk memastikan bahwa Pod tidak menjadi tidak terjadwal setelah penghapusan node.

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 otomatis). `edge`: kelompok node edge. `lingjun`: kelompok node Lingjun.	ess
is_default	boolean	Menunjukkan apakah ini adalah kelompok node default. Biasanya, sebuah kluster 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`: Aktif. `scaling`: Penskalaan. `removing`: Menghapus node. `deleting`: Menghapus. `updating`: Memperbarui.	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 penskalaan otomatis. Nilai valid: `true`: Mengaktifkan fitur penskalaan otomatis untuk kelompok node. Ketika perencanaan kapasitas kluster tidak dapat memenuhi persyaratan penjadwalan Pod, ACK secara otomatis menskalakan Sumber daya node berdasarkan jumlah instans minimum dan maksimum yang dikonfigurasi. Kluster versi 1.24 dan lebih baru menggunakan elastisitas node instan secara default. Kluster sebelum versi 1.24 menggunakan penskalaan otomatis node secara default. Untuk informasi lebih lanjut, lihat Penskalaan node. `false`: Menonaktifkan penskalaan otomatis. ACK menyesuaikan jumlah node dalam kelompok node berdasarkan jumlah node yang diinginkan yang dikonfigurasi untuk mempertahankan jumlah node pada angka yang diinginkan. Ketika nilainya false, parameter konfigurasi lain dalam `auto_scaling` tidak berlaku.	true
type	string	Tipe penskalaan otomatis, dikategorikan berdasarkan tipe instans. Nilai valid: `cpu`: tipe instans reguler. `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 saat ini.	10
min_instances	integer	Jumlah minimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada saat ini.	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`: EIP diasosiasikan. `false`: Tidak ada EIP yang diasosiasikan.	true
eip_bandwidth	integer	Bandwidth puncak EIP. Nilai valid: [1,100]. Unit: Mbps.	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`: Mengaktifkan kelompok node terkelola. `false`: Menonaktifkan kelompok node terkelola. Konfigurasi terkait lainnya hanya berlaku ketika `enable=true`.	true
auto_repair	boolean	Apakah akan mengaktifkan perbaikan otomatis. Hanya berlaku ketika `enable=true`. `true`: Perbaikan otomatis diaktifkan. `false`: Perbaikan otomatis dinonaktifkan.	true
auto_repair_policy	object	Kebijakan perbaikan otomatis node.
restart_node	boolean	Apakah akan mengizinkan restart node. Hanya berlaku ketika `auto_repair=true`. `true`: Restart node diizinkan. `false`: Restart node tidak diizinkan.	true
approval_required	boolean	Apakah persetujuan manual diperlukan untuk perbaikan node.	false
auto_repair_policy_id	string	ID kebijakan perbaikan otomatis.	r-xxxxxxxxx
auto_vul_fix	boolean	Apakah akan mengaktifkan perbaikan CVE otomatis. Hanya berlaku ketika `enable=true`. `true`: Perbaikan CVE otomatis diaktifkan. `false`: Perbaikan CVE otomatis dinonaktifkan.	true
auto_vul_fix_policy	object	Kebijakan perbaikan CVE otomatis.
restart_node	boolean	Apakah akan mengizinkan restart node. Hanya berlaku ketika `auto_vul_fix=true`. Nilai valid: `true`: Restart node diizinkan. `false`: Restart node tidak diizinkan.	true
vul_level	string	Level kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan oleh koma. `asap`: Tinggi `later`: Sedang `nntf`: Rendah	asap,nntf
exclude_packages	string	Paket yang dikecualikan selama perbaikan kerentanan.	kernel
auto_upgrade	boolean	Apakah akan mengaktifkan peningkatan otomatis untuk node. Hanya berlaku ketika `enable=true`. `true`: Peningkatan otomatis diaktifkan. `false`: Peningkatan otomatis dinonaktifkan.	true
auto_upgrade_policy	object	Kebijakan peningkatan otomatis.
auto_upgrade_kubelet	boolean	Apakah akan mengizinkan peningkatan kubelet otomatis. Hanya berlaku ketika `auto_upgrade=true`. Nilai valid: `true`: Peningkatan kubelet otomatis diizinkan. `false`: Peningkatan kubelet otomatis tidak diizinkan.	true
upgrade_config	object	Konfigurasi peningkatan otomatis. Hanya berlaku ketika `enable=true`.
auto_upgrade	boolean	Apakah akan mengaktifkan peningkatan otomatis. Nilai valid: `true`: Peningkatan otomatis diaktifkan. `false`: Peningkatan otomatis dinonaktifkan.	true
surge	integer	Jumlah node tambahan. Saling eksklusif dengan `surge_percentage`.	5
surge_percentage	integer	Persentase node tambahan. Saling eksklusif dengan `surge`. Node tambahan = persentase node tambahan × jumlah node. Misalnya, jika persentase node tambahan adalah 50% dan ada 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 deteksi fault ECS untuk penyembuhan mandiri node diaktifkan.
drift_enabled	boolean
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 akhirnya dibeli dapat bervariasi tergantung pada ketersediaan inventaris.	ecs.n4.large
	string	Tipe instans node.	ecs.n4.large
instance_charge_type	string	Tipe penagihan node dalam kelompok node. Nilai valid: `PrePaid`: langganan. `PostPaid`: bayar sesuai pemakaian.	PostPaid
period	integer	Durasi langganan node. Berlaku dan diperlukan hanya ketika `instance_charge_type` diatur ke `PrePaid`. Ketika `period_unit=Week`, nilai valid `period`: {1, 2, 3, 4}. Ketika `period_unit=Month`, nilai valid `period`: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.	1
period_unit	string	Unit periode langganan. Diperlukan ketika `instance_charge_type` diatur ke `PrePaid`. `Month`: bulan. `Week`: minggu.	Month
auto_renew	boolean	Apakah akan mengaktifkan perpanjangan otomatis untuk node. Hanya berlaku ketika `instance_charge_type` diatur ke `PrePaid`. Nilai valid: `true`: Perpanjangan otomatis diaktifkan. `false`: Perpanjangan otomatis dinonaktifkan.	false
auto_renew_period	integer	Durasi setiap siklus perpanjangan otomatis. Nilai valid: Ketika PeriodUnit=Week: 1, 2, 3. Ketika 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 pasar spot instans.
	object	Konfigurasi rentang harga pasar spot instans. Anda dapat menetapkan rentang harga berbeda untuk tipe instans berbeda.
instance_type	string	Tipe spot instans.	ecs.c6.large
price_limit	string	Rentang harga pasar per instans. Unit: USD/jam.	0.39
image_type	string	Tipe image sistem operasi. `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 Tipe disk sistem node. Nilai valid: `cloud_efficiency`: ultra Tipe disk. `cloud_ssd`: SSD standar. `cloud_essd`: ESSD. `cloud_auto`: Tipe disk ESSD AutoPL. `cloud_essd_entry`: Tipe disk ESSD Entry.	cloud_efficiency
system_disk_categories	array	Beberapa tipe 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 Tipe disk sistem node. Nilai valid: `cloud_efficiency`: ultra Tipe disk. `cloud_ssd`: SSD standar. `cloud_essd`: ESSD. `cloud_auto`: Tipe disk ESSD AutoPL. `cloud_essd_entry`: Tipe disk ESSD Entry.	EESSD云盘
system_disk_size	integer	Ukuran cloud disk sistem node. Unit: GiB. Nilai valid: [20,2048].	120
system_disk_performance_level	string	Tingkat kinerja cloud disk sistem node. Hanya berlaku untuk cloud disk ESSD. Tingkat kinerja berkaitan dengan ukuran disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD. PL0: kinerja I/O konkuren moderat dengan latensi baca/tulis yang relatif stabil. PL1: kinerja I/O konkuren moderat dengan latensi baca/tulis yang relatif stabil. PL2: kinerja I/O konkuren tinggi dengan latensi baca/tulis yang stabil. PL3: kinerja I/O konkuren sangat tinggi dengan latensi baca/tulis yang sangat stabil.	PL1
system_disk_encrypted	boolean	Apakah akan mengenkripsi cloud disk sistem. Nilai valid: true: Dienkripsi. false: Tidak dienkripsi.	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. Ketika diaktifkan, cloud disk sementara meningkatkan performa selama tekanan baca/tulis data mendadak hingga beban kerja stabil. false: Dinonaktifkan. Parameter ini hanya didukung ketika `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. Dikonfigurasi ketika tipe disk adalah cloud_auto.	1000
data_disks	array	Kombinasi tipe, ukuran, dan konfigurasi lain dari cloud disk data node.
	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`. Ketika 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`. Kata sandi logon harus memiliki panjang 8 hingga 30 karakter dan mengandung setidaknya tiga dari tipe karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Untuk tujuan keamanan, kata sandi logon dienkripsi dalam hasil kueri.	******
login_as_non_root	boolean	Apakah Instans ECS yang diskalakan keluar menggunakan logon pengguna non-root. true: Logon sebagai pengguna non-root (ecs-user). false: Logon sebagai pengguna root. [_single.resp.200.props.nodepools.items.scaling_group.cis	true
cis_enabled `deprecated`	boolean	[Usang] Gunakan parameter security_hardening_os sebagai gantinya.	false
soc_enabled	boolean	Apakah akan mengaktifkan penguatan keamanan MLPS 2.0. Penguatan keamanan MLPS 2.0 hanya dapat diaktifkan ketika image sistem adalah Alibaba Cloud Linux 2 atau Alibaba Cloud Linux 3. Alibaba Cloud menyediakan standar pemeriksaan garis dasar kepatuhan perlindungan berlapis dan program pemindaian untuk image MLPS 2.0 Level 3 dari 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`: Penguatan keamanan OS Alibaba Cloud diaktifkan. `false`: Penguatan keamanan OS Alibaba Cloud tidak diaktifkan. Nilai default: `false`.	false
internet_charge_type	string	Metode penagihan untuk alamat IP publik node. PayByBandwidth: ditagih berdasarkan bandwidth tetap. PayByTraffic: ditagih berdasarkan bayar per trafik.	PayByBandwidth
internet_max_bandwidth_out	integer	Bandwidth arah keluar maksimum untuk alamat IP publik node, dalam Mbps (Mega bit per second). 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 untuk Instans ECS dalam grup penskalaan multi-zona. Nilai valid: `PRIORITY`: Melakukan 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 tertinggi berikutnya untuk membuat Instans ECS. `COST_OPTIMIZED`: Mencoba membuat instans berdasarkan urutan harga satuan vCPU dari terendah ke tertinggi. Ketika konfigurasi penskalaan menetapkan metode penagihan spot untuk beberapa tipe instans, spot instans diprioritaskan untuk dibuat. Anda dapat menggunakan parameter `CompensateWithOnDemand` untuk menentukan apakah akan secara otomatis mencoba membuat instans bayar sesuai pemakaian ketika spot instans tidak dapat dibuat karena inventaris tidak mencukupi atau alasan lain. Catatan `COST_OPTIMIZED` hanya berlaku ketika beberapa tipe instans ditetapkan dalam konfigurasi penskalaan atau metode penagihan spot instans dipilih. `BALANCE`: Mendistribusikan Instans ECS secara merata di seluruh zona aktif yang ditentukan untuk grup penskalaan. Jika zona menjadi tidak seimbang karena inventaris tidak	COST_OPTIMIZED
scaling_policy	string	The scaling group mode. Valid values: `release`: Standard mode. Scales by creating and releasing ECS instances based on resource usage. `recycle`: Swift mode. Scales by creating, stopping, and starting ECS instances, which improves the speed of subsequent scaling operations. Compute resources are not charged during the stopped state. Only storage fees are charged, except for instances with local disks.	release
on_demand_base_capacity	integer	The minimum number of pay-as-you-go instances required in the scaling group. Valid values: [0,1000]. When the number of pay-as-you-go instances is less than this value, pay-as-you-go instances are preferentially created.	0
on_demand_percentage_above_base_capacity	integer	The percentage of pay-as-you-go instances among the extra instances that exceed the minimum number of pay-as-you-go instances (`on_demand_base_capacity`) required in the scaling group. Valid values: [0,100].	20
spot_instance_pools	integer	The number of available instance types. The scaling group creates spot instances across multiple types at the lowest cost. Valid values: [1,10].	5
spot_instance_remedy	boolean	Specifies whether to enable supplementing spot instances. When enabled, the scaling group attempts to create new instances to replace spot instances that are about to be reclaimed upon receiving a system notification. Valid values: `true`: Enables supplementing spot instances. `false`: Disables supplementing spot instances.	false
compensate_with_on_demand	boolean	When `multi_az_policy` is set to `COST_OPTIMIZED`, specifies whether to allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances when spot instances cannot be created due to cost or inventory reasons. Valid values: `true`: Allows automatic creation of pay-as-you-go instances to meet the required number of ECS instances. `false`: Does not allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances.	true
deploymentset_id	string	The deployment set ID.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	If an RDS instance list is specified, the ECS instances of the cluster nodes are automatically added to the RDS access whitelist.
	string	The ApsaraDB RDS instance.	rm-xxx
private_pool_options	object	The private pool options.
id	string	The private pool ID, which is the ID of the elasticity assurance or capacity reservation.	eap-bp67acfmxazb4****
match_criteria	string	The private node pool type, which specifies the capacity option for the private pool used when launching instances. After an elasticity assurance or capacity reservation takes effect, a private pool is generated for instance launch. Valid values: `Open`: Open mode. Automatically matches open-type private pool capacity. If no matching private pool capacity is available, public pool resources are used for launch. `Target`: Targeted mode. Uses the specified private pool capacity to launch instances. If the specified private pool capacity is unavailable, the instance launch fails. `None`: No private pool mode. Instance launch does not use private pool capacity.	Open
security_group_id	string	[Deprecated] The security group ID of the node pool. When the node pool is associated with multiple security groups, this is the first value in `security_group_ids`.	sg-2ze1iuk12m2sb4c4****
platform	string	[Deprecated] The operating system distribution. Valid values: `CentOS` `AliyunLinux` `Windows` `WindowsCore`	AliyunLinux
ram_policy	string	This field is deprecated. Use ram_role_name instead.	KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
instance_patterns	array	The instance attribute configurations.
	instance_patterns	The instance attribute.
ram_role_name	string	The worker RAM role name.	KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
resource_pool_options	object	The resource pool and resource pool policy used when creating instances.
strategy	string	The resource pool policy used when creating instances. Valid values: PrivatePoolFirst: private pool first. PrivatePoolOnly: private pool only. None: no resource pool policy.	PrivatePoolFirst
private_pool_ids	array	The list of private pool IDs.
	string	The private pool ID.	eap-bp1c1fohub5jccwi****
system_disk_snapshot_policy_id	string	The system cloud disk snapshot policy.	sp-0jl6xnmme8v7o935****
node_config	object	The node configuration.
kubelet_configuration	kubelet_config	The Kubelet parameter settings.
node_os_config	object	The node operating system configuration.
hugepage	Hugepage	The hugepage configuration.
kubernetes_config	object	The cluster-related configuration.
labels	array	Tag node.
	tag	The label configuration.	{}
taints	array	The node taint information. Taints and tolerations work together to prevent pods from being scheduled to inappropriate nodes. For more information, see taint-and-toleration.
	taint	The node taint information.
runtime	string	The container runtime name. ACK supports the following three container runtimes: containerd: Recommended. Supported by all cluster versions. Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supported by cluster versions 1.31 and earlier. docker: No longer maintained. Supported by cluster versions 1.22 and earlier.	containerd
runtime_version	string	The container runtime version.	1.6.38
cpu_policy	string	The node CPU management policy. The following two policies are supported for cluster versions 1.12.6 and later: `static`: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity. `none`: Enables the existing default CPU affinity scheme.	none
user_data	string	The node pool custom data, which is a script that runs after node initialization. For more information, see Generate instance user data.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
unschedulable	boolean	Specifies whether the scaled-out nodes are unschedulable. true: Unschedulable. false: Schedulable.	true
cms_enabled	boolean	Specifies whether to install the CloudMonitor agent on ECS nodes. After installation, you can view monitoring information for the created ECS instances in the CloudMonitor console. We recommend that you enable this feature. Valid values: `true`: Installs the CloudMonitor agent on ECS nodes. `false`: Does not install the CloudMonitor agent on ECS nodes.	true
node_name_mode	string	The custom node name. A node name consists of three parts: prefix + node IP address substring + suffix: The prefix and suffix can each consist of one or more parts separated by ".". Each part can contain lowercase letters, digits, and hyphens (-). The node name must start and end with a lowercase letter or digit. The IP address segment length specifies the number of digits taken from the end of the node IP address. Valid values: 5 to 12. For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP address segment length is 5, and the suffix is test, the node name is aliyun.com00055test.	aliyun.com192.XX.YY.55test
pre_user_data	string	The node pool pre-custom data, which is a script that runs before node initialization. For more information, see Generate instance user data.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
tee_config	object	The confidential computing configuration.
tee_enable	boolean	Specifies whether to enable confidential computing for the cluster. Valid values: `true`: Enabled. `false`: Not enabled.	false
interconnect_config	object	[This field is deprecated] The network configuration for edge node pools. This value is meaningful only for edge-type node pools.
cen_id	string	[Deprecated] The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool (CENID).	cen-ey9k9nfhz0f*******
ccn_id	string	[Deprecated] The Cloud Connect Network (CCN) instance ID bound to the enhanced edge node pool (CCNID).	ccn-qm5i0i0q9yi*******
ccn_region_id	string	[Deprecated] The region of the Cloud Connect Network (CCN) instance bound to the enhanced edge node pool.	cn-shanghai
bandwidth	integer	[Deprecated] The network bandwidth of the enhanced edge node pool, in Mbps.	10
improved_period	string	[Deprecated] The subscription duration of the enhanced edge node pool, in months.	1
max_nodes	integer	The maximum number of nodes allowed in the edge node pool. This parameter specifies the maximum number of nodes that the node pool can contain and must be greater than or equal to 0. A value of 0 indicates no additional limit (limited only by the maximum number of nodes the cluster can contain, with no additional limit on the node pool itself). This value is typically greater than 0 for edge node pools. For ess-type node pools and default edge-type node pools, this value is 0.	10
interconnect_mode	string	The network type of the edge node pool. This parameter takes effect only for node pools with `type` set to `edge`. Valid values: `basic`: public network. Nodes in cloud node pool interact with cloud nodes over the Internet. Applications in cloud node pool cannot directly access the cloud VPC internal network. `private`: private network. Nodes in cloud node pool connect to the cloud through Express Connect, VPN, or CEN, providing higher cloud-edge communication quality and more effective security.	basic
auto_mode	object	The intelligent managed configuration.
enable	boolean	Specifies whether to enable intelligent managed mode.	true
node_components	array<object>	The list of node components.
	array<object>	The node component.
name	string	The node component name.	kubelet
version	string	The node component version.	1.33.3-aliyun.1
config	object	The node component configuration.
custom_config	object	The node component custom configuration.	{"cpuManagerPolicy":"static"}
	any	The node component custom configuration string.	cpuManagerPolicy
config_revision	string	The node component custom configuration revision number.	1
eflo_node_group	object	The Lingjun node group information.
cluster_id	string	The Lingjun cluster ID.	i113790071760688002461
group_id	string	The Lingjun group ID.	i128147721760688002463
auto_attach_enabled	boolean	Specifies whether to enable automatic node addition for the Lingjun node pool (not effective).
worker_ram_role_name	string	The worker RAM role used by the Lingjun node pool.

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"
        },
        "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,
        "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****"
      },
      "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"
            }
          },
          "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.