CreateClusterNodePool - Container Service for Kubernetes

Kelompok node adalah kumpulan logis node yang memiliki atribut sama, memungkinkan manajemen terpusat dan operasi O&M seperti peningkatan node dan skalabilitas elastis. Anda dapat memanfaatkan kemampuan O&M otomatis dari kelompok node, termasuk patching kerentanan CVE OS otomatis, pemulihan node rusak otomatis, serta peningkatan versi kubelet dan containerd otomatis, untuk mengurangi biaya O&M. Anda dapat memanggil CreateClusterNodePool untuk membuat kelompok node bagi sebuah kluster.

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

create

*Cluster

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

None

Sintaks permintaan

POST /clusters/{ClusterId}/nodepools HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
ClusterId	string	Yes	ID kluster.	c61da77e8bfbc4c4c999af2b51b65****

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Parameter badan permintaan.
nodepool_info	object	No	Konfigurasi kelompok node.
name	string	Yes	Nama kelompok node.	nodepool-test
type	string	No	Tipe kelompok node. Nilai valid: `ess`: kelompok node reguler (termasuk fitur terkelola dan skalabilitas elastis otomatis). `edge`: kelompok node edge. `lingjun`: kelompok node Node Lingjun. `hybrid`: kelompok node cloud hibrida. Valid values: lingjun : kelompok node Node Lingjun. edge : kelompok node edge. ess : kelompok node reguler.	ess
resource_group_id	string	No	ID kelompok sumber daya kelompok node. Instans yang diskalakan keluar 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-acfmyvw3wjmb****
auto_scaling	object	No	Konfigurasi skalabilitas elastis otomatis.
enable	boolean	No	Apakah akan mengaktifkan skalabilitas otomatis. Nilai valid: `true`: Mengaktifkan fitur skalabilitas 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 mengaktifkan penskalaan node instan secara default. Kluster versi sebelumnya dari 1.24 mengaktifkan penskalaan node otomatis secara default. Untuk informasi lebih lanjut, lihat Penskalaan node. `false`: Menonaktifkan skalabilitas otomatis. ACK menyesuaikan jumlah node di kelompok node berdasarkan jumlah node desired yang dikonfigurasi dan mempertahankan jumlah node pada nilai desired tersebut. Ketika nilainya false, parameter konfigurasi lain di `auto_scaling` tidak berlaku. Nilai default: `false`.	false
type	string	No	Tipe instans untuk skalabilitas elastis otomatis. Parameter ini hanya berlaku ketika `enable=true`. Nilai valid: `cpu`: tipe instans reguler. `gpu`: tipe instans GPU. `gpushare`: tipe berbagi GPU. `spot`: tipe spot instans. Nilai default: `cpu`. Penting Parameter ini tidak dapat dimodifikasi setelah kelompok node dibuat. Valid values: spot : tipe spot instans. cpu : tipe instans reguler. gpushare : tipe berbagi GPU. gpu : tipe instans GPU.	cpu
max_instances	integer	No	Jumlah maksimum instans yang dapat diskalakan di kelompok node, tidak termasuk instans yang sudah 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 di kelompok node, tidak termasuk instans yang sudah ada. Parameter ini hanya berlaku ketika `enable=true`. Nilai valid: [0, max_instances]. Nilai default: 0. Catatan Jika jumlah minimum instans bukan 0, grup penskalaan akan melakukan pembuatan otomatis sejumlah Instance ECS yang sesuai setelah pengaturan berlaku. Atur jumlah maksimum instans ke nilai yang tidak kurang dari jumlah node saat ini di kelompok node. Jika tidak, node di kelompok node akan diskalakan masuk setelah fitur skalabilitas elastis berlaku.	1
is_bond_eip `deprecated`	boolean	No	[Sudah usang] Parameter ini sudah usang. Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. Apakah akan mengaitkan elastic IP address (EIP). Nilai valid: `true`: Mengaitkan EIP. `false`: Tidak mengaitkan EIP. Nilai default: `false`.	null
eip_internet_charge_type `deprecated`	string	No	[Sudah usang] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. Metode penagihan untuk EIP. Nilai valid: `PayByBandwidth`: bayar berdasarkan bandwidth. `PayByTraffic`: bayar berdasarkan transfer data. Nilai default: `PayByBandwidth`.	null
eip_bandwidth `deprecated`	integer	No	[Sudah usang] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. Bandwidth puncak EIP. Unit: Mbit/s.	null
management	object	No	Konfigurasi fitur terkelola untuk kelompok node.
enable	boolean	No	Apakah akan mengaktifkan fitur terkelola untuk kelompok node. Nilai valid: `true`: Mengaktifkan fitur terkelola. `false`: Menonaktifkan fitur terkelola. Konfigurasi terkait lainnya hanya berlaku ketika enable=true. Nilai default: false.	false
auto_repair	boolean	No	Apakah akan memperbaiki node secara otomatis. Parameter ini hanya berlaku ketika `enable=true`. `true`: Memperbaiki node secara otomatis. `false`: Tidak memperbaiki node secara otomatis. Nilai default: `true`.	true
auto_repair_policy	object	No	Kebijakan perbaikan node otomatis.
restart_node	boolean	No	Apakah akan mengizinkan restart node. 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_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. Hanya berlaku ketika `auto_vul_fix=true`. Nilai valid: `true`: Mengizinkan restart node. `false`: Tidak mengizinkan restart node. Nilai default: `true`.	false
vul_level	string	No	Tingkat kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan dengan koma, misalnya: `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 node otomatis.
auto_upgrade_kubelet	boolean	No	Apakah akan mengizinkan peningkatan kubelet otomatis. 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. 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 OS otomatis. Hanya berlaku ketika `auto_upgrade=true`. Nilai valid: `true`: Mengizinkan peningkatan OS otomatis. `false`: Tidak mengizinkan peningkatan OS otomatis. Nilai default: `false`.	false
upgrade_config `deprecated`	object	No	[Sudah usang] Gunakan parameter `auto_upgrade` di tingkat atas sebagai gantinya. Konfigurasi peningkatan otomatis. Parameter ini hanya berlaku ketika `enable=true`.
auto_upgrade `deprecated`	boolean	No	[Tidak digunakan lagi] Silakan gunakan parameter `auto_upgrade` di tingkat atas sebagai gantinya. Apakah akan mengaktifkan peningkatan otomatis. Nilai valid: `true`: Mengaktifkan peningkatan otomatis. `false`: Menonaktifkan peningkatan otomatis.	null
surge	integer	No	Jumlah node tambahan. Saling eksklusif dengan `surge_percentage`. Node menjadi tidak tersedia selama peningkatan. Anda dapat membuat node tambahan untuk mengompensasi beban kerja kluster. Catatan Kami merekomendasikan agar jumlah node tambahan tidak melebihi jumlah node saat ini.	0
surge_percentage	integer	No	Persentase node tambahan. Saling eksklusif dengan `surge`. Node tambahan = persentase node tambahan x jumlah node. Misalnya, jika persentase node tambahan diatur ke 50% dan jumlah node yang ada adalah 6, jumlah node tambahan = 50% x 6, yang menghasilkan 3 node tambahan.	0
max_unavailable	integer	No	Jumlah maksimum node yang tidak tersedia. Rentang nilai: [1, 1000] Nilai default: 1.	1
auto_fault_diagnosis	boolean	No
scaling_group	object	No	Konfigurasi grup penskalaan untuk kelompok node.
vswitch_ids	array	Yes	Daftar ID vSwitch. Nilai valid: [1,8]. Catatan Untuk memastikan ketersediaan tinggi, pilih vSwitch di zona yang berbeda.
	string	No	ID vSwitch.	vsw-wz9mfnhmssud6eicu****
instance_types	array	Yes	Daftar Tipe instans untuk node di kelompok node. Saat kelompok node melakukan skala keluar, instans dibuat menggunakan Tipe instans yang memenuhi syarat dari daftar ini. Jumlah Tipe instans yang didukung berkisar dari 1 hingga 10. Catatan Untuk memastikan ketersediaan tinggi, pilih beberapa Tipe instans.
	string	No	Tipe instans. Untuk informasi lebih lanjut, lihat Keluarga instans.	ecs.d1ne.2xlarge
instance_charge_type	string	Yes	Metode penagihan untuk node di kelompok node. Nilai valid: `PrePaid`: langganan. `PostPaid`: bayar sesuai pemakaian. Nilai default: `PostPaid`. Valid values: PostPaid : bayar sesuai pemakaian. PrePaid : langganan.	PostPaid
period	integer	No	Durasi langganan untuk Instans di kelompok node. Parameter ini berlaku dan wajib diisi hanya ketika `instance_charge_type` diatur ke `PrePaid`. Ketika `period_unit=Week`, nilai valid `periode`: {1, 2, 3, 4}. Ketika `period_unit=Month`, nilai valid `periode`: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.	1
period_unit	string	No	Siklus penagihan untuk Instans di kelompok node. Parameter ini berlaku dan wajib diisi hanya ketika `instance_charge_type` diatur ke `PrePaid`. `Month`: menggunakan bulan sebagai unit komputasi (CU). `Week`: menggunakan minggu sebagai unit komputasi (CU). Nilai default: `Month`.	Month
auto_renew	boolean	No	Apakah akan mengaktifkan perpanjangan otomatis untuk Instans di kelompok 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	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. Nilai default: 1.	1
spot_strategy	string	No	Kebijakan penawaran untuk 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.	NoSpot
spot_price_limit	array<object>	No	Konfigurasi rentang harga pasar untuk satu tipe spot instans.
	object	No	Konfigurasi rentang harga pasar untuk spot instans. Anda dapat menetapkan rentang harga berbeda untuk tipe instans berbeda.
instance_type	string	No	Tipe instans preemptible.	ecs.c6.large
price_limit	string	No	Harga maksimum per instans. Unit: USD/jam..	0.39
image_type	string	No	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	No	ID gambar kustom. Image yang disediakan sistem digunakan secara default.	aliyun_2_1903_x64_20G_alibase_20200529.vhd
system_disk_category	string	No	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`: Tipe 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`: basic Tipe disk. `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 untuk node. Unit: GiB. Nilai valid: [20,2048].	120
system_disk_performance_level	string	No	Tingkat kinerja cloud disk sistem node. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja bervariasi berdasarkan ukuran cloud disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD. PL0: kinerja I/O konkuren maksimum sedang dengan latensi baca/tulis yang relatif stabil. PL1: kinerja I/O konkuren maksimum sedang dengan latensi baca/tulis yang relatif stabil. PL2: kinerja I/O konkuren maksimum tinggi dengan latensi baca/tulis yang stabil. PL3: kinerja I/O konkuren maksimum sangat tinggi dengan latensi baca/tulis yang sangat stabil.	PL1
system_disk_encrypted	boolean	No	Apakah akan mengenkripsi cloud disk sistem. Nilai valid: true: Terenkripsi. false: Tidak terenkripsi.	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 untuk cloud disk sistem. Nilai valid: aes-256.	aes-256
system_disk_bursting_enabled	boolean	No	Apakah akan mengaktifkan burst (lonjakan performa) untuk cloud disk sistem node. Nilai valid: true: Diaktifkan. false: Dinonaktifkan. Parameter ini hanya didukung ketika `system_disk_category` diatur ke `cloud_auto`. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.	true
system_disk_provisioned_iops	integer	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
data_disks	array	No	Konfigurasi cloud disk data untuk node di kelompok node.
	data_disk	No	Konfigurasi cloud disk data.
