All Products
Search
Document Center

Container Service for Kubernetes:nodepool

Last Updated:Jul 17, 2026

Parameter

Type

Description

Example

object

Node pool.

auto_scaling

object

Konfigurasi penskalaan otomatis untuk node pool.

enable

boolean

Apakah akan mengaktifkan penskalaan otomatis.

  • true: Mengaktifkan penskalaan otomatis untuk node pool.

  • false: Menonaktifkan penskalaan otomatis. Jika disetel ke false, parameter konfigurasi lain dalam auto_scaling tidak berlaku.

Nilai default: false.

true

max_instances

integer

Jumlah maksimum instans dalam grup penskalaan.

10

min_instances

integer

Jumlah minimum instans dalam grup penskalaan.

0

type

string

Tipe auto scaling, diklasifikasikan berdasarkan tipe instans. Nilai valid:

  • cpu: Tipe instans reguler.

  • gpu: Tipe instans GPU.

  • gpushare: Tipe berbagi GPU.

  • spot: Tipe spot instans.

Nilai default: cpu.

cpu

is_bond_eip

boolean

[Bidang ini sudah tidak digunakan]

Apakah akan mengasosiasikan EIP. Nilai valid:

  • true: Mengasosiasikan EIP.

  • false: Tidak mengasosiasikan EIP.

Nilai default: false.

true

eip_internet_charge_type

string

[Bidang ini sudah tidak digunakan]

Metode penagihan untuk EIP. Nilai valid:

  • PayByBandwidth: bayar berdasarkan bandwidth.

  • PayByTraffic: bayar berdasarkan transfer data.

Nilai default: PayByBandwidth.

PayByBandwidth

eip_bandwidth

integer

[Bidang ini sudah tidak digunakan]

Bandwidth puncak EIP. Unit: Mbit/s.

5

kubernetes_config

object

Konfigurasi terkait kluster.

cms_enabled

boolean

Apakah akan menginstal Agen CloudMonitor pada node ECS. Setelah instalasi, Anda dapat melihat Tampilan informasi pemantauan Instans ECS yang dibuat di Konsol CloudMonitor. Kami menyarankan Anda mengaktifkan fitur ini. Nilai valid:

  • true: Menginstal Agen CloudMonitor pada node ECS.

  • false: Tidak menginstal Agen CloudMonitor pada node ECS.

Nilai default: false.

true

cpu_policy

string

Kebijakan manajemen CPU untuk node. Dua kebijakan berikut didukung untuk kluster versi 1.12.6 atau lebih baru:

  • static: Memungkinkan pod dengan karakteristik Sumber daya tertentu pada node diberikan afinitas CPU yang ditingkatkan dan eksklusivitas.

  • none: Mengaktifkan skema afinitas CPU default yang ada.

Nilai default: none.

none

labels

array

Label node. Menambahkan label ke node dalam kluster Kubernetes.

tag

Label node.

runtime

string

Waktu proses kontainer. Nilai valid:

  • containerd: Direkomendasikan. Mendukung semua versi kluster.

  • Sandboxed-Container.runv: Kontainer sandbox. Memberikan isolasi yang lebih tinggi. Mendukung kluster versi 1.24 atau lebih lama.

  • docker: Mendukung kluster versi 1.22 atau lebih lama.

Nilai default: containerd

containerd

runtime_version

string

Versi runtime kontainer.

1.6.20

taints

array

Konfigurasi taint.

taint

Konfigurasi taint.

user_data

string

Data kustom node.

MXM=

node_name_mode

string

Nama node terdiri dari tiga bagian: awalan + IP node + akhiran:

  • Baik awalan maupun akhiran dapat terdiri dari satu atau beberapa bagian yang dipisahkan oleh ".". Setiap bagian dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama node harus dimulai dan diakhiri dengan huruf kecil atau angka.

  • IP node adalah alamat IP privat lengkap dari node.

Parameter ini berisi empat bagian yang dipisahkan oleh koma. Misalnya, jika Anda memasukkan string "customized,aliyun,ip,com" (di mana "customized" dan "ip" adalah string tetap, "aliyun" adalah awalan, dan "com" adalah akhiran), nama node adalah: aliyun.192.168.xxx.xxx.com.

customized,aliyun,ip,com

nodepool_info

object

Konfigurasi node pool.

name

string

Nama node pool.

np-test

resource_group_id

string

ID kelompok sumber daya tempat node pool berada.

rg-acfmyvw3wjm****

type

string

Tipe node pool. Nilai valid:

  • ess: Node pool.

  • edge: Node pool edge.

