All Products
Search
Document Center

Container Service for Kubernetes:ModifyClusterNodePool

Last Updated:Jul 13, 2026

Memperbarui konfigurasi kelompok node berdasarkan ID kelompok node.

Deskripsi operasi

Penting Mulai 04 Juli 2026, parameter permintaan instance_deletion_protection, ingress_loadbalancer_id, dan access_control_list tidak akan berlaku lagi. Untuk informasi lebih lanjut tentang perubahan tersebut, lihat Pengumuman perubahan parameter permintaan dan tanggapan OpenAPI serta penghentian OpenAPI untuk manajemen kluster ACK.

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:ModifyClusterNodePool

update

*Cluster

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

None None

Sintaks permintaan

PUT /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.

p31da1b38983f4511b490fc62108a****

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

Parameter badan permintaan.

nodepool_info

object

No

Konfigurasi kelompok node.

name

string

No

Nama kelompok node.

Aturan penamaan: Panjang nama harus 1 hingga 63 karakter dan dapat berisi angka, karakter Mandarin, huruf, dan tanda hubung (-). Nama tidak boleh diawali dengan tanda hubung (-).

default-nodepool

resource_group_id

string

No

ID kelompok sumber daya kelompok node. Instans yang dibuat oleh kelompok node termasuk dalam kelompok sumber daya ini.

Sebuah resource hanya dapat menjadi milik satu kelompok sumber daya. Anda dapat memetakan kelompok sumber daya ke konsep seperti proyek, aplikasi, atau organisasi berdasarkan skenario bisnis Anda.

rg-acfmyvw3wjm****

auto_scaling

object

No

Konfigurasi penskalaan otomatis.

enable

boolean

No

Apakah akan mengaktifkan penskalaan otomatis. Nilai valid:

  • true: Mengaktifkan fitur penskalaan otomatis untuk node pool. Ketika perencanaan kapasitas kluster tidak dapat memenuhi persyaratan penjadwalan pod aplikasi, ACK secara otomatis melakukan penskalaan sumber daya node berdasarkan jumlah instans minimum dan maksimum yang dikonfigurasi. Kluster versi 1.24 atau lebih baru menggunakan elastisitas instan secara default. Kluster versi sebelumnya dari 1.24 menggunakan penskalaan otomatis secara default. Untuk informasi lebih lanjut, lihat Penskalaan node.

  • false: Menonaktifkan penskalaan otomatis. ACK menyesuaikan kelompok node dalam node pool berdasarkan kelompok node yang diinginkan yang dikonfigurasi dan mempertahankan kelompok node pada nilai yang diinginkan.

Ketika parameter ini diatur ke false, parameter konfigurasi lain dalam auto_scaling tidak berlaku.

Nilai default: false.

true

type deprecated

string

No

Tipe penskalaan otomatis, 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

max_instances

integer

No

Jumlah maksimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada. Parameter ini hanya berlaku ketika enable=true.

Nilai valid: [min_instances, 2000]. Nilai default: 0.

10

min_instances

integer

No

Jumlah minimum instans yang dapat diskalakan kelompok node pool, tidak termasuk instans yang ada. Parameter ini hanya berlaku ketika enable=true.

Nilai valid: [0, max_instances]. Nilai default: 0.

Catatan
  • Jika jumlah instans minimum bukan 0, jumlah Instance ECS yang sesuai akan dibuat secara otomatis setelah grup penskalaan berlaku.

  • Pastikan bahwa jumlah instans maksimum tidak kurang dari jumlah node saat ini kelompok node pool. Jika tidak, node kelompok node pool akan diskalakan masuk setelah fitur skalabilitas elastis berlaku.

2

is_bond_eip deprecated

boolean

No

[Bidang ini sudah tidak digunakan] Bidang ini sudah tidak digunakan. Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya.

  • true: Mengasosiasikan EIP.

  • false: Tidak mengasosiasikan EIP.

Nilai default: false.

null

eip_internet_charge_type deprecated

string

No

[Bidang ini sudah tidak digunakan] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya.

Tipe penagihan EIP. Nilai valid:

  • PayByBandwidth: bayar per bandwidth.

  • PayByTraffic: bayar per transfer data.

Nilai default: PayByBandwidth.

