Memperbarui konfigurasi kelompok node berdasarkan ID kelompok node.
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: 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:
Ketika parameter ini diatur ke false, parameter konfigurasi lain dalam Nilai default: |
true |
type
deprecated
|
string |
No |
Tipe penskalaan otomatis, diklasifikasikan berdasarkan tipe instans. Nilai valid:
Nilai default: |
cpu |
| max_instances |
integer |
No |
Jumlah maksimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada. Parameter ini hanya berlaku ketika 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 Nilai valid: [0, max_instances]. Nilai default: 0. Catatan
|
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.
Nilai default: |
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:
Nilai default: |
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:
Nilai default: |
true |
| auto_repair |
boolean |
No |
Apakah akan memperbaiki node secara otomatis. Parameter ini hanya berlaku ketika
Nilai default: |
true |
| auto_repair_policy |
object |
No |
Kebijakan node perbaikan otomatis. |
|
| restart_node |
boolean |
No |
Apakah akan mengizinkan restart node. Parameter ini hanya berlaku ketika
Nilai default: |
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
Nilai default: |
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
Nilai default: |
true |
| vul_level |
string |
No |
Tingkat kerentanan yang mengizinkan perbaikan otomatis, dipisahkan dengan koma. Contoh:
Nilai default: |
asap,nntf |
| exclude_packages |
string |
No |
Menentukan paket yang dikecualikan selama perbaikan kerentanan. Nilai default: |
kernel |
| auto_upgrade |
boolean |
No |
Apakah akan meningkatkan node secara otomatis. Parameter ini hanya berlaku ketika
Nilai default: |
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
Nilai default: |
true |
| auto_upgrade_runtime |
boolean |
No |
Apakah akan mengizinkan peningkatan waktu proses otomatis. Parameter ini hanya berlaku ketika
Nilai default: |
false |
| auto_upgrade_os |
boolean |
No |
Apakah akan mengizinkan peningkatan sistem operasi otomatis. Parameter ini hanya berlaku ketika
Nilai default: |
false |
upgrade_config
deprecated
|
object |
No |
[Bidang ini sudah tidak digunakan] Gunakan parameter Konfigurasi peningkatan otomatis. Parameter ini hanya berlaku ketika |
|
auto_upgrade
deprecated
|
boolean |
No |
[Bidang ini sudah tidak digunakan] Gunakan parameter Apakah akan mengaktifkan peningkatan otomatis:
Nilai default: |
true |
| surge |
integer |
No |
Jumlah node tambahan. Parameter ini dan 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 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:
Nilai default: |
PostPaid |
| period |
integer |
No |
Durasi langganan node dalam node pool. Parameter ini berlaku dan diperlukan hanya ketika
|
1 |
| period_unit |
string |
No |
Siklus penagihan node dalam node pool. Parameter ini berlaku dan diperlukan hanya ketika
Nilai default: |
Month |
| auto_renew |
boolean |
No |
Apakah akan mengaktifkan perpanjangan otomatis untuk node. Parameter ini hanya berlaku ketika
Nilai default: |
true |
| auto_renew_period |
integer |
No |
Periode perpanjangan otomatis untuk satu kali perpanjangan. Nilai valid:
Nilai default: 1. |
1 |
| spot_strategy |
string |
No |
Tipe spot instans. Nilai valid:
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:
|
AliyunLinux3 |
| image_id |
string |
No |
ID gambar kustom. Anda dapat memanggil |
aliyun_3_x64_20G_alibase_20241218.vhd |
| system_disk_category |
string |
No |
Tipe cloud disk sistem node. Nilai valid:
Nilai default: |
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_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.
|
PL1 |
| system_disk_encrypted |
boolean |
No |
Apakah akan mengenkripsi cloud disk sistem. Nilai valid:
|
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 |
1000 |
| system_disk_bursting_enabled |
boolean |
No |
Apakah akan mengaktifkan burst (lonjakan performa) untuk cloud disk sistem node. Nilai valid:
Parameter ini hanya didukung ketika |
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 |
pro-nodepool |
| login_password |
string |
No |
Kata sandi logon SSH. Parameter ini dan |
Hello1234 |
| internet_charge_type |
string |
No |
Tipe penagihan untuk alamat IP publik. Nilai valid:
|
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:
Nilai default: |
BALANCE |
| scaling_policy |
string |
No |
Mode grup penskalaan. Nilai valid:
|
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:
|
false |
| compensate_with_on_demand |
boolean |
No |
Ketika
|
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 |
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 |
platform
deprecated
|
string |
No |
Bidang ini sudah tidak digunakan. Gunakan parameter Platform sistem operasi. Nilai valid:
|
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:
|
|
| 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:
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:
Default value: |
none |
| unschedulable |
boolean |
No |
Specifies whether the nodes added during scale-out are unschedulable.
|
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:
Default value: |
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:
Default value: |
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.