All Products
Search
Document Center

Container Service for Kubernetes:nodepool

Last Updated:Jun 25, 2026

Parameter

Type

Description

Example

object

Kelompok node.

auto_scaling

object

Konfigurasi penskalaan otomatis kelompok node.

enable

boolean

Apakah akan mengaktifkan penskalaan otomatis.

  • true: Mengaktifkan penskalaan otomatis untuk kelompok node.

  • false: Menonaktifkan penskalaan otomatis. Jika parameter ini diatur ke false, parameter konfigurasi lain di auto_scaling tidak akan 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 penskalaan otomatis, diklasifikasikan berdasarkan tipe instans. Nilai valid:

  • cpu: tipe instans reguler.

  • gpu: tipe instans yang dipercepat GPU.

  • gpushare: tipe instans berbagi GPU.

  • spot: tipe spot instans.

Nilai default: cpu.

cpu

is_bond_eip

boolean

[Bidang ini tidak digunakan lagi].

Apakah akan mengaitkan EIP. Nilai valid:

  • true: Mengaitkan EIP.

  • false: Tidak mengaitkan EIP.

Nilai default: false.

true

eip_internet_charge_type

string

[Bidang ini tidak digunakan lagi].

Metode penagihan EIP. Nilai valid:

  • PayByBandwidth: bayar berdasarkan bandwidth.

  • PayByTraffic: bayar berdasarkan trafik.

Nilai default: PayByBandwidth.

PayByBandwidth

eip_bandwidth

integer

[Bidang ini tidak digunakan lagi]

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 penginstalan, Anda dapat Tampilan informasi pemantauan Instance ECS yang dibuat di konsol CloudMonitor. Kami menyarankan Anda mengaktifkan fitur ini. Nilai valid:

  • true: Menginstal agen CloudMonitor pada node ECS.

  • false: Tidak menginstal agen CloudMonitor pada node ECS.

Nilai default: false.

true

cpu_policy

string

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

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

  • none: Menggunakan skema afinitas CPU default yang ada. Nilai default: none.

none

labels

array

Label node. Menambahkan label ke node kluster Kubernetes.

tag

Label node.

runtime

string

Runtime kontainer. Nilai valid:

  • containerd: Direkomendasikan. Mendukung semua versi kluster.

  • Sandboxed-Container.runv: Kontainer sandbox yang menyediakan isolasi 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 pengguna node.

MXM=

node_name_mode

string

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

  • Awalan dan akhiran masing-masing dapat berisi satu atau beberapa bagian yang dipisahkan oleh titik (.). Setiap bagian dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama node harus diawali dan diakhiri dengan huruf kecil atau angka.

  • IP node adalah alamat IP privat lengkap node.

Parameter ini berisi empat bagian yang dipisahkan oleh koma. Misalnya, jika Anda meneruskan 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 kelompok node.

name

string

Nama kelompok node.

np-test

resource_group_id

string

ID kelompok sumber daya tempat kelompok node berada.

rg-acfmyvw3wjm****

type

string

Tipe kelompok node. Nilai valid:

  • ess: kelompok node reguler.

  • edge: kelompok node edge.

ess

scaling_group

object

Konfigurasi grup penskalaan kelompok node.

auto_renew

boolean

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

  • true: Perpanjangan otomatis diaktifkan.

  • false: Perpanjangan otomatis dinonaktifkan.

Nilai default: true.

false

auto_renew_period

integer

Epoch perpanjangan otomatis kelompok node. Parameter ini berlaku dan wajib diisi hanya jika instance_charge_type diatur 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 kelompok node.

data_disk

Konfigurasi cloud disk data untuk node dalam kelompok node.

disk_init

array

Konfigurasi inisialisasi perangkat blok.

DiskInit

Konfigurasi DiskInit.

image_id

string

ID gambar kustom. Secara default, gambar yang disediakan sistem digunakan.

aliyun_2_1903_x64_20G_alibase_20200904.vhd

instance_charge_type

string

Metode penagihan untuk node dalam kelompok node. 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

Jika Anda membuat kelompok node terkelola, hanya key_pair yang didukung.

np-key

login_password

string

Kata sandi logon SSH. Tentukan parameter ini atau key_pair. Kata sandi harus terdiri dari 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 akan logon ke Instans ECS sebagai pengguna non-root.

period

integer

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

Nilai default: 1.

0

period_unit

string