null

eip_bandwidth deprecated

integer

No

[Bidang ini sudah tidak digunakan] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. Bandwidth puncak EIP.

Nilai valid: [1,100]. Unit: Mbit/s.

null

management

object

No

Konfigurasi kelompok node terkelola.

enable

boolean

No

Apakah akan mengaktifkan kelompok node terkelola. Nilai valid:

  • true: Mengaktifkan kelompok node terkelola.

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

Nilai default: false.

true

auto_repair

boolean

No

Apakah akan memperbaiki node secara otomatis. Parameter ini hanya berlaku ketika enable=true.

  • true: Mengaktifkan perbaikan otomatis.

  • false: Menonaktifkan perbaikan otomatis.

Nilai default: true.

true

auto_repair_policy

object

No

Kebijakan node perbaikan otomatis.

restart_node

boolean

No

Apakah akan mengizinkan restart node. Parameter ini hanya berlaku ketika auto_repair=true. Nilai valid:

  • true: Mengizinkan restart node.

  • false: Tidak mengizinkan restart node.

Nilai default: true.

true

approval_required

boolean

No

Apakah perbaikan node memerlukan persetujuan manual.

auto_repair_policy_id

string

No

ID kebijakan perbaikan otomatis.

r-xxxxxxxxxx

auto_vul_fix

boolean

No

Apakah akan memperbaiki kerentanan CVE secara otomatis. Parameter ini hanya berlaku ketika enable=true.

  • true: Mengizinkan perbaikan CVE otomatis.

  • false: Tidak mengizinkan perbaikan CVE otomatis.

Nilai default: true.

true

auto_vul_fix_policy

object

No

Kebijakan perbaikan CVE otomatis.

restart_node

boolean

No

Apakah akan mengizinkan restart node. Parameter ini hanya berlaku ketika auto_vul_fix=true. Nilai valid:

  • true: Mengizinkan restart node.

  • false: Tidak mengizinkan restart node.

Nilai default: true.

true

vul_level

string

No

Tingkat kerentanan yang mengizinkan perbaikan otomatis, dipisahkan dengan koma. Contoh: asap,later. Tingkat kerentanan yang didukung:

  • asap: tinggi

  • later: Menengah

  • nntf: rendah

Nilai default: asap.

asap,nntf

exclude_packages

string

No

Menentukan paket yang dikecualikan selama perbaikan kerentanan.

Nilai default: kernel.

kernel

auto_upgrade

boolean

No

Apakah akan meningkatkan node secara otomatis. Parameter ini hanya berlaku ketika enable=true.

  • true: Mengaktifkan peningkatan otomatis.

  • false: Menonaktifkan peningkatan otomatis.

Nilai default: true.

true

auto_upgrade_policy

object

No

Kebijakan peningkatan otomatis.

auto_upgrade_kubelet

boolean

No

Apakah akan mengizinkan peningkatan kubelet otomatis. Parameter ini hanya berlaku ketika auto_upgrade=true. Nilai valid:

  • true: Mengizinkan peningkatan kubelet otomatis.

  • false: Tidak mengizinkan peningkatan kubelet otomatis.

Nilai default: true.

true

auto_upgrade_runtime

boolean

No

Apakah akan mengizinkan peningkatan waktu proses otomatis. Parameter ini hanya berlaku ketika auto_upgrade=true. Nilai valid:

  • true: Mengizinkan peningkatan waktu proses otomatis.

  • false: Tidak mengizinkan peningkatan waktu proses otomatis.

Nilai default: true.

false

auto_upgrade_os

boolean

No

Apakah akan mengizinkan peningkatan sistem operasi otomatis. Parameter ini hanya berlaku ketika auto_upgrade=true. Nilai valid:

  • true: Mengizinkan peningkatan sistem operasi otomatis.

  • false: Tidak mengizinkan peningkatan sistem operasi otomatis.

Nilai default: false.

false

upgrade_config deprecated

object

No

[Bidang ini sudah tidak digunakan] Gunakan parameter auto_upgrade di level atas sebagai gantinya.

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

auto_upgrade deprecated

boolean

No

[Bidang ini sudah tidak digunakan] Gunakan parameter auto_upgrade di tingkat atas sebagai gantinya.

