Memperbarui konfigurasi kelompok node berdasarkan ID kelompok node melalui operasi ModifyClusterNodePool.
Deskripsi operasi
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
cs:ModifyClusterNodePool |
update |
*Cluster
|
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: Nama harus terdiri dari 1 hingga 63 karakter dan dapat berisi angka, karakter Tionghoa, huruf, dan tanda hubung (-). Nama tidak boleh diawali dengan tanda hubung (-). |
default-nodepool |
| resource_group_id |
string |
No |
ID kelompok sumber daya untuk kelompok node. Instance yang diskalakan oleh kelompok node termasuk dalam kelompok sumber daya ini. |
rg-acfmyvw3wjm**** |
| auto_scaling |
object |
No |
Konfigurasi penskalaan otomatis. |
|
| enable |
boolean |
No |
Menentukan apakah penskalaan otomatis diaktifkan. Nilai yang valid: |
true |
type
deprecated
|
string |
No |
Jenis penskalaan otomatis, diklasifikasikan berdasarkan tipe instance untuk penskalaan otomatis. Nilai yang valid: |
cpu |
| max_instances |
integer |
No |
Jumlah maksimum instance yang dapat diskalakan pada kelompok node, tidak termasuk instance yang sudah ada. Parameter ini hanya berlaku ketika |
10 |
| min_instances |
integer |
No |
Jumlah minimum instance yang dapat diskalakan pada kelompok node, tidak termasuk instance yang sudah ada. Parameter ini hanya berlaku ketika Nilai yang valid: [0, max_instances]. Nilai default: 0. Catatan
|
2 |
is_bond_eip
deprecated
|
boolean |
No |
[Deprecated] Parameter ini tidak digunakan lagi. Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. |
null |
eip_internet_charge_type
deprecated
|
string |
No |
[Deprecated] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. |
null |
eip_bandwidth
deprecated
|
integer |
No |
[Deprecated] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya. Bandwidth puncak EIP. Nilai yang valid: [1,100]. Satuan: Mbit/s. |
null |
| management |
object |
No |
Konfigurasi kelompok node terkelola. |
|
| enable |
boolean |
No |
Menentukan apakah kelompok node terkelola diaktifkan. Nilai yang valid: |
true |
| auto_repair |
boolean |
No |
Menentukan apakah perbaikan node dilakukan secara otomatis. Parameter ini hanya berlaku ketika
Nilai default: |
true |
| auto_repair_policy |
object |
No |
Kebijakan perbaikan node otomatis. |
|
| restart_node |
boolean |
No |
Menentukan apakah restart node diizinkan. Parameter ini hanya berlaku ketika |
true |
| approval_required |
boolean |
No |
Menentukan apakah perbaikan node memerlukan persetujuan manual. |
|
| auto_repair_policy_id |
string |
No |
ID kebijakan perbaikan otomatis. |
r-xxxxxxxxxx |
| max_parallel_repairing_nodes |
string |
No |
Jumlah maksimum node yang dapat diperbaiki secara paralel. Ketika terdapat banyak node abnormal dalam kelompok node, parameter ini menentukan jumlah atau persentase maksimum node yang dapat diperbaiki secara bersamaan. Anda dapat menentukan angka (misalnya 5, rentang valid: 1 hingga 100000) atau persentase (misalnya 10%, rentang valid: 1% hingga 100%). Nilai default: 1. |
5 |
| max_unhealthy_nodes_threshold |
string |
No |
Kondisi pemutus sirkuit untuk penyembuhan mandiri. Ketika jumlah atau persentase node rusak melebihi ambang batas ini, penyembuhan mandiri memasuki kondisi pemutus sirkuit dan berhenti memulai aksi perbaikan baru. Anda dapat menentukan angka (misalnya 10, rentang valid: 1 hingga 100000) atau persentase (misalnya 20%, rentang valid: 1% hingga 100%). Nilai default: 100%. |
20% |
| auto_vul_fix |
boolean |
No |
Menentukan apakah kerentanan CVE diperbaiki secara otomatis. Parameter ini hanya berlaku ketika |
true |
| auto_vul_fix_policy |
object |
No |
Kebijakan perbaikan CVE otomatis. |
|
| restart_node |
boolean |
No |
Menentukan apakah restart node diizinkan. Parameter ini hanya berlaku ketika
Nilai default: |
true |
| vul_level |
string |
No |
Tingkat kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan dengan koma. Contoh: |
asap,nntf |
| exclude_packages |
string |
No |
Paket yang dikecualikan selama perbaikan kerentanan. |
kernel |
| auto_upgrade |
boolean |
No |
Menentukan apakah upgrade node dilakukan secara otomatis. Parameter ini hanya berlaku ketika |
true |
| auto_upgrade_policy |
object |
No |
Kebijakan upgrade otomatis. |
|
| auto_upgrade_kubelet |
boolean |
No |
Menentukan apakah upgrade kubelet otomatis diizinkan. Parameter ini hanya berlaku ketika |
true |
| auto_upgrade_runtime |
boolean |
No |
Menentukan apakah upgrade runtime otomatis diizinkan. Parameter ini hanya berlaku ketika |
false |
| auto_upgrade_os |
boolean |
No |
Menentukan apakah upgrade sistem operasi otomatis diizinkan. Parameter ini hanya berlaku ketika |
false |
upgrade_config
deprecated
|
object |
No |
[Deprecated] Gunakan parameter Konfigurasi upgrade otomatis. Parameter ini hanya berlaku ketika |
|
auto_upgrade
deprecated
|
boolean |
No |
[Deprecated] Gunakan parameter |
true |
| surge |
integer |
No |
Jumlah node tambahan. Anda dapat menentukan parameter ini atau |
5 |
| surge_percentage |
integer |
No |
Persentase node tambahan. Anda dapat menentukan parameter ini atau |
0 |
| max_unavailable |
integer |
No |
Jumlah maksimum node yang tidak tersedia. |
1 |
| auto_fault_diagnosis |
boolean |
No |
Menentukan apakah deteksi kesalahan ECS diaktifkan untuk penyembuhan mandiri node. |
|
| drift_enabled |
boolean |
No |
Menentukan apakah rotasi node diaktifkan. Hanya kelompok node terkelola cerdas yang mendukung fitur ini, dan diaktifkan secara default. Kelompok node biasa tidak mendukung fitur ini. |
|
| scaling_group |
object |
No |
Konfigurasi grup penskalaan untuk kelompok node. |
|
| vswitch_ids |
array |
No |
Daftar ID vSwitch. Nilai yang valid: 1 hingga 8. Catatan
Untuk memastikan ketersediaan tinggi, pilih vSwitch di zona yang berbeda. |
|
|
string |
No |
ID vSwitch. |
vsw-wz9uwxhawmtzg7u9h**** |
|
| instance_types |
array |
No |
Daftar tipe instance node. Anda dapat memilih beberapa tipe instance sebagai alternatif. Saat setiap node dibuat, sistem mencoba membeli instance mulai dari spesifikasi pertama hingga berhasil. Tipe instance yang akhirnya dibeli dapat bervariasi tergantung ketersediaan inventaris. |
|
|
string |
No |
Tipe instance. Untuk informasi lebih lanjut, lihat Instance family. |
ecs.c6.large |
|
| instance_charge_type |
string |
No |
Metode penagihan node dalam kelompok node. Nilai yang valid: |
PostPaid |
| period |
integer |
No |
Durasi langganan node dalam kelompok node. Parameter ini hanya berlaku dan wajib ditentukan ketika |
1 |
| period_unit |
string |
No |
Siklus penagihan node dalam kelompok node. Parameter ini hanya berlaku dan wajib ditentukan ketika |
Month |
| auto_renew |
boolean |
No |
Menentukan apakah perpanjangan otomatis untuk node diaktifkan. Parameter ini hanya berlaku ketika |
true |
| auto_renew_period |
integer |
No |
Durasi setiap siklus perpanjangan otomatis. Nilai yang valid: |
1 |
| spot_strategy |
string |
No |
Jenis spot instans. Nilai yang valid: |
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 instance untuk spot instans. |
ecs.c6.large |
| price_limit |
string |
No |
Harga maksimum untuk satu instance. Satuan: USD/jam. |
0.39 |
| image_type |
string |
No |
Jenis distribusi sistem operasi. Kami merekomendasikan Anda menggunakan parameter ini untuk menentukan sistem operasi node. Nilai yang valid: |
AliyunLinux3 |
| image_id |
string |
No |
ID gambar kustom. Anda dapat memanggil |
aliyun_3_x64_20G_alibase_20241218.vhd |
| system_disk_category |
string |
No |
Jenis disk cloud sistem node. Nilai yang valid: |
cloud_efficiency |
| system_disk_categories |
array |
No |
Berbagai jenis disk cloud untuk disk sistem. Jika jenis disk cloud prioritas tinggi tidak tersedia, sistem secara otomatis mencoba jenis disk cloud prioritas berikutnya untuk membuat disk sistem. |
|
|
string |
No |
Berbagai jenis disk cloud sistem untuk node. |
cloud_essd |
|
| system_disk_size |
integer |
No |
Ukuran disk cloud sistem node. Satuan: GiB. |
120 |
| system_disk_performance_level |
string |
No |
Tingkat kinerja disk cloud sistem node. Parameter ini hanya berlaku untuk disk cloud ESSD. Tingkat kinerja terkait dengan ukuran disk cloud. Untuk informasi lebih lanjut, lihat Disk cloud ESSD. |
PL1 |
| system_disk_encrypted |
boolean |
No |
Menentukan apakah disk cloud sistem dienkripsi. Nilai yang valid: |
false |
| system_disk_kms_key_id |
string |
No |
ID kunci KMS yang digunakan oleh disk cloud sistem. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| system_disk_encrypt_algorithm |
string |
No |
Algoritma enkripsi yang digunakan oleh disk cloud sistem. Nilai yang valid: aes-256. |
aes-256 |
| system_disk_provisioned_iops |
integer |
No |
IOPS baca/tulis yang disediakan untuk disk cloud sistem node. |
1000 |
| system_disk_bursting_enabled |
boolean |
No |
Menentukan apakah lonjakan (lonjakan performa I/O) diaktifkan untuk disk cloud sistem node. Nilai yang valid: |
true |
| data_disks |
array |
No |
Konfigurasi disk cloud data untuk node. Nilai yang valid: 0 hingga 10. Anda dapat menambahkan hingga 10 disk cloud data. |
|
| data_disk |
No |
Konfigurasi disk cloud data untuk node. |
||
| disk_init |
array |
No |
Konfigurasi inisialisasi perangkat blok. |
|
|
DiskInit |
No |
Konfigurasi inisialisasi perangkat blok. |
||
| key_pair |
string |
No |
Nama pasangan kunci. Tentukan parameter ini atau |
pro-nodepool |
| login_password |
string |
No |
Kata sandi logon SSH. Tentukan parameter ini atau |
Hello1234 |
| internet_charge_type |
string |
No |
Metode penagihan untuk alamat IP publik. Nilai yang valid: |
PayByBandwidth |
| internet_max_bandwidth_out |
integer |
No |
Bandwidth outbound maksimum untuk alamat IP publik node. Satuan: Mbps (Mega bit per second). Nilai yang valid: [1,100]. |
5 |
| tags |
array |
No |
Tag yang hanya ditambahkan ke instance ECS. |
|
| tag |
No |
Tag instance ECS. |
||
| desired_size |
integer |
No |
Jumlah node yang diinginkan dalam kelompok node. |
2 |
| multi_az_policy |
string |
No |
Kebijakan penskalaan multi-zona untuk instance ECS dalam grup penskalaan. Nilai yang valid: |
BALANCE |
| scaling_policy |
string |
No |
Mode grup penskalaan. Nilai yang valid: |
release |
| on_demand_base_capacity |
integer |
No |
Jumlah minimum instans pay-as-you-go yang dibutuhkan oleh grup penskalaan. Nilai yang valid: [0,1000]. Instans pay-as-you-go dibuat dengan prioritas ketika jumlah instans pay-as-you-go kurang dari nilai ini. |
0 |
| on_demand_percentage_above_base_capacity |
integer |
No |
Persentase instans pay-as-you-go di antara instans yang melebihi jumlah minimum instans pay-as-you-go ( |
20 |
| spot_instance_pools |
integer |
No |
Jumlah tipe instance yang tersedia. Grup penskalaan membuat spot instans dengan cara yang dioptimalkan biaya di berbagai tipe instance. Nilai yang valid: [1,10]. |
5 |
| spot_instance_remedy |
boolean |
No |
Menentukan apakah pelengkap spot instans diaktifkan. Jika diaktifkan, ketika menerima pesan sistem bahwa spot instans akan ditarik kembali, grup penskalaan mencoba membuat instance baru untuk menggantikan spot instans yang akan ditarik kembali. Nilai yang valid: |
false |
| compensate_with_on_demand |
boolean |
No |
Menentukan apakah pembuatan otomatis instans pay-as-you-go diizinkan untuk memenuhi jumlah instance ECS yang diperlukan ketika instans spot yang ditentukan tidak dapat dibuat karena alasan seperti biaya atau inventaris yang tidak mencukupi. Parameter ini hanya berlaku ketika
|
true |
| enable_high_density_mode |
boolean |
No |
Menentukan apakah mode disk cloud kepadatan tinggi diaktifkan. Ini hanya didukung ketika kelompok node menggunakan tipe instance. Ketika diaktifkan, jumlah total disk cloud sistem dan disk cloud data tidak melebihi jumlah disk cloud kepadatan tinggi yang didukung oleh tipe instance. |
false |
| rds_instances |
array |
No |
Daftar instance RDS. |
|
|
string |
No |
ID instance RDS. Jika daftar instance RDS ditentukan, instance ECS dari node kluster secara otomatis ditambahkan ke Daftar putih RDS. |
rds-xxx |
|
| private_pool_options |
object |
No |
Konfigurasi kolam node privat. |
|
| id |
string |
No |
ID kolam node privat. Ketika |
eap-bp67acfmxazb4**** |
| match_criteria |
string |
No |
Jenis kolam node privat. Opsi kolam privat untuk peluncuran instance. Setelah jaminan elastisitas atau reservasi kapasitas berlaku, kolam privat dihasilkan untuk kapasitas yang dipesan, yang dapat dipilih saat instance diluncurkan. Nilai yang valid:
|
Open |
platform
deprecated
|
string |
No |
[Deprecated] Gunakan parameter Platform sistem operasi. Nilai yang valid:
|
AliyunLinux |
| instance_patterns |
array |
No |
Konfigurasi atribut instance. |
|
| instance_patterns |
No |
Atribut instance. |
||
| deploymentset_id |
string |
No |
Set penyebaran tempat instance ECS yang dibuat oleh kelompok node termasuk. Pengaturan ini hanya berlaku untuk node baru. Set penyebaran node yang sudah ada tidak diubah. |
ds-bp1d19mmbsv3jf6xxxxx |
| security_group_ids |
array |
No |
Daftar ID grup keamanan. |
|
|
string |
No |
ID grup keamanan. |
sg-wz9a8g2mt6x5ll****** |
|
| resource_pool_options |
object |
No |
Kolam sumber daya dan strategi kolam sumber daya yang digunakan saat membuat instance. Setelah Anda mengatur parameter ini, perhatikan hal berikut: |
|
| strategy |
string |
No |
Strategi kolam sumber daya yang digunakan saat instance dibuat. Kolam sumber daya mencakup kolam privat yang dihasilkan setelah jaminan elastisitas atau reservasi kapasitas berlaku, dan kolam publik, yang tersedia untuk startup instance. Nilai yang valid:
Nilai default: None. |
PrivatePoolFirst |
| private_pool_ids |
array |
No |
Daftar ID kolam privat, yaitu ID jaminan elastisitas atau ID reservasi kapasitas. Hanya ID kolam privat mode Target yang dapat ditentukan untuk parameter ini. Nilai N yang valid: 1 hingga 20. |
|
|
string |
No |
ID kolam privat, yaitu ID jaminan elastisitas atau ID reservasi kapasitas. Hanya ID kolam privat mode Target yang dapat ditentukan untuk parameter ini. |
eap-bp67acfmxazb4**** |
|
| system_disk_snapshot_policy_id |
string |
No |
Kebijakan snapshot untuk disk cloud sistem. |
sp-0jl6xnmme8v7o935**** |
| kubernetes_config |
object |
No |
Konfigurasi terkait kluster. |
|
| labels |
array |
No |
Label node. Anda dapat menambahkan label ke node dalam kluster Kubernetes. Aturan definisi label: |
|
| tag |
No |
Label node. |
||
| taints |
array |
No |
Konfigurasi taint node. |
|
| taint |
No |
Konfigurasi taint node. |
||
| runtime |
string |
No |
Nama runtime kontainer. ACK mendukung tiga runtime kontainer berikut.
Nilai default: containerd. |
containerd |
| runtime_version |
string |
No |
Versi runtime kontainer. |
1.6.38 |
| cpu_policy |
string |
No |
Kebijakan manajemen CPU untuk node. Dua kebijakan berikut didukung untuk kluster versi 1.12.6 atau lebih baru: |
none |
| unschedulable |
boolean |
No |
Menentukan apakah node yang ditambahkan selama penskalaan tidak dapat dijadwalkan. |
false |
| user_data |
string |
No |
Data pengguna instans. Setelah node bergabung dengan kluster, skrip data pengguna yang ditentukan dijalankan. Untuk informasi lebih lanjut, lihat Skrip data pengguna. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| cms_enabled |
boolean |
No |
Menentukan apakah agen CloudMonitor diinstal pada node ECS. Setelah instalasi, Anda dapat melihat informasi pemantauan instance ECS yang dibuat di Konsol CloudMonitor. Kami merekomendasikan agar Anda mengaktifkan fitur ini. Nilai yang valid:
Nilai default: |
true |
| pre_user_data |
string |
No |
Data pengguna awal instans. Sebelum node bergabung dengan kluster, skrip data pengguna awal yang ditentukan dijalankan. Untuk informasi lebih lanjut, lihat Skrip data pengguna. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| node_name_mode |
string |
No |
Parameter nama node kustom. Nama node terdiri dari tiga bagian: awalan + alamat IP node + akhiran. |
customized,aliyun,ip,com |
| tee_config |
object |
No |
Konfigurasi kluster komputasi rahasia. |
|
| tee_enable |
boolean |
No |
Menentukan apakah kluster komputasi rahasia diaktifkan. Nilai yang valid:
Nilai default: |
false |
| update_nodes |
boolean |
No |
Menentukan apakah label dan taint node diperbarui secara sinkron. |
true |
| concurrency |
boolean |
No |
Menentukan apakah konkurensi diaktifkan. |
true |
| eflo_node_group |
object |
No |
Konfigurasi kelompok node Lingjun. (Tidak efektif) |
|
| auto_attach_enabled |
string |
No |
Menentukan apakah penambahan otomatis untuk kelompok node Lingjun diaktifkan. (Tidak efektif) |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Data badan respons. |
||
| task_id |
string |
ID tugas. |
T-5fd211e924e1d00787000293 |
| nodepool_id |
string |
ID kelompok node. |
np737c3ac1ac684703b9e10673aa2c**** |
| request_id |
string |
ID permintaan. |
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.