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 terkelola dan skalabilitas otomatis). `edge`: kelompok node tepi. `lingjun`: kelompok node Lingjun.	ess
is_default	boolean	Menunjukkan apakah kelompok node adalah kelompok node default. 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-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`: Aktif. `scaling`: Menskalakan. `removing`: Menghapus node. `deleting`: Menghapus. `updating`: Memperbarui.	active
healthy_nodes	integer	Jumlah node sehat.	3
initial_nodes	integer	Jumlah node yang sedang dibuat.	0
failed_nodes	integer	Jumlah node gagal.	0
offline_nodes	integer	Jumlah node 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 kelompok node, yang merepresentasikan informasi status kelompok node di berbagai dimensi.
	object	Kondisi.
type	string	Tipe.	ImageUpgradeReady
status	string	Status.	True
reason	string	Alasan.	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 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 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 versi sebelum 1.24 menggunakan penskalaan otomatis node secara default. Untuk informasi selengkapnya, 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 per bandwidth. `PayByTraffic`: bayar per transfer data.	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`: Izinkan restart node. `false`: Jangan izinkan restart node.	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`: Izinkan restart node. `false`: Jangan izinkan restart node.	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`: Izinkan peningkatan kubelet otomatis. `false`: Jangan izinkan peningkatan kubelet otomatis.	true
upgrade_config	object	Konfigurasi peningkatan otomatis. Parameter ini hanya berlaku ketika `enable=true`.
auto_upgrade	boolean	Apakah akan mengaktifkan peningkatan otomatis. Nilai valid: `true`: Aktifkan peningkatan otomatis. `false`: Nonaktifkan peningkatan otomatis.	true
surge	integer	Jumlah node tambahan. Anda dapat menentukan parameter ini atau `surge_percentage`.	5
surge_percentage	integer	Persentase node tambahan. Anda dapat menentukan parameter ini atau `surge`. Node tambahan = persentase node tambahan × jumlah node. Misalnya, jika persentase node tambahan diatur ke 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
drift_enabled	boolean
scaling_group	object	Konfigurasi grup penskalaan 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 wajib diisi 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 siklus penagihan. `Week`: minggu sebagai siklus 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	Tipe spot instans. Nilai valid: NoSpot: instans non-spot. SpotWithPriceLimit: spot instans dengan batas harga. SpotAsPriceGo: spot instans dengan laju pasar. Untuk informasi selengkapnya, lihat Spot instans.	NoSpot
spot_price_limit	array<object>	Konfigurasi rentang harga untuk spot instans.
	object	Konfigurasi rentang harga untuk spot instans. Anda dapat mengatur rentang harga berbeda untuk tipe instans berbeda.
instance_type	string	Tipe spot instans.	ecs.c6.large
price_limit	string	Batas harga 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 selengkapnya, 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. `false`: Jangan enkripsi.	false
system_disk_kms_key_id	string	ID kunci KMS yang digunakan oleh cloud disk sistem.	0e478b7a-4262-4802-b8cb-00d3fb40****
system_disk_encrypt_algorithm	string	Algoritma enkripsi yang digunakan oleh cloud disk sistem. Nilai valid: aes-256.	aes-256
system_disk_bursting_enabled	boolean	Apakah akan mengaktifkan kinerja burst untuk cloud disk sistem. Nilai valid: true: Aktifkan. Ketika diaktifkan, cloud disk sementara meningkatkan kinerja untuk handle tekanan baca/tulis data mendadak selama beban kerja yang berfluktuasi hingga beban kerja stabil. false: Nonaktifkan. Parameter ini hanya didukung ketika `system_disk_category` diatur ke `cloud_auto`. Untuk informasi selengkapnya, lihat Cloud disk ESSD AutoPL.	true
system_disk_provisioned_iops	integer	IOPS baca/tulis yang disediakan untuk cloud disk sistem. Nilai valid: 0~min{50.000, 1000kapasitas-kinerja dasar}. Garis dasar=min{1.800+50kapasitas, 50000}. Parameter ini hanya didukung ketika `system_disk_category` diatur ke `cloud_auto`. Untuk informasi selengkapnya, lihat Cloud disk ESSD AutoPL.	1000
data_disks	array	Konfigurasi cloud disk data, termasuk tipe dan ukuran.
	data_disk	Konfigurasi cloud disk data.