Apakah akan mengaktifkan peningkatan otomatis:

  • true: Diaktifkan.

  • false: Dinonaktifkan.

Nilai default: true.

true

surge

integer

No

Jumlah node tambahan. Parameter ini dan surge_percentage saling eksklusif.

Node menjadi tidak tersedia selama peningkatan. Anda dapat membuat node tambahan untuk mengompensasi beban kerja kluster.

Catatan

Jumlah node tambahan tidak boleh melebihi jumlah node saat ini.

5

surge_percentage

integer

No

Persentase node tambahan. Parameter ini dan surge saling eksklusif.

Jumlah node tambahan = persentase node tambahan × jumlah node. Misalnya, jika persentase diatur ke 50% dan ada 6 node yang ada, jumlah node tambahan = 50% × 6 = 3.

0

max_unavailable

integer

No

Jumlah maksimum node yang tidak tersedia.

Nilai valid: [1,1000].

Nilai default: 1.

1

auto_fault_diagnosis

boolean

No

Apakah akan mengaktifkan deteksi fault ECS untuk penyembuhan mandiri node.

scaling_group

object

No

Konfigurasi grup penskalaan kelompok node.

vswitch_ids

array

No

Daftar ID vSwitch. Nilai valid: [1,8].

Catatan

Untuk memastikan ketersediaan tinggi, pilih vSwitch di zona yang berbeda.

string

No

ID vSwitch.

vsw-wz9uwxhawmtzg7u9h****

instance_types

array

No

Daftar tipe instans node. Anda dapat memilih beberapa tipe instans sebagai alternatif. Ketika setiap node dibuat, sistem mencoba membeli instans dimulai dari spesifikasi pertama hingga pembuatan berhasil. Tipe instans aktual yang dibeli dapat bervariasi tergantung pada ketersediaan inventaris.

Jumlah tipe instans yang didukung: [1,10].

string

No

Tipe instans. Untuk informasi lebih lanjut, lihat Keluarga instans.

ecs.c6.large

instance_charge_type

string

No

Metode penagihan node dalam node pool. Nilai valid:

  • PrePaid: langganan.

  • PostPaid: bayar sesuai pemakaian.

Nilai default: PostPaid.

PostPaid

period

integer

No

Durasi langganan node dalam node pool. 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}.

1

period_unit

string

No

Siklus penagihan node dalam node pool. Parameter ini berlaku dan diperlukan hanya ketika instance_charge_type diatur ke PrePaid.

  • Month: ditagih bulanan.

  • Week: ditagih mingguan.

Nilai default: Month.

Month

auto_renew

boolean

No

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

  • true: Mengaktifkan perpanjangan otomatis.

  • false: Menonaktifkan perpanjangan otomatis.

Nilai default: false.

true

auto_renew_period

integer

No

Periode perpanjangan otomatis untuk satu kali perpanjangan. Nilai valid:

  • Ketika PeriodUnit=Week: 1, 2, 3.

  • Ketika PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 60.

Nilai default: 1.

1

spot_strategy

string

No

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 lebih lanjut, lihat Spot instans.

SpotWithPriceLimit

spot_price_limit

array<object>

No

Konfigurasi batas harga untuk spot instans.

object

No

Konfigurasi batas harga untuk spot instans.

instance_type

string

No

Tipe spot instans.

ecs.c6.large

price_limit

string

No

Harga maksimum per instans.

Unit: USD/jam.

0.39

image_type

string

No

Tipe distribusi sistem operasi. Gunakan bidang ini untuk menentukan sistem operasi node. Nilai valid:

  • AliyunLinux: Image Alinux 2.

  • AliyunLinuxSecurity: Image UEFI Alinux 2.

  • AliyunLinux3: Image Alinux 3.

  • AliyunLinux3Arm64: Image ARM Alinux 3.

  • AliyunLinux3Security: Image UEFI Alinux 3.

  • CentOS: Image CentOS.

  • Windows: Image Windows.

  • WindowsCore: Image WindowsCore.

  • ContainerOS: Image yang dioptimalkan untuk kontainer.

  • AliyunLinux3ContainerOptimized: Image yang dioptimalkan untuk kontainer Alinux 3.

AliyunLinux3

image_id

