All Products
Search
Document Center

Container Service for Kubernetes:DescribeClusterNodePoolDetail

Last Updated:Aug 21, 2026

Mengkueri konfigurasi kelompok node tertentu dalam kluster berdasarkan ID kelompok 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:DescribeClusterNodePoolDetail

get

*Cluster

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

None None

Sintaks permintaan

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

Path Parameters

Parameter

Type

Required

Description

Example

ClusterId

string

Yes

ID kluster.

c23421cfa74454bc8b37163fd19af****

NodepoolId

string

Yes

ID kelompok node.

np31da1b38983f4511b490fc62108a****

Parameter permintaan

Parameter

Type

Required

Description

Example

Tidak ada parameter yang diperlukan.

Elemen respons

Element

Type

Description

Example

object

Detail kelompok node.

nodepool_info

object

Konfigurasi 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 pengelolaan dan skalabilitas elastis).

  • edge: Kelompok node edge.

  • lingjun: Kelompok node Lingjun.

ess

is_default

boolean

Menunjukkan apakah ini adalah kelompok node default. Biasanya, sebuah kluster hanya memiliki satu kelompok node default. Nilai valid:

  • true: Kelompok node default.

  • false: Kelompok node non-default.

true

resource_group_id

string

ID kelompok sumber daya.

rg-acfmyvw3wjmb****

region_id

string

ID wilayah.

cn-beijing

created

string

Waktu ketika kelompok node dibuat.

2025-04-10T14:25:37.285530433+08:00

updated

string

Waktu ketika kelompok node terakhir diperbarui.

2025-04-15T15:39:45.41+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 node sehat.

3

initial_nodes

integer

Jumlah node yang sedang dibuat.

0

failed_nodes

integer

Jumlah node gagal.

0

offline_nodes

integer

Jumlah node offline.

0

removing_nodes

integer

Jumlah node yang sedang dihapus.

0

serving_nodes

integer

Jumlah node yang melayani.

3

total_nodes

integer

Jumlah total node dalam kelompok node.

3

conditions

array<object>

Kondisi kelompok node, yang merepresentasikan informasi status kelompok node di berbagai dimensi.

object

Atribut kondisi tunggal.

type

string

Tipe.

ImageUpgradeReady

status

string

Status.

True

reason

string

Alasan.

UpgradeDisabled

message

string

Paket detail.

AutoUpgradeDisabled

last_transition_time

string

Waktu transisi status terakhir.

20**-**-30T10:39:00+08:00

auto_scaling

object

Konfigurasi penskalaan otomatis untuk kelompok node.

enable

boolean

Apakah akan mengaktifkan skalabilitas elastis. Nilai valid:

  • true: Mengaktifkan fitur skalabilitas elastis 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 elastisitas node instan secara default. Kluster versi sebelumnya dari 1.24 menggunakan skalabilitas elastis node secara default. Untuk informasi selengkapnya, lihat Penskalaan node.

  • false: Menonaktifkan skalabilitas elastis. 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 dalam 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.

10

min_instances

integer

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

1

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: Asosiasikan EIP.

  • false: Jangan asosiasikan EIP.

true

eip_bandwidth

integer

Bandwidth puncak EIP.

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

5

management

object

Konfigurasi kelompok node terkelola.

enable

boolean

Apakah akan mengaktifkan kelompok node terkelola. Nilai valid:

  • true: Aktifkan kelompok node terkelola.

  • false: Nonaktifkan 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. Nilai valid:

  • true: Aktifkan perbaikan otomatis.

  • false: Nonaktifkan 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. Nilai valid:

  • true: Izinkan restart node.

  • false: Jangan izinkan restart node.

true

approval_required

boolean

Apakah persetujuan manual diperlukan untuk perbaikan node.

false

auto_repair_policy_id

string

ID kebijakan perbaikan otomatis.

r-xxxxxxxxxx

max_parallel_repairing_nodes

string

Jumlah maksimum perbaikan paralel. Ketika terdapat sejumlah besar node abnormal dalam kelompok node, parameter ini menentukan jumlah atau persentase maksimum node yang dapat diperbaiki secara bersamaan.

1

max_unhealthy_nodes_threshold

string

