All Products
Search

This Product

    Container Service for Kubernetes:CreateClusterNodePool

    Document Center

    Container Service for Kubernetes:CreateClusterNodePool

    Last Updated:Aug 21, 2026

    Kelompok node adalah kumpulan logis node yang memiliki atribut yang sama. Kelompok node memungkinkan Anda mengelola dan memelihara node secara terpusat, seperti peningkatan node dan skalabilitas elastis. Anda dapat menggunakan kemampuan O&M otomatis dari kelompok node, termasuk patching kerentanan CVE OS otomatis, pemulihan node rusak otomatis, dan peningkatan versi kubelet serta containerd otomatis, untuk mengurangi biaya O&M. Anda dapat memanggil CreateClusterNodePool untuk membuat kelompok node untuk 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 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).

    • 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 dari 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 yang berbeda.

    rg-acfmyvw3wjmb****
    auto_scaling

    object

    No

    Konfigurasi penskalaan.

    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 atau 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. 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 diubah setelah kelompok node dibuat.

    Valid values:

    • spot :

      Tipe instans spot.

    • 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 ada saat ini. 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 ada saat ini. 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 mengalami pembuatan otomatis setelah grup penskalaan aktif.

    • Atur jumlah instans maksimum 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 aktif.

    1
    is_bond_eip deprecated

    boolean

    No

    [Deprecated] Parameter ini sudah tidak digunakan lagi. Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya.

    Apakah akan mengasosiasikan EIP. Nilai valid:

    • true: Mengasosiasikan EIP.

    • false: Tidak mengasosiasikan EIP.

    Nilai default: false.

    null
    eip_internet_charge_type deprecated

    string

    No

    [Deprecated] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya.

    Metode penagihan EIP. Nilai valid:

    • PayByBandwidth: bayar per bandwidth.

    • PayByTraffic: bayar per trafik.

    Nilai default: PayByBandwidth.

    null
    eip_bandwidth deprecated

    integer

    No

    [Deprecated] Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya.

    Bandwidth puncak EIP. Unit: Mbit/s.

    null
    management

    object

    No

    Konfigurasi fitur kelompok node terkelola.

    enable

    boolean

    No

    Apakah akan mengaktifkan fitur kelompok node terkelola. Nilai valid:

    • true: Diaktifkan.

    • false: Dinonaktifkan. Konfigurasi terkait lainnya hanya berlaku jika enable diatur ke true.

    Nilai default: false.

    false
    auto_repair

    boolean

    No

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

    • true: Diaktifkan.

    • false: Dinonaktifkan.

    Nilai default: true.

    true
    auto_repair_policy

    object

    No

    Kebijakan perbaikan node otomatis.

    restart_node

    boolean

    No

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

    • true: Restart node diizinkan.

    • false: Restart node tidak diizinkan.

    Nilai default: true.

    true
    approval_required

    boolean

    No

    Apakah persetujuan manual diperlukan untuk perbaikan node.

    max_parallel_repairing_nodes

    string

    No

    Jumlah maksimum node yang dapat diperbaiki secara paralel. Ketika sejumlah besar node tidak sehat ada di kelompok node, parameter ini menentukan jumlah atau persentase 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

    Ambang batas pemutus sirkuit self-healing. Ketika jumlah atau persentase node rusak melebihi ambang batas ini, self-healing memasuki status pemutus sirkuit dan berhenti memulai tindakan 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

    Apakah akan mengaktifkan perbaikan kerentanan CVE otomatis. Parameter ini hanya berlaku jika enable=true.

    • true: Perbaikan CVE otomatis diaktifkan.

    • false: Perbaikan CVE otomatis dinonaktifkan.

    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 jika auto_vul_fix=true. Nilai valid:

    • true: Restart node diizinkan.

    • false: Restart node tidak diizinkan.

    Nilai default: true.

    false
    vul_level

    string

    No

    Tingkat kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan dengan koma. Contoh: asap,later. Nilai valid:

    • asap: tinggi

    • later: Menengah

    • nntf: rendah

    Nilai default: asap.

    asap,nntf
    exclude_packages

    string

    No

    Paket yang dikecualikan selama perbaikan kerentanan.

    Nilai default: kernel.

    kernel
    auto_upgrade

    boolean

    No

    Apakah akan mengaktifkan peningkatan node otomatis. Parameter ini hanya berlaku jika enable=true.

    • true: Peningkatan otomatis diaktifkan.

    • false: Peningkatan otomatis dinonaktifkan.

    Nilai default: true.

    true
    auto_upgrade_policy

    object

    No

    Kebijakan peningkatan node otomatis.

    auto_upgrade_kubelet

    boolean

    No

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

    • true: Peningkatan kubelet otomatis diizinkan.

    • false: Peningkatan kubelet otomatis tidak diizinkan.

    Nilai default: true.

    true
    auto_upgrade_runtime

    boolean

    No

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

    • true: Peningkatan waktu proses otomatis diizinkan.

    • false: Peningkatan waktu proses otomatis tidak diizinkan.

    Nilai default: true.

    false
    auto_upgrade_os

    boolean

    No

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

    • true: Peningkatan OS otomatis diizinkan.

    • false: Peningkatan OS otomatis tidak diizinkan.

    Nilai default: false.

    false
    upgrade_config deprecated

    object

    No

    [Deprecated] Gunakan parameter auto_upgrade di tingkat atas sebagai gantinya.

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

    auto_upgrade deprecated

    boolean

    No

    [Deprecated] Gunakan parameter auto_upgrade di tingkat atas sebagai gantinya.

    Apakah akan mengaktifkan peningkatan otomatis. Nilai valid:

    • true: Peningkatan otomatis diaktifkan.

    • false: Peningkatan otomatis dinonaktifkan.

    null
    surge

    integer

    No

    Jumlah node tambahan. Anda dapat menentukan parameter ini atau surge_percentage.

    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.

    0
    surge_percentage

    integer

    No

    Persentase node tambahan. Anda dapat menentukan parameter ini atau surge.

    Jumlah node tambahan = persentase node tambahan × jumlah node. Misalnya, jika persentase node tambahan 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. Rentang valid: [1,1000].

    Nilai default: 1.

    1
    auto_fault_diagnosis

    boolean

    No

    Apakah akan mengaktifkan deteksi fault ECS untuk self-healing node.

    drift_enabled

    boolean

    No

    Apakah akan mengaktifkan rotasi node. Hanya kelompok node terkelola cerdas yang mendukung fitur ini, dan diaktifkan secara default. Kelompok node umum tidak mendukung fitur ini.

    scaling_group

    object

    No

    Konfigurasi grup penskalaan dari 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 kelompok node. Saat kelompok node melakukan skala keluar, instans dibuat berdasarkan tipe instans yang memenuhi persyaratan dari daftar ini.

    Jumlah tipe instans yang didukung berkisar dari 1 hingga 10.

    Catatan

    Untuk memastikan ketersediaan tinggi, tentukan beberapa tipe instans.

    string

    No

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

    ecs.d1ne.2xlarge
    instance_charge_type

    string

    Yes

    Metode penagihan node dalam kelompok node. Nilai valid:

    • PrePaid: langganan.

    • PostPaid: bayar sesuai pemakaian.

    Nilai default: PostPaid.

    Valid values:

    • PostPaid :

      Instans bayar sesuai pemakaian.

    • PrePaid :

      Instans langganan.

    PostPaid
    period

    integer

    No

    Durasi langganan node dalam kelompok node. Parameter ini berlaku dan wajib diisi hanya jika instance_charge_type diatur ke PrePaid.

    • Jika period_unit=Week, nilai valid period: {1, 2, 3, 4}.

    • Jika 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

    Epoch penagihan node dalam kelompok node. Parameter ini berlaku dan wajib diisi hanya jika 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 node dalam kelompok node. Parameter ini berlaku hanya jika 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 perpanjangan otomatis untuk satu kali perpanjangan. Nilai valid:

    • PeriodUnit=Week: 1, 2, 3.

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

    NoSpot
    spot_price_limit

    array<object>

    No

    Konfigurasi rentang harga untuk tipe spot instans saat ini.

    object

    No

    Konfigurasi rentang harga untuk spot instans. Anda dapat menetapkan rentang harga yang berbeda untuk tipe instans yang berbeda.

    instance_type

    string

    No

    Tipe instans dari spot instans.

    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 cloud disk sistem node. Nilai valid:

    • cloud_efficiency: ultra cloud disk.

    • cloud_ssd: SSD standar.

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

    Nilai valid: [20,2048].

    120
    system_disk_performance_level

    string

    No

    Tingkat kinerja cloud disk sistem node. Parameter ini berlaku hanya 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: 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_bursting_enabled

    boolean

    No

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

    • true: mengaktifkan burst.

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

    data_disk

    No

    Konfigurasi cloud disk data.

    security_group_ids

    array

    No

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

    string

    No

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

    sg-wz9a8g2mt6x5ll******
    key_pair

    string

    No

    Nama pasangan kunci untuk logon tanpa kata sandi. Gunakan 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. Gunakan parameter ini atau key_pair. Panjang kata sandi harus 8 hingga 30 karakter dan mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus.

    ****
    login_as_non_root

    boolean

    No

    Apakah Instans ECS yang diskalakan keluar menggunakan pengguna non-root untuk logon.

    • true: logon sebagai pengguna non-root (ecs-user).

    • false: logon sebagai pengguna root.

    true
    cis_enabled deprecated

    boolean

    No

    [Deprecated] Gunakan parameter security_hardening_os sebagai gantinya.

    null
    soc_enabled

    boolean

    No

    Apakah akan mengaktifkan penguatan keamanan MLPS 2.0. Fitur ini hanya dapat diaktifkan ketika image sistem adalah Alibaba Cloud Linux 2 atau Alibaba Cloud Linux 3. Alibaba Cloud menyediakan standar pemeriksaan baseline 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: ditagih berdasarkan bandwidth tetap.

    • PayByTraffic: ditagih berdasarkan penggunaan trafik.

    PayByTraffic
    internet_max_bandwidth_out

    integer

    No

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

    5
    tags

    array<object>

    No

    Tag yang hanya ditambahkan ke Instans ECS.

    Kunci tag tidak boleh duplikat dan panjangnya maksimal 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

    Jumlah node yang diinginkan dalam kelompok node.

    Jumlah total node yang harus dipertahankan oleh kelompok node. Kami menyarankan Anda mengonfigurasi setidaknya 2 node untuk memastikan komponen kluster berjalan dengan baik. Anda dapat melakukan penskalaan masuk atau keluar pada kelompok node dengan menyesuaikan jumlah node yang diinginkan.

    Jika Anda tidak perlu membuat node, setel parameter ini ke 0. Anda dapat menyesuaikan nilai tersebut secara manual nanti untuk menambahkan node.

    0
    multi_az_policy

    string

    No

    Kebijakan penskalaan multi-zona untuk Instans ECS dalam grup penskalaan. Nilai valid:

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

    • COST_OPTIMIZED: Mencoba membuat instans berdasarkan urutan harga per unit vCPU dari terendah ke tertinggi. Ketika pengaturan 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 mencoba membuat instans pay-as-you-go ketika spot instans tidak dapat dibuat karena persediaan tidak mencukupi atau alasan lainnya.

      Catatan

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

    • BALANCE: Mendistribusikan Instans ECS secara merata di seluruh zona yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena persediaan 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. Melakukan penskalaan instans dengan membuat dan merilis Instans ECS berdasarkan penggunaan sumber daya.

    • recycle: mode cepat. Melakukan penskalaan instans dengan membuat, menghentikan, dan memulai Instans ECS, yang meningkatkan kecepatan operasi penskalaan berikutnya. Sumber daya komputasi tidak dikenakan biaya selama periode penghentian. Hanya biaya penyimpanan yang dikenakan, kecuali untuk instans dengan disk lokal.

    Nilai default: release.

    rilis
    on_demand_base_capacity

    integer

    No

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

    0
    on_demand_percentage_above_base_capacity

    integer

    No

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

    20
    spot_instance_pools

    integer

    No

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

    5
    spot_instance_remedy

    boolean

    No

    Apakah akan mengaktifkan suplementasi spot instans. Jika diaktifkan, ketika sistem menerima notifikasi bahwa spot instans akan diklaim kembali, grup penskalaan akan mencoba membuat instans baru untuk menggantikan spot instans yang akan diklaim kembali. 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 pay-as-you-go untuk memenuhi jumlah Instans ECS yang diperlukan ketika multi_az_policy disetel ke COST_OPTIMIZED dan spot instans tidak dapat dibuat karena alasan biaya, persediaan, atau lainnya. Nilai valid:

    • true: Mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi jumlah Instans ECS yang diperlukan.

    • false: Tidak mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi jumlah Instans ECS yang diperlukan.

    true
    enable_high_density_mode

    boolean

    No

    Apakah akan mengaktifkan mode cloud disk kerapatan tinggi. Ini hanya didukung ketika kelompok node menggunakan tipe instans. Ketika diaktifkan, jumlah total cloud disk sistem dan cloud disk data tidak melebihi jumlah maksimum cloud disk kerapatan tinggi yang didukung oleh tipe instans.

    false
    deploymentset_id

    string

    No

    ID set penyebaran. Anda dapat menggunakan set penyebaran untuk mendistribusikan Instans ECS yang diskalakan keluar oleh kelompok node ke berbagai server fisik untuk memastikan ketersediaan tinggi dan pemulihan bencana tingkat dasar. Ketika Instans ECS dibuat dalam set penyebaran, instans tersebut diluncurkan di wilayah yang ditentukan berdasarkan kebijakan penyebaran yang telah dikonfigurasi sebelumnya.

    Penting Setelah Anda memilih set penyebaran, jumlah maksimum node dalam kelompok node menjadi terbatas. Jumlah maksimum node default yang didukung oleh set penyebaran adalah 20 × jumlah zona (jumlah zona ditentukan oleh vSwitch). Pilih dengan hati-hati dan pastikan set penyebaran memiliki kuota yang cukup untuk menghindari kegagalan penskalaan keluar node.

    ds-bp1d19mmbsv3jf6xxxxx
    rds_instances

    array

    No

    Daftar instans ApsaraDB RDS.

    string

    No

    ID instans ApsaraDB RDS.

    rds-****
    private_pool_options

    object

    No

    Konfigurasi kelompok node pribadi.

    id

    string

    No

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

    eap-bp67acfmxazb4****
    match_criteria

    string

    No

    Tipe kelompok node pribadi. Menentukan opsi kapasitas kolam pribadi untuk peluncuran instans. Setelah jaminan elastisitas atau reservasi kapasitas berlaku, kolam pribadi dihasilkan untuk peluncuran instans. Nilai valid:

    • Open: mode terbuka. Secara otomatis mencocokkan kapasitas kolam pribadi terbuka. Jika tidak ada kapasitas kolam pribadi yang cocok tersedia, sumber daya kolam publik digunakan.

    • Target: mode tertarget. Menggunakan kapasitas kolam pribadi yang ditentukan untuk meluncurkan instans. Jika kapasitas kolam pribadi yang ditentukan tidak tersedia, peluncuran instans gagal.

    • None: mode tanpa. Peluncuran instans tidak menggunakan kapasitas kolam pribadi.

    Target
    security_group_id deprecated

    string

    No

    ID grup keamanan dari kelompok node. Gunakan parameter ini atau security_group_ids. Penggunaan security_group_ids lebih disarankan.

    sg-wz9a8g2mt6x5llu0****
    platform deprecated

    string

    No

    [Deprecated] Gunakan parameter image_type sebagai gantinya.

    Distribusi sistem operasi. Nilai valid:

    • CentOS

    • AliyunLinux

    • Windows

    • WindowsCore

    Nilai default: AliyunLinux.

    null
    instance_patterns

    array

    No

    Konfigurasi atribut instans.

    instance_patterns

    No

    Atribut instans.

    ram_role_name

    string

    No

    Nama peran RAM Worker.

    • Jika dibiarkan kosong, peran RAM Worker default yang dibuat oleh kluster akan digunakan.

    • Jika ditentukan, peran RAM harus berupa peran layanan reguler dengan layanan tepercaya-nya dikonfigurasi sebagai Elastic Compute Service. Untuk informasi lebih lanjut, lihat Membuat peran layanan reguler. Ketika peran RAM yang ditentukan bukan peran RAM Worker default yang dibuat oleh kluster, nama peran tidak boleh dimulai dengan KubernetesMasterRole- atau KubernetesWorkerRole-.

    Penting Hanya kluster ACK terkelola versi 1.22 atau lebih baru yang mendukung parameter ini.

    contoh-peran
    instance_metadata_options InstanceMetadataOptions

    No

    Konfigurasi akses metadata instans Instans ECS.

    resource_pool_options

    object

    No

    Kolam sumber daya dan kebijakan kolam sumber daya yang digunakan saat membuat instans. Setelah Anda menyetel parameter ini, perhatikan hal-hal berikut: Parameter ini hanya berlaku saat membuat instans pay-as-you-go. Parameter ini tidak dapat disetel bersama dengan private_pool_options.match_criteria atau private_pool_options.id.

    strategy

    string

    No

    Kebijakan kolam sumber daya yang digunakan saat membuat instans. Kolam sumber daya mencakup kolam pribadi yang dihasilkan setelah jaminan elastisitas atau reservasi kapasitas berlaku, dan kolam publik, untuk peluncuran instans. Nilai valid: PrivatePoolFirst: kolam pribadi terlebih dahulu. Ketika kebijakan ini dipilih dan resouce_pool_options.private_pool_ids ditentukan, kolam pribadi yang ditentukan digunakan terlebih dahulu. Jika tidak ada kolam pribadi yang ditentukan atau kapasitas kolam pribadi yang ditentukan tidak mencukupi, kolam pribadi terbuka secara otomatis dicocokkan. Jika tidak ada kolam pribadi yang cocok tersedia, sumber daya kolam publik digunakan. PrivatePoolOnly: hanya kolam pribadi. Ketika kebijakan ini dipilih, resouce_pool_options.private_pool_ids harus ditentukan. Jika kapasitas kolam pribadi yang ditentukan tidak mencukupi, peluncuran instans gagal. None: tanpa kebijakan kolam sumber daya. Nilai default: None.

    PrivatePoolFirst
    private_pool_ids

    array

    No

    Daftar ID kolam pribadi, yaitu ID jaminan elastisitas atau ID reservasi kapasitas. Hanya ID kolam pribadi mode Target yang dapat ditentukan. Nilai valid N: 1 hingga 20.

    string

    No

    ID kolam pribadi, yaitu ID jaminan elastisitas atau ID reservasi kapasitas. Hanya ID kolam pribadi mode Target yang dapat ditentukan.

    eap-bp67acfmxazb4****
    system_disk_snapshot_policy_id

    string

    No

    Kebijakan snapshot untuk cloud disk sistem.

    sp-0jl6xnmme8v7o935****
    disk_init

    array

    No

    Konfigurasi inisialisasi perangkat blok.

    DiskInit

    No

    Konfigurasi DiskInit.

    cpu_options

    object

    No

    Opsi konfigurasi terkait CPU.

    nested_virtualization

    string

    No

    Apakah akan mengaktifkan virtualisasi bersarang. Nilai valid: disabled: menonaktifkan virtualisasi bersarang. enabled: mengaktifkan virtualisasi bersarang.

    enabled
    node_config

    object

    No

    Konfigurasi node.

    kubelet_configuration kubelet_config

    No

    Pengaturan parameter kubelet.

    kubernetes_config

    object

    No

    Konfigurasi terkait kluster.

    labels

    array

    No

    Label node. Anda dapat menambahkan label ke node dalam kluster Kubernetes.

    tag

    No

    Konfigurasi label.

    taints

    array

    No

    Konfigurasi taint.

    taint

    No

    Kumpulan konfigurasi taint.

    runtime

    string

    No

    Nama runtime kontainer. ACK mendukung tiga runtime kontainer berikut:

    • containerd: Direkomendasikan. Didukung oleh semua versi kluster.

    • Sandboxed-Container.runv: Kontainer sandbox yang menyediakan isolasi lebih tinggi. Didukung oleh kluster versi 1.31 dan sebelumnya.

    • docker: Tidak lagi dipelihara. Didukung oleh kluster versi 1.22 dan sebelumnya.

    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 dan lebih baru:

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

    • none: Mengaktifkan skema afinitas CPU default yang ada.

    Nilai default: none.

    none
    user_data

    string

    No

    Data pengguna instans. Setelah node bergabung dengan kluster, skrip data pengguna yang ditentukan akan dijalankan. Untuk informasi selengkapnya, lihat Skrip data pengguna.

    dGhpcyBpcyBhIGV4YW1wbGU=
    unschedulable

    boolean

    No

    Apakah node tidak dapat dijadwalkan setelah penskalaan keluar.

    • true: Tidak dapat dijadwalkan.

    • false: Dapat dijadwalkan.

    true
    cms_enabled

    boolean

    No

    Apakah akan menginstal agen CloudMonitor pada node ECS. Setelah instalasi, Anda dapat melihat informasi pemantauan tentang Instance ECS yang dibuat di konsol CloudMonitor. Kami menyarankan Anda mengaktifkan fitur ini. Nilai valid:

    • true: Menginstal agen CloudMonitor pada node ECS.

    • false: Tidak menginstal agen CloudMonitor pada node ECS.

    Nilai default: false.

    false
    node_name_mode

    string

    No

    Nama node kustom. Setelah Anda menyesuaikan nama node, nama node, nama Instance ECS, dan hostname Instance ECS semuanya berubah sesuai.

    Catatan

    Untuk instans Windows dengan nama node kustom diaktifkan, hostname ditetapkan ke alamat IP dengan tanda hubung (-) menggantikan titik (.) dalam alamat IP, dan tidak termasuk awalan atau akhiran.

    Nama node terdiri dari tiga bagian: awalan, alamat IP node, dan akhiran.

    • Panjang total adalah 2 hingga 64 karakter. Nama node harus dimulai dan diakhiri dengan huruf kecil atau digit.

    • Awalan dan akhiran dapat berisi huruf besar dan kecil, digit, tanda hubung (-), dan titik (.). Mereka harus dimulai dengan huruf besar atau kecil dan tidak boleh dimulai atau diakhiri dengan tanda hubung (-) atau titik (.). Tanda hubung (-) atau titik (.) berurutan tidak diperbolehkan.

    • Awalan wajib diisi (pembatasan ECS). Akhiran opsional.

    • IP node adalah alamat IP pribadi lengkap dari node.

    Contoh: Jika alamat IP node adalah 192.XX.YY.55, awalan adalah aliyun.com, dan akhiran adalah test:

    • Untuk node Linux, nama node, nama Instance ECS, dan hostname Instance ECS semuanya adalah aliyun.com192.XX.YY.55test.

    • Untuk node Windows, hostname Instance ECS adalah 192-XX-YY-55, dan nama node serta nama Instance ECS keduanya adalah aliyun.com192.XX.YY.55test.

    aliyun.com192.XX.YY.55test
    pre_user_data

    string

    No

    Data pra-pengguna untuk instans. Sebelum node bergabung dengan kluster, skrip data pra-pengguna yang ditentukan akan dijalankan. Untuk informasi selengkapnya, lihat Skrip data pengguna.

    dGhpcyBpcyBhIGV4YW1wbGU
    tee_config

    object

    No

    Konfigurasi kluster komputasi rahasia.

    tee_enable

    boolean

    No

    Apakah akan mengaktifkan komputasi rahasia untuk kluster.

    • true: Mengaktifkan komputasi rahasia.

    • false: Tidak mengaktifkan komputasi rahasia.

    true
    interconnect_config deprecated

    object

    No

    [Tidak digunakan lagi]

    Konfigurasi kelompok node tepi.

    cen_id

    string

    No

    [Tidak digunakan lagi]

    ID instans Cloud Enterprise Network (CEN) yang terikat ke kelompok node tepi yang ditingkatkan.

    null
    ccn_id

    string

    No

    [Tidak digunakan lagi]

    ID instans Cloud Connect Network (CCN) yang terikat ke kelompok node tepi yang ditingkatkan.

    null
    ccn_region_id

    string

    No

    [Tidak digunakan lagi]

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

    null
    bandwidth

    integer

    No

    [Tidak digunakan lagi]

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

    null
    improved_period

    string

    No

    [Tidak digunakan lagi]

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

    null
    count deprecated

    integer

    No

    [Tidak digunakan lagi] Gunakan desired_size sebagai gantinya.

    Jumlah node dalam kelompok node.

    null
    max_nodes deprecated

    integer

    No

    [Tidak digunakan lagi]

    Jumlah maksimum node yang diizinkan dalam kelompok node tepi.

    null
    interconnect_mode

    string

    No

    Jenis jaringan kolam sumber kelompok node tepi. Parameter ini hanya berlaku untuk kolam sumber kelompok node yang type-nya edge. Nilai valid:

    • basic: Jaringan publik. Node dalam kolam sumber kelompok node cloud berinteraksi dengan node cloud melalui Internet. Aplikasi dalam kolam sumber kelompok node cloud tidak dapat mengakses jaringan pribadi VPC cloud secara langsung.

    • private: Jaringan pribadi. Node dalam kolam sumber kelompok node cloud terhubung ke cloud melalui Express Connect, VPN, atau CEN, menyediakan kualitas komunikasi cloud-edge yang lebih tinggi dan keamanan yang lebih efektif.

    basic
    host_network

    boolean

    No

    Apakah mode jaringan pod menggunakan mode jaringan host.

    • true: Jaringan host. Pod secara langsung menggunakan stack jaringan host dan berbagi alamat IP serta port dengan host.

    • false: Jaringan kontainer. Pod memiliki stack jaringan independen dan tidak menempati port jaringan host.

    true
    intranet

    boolean

    No

    Apakah node dalam kolam sumber kelompok node tepi memiliki konektivitas jaringan Lapisan 3 satu sama lain.

    • true: Terhubung. Semua node dalam kolam sumber kelompok node memiliki konektivitas jaringan Lapisan 3 satu sama lain.

    • false: Tidak terhubung. Semua node dalam kolam sumber kelompok node tidak memiliki konektivitas jaringan Lapisan 3 satu sama lain.

    true
    eflo_node_group

    object

    No

    Konfigurasi kelompok node Lingjun.

    cluster_id

    string

    No

    ID kluster Lingjun yang akan diasosiasikan saat membuat kelompok node Lingjun.

    i1169130516633730****
    group_id

    string

    No

    ID kelompok Lingjun dari kluster Lingjun yang akan diasosiasikan saat membuat kelompok node Lingjun.

    ng-ec3c96ff0aa****
    auto_attach_enabled

    boolean

    No

    Apakah akan mengaktifkan penambahan node otomatis untuk kelompok node Lingjun.

    worker_ram_role_name

    string

    No

    Peran RAM Worker yang digunakan oleh kelompok node Lingjun.

    auto_mode

    object

    No

    Konfigurasi pengelolaan cerdas untuk kelompok node.

    enable

    boolean

    No

    Apakah akan mengaktifkan mode pengelolaan cerdas. Nilai valid:

    • true: Mengaktifkan mode pengelolaan cerdas. Ini hanya dapat diaktifkan ketika kluster telah mengaktifkan mode pengelolaan cerdas.

    • false: Tidak mengaktifkan mode pengelolaan cerdas.

    true
    node_components

    array<object>

    No

    Daftar komponen node.

    array<object>

    No

    Komponen node.

    name

    string

    No

    Nama komponen node.

    kubelet
    version

    string

    No

    Versi komponen node.

    1.33.3-aliyun.1
    config

    object

    No

    Konfigurasi komponen node.

    custom_config

    object

    No

    Konfigurasi kustom komponen node.

    {"cpuManagerPolicy":"static"}

    any

    No

    String konfigurasi kustom komponen node.

    cpuManagerPolicy
    envs

    array<object>

    No

    Variabel lingkungan komponen node.

    object

    No

    name

    string

    No

    Nama variabel lingkungan.

    LOG_LEVEL
    value

    string

    No

    Nilai variabel lingkungan.

    info

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Konfigurasi kelompok node.

    nodepool_id

    string

    ID kelompok node.

    np31da1b38983f4511b490fc62108a****
    task_id

    string

    ID tugas.

    T-613b19bbd160ad492800****
    request_id

    string

    ID permintaan.

    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.