string

No

ID gambar kustom. Anda dapat memanggil DescribeKubernetesVersionMetadata untuk mengkueri image yang didukung oleh sistem. Secara default, image sistem terbaru digunakan.

aliyun_3_x64_20G_alibase_20241218.vhd

system_disk_category

string

No

Tipe cloud disk sistem node. Nilai valid:

  • cloud_efficiency: ultra cloud disk.

  • cloud_ssd: SSD standar.

  • cloud_essd: SSD Perusahaan (ESSD).

  • cloud_auto: Cloud disk ESSD AutoPL.

  • cloud_essd_entry: Cloud disk ESSD Entry.

Nilai default: cloud_efficiency.

cloud_efficiency

system_disk_categories

array

No

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

No

Beberapa tipe Tipe disk sistem untuk node.

Nilai valid:

  • cloud_efficiency: ultra Tipe disk.

  • cloud_ssd: SSD standar.

  • cloud_essd: ESSD.

  • cloud_auto: Tipe disk ESSD AutoPL.

  • cloud_essd_entry: Disk ESSD Entry.

cloud_essd

system_disk_size

integer

No

Ukuran cloud disk sistem node. Unit: GiB.

Nilai valid: [20,2048].

Nilai parameter ini harus lebih besar atau sama dengan max{20, ImageSize}.

Nilai default: max{40, ukuran image yang sesuai dengan parameter ImageId}.

120

system_disk_performance_level

string

No

Tingkat kinerja cloud disk sistem node. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja berkaitan dengan 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

No

Apakah akan mengenkripsi cloud disk sistem. Nilai valid:

  • true: Mengenkripsi cloud disk sistem.

  • false: Tidak mengenkripsi cloud disk sistem.

false

system_disk_kms_key_id

string

No

ID kunci KMS yang digunakan oleh cloud disk sistem.

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

system_disk_encrypt_algorithm

string

No

Algoritma enkripsi yang digunakan oleh cloud disk sistem. Nilai valid: aes-256.

aes-256

system_disk_provisioned_iops

integer

No

IOPS baca/tulis yang disediakan untuk cloud disk sistem node.

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

system_disk_bursting_enabled

boolean

No

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

  • true: Mengaktifkan burst. Ketika diaktifkan, cloud disk sementara meningkatkan performa selama tekanan baca/tulis data mendadak dari beban kerja yang berfluktuasi hingga beban kerja kembali ke keadaan stabil.

  • false: Menonaktifkan burst.

Parameter ini hanya didukung ketika system_disk_category diatur ke cloud_auto. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.

true

data_disks

array

No

Konfigurasi cloud disk data untuk node. Nilai valid: [0,10]. Anda dapat menambahkan hingga 10 cloud disk data.

data_disk

No

Konfigurasi cloud disk data untuk sebuah node.

disk_init

array

No

Konfigurasi inisialisasi perangkat blok.

DiskInit

No

Konfigurasi inisialisasi perangkat blok.

key_pair

string

No

Nama pasangan kunci. Parameter ini dan login_password saling eksklusif. Ketika node pool adalah node pool terkelola, hanya key_pair yang didukung.

pro-nodepool

login_password

string

No

Kata sandi logon SSH. Parameter ini dan key_pair saling eksklusif. Panjang kata sandi harus 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari tipe karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus.

Hello1234

internet_charge_type

string

No

Tipe penagihan untuk alamat IP publik. Nilai valid:

  • PayByBandwidth: bayar per bandwidth.

  • PayByTraffic: bayar per transfer data.

PayByBandwidth

internet_max_bandwidth_out

integer

No

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

5

tags

array

No

Tag yang hanya ditambahkan ke Instance ECS.

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

tag

No

Tag Instance ECS.

desired_size

integer

No

Jumlah node yang diinginkan dalam kelompok node.

Jumlah total node yang harus dipertahankan oleh kelompok node. Konfigurasikan setidaknya 2 node untuk memastikan komponen kluster berjalan dengan benar. Anda dapat melakukan penskalaan masuk atau keluar kelompok node dengan menyesuaikan jumlah node yang diinginkan.

Jika Anda tidak perlu membuat node, atur parameter ini ke 0 dan sesuaikan jumlah node secara manual nanti.