security_group_ids	array	No	Daftar ID kelompok 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	No	Daftar ID kelompok 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.	sg-wz9a8g2mt6x5ll******
key_pair	string	No	Nama pasangan kunci untuk logon tanpa kata sandi. Tentukan parameter ini atau `login_password`. Catatan Jika kelompok node menggunakan sistem operasi ContainerOS, hanya `key_pair` yang didukung.	np-key-name
login_password	string	No	Kata sandi logon SSH. Tentukan parameter ini atau `key_pair`. Kata sandi harus memiliki panjang 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus.	****
login_as_non_root	boolean	No	Apakah Instance ECS yang diskalakan keluar menggunakan logon non-root. true: logon sebagai pengguna non-root (ecs-user). false: logon sebagai pengguna root.	true
cis_enabled `deprecated`	boolean	No	[Sudah usang] Gunakan parameter security_hardening_os sebagai gantinya.	null
soc_enabled	boolean	No	Apakah akan mengaktifkan penguatan keamanan MLPS 2.0. Fitur ini hanya tersedia ketika image sistem adalah Alibaba Cloud Linux 2 atau Alibaba Cloud Linux 3. Alibaba Cloud menyediakan standar pemeriksaan garis dasar kepatuhan perlindungan berklasifikasi dan program pemindaian untuk image Alibaba Cloud Linux 2 dan Alibaba Cloud Linux 3 MLPS 2.0 level 3.	false
security_hardening_os	boolean	No	Apakah akan mengaktifkan penguatan keamanan OS Alibaba Cloud. Nilai valid: `true`: Mengaktifkan penguatan keamanan OS Alibaba Cloud. `false`: Menonaktifkan penguatan keamanan OS Alibaba Cloud. Nilai default: `false`.	false
internet_charge_type	string	No	Metode penagihan untuk alamat IP publik. Nilai valid: PayByBandwidth: bayar berdasarkan bandwidth. PayByTraffic: bayar berdasarkan transfer data.	PayByTraffic
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<object>	No	Tag yang hanya ditambahkan ke Instance ECS. Kunci tag tidak boleh duplikat dan dapat memiliki panjang hingga 128 karakter. Kunci tag dan nilai tag tidak boleh dimulai dengan "aliyun" atau "acs:", atau mengandung "https://" atau "http://".
	object	No	Tag node.