Unit periode langganan untuk node dalam kelompok node. Parameter ini harus ditentukan jika instance_charge_type diatur 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 ApsaraDB RDS.

string

ID instans ApsaraDB RDS.

rm-2zey3t89t6280****

spot_strategy

string

Tipe spot instans. Nilai valid:

  • NoSpot: instans non-spot.

  • SpotWithPriceLimit: spot instans dengan batas harga.

  • SpotAsPriceGo: spot instans dengan harga pasar pada waktu pembelian.

Untuk informasi selengkapnya, lihat Spot instances.

NoSpot

spot_price_limit

array

Konfigurasi batas harga untuk satu spot instans dari tipe instans yang ditentukan.

object

instance_type

string

Tipe instans spot instans.

ecs.c6.large

price_limit

string

Harga maksimum per instans.

0.39

scaling_policy

string

Mode kelompok penskalaan. Nilai valid:

  • release: mode standar. Instance ECS dibuat dan dirilis berdasarkan Penggunaan sumber daya.

  • recycle: mode cepat. Instance ECS dibuat, dihentikan, dan dimulai ulang untuk penskalaan, yang mempercepat penskalaan berikutnya. Sumber daya komputasi tidak dikenakan biaya selama status dihentikan. Hanya biaya penyimpanan yang dikenakan, kecuali untuk instans dengan disk lokal.

Nilai default: rilis.

release

security_group_id

string

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

sg-2zeihch86ooz9io4****

security_group_ids

array

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

string

ID kelompok keamanan.

sg-2zeihch86ooz9io4****

system_disk_category

string

Tipe cloud disk sistem node. Nilai valid:

  • cloud_efficiency: ultra cloud disk.

  • cloud_ssd: SSD standar.

  • cloud_essd: cloud disk 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 prioritas tertinggi tidak tersedia, sistem secara otomatis mencoba tipe Tipe disk prioritas berikutnya. Nilai valid:

  • cloud: Tipe disk dasar.

  • 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 node. Unit: GiB.

Nilai valid: [40,500].

120

system_disk_performance_level

string

Tingkat kinerja cloud disk sistem node. Parameter ini 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: Enkripsi. false: Jangan enkripsi.

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 yang digunakan 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 garis dasar}. Kinerja garis dasar = min{1,800+50*kapasitas, 50000}.

Parameter ini hanya didukung ketika SystemDiskCategory diatur ke cloud_auto. Untuk informasi lebih lanjut, 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: mengaktifkan burst.

  • false: menonaktifkan burst.

Parameter ini hanya didukung jika SystemDiskCategory diatur ke cloud_auto. Untuk informasi selengkapnya, lihat ESSD AutoPL cloud disks.

true

tags

array

Menambahkan tag hanya ke Instans ECS.

Kunci tag tidak boleh duplikat dan dapat memiliki panjang hingga 128 karakter. Kunci tag dan nilai tag tidak boleh diawali 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 di grup penskalaan. Nilai valid:

  • PRIORITY: melakukan penskalaan instans berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Jika Instance ECS tidak dapat dibuat di zona vSwitch dengan prioritas tertinggi, sistem secara otomatis menggunakan vSwitch dengan prioritas tertinggi berikutnya untuk membuat Instance ECS.

  • COST_OPTIMIZED: Mencoba membuat Instans berdasarkan urutan harga satuan vCPU dari yang terendah. Ketika konfigurasi penskalaan menetapkan beberapa tipe instans dengan metode penagihan spot, spot instans dibuat terlebih dahulu. Anda dapat menggunakan parameter CompensateWithOnDemand untuk menentukan apakah sistem diizinkan secara otomatis mencoba membuat instans pay-as-you-go ketika spot instans tidak dapat dibuat karena inventaris tidak mencukupi atau alasan lainnya.

    Catatan

    COST_OPTIMIZED hanya berlaku jika konfigurasi penskalaan menentukan beberapa tipe instans atau menggunakan spot instans.

  • BALANCE: Mendistribusikan Instans ECS secara merata ke beberapa zona yang ditentukan di grup penskalaan. Jika zona menjadi tidak seimbang karena inventaris tidak mencukupi atau alasan lainnya, Anda dapat memanggil operasi RebalanceInstances untuk menyeimbangkan ulang Sumber daya. Untuk informasi lebih lanjut, lihat RebalanceInstances.

Nilai default: PRIORITY.