security_group_ids	array	Daftar ID grup keamanan untuk kelompok node.
	string	ID grup keamanan 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 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 yang diskalakan keluar sebagai pengguna non-root. true: Logon sebagai pengguna non-root (ecs-user). false: Logon sebagai pengguna root.	true
cis_enabled `deprecated`	boolean	[Tidak digunakan lagi] Gunakan parameter security_hardening_os sebagai gantinya.	false
soc_enabled	boolean	Apakah akan mengaktifkan penguatan keamanan MLPS 2.0. Anda dapat mengaktifkan penguatan keamanan MLPS 2.0 untuk node hanya 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 per bandwidth. PayByTraffic: bayar per transfer data.	PayByBandwidth
internet_max_bandwidth_out	integer	Bandwidth publik arah 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`: Menskalakan 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`: Membuat instans dalam urutan menaik harga satuan vCPU. Ketika konfigurasi penskalaan menentukan beberapa tipe instans dengan metode 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 inventaris tidak mencukupi. Catatan `COST_OPTIMIZED` hanya berlaku ketika konfigurasi penskalaan menentukan beberapa tipe instans atau menggunakan spot instans. `BALANCE`: Mendistribusikan Instance ECS secara merata di seluruh zona yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena inventaris tidak mencukupi, panggil operasi RebalanceInstances untuk menyeimbangkan ulang Sumber daya. Untuk informasi selengkapnya, lihat RebalanceInstances. Nilai default: `PRIORITY`.	BALANCE
scaling_policy	string	Mode grup penskalaan. Nilai valid: `release`: mode standar. Menskalakan dengan membuat dan merilis instans ECS berdasarkan Penggunaan sumber daya. `recycle`: mode cepat. Menskalakan dengan membuat, menghentikan, dan memulai instans, yang mempercepat operasi penskalaan berikutnya. Instans yang dihentikan tidak dikenai biaya untuk resource komputasi, tetapi biaya penyimpanan tetap berlaku. Ini tidak berlaku untuk instans dengan disk lokal.	release
on_demand_base_capacity	integer	Jumlah minimum instans bayar sesuai pemakaian.	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, ketika sistem memberi tahu bahwa spot instans akan diambil kembali, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan diambil kembali. Nilai valid: `true`: Suplementasi spot instans diaktifkan. `false`: Suplementasi spot instans tidak diaktifkan.	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 persyaratan jumlah Instance ECS ketika spot instans tidak dapat dibuat karena alasan biaya atau inventaris. Nilai valid: `true`: Mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi persyaratan jumlah Instance ECS. `false`: Tidak mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi persyaratan jumlah Instance ECS.	true
deploymentset_id	string	ID set penyebaran.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	Jika daftar instans RDS ditentukan, instans ECS node kluster secara otomatis ditambahkan ke daftar putih akses RDS.
	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 meluncurkan 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. `Target`: Mode tertentu. Menggunakan kapasitas kolam pribadi tertentu untuk meluncurkan instans. Jika kapasitas kolam pribadi tertentu tidak tersedia, peluncuran instans gagal. `None`: Tidak ada kapasitas kolam pribadi yang digunakan untuk peluncuran instans.	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 takes priority. PrivatePoolOnly: only private pool is used. None: no resource pool strategy is used.	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.
cpu_options	object
nested_virtualization	string		enabled
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 and tolerations work together 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 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. 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 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.	dGhpcyBpcyBhIGV4YW1wbGU
tee_config	object	The confidential computing cluster configuration.
tee_enable	boolean	Specifies whether to enable the confidential computing cluster. Valid values: `true`: Enabled. `false`: Not enabled.	false
interconnect_config	object	[This field is deprecated] The network-related configuration for edge node pools. This value is only meaningful 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 Cloud Connect Network 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 Mbps.	10
improved_period	string	[This field is deprecated] The purchase 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 within the edge node pool have Layer 3 network connectivity. `true`: Connected. All nodes within the node pool have Layer 3 network connectivity. `false`: Not connected. All nodes within the node pool do not have Layer 3 network connectivity.	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,
    "drift_enabled": 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
      }
    ],
    "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": "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.