key	string	No	Kunci tag.	node-k-1
value	string	No	Nilai tag.	node-v-1
desired_size	integer	No	Kelompok node desired di node pool. Jumlah total node yang harus dipertahankan oleh node pool. Konfigurasikan setidaknya 2 node untuk memastikan komponen kluster berjalan dengan benar. Anda dapat menskalakan node pool masuk atau keluar dengan menyesuaikan kelompok node desired. Jika Anda tidak perlu membuat node, atur parameter ini ke 0 dan sesuaikan nilainya secara manual nanti untuk menambahkan node.	0
multi_az_policy	string	No	Kebijakan penskalaan untuk Instance ECS di grup penskalaan multi-zona. 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 untuk membuat Instance ECS. `COST_OPTIMIZED`: Mencoba membuat instans berdasarkan urutan naik harga satuan vCPU. Set 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 untuk secara otomatis mencoba membuat instans bayar sesuai pemakaian ketika spot instans tidak dapat dibuat karena stok tidak mencukupi atau alasan lainnya. Catatan `COST_OPTIMIZED` hanya berlaku set konfigurasi penskalaan menetapkan beberapa Tipe instans atau menggunakan spot instans. `BALANCE`: Mendistribusikan Instance ECS secara merata di seluruh zona aktif yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena stok tidak mencukupi atau alasan lainnya, Anda dapat memanggil operasi API RebalanceInstances untuk menyeimbangkan ulang Sumber daya. Nilai default: `PRIORITY`.	COST_OPTIMIZED
scaling_policy	string	No	Mode grup penskalaan. Nilai valid: `release`: Mode Standar. Menskalakan dengan membuat dan merilis Instance ECS berdasarkan Penggunaan sumber daya. `recycle`: Mode cepat. Menskalakan 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. Nilai default: `release`.	release
on_demand_base_capacity	integer	No	Jumlah minimum instans bayar sesuai pemakaian yang diperlukan di 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 berlebih setelah jumlah minimum instans bayar sesuai pemakaian (`on_demand_base_capacity`) terpenuhi. Nilai valid: [0,100].	20
spot_instance_pools	integer	No	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	No	Apakah akan mengaktifkan suplementasi spot instans. Jika diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan direklamasi ketika notifikasi reklamasi diterima. Nilai valid: `true`: Mengaktifkan suplementasi spot instans. `false`: Menonaktifkan suplementasi spot instans.	false
compensate_with_on_demand	boolean	No	Apakah akan mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instance ECS yang diperlukan ketika `multi_az_policy` diatur ke `COST_OPTIMIZED` dan spot instans tidak dapat dibuat karena harga, stok, atau alasan lainnya. Nilai valid: `true`: Mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instance ECS yang diperlukan. `false`: Tidak mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi jumlah Instance ECS yang diperlukan.	true
deploymentset_id	string	No	ID set penyebaran. Anda dapat menggunakan set penyebaran untuk mendistribusikan Instance ECS yang diskalakan keluar oleh kelompok node ke server fisik berbeda untuk memastikan ketersediaan tinggi dan pemulihan bencana tingkat bawah. Ketika Instance ECS dibuat dalam set penyebaran, instans diluncurkan di wilayah yang ditentukan berdasarkan strategi Penerapan yang telah dikonfigurasi sebelumnya. Penting Setelah Anda memilih set penyebaran, jumlah maksimum node di kelompok node dibatasi. Secara default, set penyebaran mendukung hingga 20 × jumlah zona (jumlah zona ditentukan oleh vSwitch). Pilih dengan hati-hati dan pastikan set penyebaran memiliki Kuota yang cukup untuk menghindari kegagalan skala keluar node.	ds-bp1d19mmbsv3jf6xxxxx
rds_instances	array	No	The list of ApsaraDB RDS instances.
	string	No	The ApsaraDB RDS instance ID.	rds-****
