All Products
Search

This Product

    Auto Scaling:EnableScalingGroup

    Document Center

    Auto Scaling:EnableScalingGroup

    Last Updated:Sep 10, 2026

    Mengaktifkan grup penskalaan.

    Deskripsi operasi

    Deskripsi operasi

    • Anda dapat memanggil operasi ini untuk mengaktifkan grup penskalaan hanya ketika grup penskalaan berada dalam status Inactive dan memiliki sumber konfigurasi instans (konfigurasi penskalaan, template peluncuran, atau Instans ECS yang ditentukan saat pembuatan grup penskalaan). Jika tidak, pemanggilan akan gagal.

      Catatan

      Grup penskalaan hanya dapat memiliki satu sumber konfigurasi instans aktif dalam satu waktu. Saat Anda memanggil operasi ini, Anda dapat menentukan konfigurasi penskalaan atau template peluncuran untuk grup penskalaan. Jika Anda telah mengonfigurasi sumber konfigurasi instans untuk grup penskalaan sebelum memanggil operasi ini, menentukan konfigurasi penskalaan atau template peluncuran akan menimpa konfigurasi yang ada.

    • Jika Anda menentukan Instans ECS (InstanceId.N) untuk ditambahkan ke grup penskalaan saat memanggil operasi ini, Penyesuaian Skala Otomatis memeriksa apakah jumlah total Instans ECS (Total Capacity) dalam grup penskalaan berada di antara nilai minimum (MinSize) dan nilai maksimum (MaxSize) setelah Instans ECS ditambahkan:

      • Jika Total Capacity grup penskalaan kurang dari MinSize, Penyesuaian Skala Otomatis secara otomatis membuat Instans ECS pay-as-you-go untuk menutupi selisihnya.

      Misalnya, jika Anda mengatur MinSize menjadi 5 saat membuat grup penskalaan dan menentukan 2 Instans ECS yang ada di parameter InstanceId.N saat mengaktifkan grup penskalaan, Penyesuaian Skala Otomatis menambahkan 2 Instans ECS yang ada lalu secara otomatis membuat 3 Instans ECS lainnya.

      • Jika Total Capacity grup penskalaan lebih besar dari MaxSize, pemanggilan akan gagal.

    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

    ess:EnableScalingGroup

    update

    *ScalingGroup

    acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupId

    string

    Yes

    ID grup penskalaan.

    asg-bp14wlu85wrpchm0****
    ActiveScalingConfigurationId

    string

    No

    ID konfigurasi penskalaan yang akan diaktifkan di grup penskalaan.

    asc-bp1ffogfdauy0nu5****
    LaunchTemplateId

    string

    No

    ID template peluncuran. Parameter ini menentukan bahwa grup penskalaan memperoleh informasi konfigurasi peluncuran dari template peluncuran.

    lt-m5e3ofjr1zn1aw7****
    LaunchTemplateVersion

    string

    No

    Versi template peluncuran. Nilai valid:

    • Nomor versi template tetap.

    • Default: selalu menggunakan versi default template.

    • Latest: selalu menggunakan versi terbaru template.

    Default
    InstanceId

    array

    No

    ID Instans ECS yang akan ditambahkan ke grup penskalaan setelah grup penskalaan diaktifkan. Nilai valid N: 1 hingga 20.

    Instans ECS yang akan ditambahkan ke grup penskalaan harus memenuhi kondisi berikut:

    • Instans harus berada di wilayah yang sama dengan grup penskalaan.

    • Instans harus berada dalam status Running.

    • Instans tidak boleh sudah menjadi milik grup penskalaan lain.

    • Metode penagihan instans harus berupa langganan, pay-as-you-go, atau spot instans.

    • Jika grup penskalaan memiliki VswitchID yang ditentukan, Instans ECS jaringan klasik tidak dapat ditambahkan ke grup penskalaan, dan Instans ECS dari VPC lain tidak dapat ditambahkan ke grup penskalaan.

    • Jika grup penskalaan tidak memiliki VswitchID yang ditentukan, Instans ECS tipe VPC tidak dapat ditambahkan ke grup penskalaan.

    i-283vv****

    string

    No

    ID Instans ECS yang akan ditambahkan ke grup penskalaan setelah grup penskalaan diaktifkan. Nilai valid N: 1 hingga 20.

    Instans ECS yang akan ditambahkan ke grup penskalaan harus memenuhi kondisi berikut:

    • Instans harus berada di wilayah yang sama dengan grup penskalaan.

    • Instans harus berada dalam status Running.

    • Instans tidak boleh sudah menjadi milik grup penskalaan lain.

    • Metode penagihan instans harus berupa langganan, pay-as-you-go, atau spot instans.

    • Jika grup penskalaan memiliki VswitchID yang ditentukan, Instans ECS jaringan klasik tidak dapat ditambahkan ke grup penskalaan, dan Instans ECS dari VPC lain tidak dapat ditambahkan ke grup penskalaan.

    • Jika grup penskalaan tidak memiliki VswitchID yang ditentukan, Instans ECS tipe VPC tidak dapat ditambahkan ke grup penskalaan.

    i-283vv****
    LoadBalancerWeight

    array

    No

    Bobot Instans ECS atau elastic container instance sebagai server backend dari instans Server Load Balancer (SLB) yang terkait. Nilai valid N: 1 hingga 20. Nilai valid parameter ini: 1 hingga 100.

    Nilai default: 50.

    50

    integer

    No

    Bobot Instans ECS atau elastic container instance sebagai server backend dari instans SLB yang terkait. Nilai valid N: 1 hingga 20. Nilai valid parameter ini: 1 hingga 100.

    Nilai default: 50.

    50
    LaunchTemplateOverride

    array<object>

    No

    Informasi penggantian template peluncuran.

    object

    No

    Informasi penggantian template peluncuran.

    InstanceType

    string

    No

    Jika Anda ingin grup penskalaan melakukan penskalaan berdasarkan kapasitas tipe instans, tentukan parameter ini dan LaunchTemplateOverride.N.WeightedCapacity.

    Parameter ini menentukan tipe Instans ECS dan menimpa tipe Instans ECS di template peluncuran. Anda dapat menentukan N nilai untuk parameter ini guna memperluas template peluncuran agar mendukung N tipe instans. Nilai valid N: 1 hingga 10.

    Catatan

    Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.

    Untuk nilai valid InstanceType, lihat Instance families.

    ecs.c5.xlarge
    WeightedCapacity

    integer

    No

    Jika Anda ingin grup penskalaan melakukan penskalaan berdasarkan kapasitas tipe instans, tentukan parameter ini setelah Anda menentukan LaunchTemplateOverride.N.InstanceType. Kedua parameter ini saling berkorespondensi satu lawan satu, dan nilai N harus sama.

    Parameter ini menentukan bobot tipe instans, yang merepresentasikan kapasitas satu instans dari tipe ini di grup penskalaan. Bobot yang lebih tinggi berarti lebih sedikit instans dari tipe ini yang diperlukan untuk memenuhi kapasitas yang diharapkan.

    Karena tipe instans berbeda dalam jumlah vCPU, ukuran memori, dan metrik kinerja lainnya, Anda dapat menetapkan bobot berbeda untuk tipe instans berbeda berdasarkan kebutuhan Anda.

    Misalnya:

    • Kapasitas saat ini: 0.

    • Kapasitas yang diharapkan: 6.

    • Kapasitas tipe instans ecs.c5.xlarge: 4.

    Untuk memenuhi kapasitas yang diharapkan, grup penskalaan melakukan scale out dengan menambahkan 2 instans ecs.c5.xlarge.

    Catatan

    Selama scale-out, kapasitas grup penskalaan tidak boleh melebihi jumlah dari kapasitas maksimum (MaxSize) dan bobot maksimum di antara tipe instans.

    Nilai valid WeightedCapacity: 1 hingga 500.

    4
    RegionId

    string

    No

    ID wilayah grup penskalaan.

    cn-qingdao

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.