ess

scaling_group

object

Konfigurasi grup penskalaan untuk node pool.

auto_renew

boolean

Apakah akan mengaktifkan perpanjangan otomatis untuk node pool. Parameter ini hanya berlaku jika instance_charge_type disetel ke PrePaid. Nilai valid:

  • true: Mengaktifkan perpanjangan otomatis.

  • false: Menonaktifkan perpanjangan otomatis.

Nilai default: true.

false

auto_renew_period

integer

Epoch perpanjangan otomatis untuk node pool. Parameter ini berlaku dan wajib diisi hanya jika instance_charge_type disetel ke PrePaid.

Jika PeriodUnit=Month, nilai valid: {1, 2, 3, 6, 12}.

Nilai default: 1.

0

data_disks

array

Konfigurasi cloud disk data untuk node dalam node pool.

data_disk

Konfigurasi cloud disk data untuk node dalam node pool.

disk_init

array

Konfigurasi inisialisasi perangkat blok.

DiskInit

Konfigurasi DiskInit.

image_id

string

ID gambar kustom. Gambar yang disediakan sistem digunakan secara default.

aliyun_2_1903_x64_20G_alibase_20200904.vhd

instance_charge_type

string

Metode penagihan untuk node dalam node pool. Nilai valid:

  • PrePaid: Langganan.

  • PostPaid: Bayar sesuai pemakaian.

Nilai default: PostPaid.

PostPaid

instance_types

array

Tipe instans.

string

Tipe instans.

ecs.n1.medium

key_pair

string

Nama key pair. Tentukan parameter ini atau login_password.

Catatan

Untuk node pool terkelola, hanya key_pair yang didukung.

np-key

login_password

string

Kata sandi logon SSH. Tentukan parameter ini atau key_pair. Panjang kata sandi harus 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus.

Hello1234

login_as_non_root

boolean

Apakah instans ECS scale-out melakukan logon sebagai pengguna non-root.

period

integer

Durasi langganan untuk Instans dalam node pool. Parameter ini berlaku dan wajib diisi hanya jika instance_charge_type disetel ke PrePaid. Jika period_unit disetel ke Month, nilai valid untuk period: {1, 2, 3, 6, 12}.

Nilai default: 1.

0

period_unit

string

Unit periode penagihan untuk Instans dalam node pool. Parameter ini harus ditentukan jika instance_charge_type disetel ke PrePaid.

Month: Saat ini, hanya penagihan bulanan yang didukung.

Month

platform

string

Distribusi sistem operasi. Nilai valid:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

Nilai default: AliyunLinux.

AliyunLinux

rds_instances

array

Daftar instans RDS.

string

ID instans RDS.

rm-2zey3t89t6280****

spot_strategy

string

Tipe spot instans. Nilai valid:

  • NoSpot: Instans non-spot.

  • SpotWithPriceLimit: Spot instans dengan batas harga.

  • SpotAsPriceGo: Sistem secara otomatis menawar pada harga pasar saat ini.

Untuk informasi selengkapnya, lihat Spot instans.

NoSpot

spot_price_limit

array

Konfigurasi rentang harga pasar untuk satu Tipe instans spot.

object

instance_type

string

Tipe spot instans.

ecs.c6.large

price_limit

string

Harga maksimum untuk satu instans.

0.39

scaling_policy

string

Mode grup penskalaan. Nilai valid:

  • release: Mode standar. Melakukan scale-in atau scale-out dengan membuat atau merilis Instans ECS berdasarkan penggunaan Sumber daya.

  • recycle: Mode cepat. Melakukan scale-in atau scale-out dengan membuat, menghentikan, atau memulai Instans ECS, yang meningkatkan kecepatan operasi penskalaan berikutnya. (Instans yang dihentikan tidak dikenakan biaya untuk resource komputasi, tetapi biaya penyimpanan tetap berlaku, kecuali untuk Instans dengan disk lokal.)

Nilai default: release.

release

security_group_id

string

ID grup keamanan untuk node pool. Tentukan parameter ini atau security_group_ids. Kami menyarankan Anda menggunakan security_group_ids.

sg-2zeihch86ooz9io4****

security_group_ids

array

Daftar ID grup keamanan. Tentukan parameter ini atau security_group_id. Kami menyarankan Anda menggunakan security_group_ids. Jika kedua security_group_id dan security_group_ids ditentukan, security_group_ids yang akan diutamakan.

string

ID grup keamanan.

sg-2zeihch86ooz9io4****

system_disk_category

string