private_pool_options	object	No	The private node pool configuration.
id	string	No	Private pool ID. When `match_criteria` is `Target`, you need to further specify the private pool ID.	eap-bp67acfmxazb4****
match_criteria	string	No	Private pool type. The private pool capacity option for instance launch. After Elastic Assurance or Capacity Reservation services take effect, private pool capacity is generated for instance launch. Valid values: `Open`: Open mode. Automatically matches open-type private pool capacity. If no matching private pool capacity is available, public pool resources are used. `Target`: Targeted mode. Uses specified private pool capacity to launch instances. If the specified private pool capacity is unavailable, instance launch fails. `None`: Not used. Instance launch does not use private pool capacity.	Target
security_group_id `deprecated`	string	No	The security group ID of the node pool. Use either this parameter or `security_group_ids`. We recommend that you use `security_group_ids`.	sg-wz9a8g2mt6x5llu0****
platform `deprecated`	string	No	[This field is deprecated] Use the `image_type` parameter instead. The operating system distribution. Valid values: `CentOS` `AliyunLinux` `Windows` `WindowsCore` Default value: `AliyunLinux`.	null
instance_patterns	array	No	The instance attribute configuration.
	instance_patterns	No	The instance attributes.
ram_role_name	string	No	The worker RAM role name. If left empty, the default worker RAM role created by the cluster is used. If specified, the RAM role must be a normal service role with its trusted service set to Elastic Compute Service. For more information, see Create a normal service role. If the specified RAM role is not the default worker RAM role created by the cluster, the role name cannot start with `KubernetesMasterRole-` or `KubernetesWorkerRole-`. Penting This parameter is supported only by ACK managed clusters of version 1.22 or later.	example-role
instance_metadata_options	InstanceMetadataOptions	No	The ECS instance metadata access configuration.
resource_pool_options	object	No	The resource pool and resource pool strategy used when creating instances. Note the following when you set this parameter: This parameter takes effect only when creating pay-as-you-go instances. This parameter cannot be set together with private_pool_options.match_criteria or private_pool_options.id.
strategy	string	No	Resource pool policy used when creating instances. Resource pools include private pools generated after Elastic Assurance or Capacity Reservation services take effect, as well as public pools, for instance launch selection. Valid values: PrivatePoolFirst: Private pool preferred. When this policy 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 has insufficient capacity, open-type private pools are automatically matched. If no matching private pool is available, instances are created using the public pool. PrivatePoolOnly: Private pool only. When this policy is selected, resouce_pool_options.private_pool_ids must be specified. If the specified private pool has insufficient capacity, instance launch fails. None: Do not use resource pool policy. Default value: None.	PrivatePoolFirst
private_pool_ids	array	No	Private pool ID list, i.e., Elastic Assurance IDs or Capacity Reservation IDs. Only Target mode private pool IDs can be passed. Value range of N: 1 to 20.
	string	No	Private pool ID, i.e., Elastic Assurance ID or Capacity Reservation ID. Only Target mode private pool IDs can be passed.	eap-bp67acfmxazb4****
