All Products
Search

This Product

    Container Service for Kubernetes:CreateAutoscalingConfig

    Document Center

    Container Service for Kubernetes:CreateAutoscalingConfig

    Last Updated:Jun 12, 2026

    Membuat Konfigurasi penskalaan otomatis yang memungkinkan sistem secara otomatis menambah atau mengurangi sumber daya komputasi berdasarkan aturan penskalaan yang dikonfigurasi untuk memenuhi tuntutan beban kerja kluster Anda. Selama prosedur pembuatan, Anda dapat menentukan metrik dan ambang batas penskalaan, urutan scale-out, periode cool-down, dan lainnya.

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

    create

    *Cluster

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

    		 None None

    Sintaks permintaan

    POST /cluster/{ClusterId}/autoscale/config/ HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    ClusterId

    string

    Yes

    ID kluster.

    cdde1f21ae22e483ebcb068a6eb7f****

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    body

    object

    No

    Parameter badan permintaan.

    cool_down_duration

    string

    No

    Penundaan scale-down. Interval waktu antara saat kebutuhan scale-down terdeteksi (ambang batas scale-down tercapai) dan saat operasi scale-down (mengurangi jumlah Pod) benar-benar dilakukan.

    Nilai valid: [1,60]. Unit: minutes.

    Nilai default: 10.

    10
    unneeded_duration

    string

    No

    Periode cool-down. Interval waktu setelah scale-out terbaru saat komponen penskalaan otomatis tidak melakukan operasi scale-down. Node yang ditambahkan selama scale-out hanya dapat dievaluasi untuk scale-down setelah periode cool-down berakhir.

    Nilai valid: [1,60]. Unit: minutes.

    Nilai default: 10.

    10
    utilization_threshold

    string

    No

    Ambang batas scale-down. Rasio sumber daya yang diminta terhadap total sumber daya pada sebuah node.

    Sebuah node hanya dapat di-scale down ketika rasio ini berada di bawah ambang batas yang dikonfigurasi, yang berarti pemanfaatan sumber daya CPU dan memori node berada di bawah ambang batas scale-down.

    Nilai valid: [0.1~1].

    Nilai default: 0.5, yang menunjukkan 50%.

    0.5
    gpu_utilization_threshold

    string

    No

    Ambang batas scale-down GPU. Rasio sumber daya yang diminta terhadap total sumber daya pada sebuah node.

    Sebuah node GPU hanya dapat di-scale down ketika rasio ini berada di bawah ambang batas yang dikonfigurasi, yang berarti pemanfaatan CPU, memori, dan GPU node semuanya berada di bawah ambang batas scale-down GPU.

    Nilai valid: [0.1~1].

    Nilai default: 0.3, yang menunjukkan 30%.

    0.3
    scan_interval

    string

    No

    Sensitivitas penskalaan, yang menyesuaikan interval saat sistem mengevaluasi keputusan penskalaan.

    Nilai valid: 15, 30, 60, 120, 180, dan 300. Unit: seconds.

    Nilai default: 60.

    30
    scale_down_enabled

    boolean

    No

    Apakah akan mengizinkan scale-down node. Nilai valid:

    • true: Scale-down diizinkan.

    • false: Scale-down tidak diizinkan.

    Valid values:

    • true :

      true.

    • false :

      false.

    true
    expander

    string

    No

    Kebijakan urutan scale-out kelompok node. Nilai valid:

    • least-waste: Kebijakan default. Jika beberapa kelompok node tersedia untuk scale-out, kelompok node dengan pemborosan sumber daya paling sedikit akan dipilih.

    • random: Kebijakan acak. Jika beberapa kelompok node tersedia untuk scale-out, sebuah kelompok node akan dipilih secara acak.

    • priority: Kebijakan prioritas. Jika beberapa kelompok node tersedia untuk scale-out, kelompok node dengan prioritas tertinggi akan dipilih berdasarkan urutan grup penskalaan kustom yang Anda tentukan. Prioritas kelompok node ditentukan oleh parameter priorities.

    Valid values:

    • random :

      random.

    • least-waste :

      least-waste.

    • priority :

      priority.

    least-waste
    skip_nodes_with_system_pods

    boolean

    No

    Apakah cluster-autoscaler akan melewatkan scale-down node yang menjalankan Pod di namespace kube-system. Fitur ini tidak berlaku untuk Pod DaemonSet atau Pod mirror. Nilai valid:

    • true: Node tidak di-scale down.

    • false: Node di-scale down.

    Valid values:

    • true :

      true.

    • false :

      false.

    true
    skip_nodes_with_local_storage

    boolean

    No

    Apakah cluster-autoscaler akan melewatkan scale-down node yang menjalankan Pod dengan penyimpanan lokal seperti EmptyDir atau HostPath. Nilai valid:

    • true: Node tidak di-scale down.

    • false: Node di-scale down.

    Valid values:

    • true :

      true.

    • false :

      false.

    false
    daemonset_eviction_for_nodes

    boolean

    No

    Apakah cluster-autoscaler akan mengeluarkan Pod DaemonSet pada sebuah node selama scale-down. Nilai valid:

    • true: Pod DaemonSet dikeluarkan.

    • false: Pod DaemonSet tidak dikeluarkan.

    Valid values:

    • true :

      true.

    • false :

      false.

    false
    max_graceful_termination_sec

    integer

    No

    Periode waktu tunggu (timeout) saat cluster-autoscaler menunggu penghentian Pod selama pengosongan (draining) node dalam skenario scale-down.

    Unit: seconds.

    Nilai default: 14400.

    14400
    min_replica_count

    integer

    No

    Jumlah minimum Pod yang diizinkan di setiap Set Replika sebelum sebuah node dapat di-scale down.

    Nilai default: 0.

    0
    recycle_node_deletion_enabled

    boolean

    No

    Apakah akan menghapus objek Kubernetes Node yang sesuai setelah sebuah node berhasil di-scale down dalam mode swift. Untuk informasi selengkapnya tentang mode swift, lihat Scaling modes. Nilai default: false. Nilai valid:

    • true: Objek Kubernetes Node dihapus setelah node dihentikan dalam mode swift. Menetapkan parameter ini ke true tidak direkomendasikan karena dapat menyebabkan inkonsistensi data objek Kubernetes.

    • false: Objek Kubernetes Node dipertahankan setelah node dihentikan dalam mode swift.

    Valid values:

    • true :

      true.

    • false :

      false.

    false
    scale_up_from_zero

    boolean

    No

    Apakah cluster-autoscaler akan melakukan scale-out ketika jumlah node siap di kluster adalah 0. Nilai default: true. Nilai valid:

    • true: Scale-out dilakukan.

    • false: Scale-out tidak dilakukan.

    Valid values:

    • true :

      true.

    • false :

      false.

    true
    scaler_type

    string

    No

    Tipe komponen penskalaan otomatis. Untuk kluster versi 1.24 dan yang lebih baru, nilai default adalah goatscaler. Untuk versi sebelumnya, nilai default adalah cluster-autoscaler. Nilai valid:

    • goatscaler: Penskalaan instan.

    • cluster-autoscaler: Penskalaan otomatis.

    Valid values:

    • goatscaler :

      goatscaler.

    • cluster-autoscaler :

      cluster-autoscaler

    goatscaler
    priorities

    object

    No

    Konfigurasi prioritas untuk penskalaan otomatis. Setelah Anda membuat kelompok node dengan penskalaan otomatis diaktifkan, Anda dapat memilih apakah akan mengonfigurasi kebijakan prioritas dan pengaturan prioritas dengan menggunakan Enable auto scaling for nodes untuk menetapkan prioritas ke grup penskalaan dari kelompok node penskalaan otomatis yang ditentukan.

    Nilai valid: [1, 100]. Nilai harus berupa bilangan bulat positif. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi.

    array

    No

    同一优先级的自动伸缩节点池伸缩组 ID。

    string

    No

    自动伸缩节点池的伸缩组 ID。

    asg-bp1fe63lqz******

    Elemen respons

    Element

    Type

    Description

    Example

    object

    cluster_id

    string

    ID kluster.

    cc212d04dfe184547bffaa596********
    task_id

    string

    ID tugas.

    T-5fd211e924e1d007********
    request_id

    string

    ID permintaan.

    AF8BE105-C32B-1269-9774-5510********

    Contoh

    Respons sukses

    JSONformat

    {
  "cluster_id": "cc212d04dfe184547bffaa596********",
  "task_id": "T-5fd211e924e1d007********",
  "request_id": "AF8BE105-C32B-1269-9774-5510********"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.