All Products
Search

This Product

    Container Service for Kubernetes:CreateClusterNodePool

    Document Center

    Container Service for Kubernetes:CreateClusterNodePool

    Last Updated:Jul 15, 2026

    Membuat kelompok node untuk kluster. Kelompok node adalah kumpulan logis dari node yang berbagi atribut yang sama, memungkinkan manajemen terpusat dan operasi seperti peningkatan node serta 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.

    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 standar (termasuk fitur terkelola dan skalabilitas otomatis).

    • edge: kelompok node edge.

    • lingjun: kelompok node Lingjun.

    • hybrid: kelompok node cloud hibrida.

    Valid values:

    • lingjun :

      Kelompok node Lingjun.

    • edge :

      Kelompok node edge.

    • ess :

      Kelompok node standar.

    ess
    resource_group_id

    string

    No

    ID kelompok sumber daya dari 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-acfmyvw3wjmb****
    auto_scaling

    object

    No

    Konfigurasi penskalaan 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 atau lebih baru menggunakan skalabilitas elastis node instan secara default. Kluster versi sebelumnya menggunakan skalabilitas otomatis node secara default. Untuk informasi lebih lanjut, lihat Penskalaan node.

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

    Ketika nilainya false, parameter konfigurasi lain di auto_scaling tidak berlaku.

    Nilai default: false.

    false
    type

    string

    No

    Tipe instans skalabilitas otomatis. 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 Bidang 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 dalam kelompok node, tidak termasuk instans yang ada. Hanya berlaku ketika enable=true.

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

    10
    min_instances

    integer

    No

    Jumlah minimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada. Hanya berlaku ketika enable=true.

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

    Catatan

    • Jika jumlah instans minimum bukan 0, grup penskalaan memicu pembuatan otomatis sejumlah Instance ECS yang sesuai setelah fitur skalabilitas otomatis aktif.

    • Atur jumlah instans maksimum ke nilai yang tidak kurang dari jumlah node saat ini dalam kelompok node. Jika tidak, node dalam kelompok node akan diskalakan masuk setelah fitur skalabilitas otomatis aktif.

    1
    is_bond_eip deprecated

    boolean

    No

    [Sudah usang] Bidang ini sudah usang. Gunakan internet_charge_type dan internet_max_bandwidth_out sebagai gantinya.

    Apakah akan mengaitkan 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 EIP. Nilai valid:

    • PayByBandwidth: bayar per bandwidth.

    • PayByTraffic: bayar per trafik.

    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 kelompok node terkelola.

    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. Hanya berlaku ketika enable=true.

    • true: Mengaktifkan perbaikan otomatis.

    • false: Menonaktifkan perbaikan otomatis.

    Nilai default: true.

    true
    auto_repair_policy

    object

    No

    Kebijakan perbaikan otomatis node.

    restart_node

    boolean

    No

    Apakah akan mengizinkan restart node. Berlaku hanya 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. 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. Berlaku hanya 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. Contoh: asap,later. Tingkat kerentanan yang didukung:

    • 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 meningkatkan node secara otomatis. Hanya berlaku ketika enable=true.

    • true: Mengaktifkan peningkatan otomatis.

    • false: Menonaktifkan peningkatan otomatis.

    Nilai default: true.

    true

    auto_upgrade_policy

    object

    No

    Kebijakan peningkatan otomatis node.

    auto_upgrade_kubelet

    boolean

    No

    Apakah akan mengizinkan peningkatan kubelet otomatis. Berlaku hanya 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. Berlaku hanya ketika auto_upgrade=true. Nilai valid:

    • true: Mengizinkan peningkatan waktu proses otomatis.

    • false: Tidak mengizinkan peningkatan waktu proses otomatis.

    Nilai default: true.

    false
    auto_upgrade_os

    boolean

    No

    Apakah akan mengizinkan peningkatan sistem operasi otomatis. Berlaku hanya 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. Hanya berlaku ketika enable=true.

    auto_upgrade deprecated

    boolean

    No

    [Sudah usang] 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 kluster.

    Catatan

    Jumlah node tambahan tidak boleh melebihi jumlah node saat ini.

    0
    surge_percentage

    integer

    No

    Persentase node tambahan. Saling eksklusif dengan surge.

    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

    drift_enabled

    boolean

    No

    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 node dalam kelompok node. Ketika kelompok node melakukan scale-out, instans dibuat dari tipe instans yang ditentukan yang memenuhi persyaratan.

    Jumlah tipe instans yang didukung: [1,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 node dalam 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 node dalam kelompok node. Berlaku dan diperlukan hanya ketika instance_charge_type diatur ke PrePaid.

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

    • Ketika period_unit=Month, nilai valid period: {1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, 60}.

    1
    period_unit

    string

    No

    Unit periode penagihan node dalam kelompok node. Berlaku dan diperlukan hanya ketika instance_charge_type diatur ke PrePaid.

    • Month: ditagih bulanan.

    • Week: ditagih mingguan.

    Nilai default: Month.

    Month
    auto_renew

    boolean

    No

    Apakah akan mengaktifkan perpanjangan otomatis untuk node dalam kelompok node. 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:

    • 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 batas harga untuk tipe spot instans saat ini.

    object

    No

    Konfigurasi batas harga untuk spot instans. Anda dapat mengatur batas harga yang berbeda untuk tipe instans yang berbeda.

    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 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 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 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. Hanya berlaku untuk cloud disk ESSD. Tingkat kinerja terkait dengan ukuran cloud disk. Untuk informasi lebih lanjut, lihat Cloud disk ESSD.

    • PL0: kinerja I/O konkuren maksimum sedang dengan latensi baca/tulis yang relatif stabil.

    • PL1: kinerja I/O konkuren maksimum sedang dengan latensi baca/tulis yang relatif stabil.

    • PL2: kinerja I/O konkuren maksimum tinggi dengan latensi baca/tulis yang stabil.

    • PL3: kinerja I/O konkuren maksimum sangat tinggi dengan latensi baca/tulis yang sangat stabil.

    PL1
    system_disk_encrypted

    boolean

    No

    Apakah akan mengenkripsi cloud disk sistem. Nilai valid:

    • true: 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 (bursting kinerja) 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~min{50.000, 1000kapasitas-kinerja dasar}. Kinerja dasar=min{1.800+50kapasitas, 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 dalam kelompok node.

    data_disk

    No

    Konfigurasi cloud disk data.

    security_group_ids

    array

    No

    Daftar ID grup keamanan. Saling eksklusif dengan security_group_id. Kami menyarankan Anda menggunakan security_group_ids. Ketika kedua security_group_id dan security_group_ids ditentukan, security_group_ids didahulukan.

    string

    No

    Daftar ID grup keamanan. Saling eksklusif dengan security_group_id. Kami menyarankan Anda menggunakan security_group_ids. Ketika kedua security_group_id dan security_group_ids ditentukan, security_group_ids didahulukan.

    sg-wz9a8g2mt6x5ll******
    key_pair

    string

    No

    Nama pasangan kunci untuk logon tanpa kata sandi. Saling eksklusif dengan 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. Saling eksklusif dengan 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 akan logon ke Instance ECS sebagai pengguna 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 MLPS 2.0 Level 3 Alibaba Cloud Linux 2 dan Alibaba Cloud Linux 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 alamat IP publik. Nilai valid:

    • PayByBandwidth: bayar per bandwidth.

    • PayByTraffic: bayar per 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 Instance ECS.

    Kunci tag tidak boleh duplikat dan memiliki panjang maksimum 128 karakter. Kunci 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 seharusnya dipertahankan oleh kelompok node. Kami menyarankan Anda mengonfigurasi setidaknya 2 node untuk memastikan komponen kluster berjalan dengan benar. Anda dapat melakukan scale-in atau scale-out kelompok node dengan menyesuaikan jumlah node yang diinginkan.

    Jika Anda tidak perlu membuat node, atur nilai ini ke 0 dan sesuaikan secara manual nanti untuk menambahkan node.

    0
    multi_az_policy

    string

    No

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

    • PRIORITY: Penskalaan berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Ketika Instance ECS tidak dapat dibuat di zona vSwitch dengan prioritas lebih tinggi, sistem secara otomatis menggunakan vSwitch dengan prioritas berikutnya untuk membuat Instance ECS.

    • COST_OPTIMIZED: Mencoba membuat instans berdasarkan urutan harga satuan vCPU dari terendah ke tertinggi. Ketika konfigurasi penskalaan menentukan beberapa tipe instans dengan metode penagihan preemptible, 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 inventaris yang tidak mencukupi.

      Catatan

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

    • BALANCE: Mendistribusikan Instance ECS secara merata di seluruh beberapa zona yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena inventaris yang tidak mencukupi, Anda dapat menggunakan 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 dengan membuat dan melepaskan Instance ECS berdasarkan Penggunaan sumber daya.

    • recycle: Mode cepat. Melakukan penskalaan dengan membuat, menghentikan, dan memulai instans, yang meningkatkan kecepatan penskalaan berikutnya. Instans yang dihentikan tidak dikenai biaya untuk resource komputasi, hanya untuk penyimpanan. Ini tidak berlaku untuk instans dengan disk lokal.

    Nilai default: release.

    release
    on_demand_base_capacity

    integer

    No

    Jumlah minimum instans bayar sesuai pemakaian yang diperlukan dalam 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 tambahan yang melebihi jumlah minimum instans bayar sesuai pemakaian (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 di seluruh tipe instans berbiaya terendah secara seimbang. Nilai valid: [1,10].

    5
    spot_instance_remedy

    boolean

    No

    Apakah akan mengaktifkan penggantian spot instans. Ketika diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan direklamasi. Nilai valid:

    • true: Mengaktifkan penggantian spot instans.

    • false: Menonaktifkan penggantian spot instans.

    false
    compensate_with_on_demand

    boolean

    No

    Ketika multi_az_policy diatur ke COST_OPTIMIZED, apakah akan mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi persyaratan kuantitas Instance ECS ketika spot instans tidak dapat dibuat karena alasan harga atau inventaris. Nilai valid:

    • true: Mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi persyaratan kuantitas Instance ECS.

    • false: Tidak mengizinkan pembuatan otomatis instans bayar sesuai pemakaian untuk memenuhi persyaratan kuantitas Instance ECS. [parameters.1

    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 yang berbeda untuk memastikan ketersediaan tinggi dan pemulihan bencana tingkat bawah. Saat membuat Instance ECS dalam set penyebaran, instans diluncurkan di wilayah yang ditentukan berdasarkan strategi penyebaran yang telah dikonfigurasi sebelumnya.

    Penting Setelah Anda memilih set penyebaran, jumlah maksimum node dalam kelompok node dibatasi. Batas atas default untuk set penyebaran adalah 20 × jumlah zona (jumlah zona ditentukan oleh vSwitch). Pilih dengan hati

    ds-bp1d19mmbsv3jf6xxxxx
    rds_instances

    array

    No

    Daftar instans RDS.

    string

    No

    ID instans RDS.

    rds-****
    private_pool_options

    object

    No

    Konfigurasi kelompok node pribadi.

    id

    string

    No

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

    eap-bp67acfmxazb4****
    match_criteria

    string

    No

    Tipe node pool 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 tipe terbuka. Jika tidak ada kapasitas kolam pribadi yang cocok, resource kolam publik digunakan.

    • Target: Mode tertarget. Menggunakan kapasitas kolam pribadi yang ditentukan untuk meluncurkan instans. Jika kapasitas kolam pribadi

    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 configured as Elastic Compute Service. For more information, see Create a normal service role. When 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 Only ACK managed clusters of version 1.22 or later support this parameter.

    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

    The resource pool strategy used when creating instances. Resource pools include private pools generated after elasticity assurance or capacity reservation takes effect, and public pools for instance launch. Valid values: PrivatePoolFirst: Private pool first. When 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-type private pools are automatically matched. If no matching private pool is available, public pool resources are used. PrivatePoolOnly: Private pool only. You must specify resouce_pool_options.private_pool_ids. If the specified private pool capacity is insufficient, instance launch 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 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 Kubernetes cluster nodes.

    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. Supports all cluster versions.

    • Sandboxed-Container.runv: Sandboxed container that provides higher isolation. Supports cluster versions 1.31 and earlier.

    • docker: No longer maintained. Supports cluster versions 1.22 and earlier.

    Default value: containerd.

    containerd
    runtime_version

    string

    No

    The container runtime version.

    1.6.38
    cpu_policy

    string

    No

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

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

    • none: 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 instance user data script runs. For more information, see User-Data scripts.

    dGhpcyBpcyBhIGV4YW1wbGU=
    unschedulable

    boolean

    No

    Specifies whether scaled-out nodes are unschedulable.

    • true: Unschedulable.

    • false: Schedulable.

    true
    cms_enabled

    boolean

    No

    Specifies whether to install CloudMonitor 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 CloudMonitor on ECS nodes.

    • false: Does not install CloudMonitor 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.

    Example: The node IP address is 192.XX.YY.55, the prefix is aliyun.com, and the suffix is test.

    • For Linux nodes, the node name, ECS instance name, and ECS instance hostname are all aliyun.com192.XX.YY.55test.

    • For Windows nodes, 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-custom data. Before the node joins the cluster, the specified pre-custom data script runs. 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: Does not enable 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: Mbps.

    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.

    • false: Not connected. All nodes in the node pool do not have Layer 3 network connectivity.

    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 node pool intelligent managed configuration.

    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: Does not enable intelligent managed mode.

    true
    node_components

    array<object>

    No

    The node component list.

    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

    The node component custom configuration.

    {"cpuManagerPolicy":"static"}

    any

    No

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