All Products
Search

This Product

    Container Service for Kubernetes:ModifyCluster

    Document Center

    Container Service for Kubernetes:ModifyCluster

    Last Updated:Sep 10, 2026

    Mengubah konfigurasi kluster ACK.

    Deskripsi operasi

    Penting Mulai 4 Juli 2026, parameter permintaan instance_deletion_protection, ingress_loadbalancer_id, dan access_control_list tidak akan berlaku lagi. Untuk informasi lebih lanjut mengenai perubahan ini, lihat Pengumuman perubahan parameter permintaan dan tanggapan OpenAPI serta penghentian OpenAPI untuk manajemen Kluster ACK.

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

    update

    *Cluster

    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
    • cs:EnableApiServerEip
    • cs:ApiServerEipId
    		 None

    Sintaks permintaan

    PUT /api/v2/clusters/{ClusterId} HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    ClusterId

    string

    Yes

    ID kluster.

    cb95aa626a47740afbf6aa099b65****

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    body

    object

    No

    Parameter badan permintaan.

    true
    access_control_list deprecated

    array

    No

    Daftar kontrol akses (ACL) untuk SLB server API kluster terdaftar.

    string

    No

    Daftar kontrol akses (ACL) untuk SLB server API kluster terdaftar.

    Catatan: Blok CIDR 0.0.0.0/0 tidak diizinkan.

    192.168.XX.XX/24
    api_server_custom_cert_sans

    object

    No

    Subject Alternative Names (SAN) sertifikat server API kustom. Parameter ini menambahkan alamat IP atau nama domain kustom ke bidang SAN sertifikat server API Kluster untuk kontrol akses klien.

    Hanya Kluster terkelola yang mendukung parameter ini.

    action

    string

    No

    Apakah akan menimpa atau menambahkan konfigurasi SAN. Nilai valid:

    • overwrite: Menimpa konfigurasi SAN yang ada.

    • append: Menambahkan ke konfigurasi SAN yang ada.

    append
    subject_alternative_names

    array

    No

    Daftar SAN.

    string

    No

    SAN. Alamat IP atau nama domain kustom didukung. Pisahkan beberapa alamat IP atau nama domain dengan koma (,).

    aliyun.xxx.com,192.168.xx.xx
    api_server_eip

    boolean

    No

    Apakah akan menyambungkan EIP ke Kluster untuk akses jaringan publik ke server API. Nilai valid:

    • true: Kluster menyambungkan EIP.

    • false: Kluster tidak menyambungkan EIP.

    true
    api_server_eip_id

    string

    No

    ID Instans EIP yang menyambungkan ke server API Kluster. Parameter ini hanya berlaku jika api_server_eip diatur ke true.

    eip-wz9fnasl6dsfhmvci****
    client_token

    string

    No

    Token klien.

    af31042c-6355-495b-b6e3-exxb9669
    cluster_name

    string

    No

    Nama kluster kustom. Nama dapat berisi angka, karakter Tionghoa, huruf, dan tanda hubung (-). Panjang nama harus 1 hingga 63 karakter dan tidak boleh diawali dengan tanda hubung (-).

    cluster-new-name
    cluster_spec

    string

    No

    Spesifikasi Kluster ketika cluster_type diatur ke ManagedKubernetes dan profile dikonfigurasi. Nilai valid:

    • ack.pro.small: Pro

    • ack.pro.xlarge: Pro XL

    • ack.pro.2xlarge: Pro 2XL

    • ack.pro.4xlarge: Pro 4XL (hubungi layanan pelanggan untuk ditambahkan ke daftar putih)

    Pro XL, Pro 2XL, dan Pro 4XL adalah tiga tingkatan yang disediakan oleh ACK Pro Provisioned Control Plane. Dengan mengalokasikan dan mendedikasikan Sumber daya lapisan kontrol sebelumnya, tingkatan ini memastikan bahwa konkurensi API dan kemampuan penjadwalan pod tetap berada pada tingkat yang konsisten tinggi. Tingkatan ini cocok untuk pelatihan dan inferensi AI, Kluster skala ultra-besar, dan beban kerja misi-kritis.

    Untuk informasi mengenai biaya manajemen Kluster untuk edisi Pro dan lapisan kontrol terprovisi, lihat Biaya manajemen Kluster.

    ack.pro.small
    control_plane_config

    object

    No

    Konfigurasi lapisan kontrol untuk Kluster khusus.

    auto_renew

    boolean

    No

    Apakah akan mengaktifkan perpanjangan otomatis untuk instans node lapisan kontrol. Parameter ini hanya berlaku jika charge_type diatur ke PrePaid. Nilai valid:

    • true: Mengaktifkan perpanjangan otomatis.

    • false: Menonaktifkan perpanjangan otomatis.

    Nilai default: false.

    false
    auto_renew_period

    integer

    No

    Periode perpanjangan otomatis untuk setiap perpanjangan instans node lapisan kontrol.

    Nilai valid: {1, 2, 3, 6, 12}. Unit: bulan.

    Nilai default: 1.

    1
    charge_type

    string

    No

    Metode penagihan untuk instans node lapisan kontrol. Nilai valid:

    • PrePaid: langganan.

    • PostPaid: bayar sesuai pemakaian.

    Nilai default: PostPaid.

    PostPaid
    cloud_monitor_flags

    boolean

    No

    Apakah akan menginstal agen CloudMonitor pada node lapisan kontrol. Nilai valid:

    • true: Menginstal agen CloudMonitor.

    • false: Tidak menginstal agen CloudMonitor.

    true
    cpu_policy

    string

    No

    Kebijakan manajemen CPU untuk node. Kebijakan berikut didukung untuk Kluster yang berjalan versi 1.12.6 atau lebih baru:

    • static: Meningkatkan afinitas CPU dan eksklusivitas untuk pod dengan karakteristik Sumber daya tertentu pada node.

    • none: Menggunakan skema afinitas CPU default.

    Nilai default: none.

    none
    deploymentset_id

    string

    No

    ID set penyebaran.

    ds-bp10b35imuam5amw****
    image_id

    string

    No

    ID gambar kustom. Tentukan parameter ini saat Anda menggunakan gambar kustom.

    aliyun_3_x64_20G_alibase_20240819.vhd
    image_type

    string

    No

    Tipe image sistem operasi. Nilai valid:

    • AliyunLinux3: Image Alinux3.

    • Custom: gambar kustom.

    AliyunLinux3
    instance_types

    array

    No

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

    string

    No

    Tipe instans.

    ecs.g6.large
    key_pair

    string

    No

    Nama pasangan kunci. Tentukan parameter ini atau login_password.

    ack
    login_password

    string

    No

    Kata sandi logon SSH. Tentukan parameter ini atau key_pair. Kata sandi harus terdiri dari 8 hingga 30 karakter dan mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Untuk menggunakan logon berbasis kata sandi, tentukan parameter ini saat scale-out.

    Ack@2000
    node_port_range

    string

    No

    Range port layanan node. Range port valid: [30000, 65535].

    Nilai default: 30000-32767.

    30000-32767
    period

    integer

    No

    Durasi langganan untuk Instans node lapisan kontrol. Parameter ini berlaku dan wajib diisi hanya jika charge_type diatur ke PrePaid.

    Jika period_unit=Month, nilai valid adalah {1, 2, 3, 6, 12, 24, 36, 48, 60}.

    1
    period_unit

    string

    No

    Unit siklus penagihan untuk Instans node lapisan kontrol. Parameter ini hanya berlaku jika charge_type diatur ke PrePaid.

    Month: Siklus penagihan diukur dalam bulan. Saat ini, hanya bulan yang didukung.

    Month
    runtime

    string

    No

    Nama runtime kontainer. Nilai valid:

    • containerd: Direkomendasikan. Didukung oleh semua versi Kluster.

    Nilai default: containerd.

    containerd
    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
    size

    integer

    No

    Jumlah node lapisan kontrol. Untuk melakukan scale-out lapisan kontrol Kluster khusus, atur parameter ini ke jumlah target node lapisan kontrol, yang harus lebih besar dari jumlah saat ini.

    5
    soc_enabled

    boolean

    No

    Apakah akan mengaktifkan penguatan keamanan MLPS 2.0. Untuk informasi lebih lanjut, lihat Penguatan keamanan MLPS 2.0 ACK Tiongkok.

    Nilai valid:

    • true: Mengaktifkan penguatan keamanan MLPS 2.0.

    • false: Menonaktifkan penguatan keamanan MLPS 2.0.

    Nilai default: false.

    false
    system_disk_bursting_enabled

    boolean

    No

    Apakah akan mengaktifkan mode burst untuk cloud disk sistem node. Nilai valid:

    • true: Mengaktifkan mode burst.

    • false: Menonaktifkan mode burst.

    Parameter ini hanya didukung jika system_disk_category diatur ke cloud_auto. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.

    true
    system_disk_category

    string

    No

    Tipe cloud disk sistem node. Nilai valid:

    • cloud_efficiency: cloud disk ultra.

    • cloud_ssd: SSD standar.

    • cloud_essd: ESSD.

    • cloud_auto: cloud disk ESSD AutoPL.

    • cloud_essd_entry: cloud disk ESSD Entry.

    cloud_essd
    system_disk_performance_level

    string

    No

    Tingkat kinerja (PL) cloud disk sistem node. Parameter ini hanya berlaku untuk cloud disk ESSD. Tingkat kinerja bervariasi berdasarkan ukuran cloud disk. Untuk informasi lebih lanjut, lihat ESSD.

    PL1
    system_disk_provisioned_iops

    integer

    No

    IOPS baca/tulis terprovisi untuk cloud disk sistem node. Nilai valid: 0 hingga min{50,000, 1000 × kapasitas - garis dasar kinerja}. Garis dasar kinerja = min{1,800 + 50 × kapasitas, 50,000}.

    Parameter ini hanya didukung jika system_disk_category diatur ke cloud_auto. Untuk informasi lebih lanjut, lihat Cloud disk ESSD AutoPL.

    1000
    system_disk_size

    integer

    No

    Ukuran cloud disk sistem node. Nilai valid: 40 hingga 500. Unit: GiB.

    120
    system_disk_snapshot_policy_id

    string

    No

    ID kebijakan snapshot otomatis yang diterapkan pada cloud disk sistem node.

    sp-2zej1nogjvovnz4z****
    control_plane_endpoints_config

    object

    No

    Konfigurasi koneksi kluster.

    internal_dns_config

    object

    No

    Konfigurasi nama domain internal kluster. Parameter ini berlaku untuk kluster terkelola ACK. Nama domain internal digunakan oleh komponen sistem sisi node seperti kubelet dan kube-proxy untuk mengakses API server. Jika akses nama domain internal tidak diaktifkan, komponen sistem sisi node mengakses API server melalui alamat IP CLB.

    bind_vpcs

    array

    No

    VPC tempat catatan DNS nama domain internal berlaku.

    string

    No

    VPC tempat catatan DNS nama domain internal berlaku.

    vpc-xxxx
    enabled

    boolean

    No

    Apakah akan mengaktifkan akses nama domain internal untuk kluster. Nilai valid:

    • true: Mengaktifkan akses nama domain internal. Komponen sisi node (kubelet, kube-proxy) mengakses API server melalui nama domain internal.

    true
    load_balancers_config

    array<object>

    No

    Konfigurasi load balancing untuk akses kluster.

    object

    No

    Konfigurasi load balancing untuk akses kluster.

    endpoint_type

    string

    No

    Tipe titik akhir.

    public
    load_balancer_id

    string

    No

    Instance SLB yang terkait dengan titik akhir.

    nlb-xxxx
    deletion_protection

    boolean

    No

    Apakah akan mengaktifkan perlindungan penghapusan untuk kluster. Perlindungan penghapusan mencegah kluster terhapus secara tidak sengaja di konsol atau melalui pemanggilan operasi API. Nilai valid:

    • true: Mengaktifkan perlindungan penghapusan. Kluster tidak dapat dihapus di konsol atau melalui pemanggilan operasi API.

    • false: Menonaktifkan perlindungan penghapusan. Kluster dapat dihapus di konsol atau melalui pemanggilan operasi API.

    Nilai default: false.

    false
    enable_rrsa

    boolean

    No

    Apakah akan mengaktifkan atau menonaktifkan fitur RRSA. Hanya kluster terkelola yang mendukung parameter ini. Nilai valid:

    • true: Mengaktifkan.

    • false: Menonaktifkan.

    true
    ingress_domain_rebinding deprecated

    boolean

    No

    Apakah akan mengikat ulang nama domain uji kluster. Nilai valid:

    • true: Mengikat ulang nama domain uji kluster.

    • false: Tidak mengikat ulang nama domain uji kluster.

    Nilai default: false.

    false
    ingress_loadbalancer_id deprecated

    string

    No

    ID Instance SLB kluster yang akan dimodifikasi.

    lb-wz97kes8tnndkpodw****
    instance_deletion_protection deprecated

    boolean

    No

    Apakah akan mengaktifkan perlindungan penghapusan instans untuk mencegah node terhapus secara tidak sengaja di konsol atau melalui pemanggilan operasi API. Nilai valid:

    • true: Node tidak dapat terhapus secara tidak sengaja di konsol atau melalui pemanggilan operasi API.

    • false: Node dapat dihapus di konsol atau melalui pemanggilan operasi API.

    Nilai default: false.

    false
    maintenance_window maintenance_window

    No

    Konfigurasi jendela O&M kluster. Fitur ini hanya berlaku pada kluster terkelola ACK Pro.

    operation_policy

    object

    No

    Kebijakan O&M otomatis kluster.

    cluster_auto_upgrade

    object

    No

    Konfigurasi peningkatan kluster otomatis.

    channel

    string

    No

    Frekuensi peningkatan kluster otomatis. Untuk informasi selengkapnya, lihat Frekuensi peningkatan.

    Nilai valid:

    • patch: Versi patch terbaru.

    • stable: Versi minor kedua terbaru.

    • rapid: Versi minor terbaru.

    patch
    enabled

    boolean

    No

    Apakah akan mengaktifkan peningkatan kluster otomatis.

    • true: Mengaktifkan peningkatan otomatis.

    • false: Menonaktifkan peningkatan otomatis.

    true
    resource_group_id

    string

    No

    ID kelompok sumber daya kluster.

    rg-acfmyvw3wjm****
    security_group_id

    string

    No

    ID kelompok keamanan lapisan kontrol.

    • Jika Anda telah mengonfigurasi aturan pemblokiran di kelompok keamanan, pastikan aturan kelompok keamanan mengizinkan protokol dan Port yang diperlukan kluster. Untuk cakupan (dalam OAuth) aturan kelompok keamanan yang direkomendasikan, lihat Mengonfigurasi dan mengelola kelompok keamanan kluster.

    • Untuk klaster khusus non-ACK, lapisan kontrol kluster dan komponen terkelola yang terinstal (seperti terway-controlplane) akan dimulai ulang secara singkat selama prosedur perubahan. Lakukan operasi ini di luar jam sibuk. Setelah kelompok keamanan lapisan kontrol diubah, antarmuka jaringan elastis (ENI) yang digunakan oleh lapisan kontrol kluster dan komponen terkelola yang terinstal secara otomatis ditambahkan ke kelompok keamanan baru.

    • Untuk klaster khusus ACK, setelah kelompok keamanan lapisan kontrol diubah, node master yang baru diskalakan keluar secara otomatis menggunakan kelompok keamanan lapisan kontrol baru. Node lapisan kontrol yang ada tidak terpengaruh.

    sg-bp1h6rk3pgct2a08***
    system_events_logging

    object

    No

    Konfigurasi penyimpanan peristiwa sistem.

    enabled

    boolean

    No

    Apakah akan mengaktifkan penyimpanan peristiwa sistem.

    • true: Mengaktifkan penyimpanan peristiwa sistem.

    • false: Menonaktifkan penyimpanan peristiwa sistem.

    true
    logging_project

    string

    No

    Nama LogProject untuk penyimpanan peristiwa sistem.

    k8s-log-cb95aa626a47740afbf6aa099b65****
    timezone

    string

    No

    Zona waktu kluster. Lihat Zona waktu yang didukung.

    • Setelah zona waktu diubah, konfigurasi inspeksi kluster menggunakan pengaturan zona waktu baru.

    • Untuk kluster terkelola, lapisan kontrol kluster dan komponen terkelola yang terinstal (seperti terway-controlplane) akan dimulai ulang secara singkat selama perubahan. Lakukan operasi ini di luar jam sibuk. Setelah zona waktu diubah, node yang baru diskalakan keluar secara otomatis menggunakan pengaturan zona waktu baru. Node yang ada tidak terpengaruh. Anda dapat menggunakan fitur reset node kelompok node untuk menerapkan pengaturan baru ke node yang ada.

    • Untuk klaster khusus, setelah zona waktu diubah, node yang baru diskalakan keluar (termasuk node lapisan kontrol) secara otomatis menggunakan pengaturan zona waktu baru. Node yang ada (termasuk node lapisan kontrol) tidak terpengaruh. Anda dapat menggunakan fitur reset node kelompok node untuk menerapkan pengaturan baru ke node yang ada. Untuk node lapisan kontrol, Anda perlu melakukan skala keluar lalu skala masuk untuk menerapkan pengaturan baru ke semua node lapisan kontrol.

    Asia/Shanghai
    vswitch_ids

    array

    No

    vSwitch lapisan kontrol kluster. Untuk klaster khusus, perubahan berlaku untuk node lapisan kontrol yang baru diskalakan keluar. Untuk kluster terkelola, perhatikan hal berikut saat mengubah vSwitch lapisan kontrol:

    • Parameter ini melakukan pembaruan timpa penuh. Tentukan daftar vSwitch target yang lengkap.

    • Komponen lapisan kontrol dimulai ulang secara singkat selama perubahan. Lanjutkan dengan hati-hati.

    • Pastikan semua kelompok keamanan kluster (termasuk kelompok keamanan lapisan kontrol, kelompok keamanan semua kelompok node, dan kelompok keamanan yang digunakan oleh jaringan kontainer) mengizinkan lalu lintas masuk dan keluar untuk blok CIDR IP dari vSwitch baru. Hal ini mencegah node dan kontainer tidak dapat terhubung ke API server.

    • Jika aturan ACL dikonfigurasi untuk vSwitch lapisan kontrol baru, pastikan aturan ACL mengizinkan komunikasi dengan blok CIDR IP node kluster dan jaringan kontainer.

    string

    No

    vSwitch lapisan kontrol kluster.

    vsw-2ze4jvvvade1yk899****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Badan respons.

    cluster_id

    string

    ID kluster.

    cb95aa626a47740afbf6aa09****
    request_id

    string

    ID permintaan.

    687C5BAA-D103-4993-884B-C35E4314****
    task_id

    string

    ID tugas.

    T-5a54309c80282e39ea00****

    Contoh

    Respons sukses

    JSONformat

    {
  "cluster_id": "cb95aa626a47740afbf6aa09****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea00****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.