All Products
Search

This Product

    Container Service for Kubernetes:DescribeClusterNodePools

    Document Center

    Container Service for Kubernetes:DescribeClusterNodePools

    Last Updated:Jul 13, 2026

    Mengkueri daftar semua kelompok node dalam sebuah kluster.

    Deskripsi operasi

    • Saat menghapus node, lakukan operasi terstandarisasi melalui API ini atau Konsol Container Service. Jangan menghapus node secara manual dengan menjalankan kubectl delete node.

    • Jika kelompok node memiliki jumlah node yang diinginkan (desired node count) yang dikonfigurasi, kelompok node akan secara otomatis melakukan skala keluar (scale out) instans lain berdasarkan konfigurasi terkait untuk mempertahankan jumlah node pada tingkat yang diinginkan.

    • Penghapusan node melibatkan migrasi Pod, yang dapat memengaruhi layanan Anda. Lakukan operasi ini selama jam non-puncak. Risiko tak terduga dapat terjadi selama operasi. Cadangkan data Anda sebelumnya.

    • Periksa aturan afinitas node dan kebijakan penjadwalan Pod pada node yang akan dihapus untuk memastikan bahwa Pod dapat dijadwalkan ke node lain setelah penghapusan node.

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

    get

    *Cluster

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

    		 None None

    Sintaks permintaan

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

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    ClusterId

    string

    Yes

    ID kluster.

    cc0f87de0b8fb403f86e10e204f83****

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    NodepoolName

    string

    No

    Nama kelompok node.

    nodepool-test

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Detail kelompok node.

    nodepools

    array<object>

    Daftar instans kelompok node.

    array<object>

    Detail instans kelompok node.

    nodepool_info

    object

    Informasi kelompok node.

    nodepool_id

    string

    ID kelompok node.

    np615c0e0966124216a0412e10afe0****
    name

    string

    Nama kelompok node.

    default-nodepool
    type

    string

    Tipe kelompok node. Nilai valid:

    • ess: kelompok node standar (termasuk fitur terkelola dan skalabilitas elastis).

    • edge: kelompok node tepi.

    • lingjun: kelompok node Lingjun.

    ess
    is_default

    boolean

    Menunjukkan apakah ini adalah kelompok node default. Sebuah kluster biasanya hanya memiliki satu kelompok node default. Nilai valid:

    • true: Ini adalah kelompok node default.

    • false: Ini bukan kelompok node default.

    true
    resource_group_id

    string

    ID kelompok sumber daya.

    rg-acfmyvw3wjm****
    region_id

    string

    ID wilayah.

    cn-beijing
    created

    string

    Waktu ketika kelompok node dibuat.

    2025-04-15T16:33:29.362888807+08:00
    updated

    string

    Waktu ketika kelompok node terakhir diperbarui.

    2025-04-15T16:33:32.823+08:00
    status

    object

    Status kelompok node.

    state

    string

    Status kelompok node. Nilai valid:

    • active: Aktif.

    • scaling: Menskalakan.

    • removing: Menghapus node.

    • deleting: Menghapus.

    • updating: Memperbarui.

    active
    healthy_nodes

    integer

    Jumlah instans yang sehat.

    3
    initial_nodes

    integer

    Jumlah node yang sedang dibuat.

    0
    failed_nodes

    integer

    Jumlah instans yang gagal.

    0
    offline_nodes

    integer

    Jumlah node offline.

    0
    removing_nodes

    integer

    Jumlah node yang sedang dihapus.

    0
    serving_nodes

    integer

    Jumlah node dalam status melayani.

    3
    total_nodes

    integer

    Jumlah total node dalam kelompok node.

    3
    auto_scaling

    object

    Konfigurasi penskalaan otomatis.

    enable

    boolean

    Apakah akan mengaktifkan penskalaan otomatis. Nilai valid:

    • true: Mengaktifkan fitur penskalaan otomatis untuk kelompok node. Ketika perencanaan kapasitas kluster tidak dapat memenuhi persyaratan penjadwalan Pod aplikasi, ACK secara otomatis menskalakan Sumber daya node berdasarkan jumlah instans minimum dan maksimum yang dikonfigurasi. Kluster versi 1.24 dan lebih baru menggunakan elastisitas node instan secara default. Kluster versi sebelum 1.24 menggunakan penskalaan otomatis node secara default. Untuk informasi lebih lanjut, lihat Penskalaan node.

    • false: Menonaktifkan penskalaan 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.

    true
    type

    string

    Tipe penskalaan otomatis, dikategorikan berdasarkan tipe instans. Nilai valid:

    • cpu: tipe instans reguler.

    • gpu: tipe instans GPU.

    • gpushare: tipe berbagi GPU.

    • spot: tipe spot instans.

    cpu
    max_instances

    integer

    Jumlah maksimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada saat ini.

    10
    min_instances

    integer

    Jumlah minimum instans yang dapat diskalakan dalam kelompok node, tidak termasuk instans yang ada saat ini.

    2
    eip_internet_charge_type

    string

    Tipe penagihan EIP. Nilai valid:

    • PayByBandwidth: bayar per bandwidth.

    • PayByTraffic: bayar per trafik.

    PayByBandwidth
    is_bond_eip

    boolean

    Apakah akan mengasosiasikan EIP. Nilai valid:

    • true: EIP diasosiasikan.

    • false: Tidak ada EIP yang diasosiasikan.

    true
    eip_bandwidth

    integer

    Bandwidth puncak EIP.

    Nilai valid: [1,100]. Unit: Mbit/s.

    5
    management

    object

    Konfigurasi kelompok node terkelola. Konfigurasi ini hanya berlaku pada kluster terkelola ACK Pro.

    enable

    boolean

    Apakah akan mengaktifkan kelompok node terkelola. Nilai valid:

    • true: Mengaktifkan kelompok node terkelola.

    • false: Menonaktifkan kelompok node terkelola. Konfigurasi terkait lainnya hanya berlaku ketika enable=true.

    true
    auto_repair

    boolean

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

    • true: Mengaktifkan perbaikan otomatis.

    • false: Menonaktifkan perbaikan otomatis.

    true
    auto_repair_policy

    object

    Kebijakan perbaikan otomatis node.

    restart_node

    boolean

    Apakah akan mengizinkan restart node. Parameter ini hanya berlaku ketika auto_repair=true.

    • true: Restart node diizinkan.

    • false: Restart node tidak diizinkan.

    true
    approval_required

    boolean

    Menunjukkan apakah persetujuan manual diperlukan untuk perbaikan node.

    false
    auto_repair_policy_id

    string

    ID kebijakan perbaikan otomatis.

    r-xxxxxxxxx
    auto_vul_fix

    boolean

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

    • true: Mengaktifkan perbaikan CVE otomatis.

    • false: Menonaktifkan perbaikan CVE otomatis.

    true
    auto_vul_fix_policy

    object

    Kebijakan perbaikan CVE otomatis.

    restart_node

    boolean

    Apakah akan mengizinkan restart node. Parameter ini hanya berlaku ketika auto_vul_fix=true. Nilai valid:

    • true: Restart node diizinkan.

    • false: Restart node tidak diizinkan.

    true
    vul_level

    string

    Level kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan oleh koma.

    • asap: tinggi

    • later: menengah

    • nntf: rendah

    asap,nntf
    exclude_packages

    string

    Paket yang dikecualikan selama perbaikan kerentanan.

    kernel
    auto_upgrade

    boolean

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

    • true: Mengaktifkan peningkatan otomatis.

    • false: Menonaktifkan peningkatan otomatis.

    true
    auto_upgrade_policy

    object

    Kebijakan peningkatan otomatis.

    auto_upgrade_kubelet

    boolean

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

    • true: Peningkatan kubelet otomatis diizinkan.

    • false: Peningkatan kubelet otomatis tidak diizinkan.

    true
    upgrade_config

    object

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

    auto_upgrade

    boolean

    Apakah akan mengaktifkan peningkatan otomatis. Nilai valid:

    • true: Mengaktifkan peningkatan otomatis.

    • false: Menonaktifkan peningkatan otomatis.

    true
    surge

    integer

    Jumlah node tambahan. Parameter ini saling eksklusif dengan surge_percentage.

    5
    surge_percentage

    integer

    Persentase node tambahan. Parameter ini 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.

    50
    max_unavailable

    integer

    Jumlah maksimum node yang tidak tersedia. Nilai valid: [1,1000].

    Nilai default: 1.

    1
    auto_fault_diagnosis

    boolean

    scaling_group

    object

    Konfigurasi grup penskalaan kelompok node.

    scaling_group_id

    string

    ID grup penskalaan.

    asg-2ze8n5qw4atggut8****
    vswitch_ids

    array

    Daftar ID vSwitch.

    string

    ID vSwitch.

    vsw-2ze3ds0mdip0hdz8i****
    instance_types

    array

    Daftar tipe instans node. Anda dapat memilih beberapa tipe instans sebagai alternatif. Selama pembuatan node, sistem mencoba membeli instans dimulai dari spesifikasi pertama hingga berhasil. Tipe instans yang dibeli akhirnya dapat bervariasi tergantung pada ketersediaan inventaris.

    ecs.n4.large

    string

    Tipe instans node.

    ecs.n4.large
    instance_charge_type

    string

    Tipe penagihan node dalam kelompok node. Nilai valid:

    • PrePaid: langganan.

    • PostPaid: bayar sesuai pemakaian.

    PostPaid
    period

    integer

    Durasi langganan node. Parameter ini berlaku dan wajib diisi 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

    Unit periode langganan. Parameter ini harus ditentukan ketika instance_charge_type diatur ke PrePaid.

    • Month: bulan sebagai unit waktu.

    • Week: minggu sebagai unit waktu.

    Month
    auto_renew

    boolean

    Apakah akan mengaktifkan perpanjangan otomatis untuk node. Parameter ini hanya berlaku ketika instance_charge_type diatur ke PrePaid. Nilai valid:

    • true: Mengaktifkan perpanjangan otomatis.

    • false: Menonaktifkan perpanjangan otomatis.

    false
    auto_renew_period

    integer

    Durasi setiap siklus perpanjangan otomatis. Nilai valid:

    • Ketika PeriodUnit=Week: 1, 2, 3.

    • Ketika PeriodUnit=Month: 1, 2, 3, 6, 12, 24, 36, 48, 60.

    0
    spot_strategy

    string

    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>

    Konfigurasi rentang harga pasar spot instans.

    object

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

    instance_type

    string

    Tipe spot instans.

    ecs.c6.large
    price_limit

    string

    Rentang harga pasar per instans.

    Unit: USD/jam.

    0.39
    image_type

    string

    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

    ID gambar kustom. Anda dapat memanggil DescribeKubernetesVersionMetadata untuk mengkueri image yang didukung oleh sistem.

    aliyun_3_x64_20G_alibase_20241218.vhd
    system_disk_category

    string

    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.

    cloud_efficiency
    system_disk_categories

    array

    Beberapa tipe cloud disk sistem. Ketika tipe disk dengan prioritas lebih tinggi tidak tersedia, sistem secara otomatis mencoba tipe disk dengan prioritas berikutnya untuk membuat cloud disk sistem.

    string

    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.

    EESSD云盘
    system_disk_size

    integer

    Ukuran cloud disk sistem node. Unit: GiB.

    Nilai valid: [20,2048].

    120
    system_disk_performance_level

    string

    Tingkat kinerja cloud disk sistem node. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja terkait dengan ukuran 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

    Apakah akan mengenkripsi cloud disk sistem. Nilai valid:

    • true: Terenkripsi.

    • false: Tidak terenkripsi.

    false
    system_disk_kms_key_id

    string

    ID kunci KMS yang digunakan oleh cloud disk sistem.

    0e478b7a-4262-4802-b8cb-00d3fb40****
    system_disk_encrypt_algorithm

    string

    Algoritma enkripsi yang digunakan oleh cloud disk sistem. Nilai valid: aes-256.

    aes-256
    system_disk_bursting_enabled

    boolean

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

    • true: Diaktifkan. Ketika diaktifkan, cloud disk sementara meningkatkan performa selama tekanan baca/tulis data yang tiba-tiba hingga beban kerja stabil.

    • 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

    IOPS baca/tulis yang disediakan untuk cloud disk sistem node. Parameter ini berlaku ketika tipe disk adalah cloud_auto.

    1000
    data_disks

    array

    Kombinasi tipe cloud disk data, ukuran, dan konfigurasi lainnya untuk node.

    data_disk

    Konfigurasi cloud disk data node.

    disk_init

    array

    Konfigurasi inisialisasi perangkat blok.

    DiskInit

    Konfigurasi DiskInit.

    security_group_ids

    array

    Daftar ID grup keamanan untuk kelompok node.

    string

    Daftar ID grup keamanan untuk kelompok node.

    sg-2ze1iuk12m2sb4c4****
    key_pair

    string

    Nama key pair. Parameter ini saling eksklusif dengan login_password.

    Untuk kelompok node terkelola, hanya key_pair yang didukung.

    pro-nodepool
    login_password

    string

    Kata sandi logon SSH. Parameter ini saling eksklusif dengan key_pair. Kata sandi logon harus memiliki panjang 8 hingga 30 karakter dan mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus.

    Untuk tujuan keamanan, kata sandi logon dienkripsi dalam hasil kueri.

    ******
    login_as_non_root

    boolean

    Apakah akan logon ke Instans ECS yang diskalakan sebagai pengguna non-root.

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

    • false: Logon sebagai pengguna root.

    true
    cis_enabled deprecated

    boolean

    [Bidang ini tidak digunakan lagi]

    Gunakan parameter security_hardening_os sebagai gantinya.

    false
    soc_enabled

    boolean

    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 berlapis dan program pemindaian untuk image MLPS 2.0 Level 3 Alibaba Cloud Linux 2 dan Alibaba Cloud Linux 3.

    false
    security_hardening_os

    boolean

    Apakah akan mengaktifkan penguatan keamanan OS Alibaba Cloud. Nilai valid:

    • true: Diaktifkan.

    • false: Dinonaktifkan.

    Nilai default: false.

    false
    internet_charge_type

    string

    Tipe penagihan untuk alamat IP publik node.

    • PayByBandwidth: bayar per bandwidth.

    • PayByTraffic: bayar per trafik.

    PayByBandwidth
    internet_max_bandwidth_out

    integer

    Bandwidth publik arah keluar maksimum untuk node. Unit: Mbit/s. Nilai valid: 1 hingga 100.

    10
    tags

    array

    Label Instans ECS.

    tag

    Tag node.

    [{\"key\":\"pkg.E2EClient.ClusterId\",\"value\":\"troopers-\"}]
    desired_size

    integer

    Jumlah node yang diinginkan dalam kelompok node.

    2
    multi_az_policy

    string

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

    • PRIORITY: Menskalakan 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: Membuat instans berdasarkan harga satuan vCPU, dalam urutan menaik. Ketika konfigurasi penskalaan menetapkan beberapa tipe instans dengan metode penagihan preemptible, spot instans diprioritaskan untuk dibuat. Anda dapat menggunakan parameter CompensateWithOnDemand untuk menentukan apakah akan secara otomatis membuat instans bayar sesuai pemakaian ketika spot instans tidak dapat dibuat karena inventaris yang tidak mencukupi.

      Catatan

      COST_OPTIMIZED hanya berlaku ketika beberapa tipe instans ditentukan dalam konfigurasi penskalaan atau tipe instans preemptible digunakan.

    • BALANCE: Mendistribusikan Instans ECS secara merata di seluruh zona aktif ganda yang ditentukan dalam grup penskalaan. Jika zona menjadi tidak seimbang karena inventaris yang tidak mencukupi, Anda dapat memanggil operasi API RebalanceInstances untuk menyeimbangkan ulang Sumber daya. Untuk informasi lebih lanjut, lihat RebalanceInstances.

    COST_OPTIMIZED
    scaling_policy

    string

    Mode grup penskalaan. Nilai valid:

    • release: Mode standar. Menskalakan dengan membuat dan melepaskan Instans ECS berdasarkan Penggunaan sumber daya.

    • recycle: Mode cepat. Menskalakan dengan membuat, menghentikan, dan memulai Instans ECS, yang meningkatkan kecepatan operasi penskalaan berikutnya. Resource komputasi tidak dikenai biaya selama status berhenti. Hanya biaya penyimpanan yang dikenai biaya, kecuali untuk instans dengan disk lokal.

    release
    on_demand_base_capacity

    integer

    Jumlah minimum instans bayar sesuai pemakaian yang diperlukan dalam grup penskalaan. Nilai valid: [0,1000]. Ketika jumlah instans bayar sesuai pemakaian kurang dari nilai ini, instans bayar sesuai pemakaian diprioritaskan untuk dibuat.

    0
    on_demand_percentage_above_base_capacity

    integer

    Persentase instans bayar sesuai pemakaian di antara instans tambahan yang melebihi jumlah minimum instans bayar sesuai pemakaian (on_demand_base_capacity). Nilai valid: [0,100].

    20
    spot_instance_pools

    integer

    Jumlah tipe instans yang tersedia. Grup penskala.

    5
    spot_instance_remedy

    boolean

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

    • true: Mengaktifkan penambahan spot instans.

    • false: Menonaktifkan

    false
    compensate_with_on_demand

    boolean

    When multi_az_policy is set to COST_OPTIMIZED, specifies whether to allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances when spot instances cannot be created due to cost or inventory reasons. Valid values:

    • true: Allows automatic creation of pay-as-you-go instances to meet the required number of ECS instances.

    • false: Does not allow automatic creation of pay-as-you-go instances to meet the required number of ECS instances.

    true
    deploymentset_id

    string

    The deployment set ID.

    ds-bp1d19mmbsv3jf6xxxxx
    rds_instances

    array

    If an RDS instance list is specified, the ECS instances in the cluster nodes are automatically added to the RDS access whitelist.

    string

    The RDS instance.

    rm-xxx
    private_pool_options

    object

    The private pool options.

    id

    string

    The private pool ID, which is the elasticity assurance ID or capacity reservation ID.

    eap-bp67acfmxazb4****
    match_criteria

    string

    The private node pool type. Specifies the private pool capacity option for instance launch. After an elasticity assurance or capacity reservation takes effect, a private pool is generated for instance launch. Valid values:

    • Open: Open mode. Automatically matches open-type private pool capacity. If no matching private pool capacity is available, public pool resources are used.

    • Target: Specified mode. Uses the specified private pool capacity to launch instances. If the private pool capacity is unavailable, instance launch fails.

    • None: Not used mode. Instance launch does not use private pool capacity.

    Open
    security_group_id

    string

    [This field is deprecated]

    The security group ID of the node pool. When the node pool is associated with multiple security groups, this is the first value in security_group_ids.

    sg-2ze1iuk12m2sb4c4****
    platform

    string

    [This field is deprecated]

    The operating system distribution. Valid values:

    • CentOS

    • AliyunLinux

    • Windows

    • WindowsCore

    AliyunLinux
    ram_policy

    string

    This field is deprecated. Use ram_role_name instead.

    KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
    instance_patterns

    array

    The instance attribute configurations.

    instance_patterns

    The instance attributes.

    ram_role_name

    string

    The worker RAM role name.

    KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****
    resource_pool_options

    object

    The resource pool and resource pool policy used when creating instances.

    strategy

    string

    The resource pool policy used when creating instances. Valid values: PrivatePoolFirst: Private pool first. PrivatePoolOnly: Private pool only. None: No resource pool policy.

    PrivatePoolFirst
    private_pool_ids

    array

    The list of private pool IDs.

    string

    The private pool ID.

    eap-bp1c1fohub5jccwi****
    system_disk_snapshot_policy_id

    string

    The snapshot policy for the system cloud disk.

    sp-0jl6xnmme8v7o935****
    node_config

    object

    The node configuration.

    kubelet_configuration kubelet_config

    The Kubelet parameter settings.

    node_os_config

    object

    The node operating system configuration.

    hugepage

    Hugepage

    The hugepage configuration.

    kubernetes_config

    object

    The cluster-related configuration.

    labels

    array

    Tag node.

    tag

    The label configuration.

    {}
    taints

    array

    The node taint information. Taints and tolerations work together to prevent pods from being scheduled to inappropriate nodes. For more information, see taint-and-toleration.

    taint

    The node taint information.

    runtime

    string

    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.

    containerd
    runtime_version

    string

    The container runtime version.

    1.6.38
    cpu_policy

    string

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

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

    • none: Enables the existing default CPU affinity scheme.

    none
    user_data

    string

    The node pool custom data, which is a script that runs after node initialization. For more information, see Generate instance user data.

    IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
    unschedulable

    boolean

    Specifies whether the scaled-out nodes are unschedulable.

    • true: Unschedulable.

    • false: Schedulable.

    true
    cms_enabled

    boolean

    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:

    • true: Installs the CloudMonitor agent on ECS nodes.

    • false: Does not install the CloudMonitor agent on ECS nodes.

    true
    node_name_mode

    string

    The custom node name.

    A node name consists of three parts: prefix + node IP address substring + suffix:

    • The prefix and suffix can each 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 IP address segment length specifies the number of digits taken from the end of the node IP address. Valid values: 5-12.

    For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP address segment length is 5, and the suffix is test, the node name is aliyun.com00055test.

    aliyun.com192.XX.YY.55test
    pre_user_data

    string

    The node pool pre-custom data, which is a script that runs before node initialization. For more information, see Generate instance user data.

    IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
    tee_config

    object

    The confidential computing configuration.

    tee_enable

    boolean

    Specifies whether to enable confidential computing for the cluster. Valid values:

    • true: Enabled.

    • false: Disabled.

    false
    interconnect_config

    object

    [Deprecated] The network configuration for edge node pools. This value is meaningful only for edge-type node pools.

    cen_id

    string

    [This field is deprecated]

    The Cloud Enterprise Network (CEN) instance ID bound to the enhanced edge node pool.

    cen-ey9k9nfhz0f*******
    ccn_id

    string

    [This field is deprecated]

    The Cloud Connect Network (CCN) instance ID bound to the enhanced edge node pool.

    ccn-qm5i0i0q9yi*******
    ccn_region_id

    string

    [This field is deprecated]

    The region of the Cloud Connect Network instance bound to the enhanced edge node pool.

    cn-shanghai
    bandwidth

    integer

    [This field is deprecated]

    The network bandwidth of the enhanced edge node pool. Unit: Mbps.

    10
    improved_period

    string

    [This field is deprecated]

    The subscription duration of the enhanced edge node pool. Unit: months.

    1
    max_nodes

    integer

    The maximum number of nodes allowed in the edge node pool. The value must be greater than or equal to 0. A value of 0 indicates no additional limit (limited only by the maximum number of nodes the cluster can accommodate, with no additional limit on the node pool itself). Edge node pools typically have a value greater than 0. The value is 0 for ess-type node pools and default edge-type node pools.

    10
    interconnect_mode

    string

    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 the node pool interact with cloud nodes over the Internet. Applications in the node pool cannot directly access the cloud VPC internal network.

    • private: private network. Nodes in the node pool connect to the cloud through Express Connect, VPN, or CEN, providing higher cloud-edge communication quality and more effective security.

    basic
    auto_mode

    object

    The intelligent managed configuration.

    enable

    boolean

    Specifies whether to enable intelligent managed mode.

    true
    node_components

    array<object>

    The list of node components.

    array<object>

    The node component.

    name

    string

    The node component name.

    kubelet
    version

    string

    The node component version.

    1.33.3-aliyun.1
    config

    object

    The node component configuration.

    custom_config

    object

    The node component custom configuration.

    {"cpuManagerPolicy":"static"}

    any

    The node component custom configuration string.

    cpuManagerPolicy
    config_revision

    string

    1
    eflo_node_group

    object

    The Lingjun node group information.

    cluster_id

    string

    The Lingjun cluster ID.

    i113790071760688002461
    group_id

    string

    The Lingjun group ID.

    i128147721760688002463
    auto_attach_enabled

    boolean

    worker_ram_role_name

    string

    Contoh

    Respons sukses

    JSONformat

    {
  "nodepools": [
    {
      "nodepool_info": {
        "nodepool_id": "np615c0e0966124216a0412e10afe0****",
        "name": "default-nodepool",
        "type": "ess",
        "is_default": true,
        "resource_group_id": "rg-acfmyvw3wjm****",
        "region_id": "cn-beijing",
        "created": "2025-04-15T16:33:29.362888807+08:00",
        "updated": "2025-04-15T16:33:32.823+08:00"
      },
      "status": {
        "state": "active",
        "healthy_nodes": 3,
        "initial_nodes": 0,
        "failed_nodes": 0,
        "offline_nodes": 0,
        "removing_nodes": 0,
        "serving_nodes": 3,
        "total_nodes": 3
      },
      "auto_scaling": {
        "enable": true,
        "type": "cpu",
        "max_instances": 10,
        "min_instances": 2,
        "eip_internet_charge_type": "PayByBandwidth",
        "is_bond_eip": true,
        "eip_bandwidth": 5
      },
      "management": {
        "enable": true,
        "auto_repair": true,
        "auto_repair_policy": {
          "restart_node": true,
          "approval_required": false,
          "auto_repair_policy_id": "r-xxxxxxxxx"
        },
        "auto_vul_fix": true,
        "auto_vul_fix_policy": {
          "restart_node": true,
          "vul_level": "asap,nntf",
          "exclude_packages": "kernel"
        },
        "auto_upgrade": true,
        "auto_upgrade_policy": {
          "auto_upgrade_kubelet": true
        },
        "upgrade_config": {
          "auto_upgrade": true,
          "surge": 5,
          "surge_percentage": 50,
          "max_unavailable": 1
        },
        "auto_fault_diagnosis": false
      },
      "scaling_group": {
        "scaling_group_id": "asg-2ze8n5qw4atggut8****",
        "vswitch_ids": [
          "vsw-2ze3ds0mdip0hdz8i****"
        ],
        "instance_types": [
          "ecs.n4.large"
        ],
        "instance_charge_type": "PostPaid",
        "period": 1,
        "period_unit": "Month",
        "auto_renew": false,
        "auto_renew_period": 0,
        "spot_strategy": "NoSpot",
        "spot_price_limit": [
          {
            "instance_type": "ecs.c6.large",
            "price_limit": "0.39"
          }
        ],
        "image_type": "AliyunLinux3",
        "image_id": "aliyun_3_x64_20G_alibase_20241218.vhd",
        "system_disk_category": "cloud_efficiency",
        "system_disk_categories": [
          "EESSD云盘"
        ],
        "system_disk_size": 120,
        "system_disk_performance_level": "PL1",
        "system_disk_encrypted": false,
        "system_disk_kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "system_disk_encrypt_algorithm": "aes-256",
        "system_disk_bursting_enabled": true,
        "system_disk_provisioned_iops": 1000,
        "data_disks": [
          {
            "category": "cloud_ssd",
            "size": 40,
            "encrypted": "true",
            "kms_key_id": "0e478b7a-4262-4802-b8cb-00d3fb40****",
            "auto_snapshot_policy_id": "sp-2zej1nogjvovnz4z****",
            "performance_level": "PL1",
            "provisioned_iops": 1000,
            "bursting_enabled": true,
            "auto_format": true,
            "file_system": "ext4",
            "mount_target": "/mnt/path1",
            "disk_name": "DataDiskName",
            "device": "/dev/xvdb",
            "snapshot_id": "s-280s7****"
          }
        ],
        "disk_init": [
          {
            "disk_name": "disk0",
            "mkfs_type": "ext4",
            "mount_target": "/mnt/disk0",
            "mount_for_runtime": false,
            "local_disk": false
          }
        ],
        "security_group_ids": [
          "sg-2ze1iuk12m2sb4c4****"
        ],
        "key_pair": "pro-nodepool",
        "login_password": "******",
        "login_as_non_root": true,
        "cis_enabled": false,
        "soc_enabled": false,
        "security_hardening_os": false,
        "internet_charge_type": "PayByBandwidth",
        "internet_max_bandwidth_out": 10,
        "tags": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "desired_size": 2,
        "multi_az_policy": "COST_OPTIMIZED",
        "scaling_policy": "release",
        "on_demand_base_capacity": 0,
        "on_demand_percentage_above_base_capacity": 20,
        "spot_instance_pools": 5,
        "spot_instance_remedy": false,
        "compensate_with_on_demand": true,
        "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
        "rds_instances": [
          "rm-xxx"
        ],
        "private_pool_options": {
          "id": "eap-bp67acfmxazb4****",
          "match_criteria": "Open"
        },
        "security_group_id": "sg-2ze1iuk12m2sb4c4****",
        "platform": "AliyunLinux",
        "ram_policy": "KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****",
        "instance_patterns": [
          {
            "cores": 4,
            "memory": 8,
            "instance_family_level": "EnterpriseLevel",
            "excluded_instance_types": [
              "ecs.c6.large"
            ],
            "min_cpu_cores": 4,
            "max_cpu_cores": 8,
            "min_memory_size": 8,
            "max_memory_size": 16,
            "instance_categories": [
              "General-purpose"
            ],
            "cpu_architectures": [
              "X86"
            ],
            "core": 4,
            "max_price": 2,
            "architectures": [
              "X86"
            ],
            "burst_performance_option": "Exclude",
            "instance_type_families": [
              "ecs.c6"
            ],
            "minimum_eni_quantity": 3,
            "minimum_eni_private_ip_address_quantity": 10,
            "minimum_eni_ipv6_address_quantity": 1,
            "maximum_gpu_amount": 8
          }
        ],
        "ram_role_name": "KubernetesWorkerRole-4a4fa089-80c1-48a5-b3c6-9349311f****",
        "resource_pool_options": {
          "strategy": "PrivatePoolFirst",
          "private_pool_ids": [
            "eap-bp1c1fohub5jccwi****"
          ]
        },
        "system_disk_snapshot_policy_id": "sp-0jl6xnmme8v7o935****"
      },
      "node_config": {
        "kubelet_configuration": {
          "registryPullQPS": 5,
          "registryBurst": 10,
          "eventRecordQPS": 5,
          "eventBurst": 10,
          "kubeAPIQPS": 5,
          "kubeAPIBurst": 10,
          "serializeImagePulls": true,
          "cpuManagerPolicy": "none",
          "evictionHard": {
            "test": "test",
            "test2": 1
          },
          "evictionSoft": {
            "test": "test",
            "test2": 1
          },
          "evictionSoftGracePeriod": {
            "test": "test",
            "test2": 1
          },
          "systemReserved": {
            "test": "test",
            "test2": 1
          },
          "kubeReserved": {
            "test": "test",
            "test2": 1
          },
          "readOnlyPort": 0,
          "maxPods": 110,
          "containerLogMaxSize": "10Mi",
          "containerLogMaxFiles": 5,
          "featureGates": {
            "test": "test",
            "test2": 1
          },
          "allowedUnsafeSysctls": [
            "net.core.somaxconn"
          ],
          "reservedMemory": [
            {
              "numaNode": 0,
              "limits": {
                "memory": "1Gi"
              }
            }
          ],
          "memoryManagerPolicy": "none",
          "cpuCFSQuota": true,
          "cpuCFSQuotaPeriod": "100ms",
          "imageGCHighThresholdPercent": 85,
          "imageGCLowThresholdPercent": 80,
          "podPidsLimit": -1,
          "topologyManagerPolicy": "restricted",
          "clusterDNS": [
            "127.0.xx.xx"
          ],
          "tracing": {
            "endpoint": "localhost:4317",
            "samplingRatePerMillion": 200000
          },
          "containerLogMaxWorkers": 1,
          "containerLogMonitorInterval": "10s",
          "serverTLSBootstrap": true
        },
        "node_os_config": {
          "hugepage": {
            "transparentEnabled": "",
            "transparentDefrag": "",
            "khugepagedDefrag": 0,
            "khugepagedAllocSleepMillisecs": 0,
            "khugepagedScanSleepMillisecs": 0,
            "khugepagedPagesToScan": 0
          }
        }
      },
      "kubernetes_config": {
        "labels": [
          {
            "key": "env",
            "value": "prod"
          }
        ],
        "taints": [
          {
            "key": "key",
            "value": "value",
            "effect": "NoSchedule"
          }
        ],
        "runtime": "containerd",
        "runtime_version": "1.6.38",
        "cpu_policy": "none",
        "user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****",
        "unschedulable": true,
        "cms_enabled": true,
        "node_name_mode": "aliyun.com192.XX.YY.55test",
        "pre_user_data": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD"
      },
      "tee_config": {
        "tee_enable": false
      },
      "interconnect_config": {
        "cen_id": "cen-ey9k9nfhz0f*******",
        "ccn_id": "ccn-qm5i0i0q9yi*******",
        "ccn_region_id": "cn-shanghai",
        "bandwidth": 10,
        "improved_period": "1"
      },
      "max_nodes": 10,
      "interconnect_mode": "basic",
      "auto_mode": {
        "enable": true
      },
      "node_components": [
        {
          "name": "kubelet",
          "version": "1.33.3-aliyun.1",
          "config": {
            "custom_config": {
              "key": "cpuManagerPolicy"
            }
          },
          "config_revision": "1"
        }
      ],
      "eflo_node_group": {
        "cluster_id": "i113790071760688002461",
        "group_id": "i128147721760688002463",
        "auto_attach_enabled": false,
        "worker_ram_role_name": ""
      }
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.