Kondisi pemutus sirkuit penyembuhan mandiri. Ketika jumlah atau persentase node rusak melebihi ambang batas ini, penyembuhan mandiri memasuki status pemutus sirkuit dan berhenti memulai tindakan perbaikan baru.

10%

auto_vul_fix

boolean

Apakah akan memperbaiki CVE secara otomatis. Parameter ini hanya berlaku ketika enable=true.

  • true: Memperbolehkan perbaikan CVE otomatis.

  • false: Tidak memperbolehkan 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

Tingkat kerentanan yang diizinkan untuk perbaikan otomatis, dipisahkan dengan koma.

  • asap: tinggi

  • later: Menengah

  • nntf: rendah

asap,nntf

exclude_packages

string

Paket yang harus dikecualikan selama perbaikan kerentanan.

kernel

auto_upgrade

boolean

Apakah akan meningkatkan node secara otomatis. Parameter ini hanya berlaku ketika enable=true.

  • true: Peningkatan otomatis diaktifkan.

  • false: Peningkatan otomatis tidak diaktifkan.

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: Peningkatan otomatis diaktifkan.

  • false: Peningkatan otomatis tidak diaktifkan.

true

surge

integer

Jumlah node tambahan. Anda dapat mengatur parameter ini atau surge_percentage, tetapi tidak keduanya.

5

surge_percentage

integer

Persentase node tambahan. Anda dapat mengatur parameter ini atau surge, tetapi tidak keduanya.

Jumlah node tambahan = Persentase node tambahan × Jumlah node. Misalnya, jika persentase node tambahan diatur ke 50% dan terdapat 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

Apakah akan mengaktifkan deteksi fault ECS untuk penyembuhan mandiri node.

drift_enabled

boolean

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

scaling_group

object

Konfigurasi grup penskalaan dari kelompok node.

scaling_group_id

string

ID grup penskalaan.

asg-2zeieod8giqmov7z****

vswitch_ids

array

Daftar ID vSwitch.

string

ID vSwitch.

vsw-2ze3ds0mdip0hdz8i****

instance_types

array

Daftar tipe instans node.

string

Tipe instans node.

ecs.n4.large

instance_charge_type

string

Metode 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}.

0

period_unit

string

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

  • Month: diukur dalam bulan.

  • Week: diukur dalam minggu.

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: Perpanjangan otomatis diaktifkan.

  • false: Perpanjangan otomatis tidak diaktifkan.

false

auto_renew_period

integer

Durasi setiap siklus perpanjangan otomatis. Nilai valid:

  • PeriodUnit=Week: 1, 2, 3.

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

1

spot_strategy

string

Tipe spot instans. Nilai valid:

  • NoSpot: non-spot instans.

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

object

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

instance_type

string

Tipe spot instans.

ecs.c6.large

price_limit

string

Harga pasar satu 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.

aliyun_3_x64_20G_alibase_20241218.vhd

system_disk_category

string

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.

cloud_efficiency

system_disk_categories

array

Beberapa tipe disk untuk 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 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.

cloud_essd

system_disk_size

integer

Ukuran cloud disk sistem node, dalam 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 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

Menunjukkan apakah burst (lonjakan performa) diaktifkan untuk cloud disk sistem node. Nilai valid:

  • true: Diaktifkan. Saat diaktifkan, cloud disk sementara meningkatkan kinerja selama tekanan baca/tulis data mendadak dari beban kerja yang berfluktuasi hingga beban kerja kembali ke keadaan stabil.

  • false: Tidak diaktifkan.

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.

Nilai yang mungkin: 0~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

Kombinasi Tipe disk, ukuran, dan konfigurasi lain dari cloud disk data untuk node.

data_disk

Konfigurasi cloud disk data node.

security_group_ids

array

Daftar ID grup keamanan untuk kelompok node.

string

ID grup keamanan kelompok node.

sg-2ze60ockeekspl3d****

key_pair

string

Nama pasangan kunci, saling eksklusif dengan login_password. Ketika kelompok node adalah kelompok node terkelola, hanya key_pair yang didukung.

pro-nodepool

login_password

string

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.

Untuk tujuan keamanan, kata sandi dienkripsi dalam hasil kueri.

********

login_as_non_root

boolean