COST_OPTIMIZED

on_demand_base_capacity

integer

Jumlah minimum instans pay-as-you-go yang diperlukan di grup penskalaan. Nilai valid: 0 hingga 1000. Ketika jumlah instans pay-as-you-go kurang dari nilai ini, instans pay-as-you-go dibuat terlebih dahulu.

0

on_demand_percentage_above_base_capacity

integer

Persentase instans pay-as-you-go di antara instans yang melebihi jumlah minimum instans pay-as-you-go (on_demand_base_capacity) di grup penskalaan. Nilai valid: 0 hingga 100.

20

spot_instance_pools

integer

Jumlah tipe instans yang tersedia. Grup penskalaan membuat spot instans dari beberapa tipe dengan biaya terendah. Nilai valid: 1 hingga 10.

5

spot_instance_remedy

boolean

Apakah akan mengaktifkan suplementasi spot instans. Jika diaktifkan, ketika sistem mengirim notifikasi bahwa spot instans akan ditarik kembali, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan ditarik kembali. Nilai valid:

  • true: Mengaktifkan suplementasi spot instans.

  • false: Menonaktifkan suplementasi spot instans.

false

compensate_with_on_demand

boolean

Ketika multi_az_policy diatur ke COST_OPTIMIZED, apakah akan mengizinkan sistem untuk secara otomatis mencoba membuat instans pay-as-you-go untuk memenuhi jumlah Instans ECS yang diperlukan ketika spot instans tidak dapat dibuat karena biaya, inventaris, atau alasan lainnya. Nilai valid:

  • true: Diizinkan.

  • false: Tidak diizinkan.

true

internet_charge_type

string

Metode penagihan untuk alamat IP publik. Nilai valid:

  • PayByBandwidth: ditagih berdasarkan bandwidth tetap.

  • PayByTraffic: ditagih berdasarkan transfer data.

PayByBandwidth

internet_max_bandwidth_out

integer

Bandwidth keluar maksimum untuk alamat IP publik node. Unit: Mbit/s. Nilai valid: 1 hingga 100.

10

image_type

string

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

  • AliyunLinux: Image Alinux 2.

  • AliyunLinux3: Image Alinux 3.

  • AliyunLinux3Arm64: Image Alinux 3 ARM.

  • AliyunLinuxUEFI: Image UEFI Alinux 2.

  • 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 kelompok node.

2

private_pool_options

object

Konfigurasi private pool.

id

string

ID private pool.

eap-bp67acfmxazb4****

match_criteria

string

Tipe kolam privat, yang menentukan opsi kapasitas kolam privat untuk memulai instans. Setelah jaminan elastisitas atau reservasi kapasitas berlaku, kolam privat dihasilkan agar dapat digunakan oleh instans saat memulai. Nilai valid:

  • Open: Mode terbuka. Sistem secara otomatis mencocokkan kapasitas kolam privat terbuka. Jika tidak ada kapasitas kolam privat yang cocok tersedia, sumber daya kolam publik digunakan untuk memulai instans.

  • Target: Mode tertarget. Instans dimulai dengan menggunakan kapasitas private pool yang ditentukan. Jika kapasitas private pool yang ditentukan tidak tersedia, instans gagal dimulai.

  • None: Mode None. Instans tidak menggunakan kapasitas private pool saat memulai.

Open

ram_role_name

string

Nama Peran RAM worker.

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

example-role

instance_metadata_options InstanceMetadataOptions

Konfigurasi akses metadata untuk Instans ECS. Parameter ini saat ini hanya tersedia untuk pengguna dalam daftar putih. Untuk menggunakan parameter ini, ajukan tiket.

resource_pool_options

object

Kolam sumber daya dan strategi kolam sumber daya yang digunakan saat membuat instans. Setelah Anda menetapkan parameter ini, perhatikan hal berikut: Parameter ini hanya berlaku saat Anda membuat instans bayar sesuai pemakaian. Parameter ini tidak dapat ditetapkan bersama dengan private_pool_options.match_criteria atau private_pool_options.id.

strategy

string

