All Products
Search
Document Center

Auto Scaling:EnableScalingGroup

Last Updated:Jun 12, 2026

Mengaktifkan kelompok penskalaan yang berada dalam status Inactive dan memiliki sumber konfigurasi Instans yang ditentukan oleh template peluncuran atau konfigurasi penskalaan aktif, memungkinkan Penyesuaian Skala Otomatis untuk secara otomatis menyesuaikan kapasitas komputasi Anda (jumlah Instans).

Deskripsi operasi

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

    Catatan

    Kelompok 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 kelompok penskalaan. Jika sumber konfigurasi Instans sudah dikonfigurasi sebelum Anda memanggil operasi ini, menentukan konfigurasi penskalaan atau template peluncuran baru akan menimpa konfigurasi yang ada.

  • Jika Anda menentukan Instance ECS untuk ditambahkan ke kelompok penskalaan dengan menggunakan InstanceId.N, Penyesuaian Skala Otomatis akan memeriksa apakah jumlah total Instance ECS (Total Capacity) dalam kelompok penskalaan berada di antara nilai minimum (MinSize) dan nilai maksimum (MaxSize) setelah Instans ditambahkan:

    • Jika Total Capacity kurang dari MinSize setelah pemanggilan berhasil, Penyesuaian Skala Otomatis secara otomatis membuat Instance ECS pay-as-you-go untuk memenuhi selisihnya. Misalnya, jika Anda mengatur MinSize menjadi 5 saat membuat kelompok penskalaan dan menentukan 2 Instance ECS yang sudah ada di parameter InstanceId.N saat mengaktifkan kelompok penskalaan, Penyesuaian Skala Otomatis menambahkan 2 Instance ECS yang sudah ada lalu secara otomatis membuat 3 Instance ECS tambahan.

    • Jika Total Capacity melebihi 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 kelompok penskalaan.

asg-bp14wlu85wrpchm0****

ActiveScalingConfigurationId

string

No

ID konfigurasi penskalaan yang akan diaktifkan dalam kelompok penskalaan.

asc-bp1ffogfdauy0nu5****

LaunchTemplateId

string

No

ID template peluncuran tempat kelompok penskalaan memperoleh informasi konfigurasi 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

InstanceIds

array

No

ID Instance ECS yang akan ditambahkan ke kelompok penskalaan setelah kelompok penskalaan diaktifkan.

Instance ECS yang ingin Anda tambahkan harus memenuhi kondisi berikut:

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

  • Instans harus berada dalam status Running.

  • Instans tidak boleh sudah termasuk dalam kelompok penskalaan lain.

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

  • Jika kelompok penskalaan memiliki VswitchID yang ditentukan, Instance ECS jenis jaringan klasik dan Instance ECS di VPC lain tidak dapat ditambahkan ke kelompok penskalaan.

  • Jika kelompok penskalaan tidak memiliki VswitchID yang ditentukan, Instance ECS jenis VPC tidak dapat ditambahkan ke kelompok penskalaan.

string

No

ID Instance ECS yang akan ditambahkan ke kelompok penskalaan setelah kelompok penskalaan diaktifkan.

Instance ECS yang ingin Anda tambahkan harus memenuhi kondisi berikut:

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

  • Instans harus berada dalam status Running.

  • Instans tidak boleh sudah termasuk dalam kelompok penskalaan lain.

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

  • Jika kelompok penskalaan memiliki VswitchID yang ditentukan, Instance ECS jenis jaringan klasik dan Instance ECS di VPC lain tidak dapat ditambahkan ke kelompok penskalaan.

  • Jika kelompok penskalaan tidak memiliki VswitchID yang ditentukan, Instance ECS jenis VPC tidak dapat ditambahkan ke kelompok penskalaan.

i-283vv****

LoadBalancerWeights

array

No

Bobot setiap Instance ECS atau Instans Kontainer elastis yang ditambahkan ke kelompok penskalaan sebagai server backend dari Instans Server Load Balancer (SLB) yang terkait.

Nilai default: 50.

integer

No

Bobot setiap Instance ECS atau Instans Kontainer elastis yang ditambahkan ke kelompok penskalaan sebagai server backend dari Instans Server Load Balancer (SLB) yang terkait.

Nilai default: 50.

50

LaunchTemplateOverrides

array<object>

No

Informasi tipe instans yang menimpa template peluncuran.

object

No

Informasi tipe instans yang menimpa template peluncuran.

InstanceType

string

No

Untuk menskalakan kelompok penskalaan berdasarkan kapasitas tipe Instans, tentukan parameter ini dan LaunchTemplateOverrides.WeightedCapacity.

Parameter ini menentukan tipe Instans, yang menimpa tipe Instans dalam template peluncuran.

Catatan

Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.

Nilai valid InstanceType: Tipe Instance ECS yang tersedia untuk dibeli.

ecs.c5.xlarge

WeightedCapacity

integer

No

Untuk menskalakan kelompok penskalaan berdasarkan kapasitas tipe Instans, tentukan LaunchTemplateOverrides.InstanceType terlebih dahulu, lalu tentukan parameter ini.

Parameter ini menentukan bobot tipe Instans, yang merepresentasikan kapasitas yang disediakan oleh satu Instans dari tipe ini dalam kelompok 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 yang berbeda untuk tipe Instans yang berbeda berdasarkan kebutuhan Anda.

Contoh:

  • Kapasitas saat ini: 0.

  • Kapasitas yang diharapkan: 6.

  • Kapasitas ecs.c5.xlarge: 4.

Untuk memenuhi kapasitas yang diharapkan, kelompok penskalaan melakukan scale-out dengan menambahkan 2 Instans ecs.c5.xlarge.

Catatan

Selama scale-out, kapasitas kelompok 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 kelompok 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.