system_disk_snapshot_policy_id	string	No	The system cloud disk snapshot policy.	sp-0jl6xnmme8v7o935****
disk_init	array	No	The block device initialization configuration.
	DiskInit	No	The DiskInit configuration.
node_config	object	No	The node configuration.
kubelet_configuration	kubelet_config	No	The Kubelet parameter settings.
kubernetes_config	object	No	The cluster-related configuration.
labels	array	No	The node labels. Adds labels to nodes in the Kubernetes cluster.
	tag	No	The label configuration.
taints	array	No	The taint configuration.
	taint	No	The taint configuration set.
runtime	string	No	The container runtime name. ACK supports the following three container runtimes: containerd: Recommended. Supported by all cluster versions. Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supported by cluster versions 1.31 and earlier. docker: No longer maintained. Supported by 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 CPU management policy for nodes. 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. Default value: `none`.	none
user_data	string	No	The instance user data. After the node joins the cluster, the specified user data script is executed. For more information, see User data scripts.	dGhpcyBpcyBhIGV4YW1wbGU=
unschedulable	boolean	No	Specifies whether the scaled-out nodes are unschedulable. true: Unschedulable. false: Schedulable.	true
cms_enabled	boolean	No	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. Default value: `false`.	false
node_name_mode	string	No	The custom node name. After you customize the node name, the node name, ECS instance name, and ECS instance hostname are all changed. Catatan For Windows instances with custom node names enabled, the hostname is fixed to the IP address with hyphens (-) replacing the dots (.) in the IP address, and does not include the prefix or suffix. The node name consists of a prefix, the node IP address, and a suffix: The total length is 2 to 64 characters. The node name must start and end with a lowercase letter or digit. The prefix and suffix can contain uppercase and lowercase letters, digits, hyphens (-), and periods (.). They must start with an uppercase or lowercase letter and cannot start or end with a hyphen (-) or period (.). Consecutive hyphens (-) or periods (.) are not allowed. The prefix is required (ECS restriction). The suffix is optional. The node IP is the full private IP address of the node. For example, if the node IP address is 192.XX.YY.55, the prefix is aliyun.com, and the suffix is test: For a Linux node, the node name, ECS instance name, and ECS instance hostname are all aliyun.com192.XX.YY.55test. For a Windows node, the ECS instance hostname is 192-XX-YY-55, and the node name and ECS instance name are both aliyun.com192.XX.YY.55test.	aliyun.com192.XX.YY.55test
pre_user_data	string	No	The instance pre-user data. Before the node joins the cluster, the specified pre-user data script is executed. For more information, see User data scripts.	dGhpcyBpcyBhIGV4YW1wbGU
tee_config	object	No	The confidential computing cluster configuration.
tee_enable	boolean	No	Specifies whether to enable confidential computing for the cluster. true: Enables confidential computing. false: Disables confidential computing.	true
interconnect_config `deprecated`	object	No	[This field is deprecated] The edge node pool configuration.
cen_id	string	No	[This field is deprecated] The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool.	null
ccn_id	string	No	[This field is deprecated] The Cloud Connect Network (CCN) instance ID bound to the enhanced edge node pool.	null
ccn_region_id	string	No	[This field is deprecated] The region of the Cloud Connect Network instance bound to the enhanced edge node pool.	null
bandwidth	integer	No	[This field is deprecated] The network bandwidth of the enhanced edge node pool. Unit: Mbit/s.	null
improved_period	string	No	[This field is deprecated] The subscription duration of the enhanced edge node pool. Unit: months.	null
count `deprecated`	integer	No	[This field is deprecated] Use desired_size instead. The number of nodes in the node pool.	null
max_nodes `deprecated`	integer	No	[This field is deprecated] The maximum number of nodes allowed in the edge node pool.	null
interconnect_mode	string	No	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	No	Specifies whether the pod network mode 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	No	Specifies whether nodes in the edge node pool have Layer 3 network connectivity with each other. `true`: Connected. All nodes in the node pool have Layer 3 network connectivity with each other. `false`: Not connected. All nodes in the node pool do not have Layer 3 network connectivity with each other.	true
eflo_node_group	object	No	The Lingjun node pool configuration.
cluster_id	string	No	The Lingjun cluster ID to associate when creating a Lingjun node pool.	i1169130516633730****
group_id	string	No	The Lingjun group ID of the Lingjun cluster to associate when creating a Lingjun node pool.	ng-ec3c96ff0aa****
auto_attach_enabled	boolean	No
worker_ram_role_name	string	No
auto_mode	object	No	The intelligent managed configuration for the node pool.
enable	boolean	No	Specifies whether to enable intelligent managed mode. Valid values: true: Enables intelligent managed mode. This can be enabled only when the cluster has intelligent managed mode enabled. false: Disables intelligent managed mode.	true
node_components	array<object>	No	The list of node components.
	array<object>	No	The node component.
name	string	No	The node component name.	kubelet
version	string	No	The node component version.	1.33.3-aliyun.1
config	object	No	The node component configuration.
custom_config	object	No	Node component custom configuration.	{"cpuManagerPolicy":"static"}
	any	No	Node component custom configuration string.	cpuManagerPolicy

Elemen respons

Element	Type	Description	Example
	object	The node pool configuration.
nodepool_id	string	The node pool ID.	np31da1b38983f4511b490fc62108a****
task_id	string	The task ID.	T-613b19bbd160ad492800****
request_id	string	The request ID.	0527ac9a-c899-4341-a21a-****

Contoh

Respons sukses

JSONformat

{
  "nodepool_id": "np31da1b38983f4511b490fc62108a****",
  "task_id": "T-613b19bbd160ad492800****",
  "request_id": "0527ac9a-c899-4341-a21a-****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.