Strategi kolam sumber daya yang digunakan saat membuat instans. Kolam sumber daya mencakup private pool yang dihasilkan setelah jaminan elastisitas atau reservasi kapasitas berlaku, serta pool publik, untuk digunakan instans saat memulai. Nilai valid: PrivatePoolFirst: Private pool terlebih dahulu. Saat strategi ini dipilih, jika resource_pool_options.private_pool_ids ditentukan, private pool yang ditentukan akan digunakan terlebih dahulu. Jika tidak ada private pool yang ditentukan atau kapasitas private pool yang ditentukan tidak mencukupi, private pool terbuka akan dicocokkan secara otomatis. Jika tidak ada private pool yang cocok, resource pool publik akan digunakan untuk membuat instans. PrivatePoolOnly: Hanya private pool. Saat strategi ini dipilih, Anda harus menentukan resource_pool_options.private_pool_ids. Jika kapasitas private pool yang ditentukan tidak mencukupi, instans gagal dimulai. None: Tidak menggunakan strategi kolam sumber daya. Nilai default: None.

PrivatePoolFirst

private_pool_ids

array

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

string

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

eap-bp67acfmxazb4****

tee_config

object

Konfigurasi kelompok node komputasi rahasia.

tee_enable

boolean

Apakah kelompok node merupakan kelompok node komputasi rahasia.

false

management

object

Konfigurasi kelompok node terkelola.

enable

boolean

Apakah akan mengaktifkan kelompok node terkelola. Nilai valid:

  • true: Mengaktifkan kelompok node terkelola.

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

false

auto_repair

boolean

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

  • true: Mengaktifkan perbaikan otomatis.

  • false: Tidak mengaktifkan perbaikan otomatis.

false

upgrade_config

object

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

auto_upgrade

boolean

Apakah akan mengaktifkan peningkatan otomatis. Nilai valid:

  • true: Mengaktifkan peningkatan otomatis.

  • false: Menonaktifkan peningkatan otomatis.

false

surge

integer

Jumlah node tambahan.

0

surge_percentage

integer

Persentase node tambahan. Anda dapat menetapkan 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 perbaikan node 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

Tingkat kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan dengan 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

count

integer

[Bidang ini tidak digunakan lagi. Gunakan desired_size sebagai gantinya.]

Jumlah node dalam kelompok node.

1

interconnect_mode

string

Jenis jaringan kelompok node tepi. Nilai ini hanya valid untuk kelompok node dengan type edge. Nilai valid:

  • basic: dasar.

  • private: khusus. Didukung pada versi 1.22 dan yang lebih baru.

basic

interconnect_config

object

[Bidang ini tidak digunakan lagi.]

Konfigurasi kelompok node tepi.

cen_id

string

[Bidang ini tidak digunakan lagi]

ID instans Cloud Enterprise Network (CEN) yang terpasang pada kelompok node tepi yang ditingkatkan.

cen-ey9k9nfhz0f*******

ccn_id

string

[Bidang ini tidak digunakan lagi]

ID instans Cloud Connect Network (CCN) yang terpasang pada kelompok node tepi yang ditingkatkan.

ccn-qm5i0i0q9yi*******

ccn_region_id

string

[Bidang ini tidak digunakan lagi]

Wilayah instans Cloud Connect Network (CCN) yang terikat pada kelompok node tepi yang ditingkatkan.

cn-shanghai

bandwidth

integer

[Bidang ini tidak digunakan lagi]

Bandwidth jaringan kelompok node tepi yang ditingkatkan. Unit: Mbps.

10

improved_period

string

[Bidang ini tidak digunakan lagi]

Durasi langganan kelompok node tepi yang ditingkatkan. Unit: bulan.

1

max_nodes

integer

Jumlah maksimum node yang diizinkan dalam kelompok node tepi. Parameter ini harus lebih besar dari atau sama dengan 0. Nilai 0 menunjukkan tidak ada batas tambahan (kelompok node hanya dibatasi oleh jumlah maksimum node yang dapat ditampung kluster). Untuk kelompok node tepi, nilai ini biasanya lebih besar dari 0. Untuk kelompok node tipe ESS dan kelompok node tipe tepi default, nilai ini adalah 0.

10

node_config

object

Konfigurasi node.

kubelet_configuration kubelet_config

Pengaturan parameter kubelet.

node_components

array

Daftar komponen node.

object

Komponen node.

name

string

Nama komponen node.

kubelet

version

string

Versi komponen node.

1.33.3-aliyun.1

config

object

Konfigurasi komponen node.

custom_config

object

Konfigurasi kustom komponen node.

{"cpuManagerPolicy":"static"}

any

The custom configuration string of the node component.

cpuManagerPolicy