All Products
Search

This Product

    Container Service for Kubernetes:ModifyCluster

    Document Center

    Container Service for Kubernetes:ModifyCluster

    Last Updated:Jun 12, 2026

    Memanggil operasi ModifyCluster untuk 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 detail perubahan, lihat Pengumuman Perubahan dan Penghapusan Parameter 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
    api_server_eip

    boolean

    No

    Apakah akan mengikat EIP ke kluster untuk akses publik ke API Server. Nilai valid:

    • true: Mengikat EIP ke kluster.

    • false: Tidak mengikat EIP ke kluster.

    true
    api_server_eip_id

    string

    No

    ID instans EIP yang diikat ke API Server kluster. Parameter ini hanya berlaku jika api_server_eip diatur ke true.

    eip-wz9fnasl6dsfhmvci****
    deletion_protection

    boolean

    No

    Perlindungan penghapusan kluster, yang mencegah penghapusan kluster secara tidak sengaja melalui konsol atau API. Nilai valid:

    • true: Mengaktifkan perlindungan penghapusan kluster. Kluster tidak dapat dihapus melalui konsol atau API.

    • false: Menonaktifkan perlindungan penghapusan kluster. Kluster dapat dihapus melalui konsol atau API.

    Nilai default: false.

    false
    resource_group_id

    string

    No

    ID kelompok sumber daya kluster.

    rg-acfmyvw3wjm****
    maintenance_window maintenance_window

    No

    Konfigurasi jendela pemeliharaan kluster. Fitur ini hanya berlaku pada kluster terkelola ACK Pro.

    enable_rrsa

    boolean

    No

    Mengaktifkan atau menonaktifkan fitur RRSA (hanya kluster terkelola yang mendukung parameter ini). Nilai valid:

    • true: Mengaktifkan.

    • false: Menonaktifkan.

    true
    cluster_name

    string

    No

    Nama kluster kustom. Nama dapat berisi angka, karakter Tionghoa, karakter Inggris, atau tanda hubung (-), harus memiliki panjang 1 hingga 63 karakter, dan tidak boleh diawali dengan tanda hubung (-).

    cluster-new-name
    cluster_spec

    string

    No

    Saat Anda mengatur cluster_type ke ManagedKubernetes dan mengonfigurasi profile, spesifikasi kluster. Nilai valid:

    • ack.pro.small: Edisi Pro

    • ack.pro.xlarge: Pro XL

    • ack.pro.2xlarge: Pro 2XL

    • ack.pro.4xlarge: Pro 4XL (memerlukan kontak layanan pelanggan untuk akses daftar izinkan)

    Pro XL, Pro 2XL, dan Pro 4XL adalah tiga tingkatan yang disediakan oleh ACK Pro Provisioned Control Plane. Dengan mengalokasikan dan menetapkan Sumber daya lapisan kontrol sebelumnya, tingkatan ini memastikan bahwa konkurensi API dan kemampuan penjadwalan Pod selalu berada pada tingkat tinggi yang tetap, cocok untuk pelatihan dan inferensi AI, kluster skala sangat besar, dan beban kerja kritis.

    Untuk harga kluster Edisi Pro dan Provisioned Control Plane, lihat Biaya Manajemen Kluster.

    ack.pro.small
    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****
    operation_policy

    object

    No

    Kebijakan O&M otomatis kluster.

    cluster_auto_upgrade

    object

    No

    Peningkatan otomatis kluster.

    enabled

    boolean

    No

    Whether to enable auto-upgrade for the cluster.

    • true: Enables auto-upgrade.

    • false: Disables auto-upgrade.

    true
    channel

    string

    No

    The auto-upgrade channel for the cluster. For more information, see Upgrade channels.

    Valid values:

    • patch: upgrades the cluster to the latest patch version.

    • stable: upgrades the cluster to the second to last minor version.

    • rapid: upgrades the cluster to the latest minor version.

    patch
    api_server_custom_cert_sans

    object

    No

    SAN (Subject Alternative Name) sertifikat API Server kustom. Digunakan untuk menambahkan IP atau domain kustom ke bidang SAN sertifikat server API Server kluster untuk kontrol akses klien.

    Hanya kluster terkelola yang mendukung parameter ini.

    action

    string

    No

    Menimpa atau menambahkan konfigurasi SAN. Nilai valid:

    • overwrite: Menimpa.

    • append: Menambahkan.

    append
    subject_alternative_names

    array

    No

    Daftar SAN.

    string

    No

    SAN. Mendukung alamat IP atau domain kustom, dengan beberapa alamat IP atau domain dipisahkan oleh koma (,).

    aliyun.xxx.com,192.168.xx.xx
    vswitch_ids

    array

    No

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

    • Parameter ini melakukan pembaruan timpa. Anda harus menentukan daftar vSwitch target secara lengkap.

    • Selama perubahan, komponen lapisan kontrol akan dimulai ulang secara singkat. Lakukan dengan hati-hati.

    • Pastikan aturan arah masuk dan arah keluar dari semua grup keamanan kluster (termasuk grup keamanan lapisan kontrol, grup keamanan semua kelompok node, dan grup keamanan yang digunakan oleh jaringan kontainer) mengizinkan blok CIDR IP dari vSwitch baru untuk 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, jaringan kontainer, dan komponen lainnya.

    string

    No

    vSwitch untuk lapisan kontrol kluster.

    vsw-2ze4jvvvade1yk899****
    control_plane_config

    object

    No

    Konfigurasi lapisan kontrol kluster khusus.

    charge_type

    string

    No

    Tipe penagihan instans node lapisan kontrol. Nilai valid:

    • PrePaid: Langganan.

    • PostPaid: Bayar sesuai pemakaian.

    Nilai default: PostPaid.

    PostPaid
    period

    integer

    No

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

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

    1
    period_unit

    string

    No

    Siklus penagihan instans node lapisan kontrol. Parameter ini hanya berlaku jika charge_type diatur ke PrePaid.

    Month: Penagihan bulanan. Saat ini, hanya penagihan bulanan yang didukung.

    Month
    auto_renew

    boolean

    No

    Apakah perpanjangan otomatis diaktifkan 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

    Durasi setiap perpanjangan otomatis untuk instans node lapisan kontrol.

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

    Nilai default: 1.

    1
    instance_types

    array

    No

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

    string

    No

    Tipe instans.

    ecs.g6.large
    image_type

    string

    No

    Tipe image OS. Nilai valid:

    • AliyunLinux3: Image Alinux3.

    • Custom: Image kustom.

    AliyunLinux3
    image_id

    string

    No

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

    aliyun_3_x64_20G_alibase_20240819.vhd
    key_pair

    string

    No

    Nama key pair. Anda harus menentukan parameter ini atau login_password.

    ack
    login_password

    string

    No

    Kata sandi masuk SSH. Anda harus menentukan parameter ini atau key_pair. Kata sandi harus memiliki panjang 8 hingga 30 karakter dan mengandung setidaknya tiga dari tipe karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Jika Anda ingin menggunakan masuk berbasis kata sandi, Anda harus menentukan parameter ini saat skala keluar.

    Ack@2000.
    system_disk_category

    string

    No

    Tipe disk sistem node. Nilai valid:

    • cloud_efficiency: Disk ultra.

    • cloud_ssd: SSD Jenis Penyimpanan Standar.

    • cloud_essd: ESSD.

    • cloud_auto: ESSD AutoPL.

    • cloud_essd_entry: ESSD Entry.

    cloud_essd
    system_disk_size

    integer

    No

    Ukuran disk sistem node. Nilai valid: [40, 500]. Unit: GiB.

    120
    system_disk_snapshot_policy_id

    string

    No

    ID kebijakan snapshot otomatis yang digunakan untuk disk sistem node.

    sp-2zej1nogjvovnz4z****
    system_disk_performance_level

    string

    No

    Tingkat kinerja disk sistem node. Parameter ini hanya berlaku untuk disk ESSD. Tingkat kinerja terkait dengan ukuran disk. Untuk informasi lebih lanjut, lihat ESSD.

    PL1
    system_disk_provisioned_iops

    integer

    No

    IOPS baca/tulis terprovisi dari 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 ESSD AutoPL.

    1000
    system_disk_bursting_enabled

    boolean

    No

    Apakah akan mengaktifkan burst (ledakan kinerja) untuk disk sistem node. Nilai valid:

    • true: Mengaktifkan.

    • false: Menonaktifkan.

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

    true
    deploymentset_id

    string

    No

    ID set penyebaran.

    ds-bp10b35imuam5amw****
    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
    soc_enabled

    boolean

    No

    Penguatan keamanan perlindungan berklasifikasi. Untuk informasi lebih lanjut, lihat Panduan Pengguna Perlindungan Keamanan Berklasifikasi ACK.

    Nilai valid:

    • true: Mengaktifkan penguatan keamanan perlindungan berklasifikasi.

    • false: Menonaktifkan penguatan keamanan perlindungan berklasifikasi.

    Nilai default: false.

    false
    security_hardening_os

    boolean

    No

    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
    cpu_policy

    string

    No

    Kebijakan manajemen CPU node. Dua kebijakan berikut didukung saat versi kluster adalah 1.12.6 atau lebih baru:

    • static: Mengizinkan afinitas CPU dan eksklusivitas yang ditingkatkan untuk Pod dengan karakteristik Sumber daya tertentu pada node.

    • none: Menggunakan skema afinitas CPU default.

    Nilai default: none.

    none
    runtime

    string

    No

    Nama waktu proses kontainer. Nilai valid:

    • containerd: Direkomendasikan. Didukung oleh semua versi kluster.

    Nilai default: containerd.

    containerd
    node_port_range

    string

    No

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

    Nilai default: 30000-32767.

    30000-32767
    size

    integer

    No

    Jumlah node lapisan kontrol. Untuk melakukan skala keluar pada lapisan kontrol kluster khusus, atur parameter ini ke jumlah target node lapisan kontrol, yang harus lebih besar dari jumlah saat ini.

    5
    security_group_id

    string

    No

    ID grup keamanan lapisan kontrol.

    • Jika Anda telah mengonfigurasi aturan pemblokiran di grup keamanan, pastikan aturan grup keamanan mengizinkan protokol dan port yang menjadi dependensi kluster. Untuk range aturan grup keamanan yang direkomendasikan, lihat Mengonfigurasi dan Mengelola Grup Keamanan Kluster.

    • Untuk kluster khusus non-ACK, selama perubahan, lapisan kontrol kluster dan komponen terkelola yang terinstal (seperti terway-controlplane) akan dimulai ulang secara singkat. Kami menyarankan Anda melakukan operasi ini di luar jam sibuk. Setelah grup keamanan lapisan kontrol diubah, ENI yang digunakan oleh lapisan kontrol kluster dan komponen terkelola yang terinstal akan secara otomatis ditambahkan ke grup keamanan baru.

    • Untuk kluster khusus ACK, setelah grup keamanan lapisan kontrol diubah, node Master yang baru diskalakan keluar akan secara otomatis menerapkan grup keamanan lapisan kontrol baru. Node lapisan kontrol yang ada tidak terpengaruh.

    sg-bp1h6rk3pgct2a08***
    timezone

    string

    No

    Zona waktu kluster. Lihat Zona Waktu yang Didukung.

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

    • Untuk kluster terkelola, selama perubahan, lapisan kontrol kluster dan komponen terkelola yang terinstal (seperti terway-controlplane) akan dimulai ulang secara singkat. Kami menyarankan Anda melakukan operasi ini di luar jam sibuk. Setelah zona waktu diubah, node yang baru diskalakan keluar akan secara otomatis menerapkan 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 kluster khusus, setelah zona waktu diubah, node yang baru diskalakan keluar (termasuk node lapisan kontrol) akan secara otomatis menerapkan 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 terlebih dahulu lalu skala masuk untuk menerapkan pengaturan baru ke semua node lapisan kontrol.

    Asia/Shanghai
    control_plane_endpoints_config

    object

    No

    Konfigurasi koneksi kluster.

    internal_dns_config

    object

    No

    Konfigurasi DNS internal kluster. Berlaku untuk kluster terkelola ACK. Domain internal kluster digunakan oleh kubelet, kube-proxy, dan komponen sistem sisi node lainnya untuk mengakses API Server. Saat akses domain internal kluster tidak diaktifkan, komponen sistem sisi node mengakses API Server melalui IP CLB.

    bind_vpcs

    array

    No

    The VPCs in which the DNS records of the cluster's internal domain name take effect.

    string

    No

    A VPC in which the DNS records of the cluster's internal domain name take effect.

    vpc-xxxx
    enabled

    boolean

    No

    Specifies whether to enable internal domain name access. Valid value:

    • true: Enables internal domain name access. Node-side components such as kubelet and kube-proxy access the API server by using the cluster's internal domain name.

    true
    access_control_list deprecated

    array

    No

    Daftar kontrol akses untuk SLB API Server kluster terdaftar.

    string

    No

    Daftar kontrol akses untuk SLB API Server kluster terdaftar.

    Catatan: Blok CIDR 0.0.0.0/0 tidak diizinkan.

    192.168.XX.XX/24
    instance_deletion_protection deprecated

    boolean

    No

    Perlindungan penghapusan instans, yang mencegah penghapusan dan rilis node secara tidak sengaja melalui konsol atau API. Nilai valid:

    • true: Node tidak dapat dihapus secara tidak sengaja melalui konsol atau API.

    • false: Node dapat dihapus melalui konsol atau API.

    Nilai default: false.

    false
    ingress_domain_rebinding deprecated

    boolean

    No

    Mengikat ulang domain uji kluster. Nilai valid:

    • true: Mengikat ulang domain uji kluster.

    • false: Tidak mengikat ulang domain uji kluster.

    Nilai default: false.

    false
    ingress_loadbalancer_id deprecated

    string

    No

    ID Instans SLB kluster yang akan dimodifikasi.

    lb-wz97kes8tnndkpodw****

    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.