2

multi_az_policy

string

No

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 untuk membuat Instance ECS.

  • COST_OPTIMIZED: Mencoba membuat instans dalam urutan menaik harga per 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, Anda dapat memanggil operasi API RebalanceInstances untuk menyeimbangkan ulang sumber daya. Untuk informasi lebih lanjut, lihat RebalanceInstances.

Nilai default: PRIORITY.

BALANCE

scaling_policy

string

No

Mode grup penskalaan. Nilai valid:

  • release: mode standar. Melakukan penskalaan dengan membuat dan merilis instans ECS berdasarkan penggunaan sumber daya.

  • recycle: mode cepat. Melakukan penskalaan dengan membuat, menghentikan, dan memulai instans, yang meningkatkan kecepatan operasi penskalaan berikutnya. (Instans yang dihentikan tidak dikenai biaya untuk resource komputasi, tetapi biaya penyimpanan tetap berlaku, kecuali untuk instans dengan disk lokal.)

release

on_demand_base_capacity

integer

No

Jumlah minimum instans bayar sesuai pemakaian yang diperlukan oleh grup penskalaan. Nilai valid: [0,1000]. Instans bayar sesuai pemakaian dibuat terlebih dahulu ketika jumlah instans bayar sesuai pemakaian kurang dari nilai ini.

0

on_demand_percentage_above_base_capacity

integer

No

Persentase instans bayar sesuai pemakaian di antara instans yang melebihi jumlah minimum instans bayar sesuai pemakai.

20

spot_instance_pools

integer

No

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

No

Apakah akan mengaktifkan penggantian spot instans. 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: Mengaktifkan penggantian spot instans.

  • false: Menonaktifkan penggantian spot instans.

false

compensate_with_on_demand

boolean

No

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 jika spot instans yang cukup tidak dapat dibuat karena alasan biaya atau inventaris. 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

rds_instances

array

No

Daftar instans RDS.

string

No

ID instans RDS. Jika daftar instans RDS ditentukan, instans ECS dari node kluster secara otomatis ditambahkan ke daftar putih akses RDS.

rds-xxx

private_pool_options

object

No

Konfigurasi node pool pribadi.

id

string

No

ID kelompok node pribadi. Ketika match_criteria diatur ke Target, Anda harus menentukan ID kolam pribadi.

eap-bp67acfmxazb4****

match_criteria

string

No

Tipe kelompok node pribadi, yaitu 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. Sistem secara otomatis mencocokkan kapasitas kolam pribadi terbuka. Jika tidak ada kapasitas kolam pribadi yang cocok, resource kolam publik digunakan.

  • Target: Mode tertarget. Instans diluncurkan menggunakan kapasitas kolam pribadi yang ditentukan. Jika kapasitas kolam pribadi yang ditentukan tidak tersedia, pembuatan instans gagal.

  • None: Mode tanpa. Kapasitas kolam pribadi tidak digunakan untuk peluncuran instans.

Open

platform deprecated

string

No

Bidang ini sudah tidak digunakan. Gunakan parameter image_type sebagai gantinya.

Platform sistem operasi. Nilai valid:

  • AliyunLinux

  • CentOS

  • Windows

  • WindowsCore

AliyunLinux

instance_patterns

array

No

Konfigurasi atribut instans.

instance_patterns

No