Menunjukkan apakah Instans ECS yang disediakan menggunakan pengguna non-root untuk logon.

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

  • false: Logon sebagai pengguna root.

true

cis_enabled deprecated

boolean

[Deprecated] Gunakan parameter security_hardening_os sebagai gantinya.

false

soc_enabled

boolean

Menunjukkan apakah penguatan keamanan MLPS 2.0 diaktifkan. Ini hanya dapat diaktifkan ketika image sistem adalah Alibaba Cloud Linux 2 atau Alibaba Cloud Linux 3. Alibaba Cloud menyediakan standar pemeriksaan garis dasar kepatuhan perlindungan berlapis dan program pemindaian untuk image Alibaba Cloud Linux 2 dan Alibaba Cloud Linux 3 MLPS 2.0 Level 3.

false

security_hardening_os

boolean

Penguatan keamanan OS Alibaba Cloud. Nilai valid:

  • true: Mengaktifkan penguatan keamanan OS Alibaba Cloud.

  • false: Tidak mengaktifkan penguatan keamanan OS Alibaba Cloud.

Nilai default: false.

false

internet_charge_type

string

Tipe penagihan jaringan untuk alamat IP publik node.

  • PayByBandwidth: Ditagih berdasarkan bandwidth tetap.

  • PayByTraffic: Ditagih berdasarkan penggunaan trafik.

PayByBandwidth

internet_max_bandwidth_out

integer

Bandwidth keluar maksimum untuk alamat IP publik node, dalam Mbps (Mega bit per second). Nilai valid: 1 hingga 100.

10

tags

array

Tag Instans ECS.

tag

Tag node.

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: Melakukan penskalaan berdasarkan vSwitch (VSwitchIds.N) yang Anda tentukan. Ketika Instans ECS tidak dapat dibuat di zona vSwitch dengan prioritas lebih tinggi, vSwitch dengan prioritas berikutnya akan otomatis digunakan.

  • COST_OPTIMIZED: Mencoba membuat instans berdasarkan urutan harga satuan vCPU dari terendah ke tertinggi. Ketika konfigurasi penskalaan menetapkan beberapa tipe instans dengan penagihan spot, spot instans dibuat terlebih dahulu. Anda dapat menggunakan parameter CompensateWithOnDemand untuk menentukan apakah akan otomatis mencoba membuat instans pay-as-you-go ketika spot instans tidak dapat dibuat karena persediaan tidak mencukupi.

    Catatan

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

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

Nilai default: PRIORITY.

Pengaturan: Metode penagihan mencakup pay-as-you-go dan spot instans.

BALANCE

scaling_policy

string

Mode grup penskalaan. Nilai valid:

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

  • recycle: Mode cepat. Melakukan penskalaan dengan membuat, menghentikan, dan memulai instans, yang meningkatkan kecepatan penskalaan berikutnya (resource komputasi tidak dikenai biaya selama penghentian, hanya biaya penyimpanan yang berlaku, kecuali untuk tipe instans disk lokal).

rilis

on_demand_base_capacity

integer

Jumlah minimum instans pay-as-you-go yang diperlukan oleh grup penskalaan. Nilai valid: [0,1000]. Instans pay-as-you-go dibuat terlebih dahulu ketika jumlah di bawah nilai ini.

0

on_demand_percentage_above_base_capacity

integer

Persentase instans pay-as-you-go di antara instans yang melebihi kapasitas dasar on-demand minimum (on_demand_base_capacity). Nilai valid: [0,100].

20

spot_instance_pools

integer

Jumlah tipe instans yang tersedia. Grup penskalaan membuat spot instans secara merata di seluruh tipe dengan biaya terendah. Nilai valid: [1,10].

5

spot_instance_remedy

boolean

Menunjukkan apakah penggantian spot instans diaktifkan. Saat diaktifkan, grup penskalaan mencoba membuat instans baru untuk menggantikan spot instans yang akan segera diklaim kembali. Nilai valid:

  • true: Mengaktifkan penggantian spot instans.

  • false: Tidak mengaktifkan penggantian spot instans.

false

compensate_with_on_demand

boolean

