DescribeClusterNodePoolDetail - Container Service for Kubernetes

Mengkueri konfigurasi kelompok node tertentu dalam kluster berdasarkan ID kelompok 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:DescribeClusterNodePoolDetail

get

*Cluster

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

None

Sintaks permintaan

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

Path Parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster.	c23421cfa74454bc8b37163fd19af****
NodepoolId	string	Yes	ID kelompok node.	np31da1b38983f4511b490fc62108a****

Parameter permintaan

Parameter

Type

Required

Description

Example

Tidak ada parameter yang diperlukan.

Elemen respons

Element	Type	Description	Example
	object	Detail kelompok node.
nodepool_info	object	Konfigurasi 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 skalabilitas elastis terkelola dan otomatis). `edge`: kelompok node edge. `lingjun`: kelompok node Lingjun.	ess
is_default	boolean	Apakah kelompok node merupakan kelompok node default. Sebuah kluster biasanya hanya memiliki satu kelompok node default. Nilai valid: `true`: Kelompok node adalah kelompok node default. `false`: Kelompok node bukan kelompok node default.	true
resource_group_id	string	ID kelompok sumber daya.	rg-acfmyvw3wjmb****
region_id	string	ID wilayah.	cn-beijing
created	string	Waktu ketika kelompok node dibuat.	2025-04-10T14:25:37.285530433+08:00
updated	string	Waktu ketika kelompok node terakhir diperbarui.	2025-04-15T15:39:45.41+08:00
status	object	Status kelompok node.
state	string	Status kelompok node. Nilai valid: `active`: Kelompok node aktif. `scaling`: Kelompok node sedang melakukan penskalaan. `removing`: Node sedang dihapus. `deleting`: Kelompok node sedang dihapus. `updating`: Kelompok node sedang diperbarui.	active
healthy_nodes	integer	Jumlah node yang sehat.	3
initial_nodes	integer	Jumlah node yang sedang dibuat.	0
failed_nodes	integer	Jumlah node yang gagal.	0
offline_nodes	integer	Jumlah node yang offline.	0
removing_nodes	integer	Jumlah node yang sedang dihapus.	0
serving_nodes	integer	Jumlah node yang melayani.	3
total_nodes	integer	Jumlah total node dalam kelompok node.	3
conditions	array<object>	Kondisi saat ini dari kelompok node, yang merepresentasikan informasi status di berbagai dimensi.
	object	Satu kondisi status.