Tipe cloud disk sistem untuk node. Nilai valid:

  • cloud_efficiency: Ultra cloud disk.

  • cloud_ssd: SSD standar.

  • cloud_essd: ESSD.

  • cloud_auto: Cloud disk ESSD AutoPL.

  • cloud_essd_entry: Disk ESSD Entry.

Nilai default: cloud_efficiency.

cloud_efficiency

system_disk_categories

array

Beberapa tipe Tipe disk untuk Tipe disk sistem. Jika tipe Tipe disk dengan prioritas lebih tinggi tidak tersedia, sistem secara otomatis mencoba tipe Tipe disk dengan prioritas berikutnya untuk membuat Tipe disk sistem. Nilai valid:

  • cloud: Basic Tipe disk.

  • cloud_efficiency: Ultra Tipe disk.

  • cloud_ssd: SSD standar.

  • cloud_essd: ESSD.

string

Tipe cloud disk sistem node.

cloud_essd

system_disk_size

integer

Ukuran cloud disk sistem untuk node. Unit: GiB.

Nilai valid: [40,500].

120

system_disk_performance_level

string

Tingkat kinerja cloud disk sistem untuk node. Hanya berlaku untuk 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: dienkripsi. false: tidak dienkripsi.

system_disk_kms_key_id

string

ID kunci KMS yang digunakan oleh cloud disk sistem node.

0e478b7a-4262-4802-b8cb-00d3fb40****

system_disk_encrypt_algorithm

string

Algoritma enkripsi untuk cloud disk sistem node. Nilai valid: aes-256.

aes-256

system_disk_provisioned_iops

integer

IOPS baca/tulis yang disediakan untuk cloud disk sistem node. Nilai valid: 0 hingga min{50.000, 1000 × kapasitas - kinerja dasar}. Garis dasar = min{1.800 + 50 × kapasitas, 50000}.

Parameter ini hanya didukung jika SystemDiskCategory disetel ke cloud_auto. Untuk informasi selengkapnya, lihat Cloud disk ESSD AutoPL.

1000

system_disk_bursting_enabled

boolean

Apakah akan mengaktifkan burst (lonjakan performa) untuk cloud disk sistem node. Nilai valid:

  • true: Diaktifkan.

  • false: Dinonaktifkan.

Parameter ini hanya didukung jika SystemDiskCategory disetel ke cloud_auto. Untuk informasi selengkapnya, lihat Cloud disk ESSD AutoPL.

true

tags

array

Tag yang hanya ditambahkan ke instans ECS.

Kunci tag tidak boleh duplikat dan panjangnya maksimal 128 karakter. Kunci tag dan nilai tag tidak boleh dimulai dengan "aliyun" atau "acs:", atau mengandung "https://" atau "http://".

object

key

string

Kunci tag.

key

value

string

Nilai tag.

value

vswitch_ids

array

ID vSwitch.

string

ID vSwitch.

vsw-2ze0fmpbwo140ahni****

multi_az_policy

string

Kebijakan penskalaan multi-zona untuk Instans ECS dalam grup penskalaan. Nilai valid:

  • PRIORITY: Melakukan penskalaan berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Ketika Instans ECS tidak dapat dibuat di zona vSwitch dengan prioritas lebih tinggi, sistem secara otomatis menggunakan vSwitch dengan prioritas berikutnya untuk membuat Instans ECS.

  • COST_OPTIMIZED: Mencoba membuat instans berdasarkan urutan kenaikan harga satuan vCPU. Ketika Konfigurasi penskalaan menetapkan metode penagihan spot untuk beberapa Tipe instans, 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 jika Konfigurasi penskalaan menetapkan beberapa Tipe instans atau menggunakan spot instans.

  • BALANCE: Mendistribusikan Instans ECS secara merata di seluruh zona aktif 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 selengkapnya, lihat RebalanceInstances.

Nilai default: PRIORITY.

COST_OPTIMIZED

on_demand_base_capacity

integer

Jumlah minimum instans bayar sesuai pemakaian yang diperlukan oleh 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 yang melebihi jumlah minimum instans bayar sesuai pemakaian (on_demand_base_capacity). Nilai valid: [0,100].

20

spot_instance_pools

integer

Jumlah Tipe instans yang tersedia. Grup penskalaan membuat spot instans di seluruh Tipe instans berbiaya terendah secara seimbang. Nilai valid: [1,10].

5

spot_instance_remedy

boolean

Apakah akan mengaktifkan suplementasi spot instans. Jika diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan diambil kembali. Nilai valid:

  • true: Mengaktifkan suplementasi spot instans.

  • false: Menonaktifkan suplementasi spot instans.