Ketika multi_az_policy diatur ke COST_OPTIMIZED, menentukan apakah akan mengizinkan pembuatan otomatis instans pay-as-you-go untuk memenuhi persyaratan jumlah Instans ECS ketika spot instans tidak dapat dibuat karena alasan harga atau persediaan. Nilai valid:

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

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

true

enable_high_density_mode

boolean

Menunjukkan apakah mode cloud disk kepadatan tinggi diaktifkan. Ini hanya didukung ketika kelompok node menggunakan tipe instans. Saat diaktifkan, jumlah total cloud disk sistem dan data tidak melebihi batas cloud disk kepadatan tinggi yang didukung oleh tipe instans.

false

deploymentset_id

string

ID set penyebaran.

ds-bp1d19mmbsv3jf6xxxxx

rds_instances

array

Jika daftar instans RDS ditentukan, node ECS dalam kluster otomatis ditambahkan ke daftar putih akses RDS.

string

Instans RDS.

rm-xxx

private_pool_options

object

Konfigurasi kelompok node pribadi.

id

string

ID kelompok node pribadi.

eap-bp67acfmxazb4****

match_criteria

string

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

  • Open: Mode terbuka. Secara otomatis mencocokkan kapasitas kolam pribadi tipe terbuka. Jika tidak ada kapasitas kolam pribadi yang cocok, Sumber daya kolam publik digunakan.

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

  • None: Mode tidak digunakan. Peluncuran instans tidak menggunakan kapasitas kolam pribadi.

Open

security_group_id

string

ID grup keamanan kelompok node. Ketika kelompok node dikaitkan dengan beberapa grup keamanan, ini adalah nilai pertama dalam security_group_ids.

sg-2ze60ockeekspl3d****

platform

string

Distribusi sistem operasi. Nilai valid:

  • CentOS

  • AliyunLinux

  • Windows

  • WindowsCore

AliyunLinux

ram_policy

string

[Deprecated] Gunakan ram_role_name sebagai gantinya.

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

instance_patterns

array

Konfigurasi atribut instans.

instance_patterns

Atribut instans.

ram_role_name

string

Nama peran RAM Worker.

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

instance_metadata_options InstanceMetadataOptions

Konfigurasi akses metadata untuk Instans ECS.

resource_pool_options

object

Kolam sumber daya dan kebijakan kolam sumber daya yang digunakan saat membuat instans.

private_pool_ids

array

Daftar ID kolam pribadi.

string

ID private pool.

eap-bp1c1fohub5jccwi****

strategy

string

Strategi kolam sumber daya yang digunakan saat membuat instans. Nilai valid:

  • PrivatePoolFirst: prioritas private pool.

  • PrivatePoolOnly: hanya private pool.

  • None: tidak menggunakan strategi kolam sumber daya.

PrivatePoolFirst

system_disk_snapshot_policy_id

string

Kebijakan snapshot untuk cloud disk sistem.

sp-bp11g8z59rawcud9****

disk_init

array

Konfigurasi inisialisasi perangkat blok.

DiskInit

Konfigurasi DiskInit.

cpu_options

object

Opsi konfigurasi terkait CPU.

nested_virtualization

string

Apakah virtualisasi bertingkat diaktifkan. Nilai valid:

  • disabled: Virtualisasi bertingkat dinonaktifkan.

  • enabled: Virtualisasi bertingkat diaktifkan.

enabled

node_config

object

Konfigurasi node.

kubelet_configuration kubelet_config

Pengaturan parameter Kubelet.

node_os_config

object

Konfigurasi sistem operasi node.

hugepage

Hugepage

Konfigurasi hugepage.

kubernetes_config

object

Konfigurasi terkait kluster.

labels

array

Tag node.

tag

Tag ECS.

taints

array

Informasi taint node. Taint dan toleransi bekerja sama untuk mencegah Pod dijadwalkan ke node yang tidak sesuai. Untuk informasi lebih lanjut, lihat taint-and-toleration.

taint

Konfigurasi taint node.

runtime

string

Nama runtime kontainer. ACK mendukung tiga runtime kontainer berikut:

  • containerd: Direkomendasikan. Mendukung semua versi kluster.

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

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

containerd

runtime_version

string

Versi runtime kontainer.

1.6.38

cpu_policy

string

Kebijakan manajemen CPU node. Dua kebijakan berikut didukung untuk kluster yang berjalan versi 1.12.6 atau 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.