type	string	Tipe kondisi.	ImageUpgradeReady
status	string	Status kondisi.	True
reason	string	Alasan untuk kondisi tersebut.	UpgradeDisabled
message	string	Paket detail.	AutoUpgradeDisabled
last_transition_time	string	Waktu transisi status terakhir.	20--30T10:39:00+08:00
auto_scaling	object	Konfigurasi penskalaan otomatis dari kelompok node.
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 aplikasi, ACK secara otomatis melakukan penskalaan node berdasarkan jumlah instans minimum dan maksimum yang dikonfigurasi. Kluster versi 1.24 dan lebih baru menggunakan elastisitas instan secara default. Kluster versi sebelum 1.24 menggunakan penskalaan node otomatis 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 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 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.	10
min_instances	integer	Jumlah minimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada.	1
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.
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 perbaikan otomatis untuk node.
restart_node	boolean	Apakah akan mengizinkan restart node. Parameter ini 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-xxxxxxxxxx
auto_vul_fix	boolean	Apakah akan mengaktifkan perbaikan CVE otomatis. Parameter ini hanya berlaku ketika `enable=true`. `true`: Aktifkan perbaikan CVE otomatis. `false`: Nonaktifkan 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 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`: menengah `nntf`: rendah	asap,nntf
exclude_packages	string	Paket yang dikecualikan selama perbaikan kerentanan.	kernel
auto_upgrade	boolean	Apakah akan mengaktifkan peningkatan node otomatis. Parameter ini hanya berlaku ketika `enable=true`. `true`: Aktifkan peningkatan otomatis. `false`: Nonaktifkan peningkatan otomatis.	true
auto_upgrade_policy	object	Kebijakan peningkatan otomatis.
auto_upgrade_kubelet	boolean	Apakah akan mengizinkan peningkatan kubelet otomatis. Parameter ini 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. Parameter ini hanya berlaku ketika `enable=true`.
auto_upgrade	boolean	Apakah peningkatan otomatis diaktifkan. Nilai valid: `true`: Peningkatan otomatis diaktifkan. `false`: Peningkatan otomatis tidak diaktifkan.	true
surge	integer	Jumlah node surge. Anda dapat menentukan parameter ini atau surge_percentage.	5
surge_percentage	integer	Persentase node surge. Anda dapat menentukan parameter ini atau `surge`. Jumlah node surge = persentase surge × jumlah node. Misalnya, jika persentase surge diatur ke 50% dan ada 6 node yang ada, jumlah node surge = 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
scaling_group	object	Konfigurasi grup penskalaan dari kelompok node.
scaling_group_id	string	ID grup penskalaan.	asg-2zeieod8giqmov7z****
vswitch_ids	array	Daftar ID vSwitch.
	string	ID vSwitch.	vsw-2ze3ds0mdip0hdz8i****
instance_types	array	Daftar tipe instans node.
	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. Parameter ini 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}.	0
period_unit	string	Unit periode langganan. Parameter ini harus ditentukan ketika `instance_charge_type` diatur ke `PrePaid`. `Month`: bulan sebagai unit penagihan. `Week`: minggu sebagai unit penagihan.	Month
auto_renew	boolean	Apakah akan mengaktifkan perpanjangan otomatis untuk node. Parameter ini hanya berlaku ketika `instance_charge_type` diatur ke `PrePaid`. Nilai valid: `true`: Aktifkan perpanjangan otomatis. `false`: Nonaktifkan perpanjangan otomatis.	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.	1
spot_strategy	string	Strategi penawaran untuk 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 batas harga untuk spot instans.
	object	Konfigurasi batas harga untuk spot instans. Anda dapat menetapkan batas harga berbeda untuk tipe instans yang berbeda.
instance_type	string	Tipe spot instans.	ecs.c6.large
price_limit	string	Harga pasar per 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.	aliyun_3_x64_20G_alibase_20241218.vhd
system_disk_category	string	Tipe cloud disk sistem. 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 Tipe disk untuk Tipe disk sistem. Ketika tipe Tipe disk dengan prioritas lebih tinggi tidak tersedia, sistem secara otomatis mencoba tipe Tipe disk dengan prioritas berikutnya untuk membuat Tipe disk sistem.
	string	Tipe cloud disk sistem. 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_essd
system_disk_size	integer	Ukuran cloud disk sistem. Unit: GiB. Nilai valid: [20,2048].	120
system_disk_performance_level	string	Tingkat kinerja cloud disk sistem. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja bervariasi berdasarkan ukuran cloud disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD. 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`: Enkripsi cloud disk sistem. `false`: Jangan enkripsi cloud disk sistem.	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. Nilai valid: true: Aktifkan burst. Ketika diaktifkan, cloud disk sementara meningkatkan performa selama tekanan baca/tulis data mendadak dari beban kerja yang berfluktuasi hingga beban kerja stabil. false: Nonaktifkan burst. 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 dari cloud disk sistem. Nilai valid: 0 hingga min{50.000, 1000 × kapasitas - kinerja dasar}. Kinerja dasar = min{1.800 + 50 × kapasitas, 50000}. Parameter ini hanya didukung ketika `system_disk_category` diatur ke `cloud_auto`. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.	1000
data_disks	array	Konfigurasi cloud disk data node, termasuk tipe dan ukuran.
	data_disk	Konfigurasi cloud disk data dari sebuah node.