false

compensate_with_on_demand

boolean

Ketika multi_az_policy disetel ke COST_OPTIMIZED, menentukan apakah mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instans ECS yang diperlukan ketika spot instans tidak dapat dibuat karena alasan harga atau stok. Nilai valid:

  • true: Mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instans ECS yang diperlukan.

  • false: Tidak mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instans ECS yang diperlukan.

true

internet_charge_type

string

Metode penagihan untuk alamat IP publik. Nilai valid:

  • PayByBandwidth: Bayar berdasarkan bandwidth.

  • PayByTraffic: Bayar berdasarkan transfer data.

PayByBandwidth

internet_max_bandwidth_out

integer

Bandwidth arah keluar maksimum untuk alamat IP publik node. Unit: Mbit/s. Nilai valid: [1,100].

10

image_type

string

Tipe image sistem operasi. Tentukan parameter ini atau platform. Nilai valid:

  • AliyunLinux: Image Alinux2.

  • AliyunLinux3: Image Alinux3.

  • AliyunLinux3Arm64: Image Alinux3 untuk ARM.

  • AliyunLinuxUEFI: Image UEFI Alinux2.

  • CentOS: Image CentOS.

  • Windows: Image Windows.

  • WindowsCore: Image WindowsCore.

  • ContainerOS: Image yang dioptimalkan untuk kontainer.

AliyunLinux

deploymentset_id

string

ID set penyebaran.

ds-bp1d19mmbsv3jf6xxxxx

desired_size

integer

Jumlah node yang diinginkan dalam node pool.

2

private_pool_options

object

Konfigurasi node pool privat.

id

string

ID node pool privat.

eap-bp67acfmxazb4****

match_criteria

string

Tipe node pool privat. Opsi kapasitas pool privat untuk memulai instans. Setelah jaminan elastisitas atau reservasi kapasitas berlaku, pool privat dihasilkan untuk memulai instans. Nilai valid:

  • Open: mode terbuka. Secara otomatis mencocokkan kapasitas pool privat tipe terbuka. Jika tidak ada kapasitas pool privat yang cocok, sumber daya pool publik digunakan untuk memulai instans.

  • Target: mode tertarget. Menggunakan kapasitas pool privat yang ditentukan untuk memulai instans. Jika kapasitas pool privat yang ditentukan tidak tersedia, instans gagal dimulai.

  • None: mode tanpa. Instans tidak menggunakan kapasitas pool privat untuk memulai.

Open

ram_role_name

string

Nama peran RAM Worker.

Penting Hanya kluster terkelola ACK versi 1.22 atau lebih baru yang mendukung konfigurasi parameter ini saat membuat node pool.

example-role

instance_metadata_options InstanceMetadataOptions

Konfigurasi akses metadata untuk instans ECS. Parameter ini saat ini hanya tersedia untuk akun dalam daftar putih. Kirim tiket untuk meminta akses.

resource_pool_options

object

Kolam sumber daya dan kebijakan kolam sumber daya yang digunakan saat membuat instans. Perhatikan hal-hal berikut saat Anda menyetel parameter ini: Parameter ini hanya berlaku saat membuat instans bayar sesuai pemakaian. Parameter ini tidak dapat disetel bersama dengan private_pool_options.match_criteria atau private_pool_options.id.

strategy

string

Kebijakan kolam sumber daya yang digunakan saat membuat instans. Kolam sumber daya mencakup pool privat yang dihasilkan setelah jaminan elastisitas atau reservasi kapasitas berlaku, dan pool publik, untuk memulai instans. Nilai valid: PrivatePoolFirst: pool privat terlebih dahulu. Saat kebijakan ini dipilih dan resource_pool_options.private_pool_ids ditentukan, pool privat yang ditentukan digunakan terlebih dahulu. Jika tidak ada pool privat yang ditentukan atau pool privat yang ditentukan memiliki kapasitas tidak mencukupi, pool privat tipe terbuka secara otomatis dicocokkan. Jika tidak ada pool privat yang cocok, resource pool publik digunakan. PrivatePoolOnly: hanya pool privat. Saat kebijakan ini dipilih, resource_pool_options.private_pool_ids harus ditentukan. Jika pool privat yang ditentukan memiliki kapasitas tidak mencukupi, instans gagal dimulai. None: tanpa kebijakan kolam sumber daya. Nilai default: None.

PrivatePoolFirst

private_pool_ids

array