none

user_data

string

Data kustom kelompok node, yaitu skrip yang berjalan setelah inisialisasi node. Untuk informasi lebih lanjut, lihat Generate instance user data.

IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi

unschedulable

boolean

Apakah node yang diskalakan keluar tidak dapat dijadwalkan.

  • true: Tidak dapat dijadwalkan.

  • false: Dapat dijadwalkan.

true

cms_enabled

boolean

Apakah akan menginstal agen CloudMonitor pada node ECS. Setelah instalasi, Anda dapat melihat tampilan informasi pemantauan 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.

true

node_name_mode

string

Nama node kustom.

Nama node terdiri dari tiga bagian: awalan + substring alamat IP node + akhiran:

  • Awalan dan akhiran masing-masing dapat terdiri dari satu atau beberapa bagian yang dipisahkan oleh ".". Setiap bagian dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama node harus dimulai dan diakhiri dengan huruf kecil atau angka.

  • Panjang segmen alamat IP menentukan jumlah digit yang diambil dari akhir alamat IP node. Nilai valid: 5 hingga 12.

Sebagai contoh, jika alamat IP node adalah 192.168.0.55, awalan adalah aliyun.com, panjang segmen alamat IP adalah 5, dan akhiran adalah test, maka nama node adalah aliyun.com00055test.

aliyun.com192.XX.YY.55test

pre_user_data

string

Data pra-kustom kelompok node, yaitu skrip yang berjalan sebelum inisialisasi node. Untuk informasi lebih lanjut, lihat Generate instance user data.

dGhpcyBpcyBhIGV4YW1wbGU

tee_config

object

Konfigurasi kluster komputasi rahasia.

tee_enable

boolean

Apakah akan mengaktifkan komputasi rahasia untuk kluster. Nilai valid:

  • true: Diaktifkan.

  • false: Tidak diaktifkan.

false

interconnect_config

object

[Deprecated]

Konfigurasi terkait jaringan kelompok node pool edge. Nilai ini hanya bermakna kelompok node pool tipe edge.

cen_id

string

[Deprecated]

ID Instans Cloud Enterprise Network (CEN) yang terikat pada kelompok node edge yang ditingkatkan.

cen-ey9k9nfhz0f*******

ccn_id

string

[Deprecated]

ID Instans Cloud Connect Network (CCN) yang terikat pada kelompok node edge yang ditingkatkan.

ccn-qm5i0i0q9yi*******

ccn_region_id

string

[Deprecated]

Wilayah Instans Cloud Connect Network (CCN) yang terikat pada kelompok node edge yang ditingkatkan.

cn-shanghai

bandwidth

integer

[Deprecated]

Bandwidth jaringan kelompok node edge yang ditingkatkan. Unit: Mbit/s.

10

improved_period

string

[Deprecated]

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

1

max_nodes

integer

[Deprecated]

Jumlah maksimum node yang diizinkan dalam kelompok node edge.

10

interconnect_mode

string

Jenis jaringan node pool edge. Parameter ini hanya berlaku untuk node pool dengan type diatur ke edge. Nilai valid:

  • basic: Jaringan publik. Node kelompok node pool cloud berinteraksi dengan node cloud melalui Internet. Aplikasi kelompok node pool cloud tidak dapat mengakses langsung jaringan internal VPC cloud.

  • private: Jaringan pribadi. Node kelompok node pool 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

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

Apakah node kelompok node pool edge memiliki konektivitas jaringan Lapisan 3.

  • true: Terhubung. Semua node kelompok node pool memiliki konektivitas jaringan Lapisan 3.

  • false: Tidak terhubung. Semua node kelompok node pool tidak memiliki konektivitas jaringan Lapisan 3.

true

auto_mode

object

Konfigurasi pengelolaan cerdas.

enable

boolean

Apakah mode pengelolaan cerdas diaktifkan.

false

node_components

array<object>

Daftar komponen node.

array<object>

Komponen node.

name

string

Nama komponen node.

kubelet

version

string

Versi komponen node.

1.33.3-aliyun.1

config

object

Konfigurasi komponen node.

custom_config

object

Konfigurasi kustom komponen node.