security_group_ids	array	Daftar ID grup keamanan untuk kelompok node.
	string	ID grup keamanan dari kelompok node.	sg-2ze60ockeekspl3d****
key_pair	string	Nama pasangan kunci. Tentukan parameter ini atau `login_password`. Untuk kelompok node terkelola, hanya `key_pair` yang didukung.	pro-nodepool
login_password	string	Kata sandi logon SSH. Tentukan parameter ini atau `key_pair`. Kata sandi logon harus memiliki panjang 8 hingga 30 karakter dan harus 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 akan logon ke Instance ECS sebagai pengguna non-root. true: Logon sebagai pengguna non-root (ecs-user). false: Logon sebagai pengguna root.	true
cis_enabled `deprecated`	boolean	[Sudah usang] Gunakan parameter security_hardening_os sebagai gantinya.	false
soc_enabled	boolean	Apakah akan mengaktifkan Penguatan Keamanan MLPS 2.0. Fitur ini hanya tersedia 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 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`: Aktifkan Penguatan Keamanan OS Alibaba Cloud. `false`: Nonaktifkan Penguatan Keamanan OS Alibaba Cloud. Nilai default: `false`.	false
internet_charge_type	string	Tipe penagihan untuk IP publik node. PayByBandwidth: bayar berdasarkan bandwidth. PayByTraffic: bayar berdasarkan trafik.	PayByBandwidth
internet_max_bandwidth_out	integer	Bandwidth publik keluar maksimum node. Unit: Mbit/s. Nilai valid: 1 hingga 100.	10
tags	array	Tag Instance ECS.
	tag	Tag node.
desired_size	integer	Jumlah node yang diinginkan dalam kelompok node.	2
multi_az_policy	string	Kebijakan penskalaan multi-zona untuk Instance ECS dalam grup penskalaan. Nilai valid: `PRIORITY`: Melakukan penskalaan berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Ketika Instance ECS tidak dapat dibuat di zona vSwitch dengan prioritas lebih tinggi, sistem secara otomatis menggunakan vSwitch dengan prioritas berikutnya. `COST_OPTIMIZED`: Mencoba membuat instans berdasarkan urutan harga satuan vCPU dari terendah ke tertinggi. Ketika konfigurasi penskalaan menentukan beberapa tipe instans dengan penagihan spot, spot instans dibuat terlebih dahulu. Anda dapat menggunakan parameter `CompensateWithOnDemand` untuk menentukan apakah akan secara otomatis membuat instans bayar sesuai pemakaian ketika spot instans tidak dapat dibuat karena stok tidak mencukupi. Catatan `COST_OPTIMIZED` hanya berlaku ketika konfigurasi penskalaan menentukan beberapa tipe instans atau spot instans. `BALANCE`: Mendistribusikan Instance ECS secara merata di seluruh zona yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena stok tidak mencukupi, Anda dapat memanggil operasi RebalanceInstances untuk menyeimbangkan ulang sumber daya. Untuk informasi lebih lanjut, lihat RebalanceInstances. Nilai default: `PRIORITY`.	BALANCE
scaling_policy	string	Mode grup penskalaan. Nilai valid: `release`: mode standar. Melakukan penskalaan dengan membuat dan merilis Instance ECS berdasarkan penggunaan sumber daya. `recycle`: mode cepat. Melakukan penskalaan dengan membuat, menghentikan, dan memulai instans, yang mempercepat operasi penskalaan berikutnya. Sumber daya komputasi tidak dikenai biaya selama periode penghentian. Hanya biaya penyimpanan yang dikenai biaya, kecuali untuk instans dengan disk lokal.	release
on_demand_base_capacity	integer	Jumlah minimum instans bayar sesuai pemakaian yang diperlukan dalam grup penskalaan. Nilai valid: [0,1000]. Ketika jumlah instans bayar sesuai pemakaian kurang dari nilai ini, instans bayar sesuai pemakaian dibuat terlebih dahulu.	0
on_demand_percentage_above_base_capacity	integer	Persentase instans bayar sesuai pemakaian di antara instans tambahan yang melebihi jumlah minimum instans bayar sesuai pemakaian (on_demand_base_capacity) dalam grup penskalaan. Nilai valid: [0,100].	20
spot_instance_pools	integer	Jumlah tipe instans yang tersedia. Grup penskalaan membuat spot instans dari beberapa tipe instans berbiaya terendah secara seimbang. Nilai valid: [1,10].	5
spot_instance_remedy	boolean	Menunjukkan apakah suplementasi spot instans diaktifkan. Jika diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan direklamasi ketika sistem mengirimkan notifikasi reklamasi. Nilai valid: `true`: Suplementasi spot instans diaktifkan. `false`: Suplementasi spot instans dinonaktifkan.	false
compensate_with_on_demand	boolean	Ketika multi_az_policy diatur ke COST_OPTIMIZED, menentukan apakah akan mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instance ECS yang diperlukan ketika spot instans tidak dapat dibuat karena alasan biaya atau stok. Nilai valid: `true`: Mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instance ECS yang diperlukan. `false`: Tidak mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instance ECS yang diperlukan.	true
deploymentset_id	string	ID set penyebaran.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Jika daftar Instans ApsaraDB RDS ditentukan, Instance ECS dari node kluster secara otomatis ditambahkan ke Daftar putih RDS. [responses.200.schema.properties.scaling_group.properties
	string	Instans ApsaraDB RDS.	rm-xxx
private_pool_options	object	Konfigurasi kelompok node pribadi.
id	string	ID kelompok node pribadi.	eap-bp67acfmxazb4****
match_criteria	string	Tipe kelompok node pribadi. Menentukan opsi kapasitas kolam pribadi untuk peluncuran instans. Setelah jaminan elastisitas atau	Open
security_group_id	string	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-2ze60ockeekspl3d****
platform	string	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 configuration.
	instance_patterns	The instance attributes.
ram_role_name	string	The worker RAM role name.	KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
instance_metadata_options	InstanceMetadataOptions	The metadata access configuration for ECS instances.
resource_pool_options	object	The resource pools and resource pool strategy used when creating instances.
private_pool_ids	array	The list of private pool IDs.
	string	The private pool ID.	eap-bp1c1fohub5jccwi****
strategy	string	The resource pool strategy used when creating instances. Valid values: PrivatePoolFirst: private pool first. PrivatePoolOnly: private pool only. None: no resource pool strategy.	PrivatePoolFirst
system_disk_snapshot_policy_id	string	The system cloud disk snapshot policy.	sp-bp11g8z59rawcud9****
disk_init	array	The block device initialization configuration.
	DiskInit	The DiskInit configuration.
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 ECS tag.
taints	array	The node taint information. Taints work together with tolerations to prevent pods from being scheduled to inappropriate nodes. For more information, see taint-and-toleration.
	taint	The node taint configuration.
runtime	string	The container runtime name. ACK supports the following three container runtimes: containerd: recommended. Supports all cluster versions. Sandboxed-Container.runv: sandboxed container that provides higher isolation. Supports cluster versions 1.31 and earlier. docker: no longer maintained. Supports 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.	IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi
unschedulable	boolean	Indicates whether nodes added during scale-out 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. The node name consists of three parts: prefix + node IP address substring + suffix: Both the prefix and suffix can 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 to extract 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.	dGhpcyBpcyBhIGV4YW1wbGU
tee_config	object	The confidential computing cluster configuration.
tee_enable	boolean	Specifies whether to enable confidential computing for the cluster. Valid values: `true`: Enabled. `false`: Disabled.	false
interconnect_config	object	[This field is deprecated] The network configuration for the edge node pool. This value is meaningful only for edge-type node pools.
cen_id	string	[This field is deprecated] The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool.	cen-ey9k9nfhz0f*******
ccn_id	string	[This field is deprecated] The Cloud Connect Network (CCN) instance ID bound to the enhanced edge node pool.	ccn-qm5i0i0q9yi*******
ccn_region_id	string	[This field is deprecated] The region of the CCN instance bound to the enhanced edge node pool.	cn-shanghai
bandwidth	integer	[This field is deprecated] The network bandwidth of the enhanced edge node pool, in Mbit/s.	10
improved_period	string	[This field is deprecated] The subscription duration of the enhanced edge node pool, in months.	1
max_nodes	integer	[This field is deprecated] The maximum number of nodes allowed in the edge node pool.	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
host_network	boolean	Indicates whether the pod network uses host network mode. `true`: Host network. Pods directly use the host network stack and share the IP address and ports with the host. `false`: Container network. Pods have independent network stacks and do not occupy host network ports.	true
intranet	boolean	Indicates whether nodes in the edge node pool have Layer 3 network connectivity with each other. `true`: Connected. All nodes in this node pool have Layer 3 network connectivity with each other. `false`: Not connected. All nodes in this node pool do not have Layer 3 network connectivity with each other.	true
auto_mode	object	The intelligent managed configuration.
enable	boolean	Indicates whether this feature is enabled.	false
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		1
eflo_node_group	object
cluster_id	string		i113790071760688002461
group_id	string		i128147721760688002463
auto_attach_enabled	boolean
worker_ram_role_name	string

Contoh

Respons sukses

JSONformat

{
  "nodepool_info": {
    "nodepool_id": "np615c0e0966124216a0412e10afe0****",
    "name": "default-nodepool",
    "type": "ess",
    "is_default": true,
    "resource_group_id": "rg-acfmyvw3wjmb****",
    "region_id": "cn-beijing",
    "created": "2025-04-10T14:25:37.285530433+08:00",
    "updated": "2025-04-15T15:39:45.41+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,
    "conditions": [
      {
        "type": "ImageUpgradeReady",
        "status": "True",
        "reason": "UpgradeDisabled",
        "message": "AutoUpgradeDisabled",
        "last_transition_time": "20**-**-30T10:39:00+08:00"
      }
    ]
  },
  "auto_scaling": {
    "enable": true,
    "type": "cpu",
    "max_instances": 10,
    "min_instances": 1,
    "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-xxxxxxxxxx"
    },
    "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
  },
  "scaling_group": {
    "scaling_group_id": "asg-2zeieod8giqmov7z****",
    "vswitch_ids": [
      "vsw-2ze3ds0mdip0hdz8i****"
    ],
    "instance_types": [
      "ecs.n4.large"
    ],
    "instance_charge_type": "PostPaid",
    "period": 0,
    "period_unit": "Month",
    "auto_renew": false,
    "auto_renew_period": 1,
    "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": [
      "cloud_essd"
    ],
    "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****"
      }
    ],
    "security_group_ids": [
      "sg-2ze60ockeekspl3d****"
    ],
    "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": "BALANCE",
    "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-2ze60ockeekspl3d****",
    "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****",
    "instance_metadata_options": {
      "http_tokens": "optional"
    },
    "resource_pool_options": {
      "private_pool_ids": [
        "eap-bp1c1fohub5jccwi****"
      ],
      "strategy": "PrivatePoolFirst"
    },
    "system_disk_snapshot_policy_id": "sp-bp11g8z59rawcud9****",
    "disk_init": [
      {
        "disk_name": "disk0",
        "mkfs_type": "ext4",
        "mount_target": "/mnt/disk0",
        "mount_for_runtime": false,
        "local_disk": false
      }
    ]
  },
  "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": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi",
    "unschedulable": true,
    "cms_enabled": true,
    "node_name_mode": "aliyun.com192.XX.YY.55test",
    "pre_user_data": "dGhpcyBpcyBhIGV4YW1wbGU\n"
  },
  "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",
  "host_network": true,
  "intranet": true,
  "auto_mode": {
    "enable": false
  },
  "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.