All Products
Search

This Product

    Auto Scaling:CreateScalingGroup

    Document Center

    Auto Scaling:CreateScalingGroup

    Last Updated:Jun 12, 2026

    Membuat scaling group untuk menyesuaikan kapasitas komputasi Anda (jumlah instans) secara otomatis berdasarkan perubahan bisnis dan kebijakan.

    Deskripsi operasi

    Scaling group adalah kumpulan instans ECS yang melayani skenario umum yang sama.

    Jumlah scaling group yang dapat dibuat dalam suatu wilayah bergantung pada penggunaan Auto Scaling Anda. Buka Quota Center untuk melihat nilai kuota jumlah total scaling group.

    Scaling group tidak langsung berlaku setelah dibuat. Anda harus memanggil operasi EnableScalingGroup untuk mengaktifkan scaling group sebelum dapat memicu aktivitas penskalaan dan menjalankan aturan penskalaan.

    Scaling group, instans Classic Load Balancer (CLB, sebelumnya SLB) yang terkait, dan instans ApsaraDB RDS yang terkait harus berada di wilayah yang sama. Untuk informasi selengkapnya, lihat Wilayah dan zona.

    Jika Anda mengaitkan instans CLB dengan scaling group, scaling group secara otomatis menambahkan instans ECS yang ditambahkan ke scaling group ke grup server backend instans CLB. Anda dapat menentukan grup server tempat instans ECS ditambahkan. Dua jenis grup server berikut didukung:

    • Grup server default: digunakan untuk menerima permintaan frontend. Jika tidak ada grup server virtual atau grup server primer/sekunder yang dikonfigurasi untuk listener, permintaan diteruskan ke instans ECS di grup server default secara default.

    • Grup server virtual: gunakan grup server virtual saat Anda ingin meneruskan permintaan yang berbeda ke server backend yang berbeda, atau saat Anda ingin meneruskan permintaan berdasarkan nama domain atau URL.

    Catatan

    Jika Anda menentukan grup server default dan beberapa grup server virtual, instans ECS ditambahkan ke semua grup server tersebut.

    Setelah instans ditambahkan ke grup server backend instans CLB, bobot instans diatur ke 50 secara default. Instans CLB harus memenuhi persyaratan berikut:

    • Instans CLB harus dalam status aktif. Anda dapat memanggil operasi DescribeLoadBalancers untuk menanyakan status instans CLB yang ditentukan.

    • Pemeriksaan kesehatan harus diaktifkan untuk semua port listener yang dikonfigurasi pada instans CLB. Jika tidak, scaling group gagal dibuat.

    Jika Anda mengaitkan grup server Application Load Balancer (ALB), grup server Network Load Balancer (NLB), atau grup server Gateway Load Balancer (GWLB) dengan scaling group, scaling group secara otomatis menambahkan instans ECS yang ditambahkan ke scaling group sebagai server backend dari grup server ALB, NLB, atau GWLB untuk memproses permintaan akses yang didistribusikan oleh instans ALB, NLB, atau GWLB. Anda dapat menentukan beberapa grup server ALB, NLB, atau GWLB, tetapi grup server harus berada dalam VPC yang sama dengan scaling group. Untuk informasi selengkapnya, lihat AttachAlbServerGroups atau AttachServerGroups.

    Jika Anda mengaitkan instans ApsaraDB RDS dengan scaling group, scaling group secara otomatis menambahkan alamat IP internal instans ECS yang ditambahkan ke scaling group ke daftar putih instans RDS. Instans RDS harus memenuhi persyaratan berikut:

    • Instans RDS harus dalam status Running. Anda dapat memanggil operasi DescribeDBInstances untuk menanyakan status instans RDS yang ditentukan.

    • Jumlah alamat IP dalam daftar putih instans RDS tidak boleh melebihi batas atas. Untuk informasi selengkapnya, lihat Mengonfigurasi daftar putih dalam dokumentasi ApsaraDB RDS.

    Jika MultiAZPolicy scaling group diatur ke COST_OPTIMIZED:

    • Jika Anda menentukan parameter OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity, dan SpotInstancePools untuk mendefinisikan metode alokasi instans di bawah kebijakan optimasi biaya, metode alokasi instans ini diprioritaskan selama peristiwa scale-out dan scale-in.

    • Jika Anda tidak menentukan parameter OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity, atau SpotInstancePools, kebijakan optimasi biaya membuat instans dengan biaya terendah. (Dalam mode ini, instans tidak dapat dibuat melalui Elasticity Assurance atau Capacity Reservation.)

    Jika Anda mengatur tag yang dapat disebarkan untuk scaling group, yaitu Tags.Propagate diatur ke true:

    • Tag pada scaling group hanya disebarkan ke instans yang baru dibuat, bukan ke instans yang sudah berjalan di scaling group.

    • Jika Anda menentukan tag instans dalam konfigurasi penskalaan dan memilih untuk menyebarkan tag scaling group ke instans, semua tag akan ada bersamaan.

    • Jika tag yang dapat disebarkan dalam scaling group dan tag dalam konfigurasi penskalaan menentukan kunci tag yang sama, nilai tag dalam konfigurasi penskalaan yang diutamakan.

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

    create

    *ScalingGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupName

    string

    No

    Nama scaling group. Nama harus unik dalam satu wilayah.

    Nama harus terdiri dari 2 hingga 64 karakter dan dapat berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). Nama harus diawali dengan angka, huruf, atau karakter China.

    Nilai default: nilai ScalingGroupId.

    scalinggroup****
    LaunchTemplateId

    string

    No

    ID template peluncuran yang digunakan scaling group untuk memperoleh informasi konfigurasi peluncuran.

    lt-m5e3ofjr1zn1aw7****

    LaunchTemplateVersion

    string

    No

    Versi template peluncuran. Nilai yang valid:

    • Nomor versi template yang tetap.

    • Default: selalu menggunakan versi default template.

    • Latest: selalu menggunakan versi terbaru template.

    Default
    InstanceId

    string

    No

    ID instans. Saat Anda membuat scaling group, informasi konfigurasi yang diperlukan diperoleh dari instans yang ditentukan, dan konfigurasi penskalaan dibuat secara otomatis.

    i-28wt4****
    RegionId

    string

    Yes

    ID wilayah scaling group.

    cn-qingdao
    MinSize

    integer

    Yes

    Jumlah minimum instans dalam scaling group. Ketika jumlah instans dalam scaling group kurang dari nilai MinSize, Auto Scaling membuat instans secara otomatis.

    Catatan

    Nilai MinSize harus kurang dari atau sama dengan nilai MaxSize.

    2
    MaxSize

    integer

    Yes

    Jumlah maksimum instans dalam scaling group. Ketika jumlah instans dalam scaling group melebihi nilai MaxSize, Auto Scaling secara otomatis menghapus instans.

    Nilai valid MaxSize bergantung pada penggunaan Auto Scaling Anda. Buka Quota Center untuk melihat nilai kuota Jumlah maksimum instans dalam scaling group.

    Jika nilai kuota untuk Jumlah maksimum instans dalam scaling group adalah 2000, nilai valid MaxSize adalah 0 hingga 2000.

    20
    DefaultCooldown

    integer

    No

    Waktu pendinginan setelah aktivitas penskalaan (menambah atau menghapus instans) selesai. Nilai yang valid: 0 hingga 86400. Satuan: detik.

    Selama waktu pendinginan, scaling group tidak menjalankan aktivitas penskalaan lainnya. Ini hanya berlaku untuk aktivitas penskalaan yang dipicu oleh tugas yang dipicu peristiwa CloudMonitor.

    Nilai default: 300.

    300
    LoadBalancerIds

    string

    No

    ID instans CLB (sebelumnya SLB). Nilainya adalah array JSON yang terdiri dari ID instans CLB yang dipisahkan oleh koma (,).

    Jumlah total instans CLB yang dapat dikaitkan dengan satu scaling group bergantung pada penggunaan Auto Scaling Anda. Buka Quota Center untuk melihat nilai kuota Jumlah total instans load balancing yang dapat dikaitkan dengan scaling group.

    .

    ["lb-bp1u7etiogg38yvwz****", "lb-bp168cqrux9ai9l7f****", "lb-bp1jv3m9zvj22ufxp****"]
    DBInstanceIds

    string

    No

    ID instans ApsaraDB RDS. Nilainya adalah array JSON yang terdiri dari ID instans RDS yang dipisahkan oleh koma (,).

    Jumlah total instans RDS yang dapat dikaitkan dengan satu scaling group bergantung pada penggunaan Auto Scaling Anda. Buka Quota Center untuk melihat nilai kuota Jumlah total instans RDS yang dapat dikaitkan dengan scaling group.

    .

    ["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]
    RemovalPolicies

    array

    No

    Kebijakan filter untuk kebijakan scale-in. Nilai yang valid:

    • OldestInstance: menghapus instans ECS yang paling awal ditambahkan ke scaling group.

    • NewestInstance: menghapus instans ECS yang paling baru ditambahkan ke scaling group.

    • OldestScalingConfiguration: menghapus instans ECS yang dibuat dari konfigurasi penskalaan paling awal.

    • CustomPolicy: menghapus instans ECS berdasarkan kebijakan scale-in kustom Function.

    Konfigurasi penskalaan yang disebutkan dalam OldestScalingConfiguration merujuk pada sumber konfigurasi instans dalam scaling group, termasuk konfigurasi penskalaan dan template peluncuran. CustomPolicy hanya dapat diatur sebagai kebijakan penghapusan pertama. Saat Anda menentukan CustomPolicy, Anda juga harus menentukan parameter CustomPolicyARN.

    Catatan

    Penghapusan instans ECS dari scaling group juga dipengaruhi oleh kebijakan penskalaan (MultiAZPolicy) scaling group. Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan kombinasi untuk menghapus instans.

    string

    No

    Kebijakan filter untuk kebijakan scale-in. Nilai yang valid:

    • OldestInstance: menghapus instans ECS yang paling awal ditambahkan ke scaling group.

    • NewestInstance: menghapus instans ECS yang paling baru ditambahkan ke scaling group.

    • OldestScalingConfiguration: menghapus instans ECS yang dibuat dari konfigurasi penskalaan paling awal.

    • CustomPolicy: menghapus instans ECS berdasarkan kebijakan scale-in kustom Function.

    Konfigurasi penskalaan yang disebutkan dalam OldestScalingConfiguration merujuk pada sumber konfigurasi instans dalam scaling group, termasuk konfigurasi penskalaan dan template peluncuran. CustomPolicy hanya dapat diatur sebagai kebijakan penghapusan pertama. Saat Anda menentukan CustomPolicy, Anda juga harus menentukan parameter CustomPolicyARN.

    Catatan

    Penghapusan instans ECS dari scaling group juga dipengaruhi oleh kebijakan penskalaan (MultiAZPolicy) scaling group. Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan kombinasi untuk menghapus instans.

    OldestScalingConfiguration
    VSwitchId

    string

    No

    ID vSwitch. Jika Anda menentukan parameter ini, jenis jaringan scaling group adalah VPC.

    Catatan

    Jika VSwitchId maupun VSwitchIds tidak ditentukan, jenis jaringan scaling group default ke jaringan klasik.

    vsw-bp14zolna43z266bq****
    MultiAZPolicy

    string

    No

    Kebijakan penskalaan untuk instans ECS dalam scaling group multi-zona. Nilai yang valid:

    • PRIORITY: vSwitch yang ditentukan pertama (dalam VSwitchIds) memiliki prioritas tertinggi. Auto Scaling secara preferensi mencoba menskalakan instans di zona vSwitch prioritas tertinggi. Jika penskalaan gagal, Auto Scaling mencoba menskalakan instans di zona vSwitch prioritas tertinggi berikutnya.

    • COST_OPTIMIZED: selama scale-out, Auto Scaling mencoba membuat instans ECS dalam urutan harga unit vCPU naik. Selama scale-in, Auto Scaling mencoba menghapus instans ECS dalam urutan harga unit vCPU turun. Ketika konfigurasi penskalaan menentukan beberapa jenis instans dengan metode penagihan spot, instans spot dibuat secara preferensial. Anda dapat menggunakan parameter CompensateWithOnDemand untuk menentukan apakah akan secara otomatis membuat instans pay-as-you-go ketika instans spot tidak dapat dibuat karena inventaris tidak mencukupi atau alasan lainnya.

      Catatan

      COST_OPTIMIZED hanya berlaku ketika konfigurasi penskalaan menentukan beberapa jenis instans atau menggunakan instans spot.

    • BALANCE: instans ECS dialokasikan secara merata di beberapa zona yang ditentukan untuk scaling group. Jika zona menjadi tidak seimbang karena inventaris tidak mencukupi atau alasan lainnya, Anda dapat memanggil operasi RebalanceInstance untuk menyeimbangkan kembali sumber daya.

      Catatan

      Jika MultiAZPolicy diatur ke BALANCE, efeknya sama dengan mengatur MultiAZPolicy ke COMPOSABLE dengan AzBalance diatur ke true.

    • COMPOSABLE: kebijakan komposit yang memungkinkan Anda menyesuaikan kombinasi kebijakan penskalaan multi-zona sebelumnya. Anda juga dapat menentukan parameter tambahan untuk kontrol yang lebih detail atas kapasitas scaling group.

    Nilai default: PRIORITY.

    PRIORITY
    HealthCheckType

    string

    No

    Mode pemeriksaan kesehatan scaling group. Nilai yang valid:

    • NONE: tidak ada pemeriksaan kesehatan yang dilakukan.

    • ECS: pemeriksaan kesehatan dilakukan pada instans di scaling group (nilai ini digunakan untuk scaling group jenis ECS maupun ECI untuk mengaktifkan pemeriksaan kesehatan instans).

    • LOAD_BALANCER: status kesehatan instans ditentukan berdasarkan hasil pemeriksaan kesehatan load balancing (jenis load balancing CLB tidak didukung).

    Nilai default: ECS.

    Catatan

    Untuk mengaktifkan pemeriksaan kesehatan instans dan pemeriksaan kesehatan load balancing secara bersamaan, gunakan parameter HealthCheckTypes.

    ECS
    ScalingPolicy

    string

    No

    Menentukan mode reklamasi scaling group. Nilai yang valid:

    • recycle: scaling group menggunakan mode shutdown dan daur ulang.

    • release: scaling group menggunakan mode rilis.

    • forcerelease: scaling group menggunakan mode rilis paksa.
      Catatan

      Jika Anda memilih forcerelease, instans dalam status Running dirilis secara paksa selama aktivitas scale-down. Merilis instans secara paksa setara dengan operasi mematikan daya, yang menghapus data sementara di memori dan penyimpanan instans. Data tidak dapat dipulihkan. Lanjutkan dengan hati-hati.

    • forcerecycle: scaling group menggunakan mode shutdown dan daur ulang paksa.
      Catatan

      Jika Anda memilih forcerecycle, instans dalam status Running dimatikan secara paksa selama aktivitas scale-down. Mematikan instans secara paksa setara dengan operasi mematikan daya, yang menghapus data sementara di memori dan penyimpanan instans. Data tidak dapat dipulihkan. Lanjutkan dengan hati-hati.

    ScalingPolicy menentukan mode reklamasi scaling group, tetapi tindakan spesifik saat instans dihapus dari scaling group ditentukan oleh parameter RemovePolicy dari RemoveInstances. Untuk informasi selengkapnya, lihat RemoveInstances.

    recycle
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

    123e4567-e89b-12d3-a456-42665544****
    OnDemandBaseCapacity

    integer

    No

    Jumlah minimum instans pay-as-you-go yang diperlukan dalam scaling group. Nilai yang valid: 0 hingga 1000. Ketika jumlah instans pay-as-you-go kurang dari nilai ini, instans pay-as-you-go dibuat secara preferensial.

    30
    OnDemandPercentageAboveBaseCapacity

    integer

    No

    Persentase instans pay-as-you-go di antara instans berlebih setelah jumlah minimum instans pay-as-you-go (OnDemandBaseCapacity) terpenuhi. Nilai yang valid: 0 hingga 100.

    20
    SpotInstanceRemedy

    boolean

    No

    Menentukan apakah akan mengaktifkan kebijakan instans spot tambahan. Setelah kebijakan ini diaktifkan, ketika scaling group menerima pesan sistem bahwa instans spot akan direklamasi, Auto Scaling mencoba membuat instans baru untuk menggantikan instans spot yang akan direklamasi.

    true
    CompensateWithOnDemand

    boolean

    No

    Menentukan apakah akan secara otomatis membuat instans pay-as-you-go untuk memenuhi persyaratan jumlah instans ECS ketika instans spot tidak dapat dibuat karena harga, inventaris, atau alasan lainnya. Parameter ini hanya berlaku ketika MultiAZPolicy diatur ke COST_OPTIMIZED. Nilai yang valid:

    • true: mengizinkan pembuatan otomatis.

    • false: tidak mengizinkan pembuatan otomatis.

    Nilai default: true.

    true
    SpotInstancePools

    integer

    No

    Jumlah jenis instans yang tersedia. Scaling group membuat instans spot dengan cara yang hemat biaya di sejumlah jenis instans yang ditentukan. Nilai yang valid: 1 hingga 10.

    5
    DesiredCapacity

    integer

    No

    Jumlah instans yang diharapkan dalam scaling group. Scaling group secara otomatis menjaga jumlah instans pada jumlah yang diharapkan. Nilainya tidak boleh lebih besar dari MaxSize atau kurang dari MinSize.

    5
    GroupDeletionProtection

    boolean

    No

    Menentukan apakah akan mengaktifkan proteksi penghapusan untuk scaling group. Nilai yang valid:

    • true: mengaktifkan proteksi penghapusan. Scaling group tidak dapat dihapus.

    • false: menonaktifkan proteksi penghapusan.

    Nilai default: false.

    true
    GroupType

    string

    No

    Jenis instans yang dikelola oleh scaling group. Nilai yang valid:

    • ECS: scaling group mengelola instans ECS.

    • ECI: scaling group mengelola instans Elastic Container Instance (ECI).

    Nilai default: ECS.

    ECS
    ContainerGroupId

    string

    No

    ID instans ECI, yaitu ID grup kontainer.

    eci-uf6fonnghi50u374****
    VSwitchIds

    array

    No

    ID satu atau beberapa vSwitch. Jika Anda menentukan parameter ini, parameter VSwitchId diabaikan. Jika Anda menentukan parameter ini, jenis jaringan scaling group adalah VPC.

    Saat Anda menentukan beberapa vSwitch:

    • vSwitch harus berada dalam VPC yang sama.

    • vSwitch dapat berada di zona yang berbeda.

    • Prioritas vSwitch ditentukan dalam urutan numerik naik, di mana 1 menunjukkan prioritas tertinggi. Ketika instans tidak dapat dibuat di zona vSwitch prioritas lebih tinggi, vSwitch prioritas tertinggi berikutnya dipilih secara otomatis.

    Catatan

    Jika VSwitchId maupun VSwitchIds tidak ditentukan, jenis jaringan scaling group default ke jaringan klasik.

    string

    No

    ID satu atau beberapa vSwitch. Jika Anda menentukan parameter ini, parameter VSwitchId diabaikan. Jika Anda menentukan parameter ini, jenis jaringan scaling group adalah VPC.

    Saat Anda menentukan beberapa vSwitch:

    • vSwitch harus berada dalam VPC yang sama.

    • vSwitch dapat berada di zona yang berbeda.

    • Prioritas vSwitch ditentukan dalam urutan numerik naik, di mana 1 menunjukkan prioritas tertinggi. Ketika instans tidak dapat dibuat di zona vSwitch prioritas lebih tinggi, vSwitch prioritas tertinggi berikutnya dipilih secara otomatis.

    Catatan

    Jika VSwitchId maupun VSwitchIds tidak ditentukan, jenis jaringan scaling group default ke jaringan klasik.

    vsw-bp14zolna43z266bq****
    LifecycleHooks

    array<object>

    No

    Daftar informasi lifecycle hook.

    object

    No

    Daftar informasi lifecycle hook.

    DefaultResult

    string

    No

    Tindakan yang diambil setelah status tunggu berakhir. Nilai yang valid:

    • CONTINUE: melanjutkan untuk merespons aktivitas scale-out atau melanjutkan untuk merespons aktivitas scale-in.

    • ABANDON: melepaskan instans yang dibuat selama aktivitas scale-out atau menghapus instans dari scaling group selama aktivitas scale-in.

    Ketika aktivitas scale-in (SCALE_IN) memicu beberapa lifecycle hook dalam scaling group, jika status tunggu lifecycle hook dengan DefaultResult diatur ke ABANDON berakhir, status tunggu lifecycle hook lain yang sesuai berakhir lebih awal. Dalam kasus lain, tindakan ditentukan oleh lifecycle hook terakhir yang status tunggunya berakhir.

    Nilai default: CONTINUE.

    CONTINUE
    LifecycleHookName

    string

    No

    Nama lifecycle hook. Setelah nama ditentukan, nama tidak dapat diubah. Jika tidak ditentukan, nama default ke ID lifecycle hook.

    lifecyclehook****
    LifecycleTransition

    string

    No

    Jenis aktivitas penskalaan yang berlaku untuk lifecycle hook. Nilai yang valid:

    • SCALE_OUT: aktivitas scale-out scaling group.

    • SCALE_IN: aktivitas scale-in scaling group.

    Catatan

    Jika lifecycle hook ditentukan untuk scaling group, parameter ini wajib. Parameter terkait lainnya bersifat opsional.

    SCALE_OUT
    NotificationMetadata

    string

    No

    Informasi string tetap untuk status tunggu aktivitas penskalaan. Nilai tidak boleh melebihi 4096 karakter. Setiap kali Auto Scaling mengirim pesan ke penerima notifikasi, Auto Scaling juga mengirimkan nilai NotificationMetadata yang Anda tentukan, yang membantu Anda mengelola dan menandai berbagai kategori informasi notifikasi. Parameter ini hanya berlaku ketika parameter NotificationArn juga ditentukan.

    Test
    NotificationArn

    string

    No

    Pengidentifikasi penerima notifikasi lifecycle hook, yang mendukung antrean atau topik Simple Message Queue (sebelumnya MNS). Nilai parameter dalam format acs:ess:{region}:{account-id}:{resource-relative-id}.

    • region: wilayah tempat scaling group berada.

    • account-id: ID akun Alibaba Cloud.

    Contoh:

    • Antrean MNS: acs:ess:{region}:{account-id}:queue/{queuename}.

    • Topik MNS: acs:ess:{region}:{account-id}:topic/{topicname}.

    acs:ess:cn-hangzhou:1111111111:queue/queue2
    HeartbeatTimeout

    integer

    No

    Waktu tunggu yang ditetapkan oleh lifecycle hook untuk aktivitas scaling group. Setelah status tunggu habis waktu, tindakan berikutnya dilakukan. Nilai yang valid: 30 hingga 21600. Satuan: detik.

    Setelah lifecycle hook dibuat, Anda dapat memanggil RecordLifecycleActionHeartbeat untuk memperpanjang waktu tunggu instans, atau memanggil CompleteLifecycleAction untuk mengakhiri status tunggu aktivitas penskalaan lebih awal.

    Nilai default: 600.

    600
    VServerGroups

    array<object>

    No

    Informasi tentang grup server virtual yang terkait dengan scaling group.

    array<object>

    No

    Informasi tentang grup server virtual yang terkait dengan scaling group.

    VServerGroupAttributes

    array<object>

    No

    Atribut grup server backend.

    object

    No

    Atribut grup server backend.

    VServerGroupId

    string

    No

    ID grup server virtual.

    rsp-bp1443g77****
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Auto Scaling menambahkan instans ke grup server virtual. Bobot yang lebih tinggi menunjukkan bahwa instans dialokasikan lebih banyak permintaan akses. Jika bobotnya 0, instans tidak menerima permintaan akses. Nilai yang valid: 0 hingga 100.

    Nilai default: 50.

    100
    Port

    integer

    No

    Nomor port yang digunakan oleh instans setelah Auto Scaling menambahkan instans ke grup server virtual. Nilai yang valid: 1 hingga 65535.

    22
    LoadBalancerId

    string

    No

    ID instans CLB (sebelumnya SLB) tempat grup server virtual berada.

    lb-bp1u7etiogg38yvwz****
    Tags

    array<object>

    No

    Tag scaling group.

    object

    No

    Tag scaling group.

    Key

    string

    No

    Kunci tag scaling group.

    Department
    Value

    string

    No

    Nilai tag scaling group.

    Finance

    Propagate

    boolean

    No

    Menentukan apakah tag merupakan tag yang dapat disebarkan. Nilai yang valid:

    • true: tag pada scaling group hanya disebarkan ke instans yang baru dibuat, bukan ke instans yang sudah berjalan di scaling group.

    • false: tag pada scaling group tidak disebarkan ke instans.

    Nilai default: false.

    false
    LaunchTemplateOverrides

    array<object>

    No

    Informasi jenis instans yang memperluas template peluncuran.

    object

    No

    Informasi jenis instans yang memperluas template peluncuran.

    InstanceType

    string

    No

    Untuk menskalakan scaling group berdasarkan kapasitas jenis instans, tentukan parameter ini dan LaunchTemplateOverrides.WeightedCapacity.

    Parameter ini menentukan jenis instans dan mengesampingkan jenis instans dalam template peluncuran.

    Catatan

    Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.

    Nilai valid InstanceType: jenis instans ECS yang tersedia untuk dibeli.

    ecs.c5.xlarge

    WeightedCapacity

    integer

    No

    Untuk menskalakan scaling group berdasarkan kapasitas jenis instans, tentukan parameter ini setelah menentukan LaunchTemplateOverrides.InstanceType.

    Parameter ini menentukan bobot jenis instans, yang mewakili kapasitas satu instans dari jenis ini dalam scaling group. Bobot yang lebih tinggi berarti lebih sedikit instans dari jenis ini yang diperlukan untuk memenuhi kapasitas yang diharapkan.

    Karena metrik performa seperti jumlah vCPU dan ukuran memori bervariasi antar jenis instans, Anda dapat menetapkan bobot yang berbeda untuk jenis 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, scaling group melakukan scale-out 2 instans ecs.c5.xlarge.

    Catatan

    Selama scale-out, kapasitas scaling group tidak boleh melebihi jumlah kapasitas maksimum (MaxSize) dan bobot maksimum jenis instans.

    Nilai valid WeightedCapacity: 1 hingga 500.

    4
    SpotPriceLimit

    number

    No

    Harga penawaran maksimum untuk jenis instans yang ditentukan dalam pengesampingan template peluncuran (LaunchTemplateOverride.InstanceType).

    Catatan

    Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.

    0.025
    AlbServerGroups

    array<object>

    No

    Informasi tentang grup server ALB.

    object

    No

    Informasi tentang grup server ALB.

    AlbServerGroupId

    string

    No

    ID grup server ALB.

    Jumlah grup server ALB yang dapat dikaitkan dengan scaling group dibatasi. Untuk melihat atau meminta peningkatan kuota, buka Quota Center.

    sgp-ddwb0y0g6y9bjm****
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Auto Scaling menambahkan instans ke grup server ALB. Bobot yang lebih tinggi menunjukkan bahwa instans menerima lebih banyak permintaan akses. Jika bobotnya 0, instans tidak menerima permintaan akses. Nilai yang valid: 0 hingga 100.

    100
    Port

    integer

    No

    Nomor port yang digunakan oleh instans setelah Auto Scaling menambahkan instans ke grup server ALB. Nilai yang valid: 1 hingga 65535.

    22
    ServerGroups

    array<object>

    No

    Informasi tentang grup server load balancing.

    Catatan

    Anda tidak dapat mengatur informasi grup server yang sama di AlbServerGroups dan ServerGroups.

    object

    No

    Informasi tentang grup server load balancing.

    ServerGroupId

    string

    No

    ID grup server.

    sgp-5yc3bd9lfyh*****
    Type

    string

    No

    Jenis grup server. Nilai yang valid:

    • ALB: Application Load Balancer (ALB).

    • NLB: Network Load Balancer (NLB).

    • GWLB: Gateway Load Balancer (GWLB).

    ALB
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Auto Scaling menambahkan instans ke grup server. Nilai yang valid: 0 hingga 100.

    Bobot yang lebih tinggi menunjukkan bahwa instans dialokasikan lebih banyak permintaan akses. Jika bobotnya 0, instans tidak menerima permintaan akses.

    Catatan

    Parameter ini diperlukan untuk grup server load balancing jenis ALB dan NLB. Parameter ini tidak dapat diatur untuk grup server load balancing jenis GWLB.

    100
    Port

    integer

    No

    Nomor port yang digunakan oleh instans setelah Auto Scaling menambahkan instans ke grup server. Nilai yang valid: 1 hingga 65535.

    22
    AzBalance

    boolean

    No

    Menentukan apakah akan mendistribusikan kapasitas scaling group secara merata di beberapa zona. Parameter ini hanya berlaku ketika MultiAZPolicy diatur ke COMPOSABLE. Nilai yang valid:

    • true: kapasitas scaling group didistribusikan secara merata di beberapa zona.

    • false: kapasitas scaling group tidak didistribusikan secara merata di beberapa zona.

    Catatan

    Jika MultiAZPolicy diatur ke COMPOSABLE dan AzBalance diatur ke true, efeknya sama dengan mengatur MultiAZPolicy ke BALANCE.

    Nilai default: false.

    false
    AllocationStrategy

    string

    No

    Strategi alokasi kapasitas yang menentukan bagaimana scaling group memilih jenis instans yang tersedia untuk memenuhi persyaratan kapasitas. Strategi alokasi kapasitas berlaku untuk kapasitas pay-as-you-go dan spot. Parameter ini hanya berlaku ketika MultiAZPolicy diatur ke COMPOSABLE. Nilai yang valid:

    • priority: instans dibuat sesuai urutan jenis instans yang dikonfigurasi.

    • lowestPrice: instans dibuat dalam urutan harga unit vCPU naik.

    Nilai default: priority.

    priority
    SpotAllocationStrategy

    string

    No

    Strategi alokasi untuk kapasitas spot. Anda dapat menggunakan parameter ini untuk secara independen menentukan strategi alokasi untuk kapasitas spot. Parameter ini hanya berlaku ketika MultiAZPolicy diatur ke COMPOSABLE. Nilai yang valid:

    • priority: instans dibuat sesuai urutan jenis instans yang dikonfigurasi.

    • lowestPrice: instans dibuat dalam urutan harga unit vCPU naik.

    Nilai default: priority.

    lowestPrice
    SyncAlarmRuleToCms

    boolean

    No

    Catatan

    Parameter ini tidak tersedia untuk digunakan.

    false
    MaxInstanceLifetime

    integer

    No

    Jumlah waktu maksimum instans dapat berada dalam scaling group. Satuan: detik.

    Nilai yang valid: [86400, Integer.maxValue].

    Nilai default: null.

    null
    CustomPolicyARN

    string

    No

    ARN kebijakan scale-in kustom Function. Parameter ini hanya berlaku ketika kebijakan penghapusan pertama di RemovalPolicies diatur ke CustomPolicy.

    acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name
    ResourceGroupId

    string

    No

    ID grup sumber daya tempat scaling group yang baru dibuat akan ditempatkan.

    Catatan

    Scaling group yang baru dibuat ditambahkan ke grup sumber daya yang ditentukan. Jika Anda tidak menentukan parameter ini, scaling group ditambahkan ke grup sumber daya default.

    rg-123******
    LoadBalancerConfigs

    array<object>

    No

    Daftar konfigurasi load balancing.

    object

    No

    Daftar konfigurasi load balancing CLB (sebelumnya SLB).

    LoadBalancerId

    string

    No

    ID instans load balancing CLB (sebelumnya SLB).

    lb-2zen1olhfg9yw3f4q****
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Auto Scaling menambahkan instans ke grup server SLB. Bobot yang lebih tinggi menunjukkan bahwa instans menerima lebih banyak permintaan akses. Jika bobotnya 0, instans tidak menerima permintaan akses. Nilai yang valid: 0 hingga 100.

    10
    HealthCheckTypes

    array

    No

    Mode pemeriksaan kesehatan scaling group.

    Catatan

    Anda dapat mengatur beberapa nilai untuk parameter ini untuk mengaktifkan beberapa opsi pemeriksaan kesehatan. Jika parameter HealthCheckType diatur, parameter ini diabaikan.

    string

    No

    Daftar mode pemeriksaan kesehatan untuk scaling group. Nilai yang valid:

    • NONE: tidak ada pemeriksaan kesehatan yang dilakukan.

    • ECS: pemeriksaan kesehatan dilakukan pada instans di scaling group (nilai ini digunakan untuk scaling group jenis ECS maupun ECI untuk mengaktifkan pemeriksaan kesehatan instans).

    • LOAD_BALANCER: status kesehatan instans ditentukan berdasarkan hasil pemeriksaan kesehatan load balancing (jenis load balancing CLB tidak didukung)

    ECS
    DBInstances

    array<object>

    No

    Daftar database yang terkait dengan scaling group.

    object

    No

    Informasi konfigurasi database yang terkait dengan scaling group.

    DBInstanceId

    string

    No

    ID instans database.

    rm-m5eqju85s45mu0***
    Type

    string

    No

    Jenis database. Nilai yang valid:

    • RDS.

    • Redis.

    • MongoDB.

    Nilai default: RDS.

    RDS
    AttachMode

    string

    No

    Mode asosiasi antara scaling group dan database. Nilai yang valid:

    • SecurityIp: mode daftar putih IP. Alamat IP internal instans yang di-scale-out secara otomatis ditambahkan ke daftar putih IP database (saat ini hanya didukung untuk database RDS).

    • SecurityGroup: mode grup keamanan. Grup keamanan yang ditentukan dalam konfigurasi penskalaan ditambahkan ke daftar putih grup keamanan database, memungkinkan instans dalam grup keamanan mengakses database.

    SecurityIp
    StopInstanceTimeout

    integer

    No

    Periode waktu tunggu untuk menunggu instans ECS berhenti selama proses scale-in. Satuan: detik. Nilai yang valid: 30 hingga 240.

    Catatan

    • Parameter ini hanya berlaku selama proses scale-in ketika ScalingPolicy diatur ke release.

    • Jika parameter ini diatur, sistem menunggu hingga StopInstanceTimeout detik agar instans berhenti. Setelah waktu habis, proses scale-in berlanjut terlepas dari apakah instans telah berhenti.

    • Jika parameter ini tidak diatur, sistem menunggu tanpa batas waktu agar instans berhenti. Proses scale-in berlanjut hanya setelah instans berhenti. Jika instans gagal berhenti, proses scale-in dibatalkan dan scale-in gagal.

    60
    CapacityOptions

    object

    No

    Opsi kapasitas.

    OnDemandBaseCapacity

    integer

    No

    Jumlah minimum instans pay-as-you-go yang diperlukan dalam scaling group. Ketika jumlah instans pay-as-you-go kurang dari nilai ini, instans pay-as-you-go dibuat secara preferensial. Nilai yang valid: 0 hingga 1000.

    Ketika MultiAZPolicy diatur ke COMPOSABLE, nilai defaultnya adalah 0.

    30
    OnDemandPercentageAboveBaseCapacity

    integer

    No

    Persentase instans pay-as-you-go di antara instans berlebih setelah jumlah minimum instans pay-as-you-go (OnDemandBaseCapacity) terpenuhi. Nilai yang valid: 0.

    20
    CompensateWithOnDemand

    boolean

    No

    Saat MultiAZPolicy diatur ke COST_OPTIMIZED, menentukan apakah akan secara otomatis mencoba membuat instans pay-as-you-go untuk memenuhi persyaratan jumlah instans ECS ketika instans spot tidak dapat dibuat karena harga, inventaris, atau alasan lainnya. Nilai yang valid:

    • true: mengizinkan.

    • false: tidak mengizinkan.

    Nilai default: true.

    true
    SpotAutoReplaceOnDemand

    boolean

    No

    Ketika CompensateWithOnDemand diaktifkan, jika rasio pay-as-you-go melebihi rasio OnDemandPercentageAboveBaseCapacity, sistem akan mencoba menggunakan spot untuk menggantikan kapasitas pay-as-you-go. Skenario umum: CompensateWithOnDemand menyebabkan instans spot diturunkan ke instans pay-as-you-go karena inventaris spot atau alasan harga. Untuk menghindari instans pay-as-you-go bertahan lama, sistem mencoba menggunakan spot untuk menggantikan kapasitas pay-as-you-go berlebih. Nilai yang valid:

    • true: mengizinkan.

    • false: tidak mengizinkan.

    Nilai default: false.

    false
    PriceComparisonMode

    string

    No

    Mode perbandingan harga untuk strategi optimasi biaya scaling group. Nilai yang valid:

    • PricePerUnit: menggunakan harga per unit kapasitas untuk perbandingan.

      Ukuran kapasitas instans dalam scaling group sama dengan bobot yang ditetapkan untuk jenis instans, default-nya adalah 1, artinya satu ECS memiliki kapasitas 1.

    • PricePerVCpu: menggunakan harga per unit vCpu untuk perbandingan.

    Nilai default: PricePerUnit.

    PricePerUnit
    BalanceMode

    string

    No

    Mode penyeimbangan zona ketersediaan, hanya berlaku ketika mode penyeimbangan zona ketersediaan diaktifkan. Nilai yang valid:

    • BalancedBestEffort: Ketika pembuatan sumber daya di zona ketersediaan tertentu gagal, sistem akan diturunkan ke zona ketersediaan lain untuk menjamin pengiriman sumber daya secara upaya terbaik.

    • BalancedOnly: Ketika pembuatan sumber daya di zona ketersediaan tertentu gagal, sistem tidak akan diturunkan ke zona ketersediaan lain. Aktivitas scale-out berhasil sebagian untuk menghindari ketidakseimbangan sumber daya yang berlebihan di zona ketersediaan yang berbeda.

    Nilai default: BalancedBestEffort.

    BalancedBestEffort
    AutoRebalance

    boolean

    No

    Menentukan apakah akan mengaktifkan penyeimbangan ulang otomatis scaling group, hanya berlaku ketika scaling group zona ketersediaan seimbang mengaktifkan BalancedOnly. Nilai yang valid:

    • false: tidak mengaktifkan penyeimbangan ulang otomatis scaling group.

    • true: ketika penyeimbangan ulang otomatis scaling group diaktifkan, scaling group secara otomatis mendeteksi kapasitas antar zona ketersediaan. Ketika kapasitas zona ketersediaan tidak seimbang, sistem akan secara proaktif melakukan scale-out/scale-in zona ketersediaan untuk menyeimbangkan kembali kapasitas zona ketersediaan.

    Nilai default: false.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

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

    string

    ID scaling group.

    asg-bp14wlu85wrpchm0****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    404 ResourceNotAvailable.VPCNetwork The specified zone does not support vpc network or sold out.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.