Daftar ID pool privat, yang merupakan ID jaminan elastisitas atau ID reservasi kapasitas. Hanya ID pool privat mode Target yang dapat dimasukkan. Nilai valid N: 1 hingga 20.

string

ID pool privat, yang merupakan ID jaminan elastisitas atau ID reservasi kapasitas. Hanya ID pool privat mode Target yang dapat ditentukan.

eap-bp67acfmxazb4****

cpu_options

object

Opsi konfigurasi CPU.

nested_virtualization

string

enabled

tee_config

object

Konfigurasi node pool komputasi rahasia.

tee_enable

boolean

Apakah node pool adalah node pool komputasi rahasia.

false

management

object

Konfigurasi node pool terkelola.

enable

boolean

Apakah akan kelompok node pool terkelola. Nilai valid:

  • true: Kelompok node pool terkelola.

  • false: Tidak kelompok node pool terkelola. Konfigurasi terkait lainnya hanya berlaku jika enable=true.

false

auto_repair

boolean

Apakah akan mengaktifkan perbaikan otomatis. Parameter ini hanya berlaku jika enable=true.

  • true: Mengaktifkan perbaikan otomatis.

  • false: Menonaktifkan perbaikan otomatis.

false

upgrade_config

object

Konfigurasi peningkatan otomatis. Parameter ini hanya berlaku jika enable=true.

auto_upgrade

boolean

Apakah akan mengaktifkan peningkatan otomatis. Nilai valid:

  • true: Mengaktifkan peningkatan otomatis.

  • false: Tidak mengaktifkan peningkatan otomatis.

false

surge

integer

Jumlah node tambahan.

0

surge_percentage

integer

Persentase node tambahan. Anda dapat mengatur parameter ini atau surge.

0

max_unavailable

integer

Jumlah maksimum node yang tidak tersedia. Nilai valid: [1,1000].

Nilai default: 1.

0

auto_repair_policy

object

Kebijakan node perbaikan otomatis.

restart_node

boolean

Apakah akan mengizinkan restart node.

true

auto_vul_fix

boolean

Apakah akan memperbaiki CVE secara otomatis.

true

auto_vul_fix_policy

object

Kebijakan perbaikan CVE otomatis.

restart_node

boolean

Apakah akan mengizinkan restart node.

true

vul_level

string

Level kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan oleh koma.

asap,nntf

auto_upgrade

boolean

Apakah akan mengaktifkan peningkatan otomatis.

true

auto_upgrade_policy

object

Kebijakan peningkatan otomatis.

auto_upgrade_kubelet

boolean

Apakah akan mengizinkan peningkatan kubelet otomatis.

true

auto_fault_diagnosis

boolean

Apakah akan mengaktifkan deteksi fault ECS penyembuhan mandiri node.

drift_enabled

boolean

Apakah akan mengaktifkan rotasi node. Hanya node pool terkelola cerdas yang mendukung fitur ini, dan diaktifkan secara default. Node pool umum tidak mendukung fitur ini.

count

integer

Bidang ini sudah tidak digunakan. Gunakan desired_size sebagai gantinya.

Jumlah node dalam node pool.

1

interconnect_mode

string

Jenis jaringan node pool edge. Parameter ini hanya valid untuk node pool yang type-nya adalah edge. Nilai valid:

  • basic: Dasar.

  • private: Spesifikasi khusus. Didukung dalam versi 1.22 dan lebih baru.

basic

interconnect_config

object

Bidang ini sudah tidak digunakan.

Konfigurasi node pool edge.

cen_id

string

Bidang ini sudah tidak digunakan.

ID instans Cloud Enterprise Network (CEN) yang dilampirkan ke node pool edge yang ditingkatkan.

cen-ey9k9nfhz0f*******

ccn_id

string

Bidang ini sudah tidak digunakan.

ID instans Cloud Connect Network (CCN) yang dilampirkan ke node pool edge yang ditingkatkan.

ccn-qm5i0i0q9yi*******

ccn_region_id

string

This field is deprecated.

The region of the Cloud Connect Network (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. Unit: Mbps.

10

improved_period

string

This field is deprecated.

The purchase duration of the enhanced edge node pool. Unit: months.

1

max_nodes

integer

The maximum number of nodes allowed in the edge node pool. This parameter 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 accommodate, 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

node_config

object

The node configuration.

kubelet_configuration kubelet_config

The Kubelet parameter settings.

node_components

array

The node component list.

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 custom configuration of the node component.

{"cpuManagerPolicy":"static"}

any

The custom configuration string of the node component.

cpuManagerPolicy