{"cpuManagerPolicy":"static"}

any

String konfigurasi kustom komponen node.

cpuManagerPolicy

envs

array<object>

Variabel lingkungan komponen node.

object

name

string

Nama variabel lingkungan.

LOG_LEVEL

value

string

Nilai variabel lingkungan.

info

config_revision

string

Nomor versi konfigurasi kustom untuk komponen node.

1

eflo_node_group

object

Informasi kelompok node Lingjun.

cluster_id

string

ID kluster Lingjun.

i113790071760688002461

group_id

string

ID kelompok Lingjun.

i128147721760688002463

auto_attach_enabled

boolean

Apakah penambahan node otomatis diaktifkan untuk kelompok node Lingjun.

worker_ram_role_name

string

Peran RAM Worker yang digunakan oleh kelompok node Lingjun.

Contoh

Respons sukses

JSONformat

{
  "nodepool_info": {
    "nodepool_id": "np615c0e0966124216a0412e10afe0****",
    "name": "default-nodepool",
    "type": "ess",
    "is_default": true,
    "resource_group_id": "rg-acfmyvw3wjmb****",
    "region_id": "cn-beijing",
    "created": "2025-04-10T14:25:37.285530433+08:00",
    "updated": "2025-04-15T15:39:45.41+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,
    "conditions": [
      {
        "type": "ImageUpgradeReady",
        "status": "True",
        "reason": "UpgradeDisabled",
        "message": "AutoUpgradeDisabled",
        "last_transition_time": "20**-**-30T10:39:00+08:00"
      }
    ]
  },
  "auto_scaling": {
    "enable": true,
    "type": "cpu",
    "max_instances": 10,
    "min_instances": 1,
    "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-xxxxxxxxxx",
      "max_parallel_repairing_nodes": "1",
      "max_unhealthy_nodes_threshold": "10%"
    },
    "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,
    "drift_enabled": false
  },
  "scaling_group": {
    "scaling_group_id": "asg-2zeieod8giqmov7z****",
    "vswitch_ids": [
      "vsw-2ze3ds0mdip0hdz8i****"
    ],
    "instance_types": [
      "ecs.n4.large"
    ],
    "instance_charge_type": "PostPaid",
    "period": 0,
    "period_unit": "Month",
    "auto_renew": false,
    "auto_renew_period": 1,
    "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": [
      "cloud_essd"
    ],
    "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****"
      }
    ],
    "security_group_ids": [
      "sg-2ze60ockeekspl3d****"
    ],
    "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": "BALANCE",
    "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,
    "enable_high_density_mode": false,
    "deploymentset_id": "ds-bp1d19mmbsv3jf6xxxxx",
    "rds_instances": [
      "rm-xxx"
    ],
    "private_pool_options": {
      "id": "eap-bp67acfmxazb4****",
      "match_criteria": "Open"
    },
    "security_group_id": "sg-2ze60ockeekspl3d****",
    "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****",
    "instance_metadata_options": {
      "http_tokens": "optional"
    },
    "resource_pool_options": {
      "private_pool_ids": [
        "eap-bp1c1fohub5jccwi****"
      ],
      "strategy": "PrivatePoolFirst"
    },
    "system_disk_snapshot_policy_id": "sp-bp11g8z59rawcud9****",
    "disk_init": [
      {
        "disk_name": "disk0",
        "mkfs_type": "ext4",
        "mount_target": "/mnt/disk0",
        "mount_for_runtime": false,
        "local_disk": false
      }
    ],
    "cpu_options": {
      "nested_virtualization": "enabled"
    }
  },
  "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": "IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi",
    "unschedulable": true,
    "cms_enabled": true,
    "node_name_mode": "aliyun.com192.XX.YY.55test",
    "pre_user_data": "dGhpcyBpcyBhIGV4YW1wbGU\n"
  },
  "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",
  "host_network": true,
  "intranet": true,
  "auto_mode": {
    "enable": false
  },
  "node_components": [
    {
      "name": "kubelet",
      "version": "1.33.3-aliyun.1",
      "config": {
        "custom_config": {
          "key": "cpuManagerPolicy"
        },
        "envs": [
          {
            "name": "LOG_LEVEL",
            "value": "info"
          }
        ]
      },
      "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.