Atribut instans. [

deploymentset_id

string

No

ID set penyebaran untuk instans ECS yang dibuat oleh node pool. Pengaturan ini hanya berlaku untuk node baru. Set penyebaran node yang ada tidak diubah.

ds-bp1d19mmbsv3jf6xxxxx

security_group_ids

array

No

Daftar ID grup keamanan.

string

No

ID grup keamanan. [_single.params.body.props.scaling_group.resource_pool

sg-wz9a8g2mt6x5ll******

resource_pool_options

object

No

Kolam sumber daya dan strategi kolam sumber daya yang digunakan saat membuat instans. Perhatikan hal berikut saat Anda mengatur parameter ini: Parameter ini hanya berlaku saat membuat instans bayar sesuai pemakaian. Parameter ini tidak dapat diatur bersama dengan private_pool_options.match.

strategy

string

No

The resource pool strategy used when creating instances. Resource pools include private pools generated after an elasticity assurance or capacity reservation takes effect, and public pools, for instance launching. Valid values: PrivatePoolFirst: private pool first. When this strategy is selected, if resouce_pool_options.private_pool_ids is specified, the specified private pools are used first. If no private pool is specified or the specified private pool capacity is insufficient, open private pools are automatically matched. If no matching private pool is available, public pool resources are used. PrivatePoolOnly: private pool only. When this strategy is selected, you must specify resouce_pool_options.private_pool_ids. If the specified private pool capacity is insufficient, instance creation fails. None: no resource pool strategy is used. Default value: None.

PrivatePoolFirst

private_pool_ids

array

No

The list of private pool IDs, which are elasticity assurance IDs or capacity reservation IDs. Only Target mode private pool IDs can be specified. Valid values of N: 1 to 20.

string

No

The private pool ID, which is the elasticity assurance ID or capacity reservation ID. Only Target mode private pool IDs can be specified.

eap-bp67acfmxazb4****

system_disk_snapshot_policy_id

string

No

The snapshot policy for the system cloud disk.

sp-0jl6xnmme8v7o935****

kubernetes_config

object

No

The cluster-related configuration.

labels

array

No

The node labels. Adds labels to Kubernetes cluster nodes. Label definition rules:

  • Labels consist of case-sensitive key-value pairs. You can set up to 20 labels.

  • Label keys cannot be duplicated and can be up to 64 characters in length. Label values can be empty and can be up to 128 characters in length. Neither label keys nor label values can start with aliyun, acs:, https://, or http://. For more information, see Labels and Selectors.

tag

No

The node label.

taints

array

No

The node taint configuration.

taint

No

The node taint configuration.

runtime

string

No

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.

Default value: containerd.

containerd

runtime_version

string

No

The container runtime version.

1.6.38

cpu_policy

string

No

The node CPU management policy. The following two policies are supported for cluster versions 1.12.6 and later:

  • static: allows enhanced CPU affinity and exclusivity for pods with certain resource characteristics on the node.

  • none: uses the existing default CPU affinity scheme.

Default value: none.

none

unschedulable

boolean

No

Specifies whether the nodes added during scale-out are unschedulable.

  • true: unschedulable.

  • false: schedulable.

false

user_data

string

No

The instance user data. After the node joins the cluster, the specified user data script is run. For more information, see User data scripts.

IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi

cms_enabled

boolean

No

Specifies whether to install the CloudMonitor agent on ECS nodes. After installation, you can view monitoring information of 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.

Default value: false.

true

pre_user_data

string

No

The pre-instance user data. Before the node joins the cluster, the specified pre-user data script is run. For more information, see User data scripts.

IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi

node_name_mode

string

No

The custom node name parameter. A node name consists of three parts: prefix + node IP + 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 node IP is the full private IP address of the node.

The parameter contains four parts separated by commas. For example, if you pass in the string "customized,aliyun,ip,com" (where "customized" and "ip" are fixed strings, "aliyun" is the prefix, and "com" is the suffix), the node name is: aliyun.192.168.xxx.xxx.com.

customized,aliyun,ip,com

tee_config

object

No

The confidential computing cluster configuration.

tee_enable

boolean

No

Specifies whether to enable confidential computing for the cluster. Valid values:

  • true: Enabled.

  • false: Disabled.

Default value: false.

false

update_nodes

boolean

No

Synchronously updates node labels and taints.

true

concurrency

boolean

No

Specifies whether to enable concurrency.

true

eflo_node_group

object

No

The Lingjun node pool configuration. (Not effective)

auto_attach_enabled

string

No

Specifies whether to enable automatic addition for the Lingjun node pool. (Not effective)

Elemen respons

Element

Type

Description

Example

object

The response body data.

task_id

string

The task ID.

T-5fd211e924e1d00787000293

nodepool_id

string

ID kelompok node.

np737c3ac1ac684703b9e10673aa2c****

request_id

string

The request ID.

687C5BAA-D103-4993-884B-C35E4314****

Contoh

Respons sukses

JSONformat

{
  "task_id": "T-5fd211e924e1d00787000293",
  "nodepool_id": "np737c3ac1ac684703b9e10673aa2c****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.