All Products
Search

This Product

    Auto Scaling:CreateScalingGroup

    Document Center

    Auto Scaling:CreateScalingGroup

    Last Updated:Sep 17, 2026

    Membuat grup penskalaan untuk menyesuaikan kapasitas komputasi (jumlah instans) secara otomatis berdasarkan perubahan bisnis dan kebijakan jika Anda perlu menambah atau mengurangi jumlah instans dari tipe tertentu secara otomatis.

    Deskripsi operasi

    Grup penskalaan adalah kumpulan Instans ECS yang melayani skenario umum yang sama.

    Jumlah grup penskalaan yang dapat dibuat di suatu wilayah terkait dengan penggunaan Penyesuaian Skala Otomatis Anda. Buka Pusat Kuota untuk melihat nilai kuota untuk jumlah total grup penskalaan.

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

    Grup penskalaan, instans Classic Load Balancer (CLB, sebelumnya SLB) yang terkait, dan instans ApsaraDB RDS yang terkait harus berada di wilayah yang sama. Untuk informasi lebih lanjut, lihat Wilayah dan zona.

    Jika Anda mengaitkan instans CLB dengan grup penskalaan, grup penskalaan secara otomatis menambahkan Instans ECS yang bergabung ke kelompok server backend dari instans CLB. Anda dapat menentukan kelompok server tempat Instans ECS ditambahkan. Dua jenis kelompok server berikut didukung:

    • Kelompok server default: digunakan untuk menerima permintaan antarmuka depan. Jika tidak ada kelompok server virtual atau kelompok server utama/sekunder yang dikonfigurasi untuk pendengar, permintaan diteruskan ke instans ECS di kelompok server default secara default.

    • Kelompok layanan virtual: gunakan kelompok layanan virtual ketika Anda ingin meneruskan permintaan berbeda ke server backend berbeda, atau ketika Anda ingin meneruskan permintaan berdasarkan nama domain atau URL.

    Catatan

    Jika Anda menentukan baik kelompok server default maupun beberapa kelompok layanan virtual, instans ECS ditambahkan ke semua kelompok server tersebut.

    Setelah instans ditambahkan ke kelompok server backend dari instans CLB, bobot instans diatur ke 50 secara default. Instans CLB harus memenuhi kondisi berikut:

    • Instans CLB harus dalam status aktif. Anda dapat memanggil operasi DescribeLoadBalancers untuk mengkueri status instans CLB tertentu.

    • Pemeriksaan kesehatan harus diaktifkan untuk semua Port pendengar yang dikonfigurasi pada instans CLB. Jika tidak, pembuatan grup penskalaan akan gagal.

    Jika Anda mengaitkan kelompok server Application Load Balancer (ALB), kelompok server Network Load Balancer (NLB), atau kelompok server Gateway Load Balancer (GWLB) dengan grup penskalaan, grup penskalaan secara otomatis menambahkan instans ECS yang bergabung sebagai server backend dari kelompok server ALB, NLB, atau GWLB untuk memproses permintaan akses yang didistribusikan oleh instans ALB, NLB, atau GWLB. Anda dapat menentukan beberapa kelompok server ALB, NLB, atau GWLB, tetapi kelompok server harus berada di VPC yang sama dengan grup penskalaan. Untuk informasi lebih lanjut, lihat AttachAlbServerGroups atau AttachServerGroups.

    Jika Anda mengaitkan instans ApsaraDB RDS dengan grup penskalaan, grup penskalaan secara otomatis menambahkan alamat IP internal instans ECS yang bergabung ke daftar putih instans ApsaraDB RDS. Instans ApsaraDB RDS harus memenuhi kondisi berikut:

    • Instans ApsaraDB RDS harus dalam status Running. Anda dapat memanggil operasi DescribeDBInstances untuk mengkueri status instans ApsaraDB RDS tertentu.

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

    Jika MultiAZPolicy dari grup penskalaan diatur ke COST_OPTIMIZED:

    • Saat Anda menentukan parameter OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity, dan SpotInstancePools, metode alokasi instans di bawah kebijakan pengoptimalan biaya ditentukan, dan metode alokasi ini diprioritaskan selama event scale-out dan scale-in.

    • Saat Anda tidak menentukan parameter OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity, atau SpotInstancePools, kebijakan pengoptimalan biaya hanya membuat instans dengan cara yang paling hemat biaya. (Dalam mode ini, instans tidak dapat dibuat menggunakan jaminan elastisitas atau reservasi kapasitas. Parameter vSwitch dari pengontrol antarmuka jaringan (NIC) sekunder tidak didukung.)

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

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

    • Jika Anda menentukan tag instans dalam konfigurasi penskalaan dan memilih untuk menyebarkan tag grup penskalaan ke instans, semua tag akan hidup berdampingan.

    • Jika tag yang dapat disebarkan pada grup penskalaan dan tag dalam konfigurasi penskalaan memiliki kunci tag yang sama, nilai tag dalam konfigurasi penskalaan akan 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 grup penskalaan. Nama harus unik dalam satu wilayah.

    Panjang nama harus 2 hingga 64 karakter dan dapat berisi huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). Harus dimulai dengan angka, huruf, atau karakter Tionghoa.

    Nilai default: nilai ScalingGroupId.

    scalinggroup****
    LaunchTemplateId

    string

    No

    ID template peluncuran tempat grup penskalaan memperoleh informasi konfigurasi peluncuran.

    lt-m5e3ofjr1zn1aw7****
    LaunchTemplateVersion

    string

    No

    Versi template peluncuran. Nilai valid:

    • Nomor versi template tetap.

    • Default: selalu menggunakan versi template default.

    • Latest: selalu menggunakan versi template terbaru.

    Default
    InstanceId

    string

    No

    ID instans. Saat Anda membuat grup penskalaan, informasi konfigurasi yang diperlukan diperoleh dari instans tertentu, dan konfigurasi penskalaan dibuat secara otomatis.

    i-28wt4****
    RegionId

    string

    Yes

    ID wilayah grup penskalaan. Untuk informasi lebih lanjut, lihat Wilayah dan zona.

    cn-qingdao
    MinSize

    integer

    Yes

    Jumlah minimum instans dalam grup penskalaan. Ketika jumlah instans dalam grup penskalaan kurang dari nilai MinSize, Penyesuaian Skala Otomatis secara otomatis membuat instans.

    Catatan

    Nilai MinSize harus kurang dari atau sama dengan nilai MaxSize.

    2
    MaxSize

    integer

    Yes

    Jumlah maksimum instans dalam grup penskalaan. Ketika jumlah instans dalam grup penskalaan lebih besar dari nilai MaxSize, Penyesuaian Skala Otomatis secara otomatis menghapus instans.

    Nilai valid MaxSize terkait dengan penggunaan Penyesuaian Skala Otomatis Anda. Buka Pusat Kuota untuk melihat nilai kuota untuk Jumlah maksimum instans dalam grup penskalaan.

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

    20
    DefaultCooldown

    integer

    No

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

    Selama waktu pendinginan, grup penskalaan tidak menjalankan aktivitas penskalaan lainnya. Pembatasan ini hanya berlaku untuk aktivitas penskalaan yang dipicu oleh tugas yang dipicu event CloudMonitor.

    Nilai default: 300.

    300
    LoadBalancerIds

    string

    No

    ID instans CLB (sebelumnya SLB). Nilainya dapat berupa array JSON yang terdiri dari beberapa ID instans CLB. Pisahkan ID dengan koma (,).

    Jumlah total instans CLB yang dapat dikaitkan dengan satu grup penskalaan terkait dengan penggunaan Penyesuaian Skala Otomatis Anda. Buka Pusat Kuota untuk melihat nilai kuota untuk Jumlah total instans penyeimbang beban yang dapat dikaitkan dengan grup penskalaan.

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

    string

    No

    ID instans ApsaraDB RDS. Nilainya dapat berupa array JSON yang terdiri dari beberapa ID instans ApsaraDB RDS. Pisahkan ID dengan koma (,).

    Jumlah total instans ApsaraDB RDS yang dapat dikaitkan dengan satu grup penskalaan terkait dengan penggunaan Penyesuaian Skala Otomatis Anda. Buka Pusat Kuota untuk melihat nilai kuota untuk Jumlah total instans RDS yang dapat dikaitkan dengan grup penskalaan.

    ["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]
    RemovalPolicy.1

    string

    No

    Strategi filter putaran pertama untuk kebijakan scale-in. Parameter ini tidak boleh memiliki nilai yang sama dengan RemovalPolicy.2 atau RemovalPolicy.3. Nilai valid:

    • OldestInstance: menghapus Instance ECS yang paling awal ditambahkan ke grup penskalaan.

    • NewestInstance: menghapus Instance ECS yang paling baru ditambahkan ke grup penskalaan.

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

    • CustomPolicy: menghapus Instance ECS berdasarkan kebijakan scale-in kustom (Function).

    Konfigurasi penskalaan yang disebutkan dalam OldestScalingConfiguration merujuk pada sumber konfigurasi instans dalam grup penskalaan, termasuk konfigurasi penskalaan dan template peluncuran. CustomPolicy hanya dapat diatur sebagai kebijakan scale-in putaran pertama. Saat Anda menentukan CustomPolicy, Anda juga harus menentukan parameter CustomPolicyARN.

    Catatan

    Penghapusan Instance ECS dari grup penskalaan juga dipengaruhi oleh kebijakan penskalaan (MultiAZPolicy) dari grup penskalaan. Untuk informasi lebih lanjut, lihat Mengonfigurasi kebijakan kombinasi untuk menghapus instans.

    OldestScalingConfiguration
    RemovalPolicy.2

    string

    No

    Strategi filter putaran kedua untuk kebijakan scale-in. Parameter ini tidak boleh memiliki nilai yang sama dengan RemovalPolicy.1 atau RemovalPolicy.3. Nilai valid:

    • OldestInstance: menghapus Instance ECS yang paling awal ditambahkan ke grup penskalaan.

    • NewestInstance: menghapus Instance ECS yang paling baru ditambahkan ke grup penskalaan.

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

    Catatan

    Penghapusan Instance ECS dari grup penskalaan juga dipengaruhi oleh kebijakan penskalaan (MultiAZPolicy) dari grup penskalaan. Untuk informasi lebih lanjut, lihat Mengonfigurasi kebijakan kombinasi untuk menghapus instans.

    OldestInstance
    RemovalPolicy.3

    string

    No

    Strategi filter putaran ketiga untuk kebijakan scale-in. Parameter ini tidak boleh memiliki nilai yang sama dengan RemovalPolicy.1 atau RemovalPolicy.2. Nilai valid:

    • OldestInstance: menghapus Instance ECS yang paling awal ditambahkan ke grup penskalaan.

    • NewestInstance: menghapus Instance ECS yang paling baru ditambahkan ke grup penskalaan.

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

    Catatan

    Penghapusan Instance ECS dari grup penskalaan juga dipengaruhi oleh kebijakan penskalaan (MultiAZPolicy) dari grup penskalaan. Untuk informasi lebih lanjut, lihat Mengonfigurasi kebijakan kombinasi untuk menghapus instans.

    NewestInstance
    VSwitchId

    string

    No

    ID vSwitch. Jika Anda menentukan parameter ini, jenis jaringan grup penskalaan adalah VPC.

    Catatan

    Jika neither VSwitchId maupun VSwitchIds.N ditentukan untuk grup penskalaan, jenis jaringan grup penskalaan default ke jaringan klasik.

    vsw-bp14zolna43z266bq****
    MultiAZPolicy

    string

    No

    Kebijakan penskalaan untuk Instance ECS dalam grup penskalaan multi-zona. Nilai valid:

    • PRIORITY: vSwitch yang ditentukan pertama (VSwitchIds.N) memiliki prioritas tertinggi. Penyesuaian Skala Otomatis secara preferensial mencoba menskalakan instans di zona vSwitch dengan prioritas tertinggi. Jika penskalaan tidak dapat diselesaikan, Penyesuaian Skala Otomatis secara otomatis mencoba menskalakan instans di zona vSwitch dengan prioritas berikutnya.

    • COST_OPTIMIZED: selama event scale-out, Penyesuaian Skala Otomatis mencoba membuat Instance ECS dalam urutan menaik harga satuan vCPU. Selama event scale-in, Penyesuaian Skala Otomatis mencoba menghapus Instance ECS dalam urutan menurun harga satuan vCPU. Jika konfigurasi penskalaan menentukan metode penagihan spot dengan beberapa tipe instans, spot instans diprioritaskan untuk dibuat. Anda dapat menggunakan parameter CompensateWithOnDemand untuk menentukan apakah akan secara otomatis membuat instans pay-as-you-go ketika spot instans tidak dapat dibuat karena persediaan tidak mencukupi atau alasan lainnya.

      Catatan

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

    • BALANCE: Instance ECS dialokasikan secara merata di seluruh beberapa zona yang ditentukan untuk grup penskalaan. Jika instans menjadi tidak seimbang di seluruh zona karena persediaan tidak mencukupi atau alasan lainnya, Anda dapat memanggil operasi RebalanceInstance untuk menyeimbangkan ulang Sumber daya.

    • COMPOSABLE: adalah kebijakan komposabel yang memungkinkan Anda menggabungkan kebijakan penskalaan multi-zona sebelumnya untuk Instance ECS. Anda juga dapat menentukan parameter tambahan untuk kontrol yang lebih terperinci atas kapasitas grup penskalaan.

    Nilai default: PRIORITY.

    PRIORITY
    HealthCheckType

    string

    No

    Mode pemeriksaan kesehatan grup penskalaan. Nilai valid:

    • NONE: tidak ada pemeriksaan kesehatan yang dilakukan.

    • ECS: pemeriksaan kesehatan dilakukan pada instans dalam grup penskalaan. (Baik grup penskalaan tipe ECS maupun tipe ECI menggunakan nilai ini untuk mengaktifkan pemeriksaan kesehatan instans.)

    • LOAD_BALANCER: status kesehatan instans ditentukan berdasarkan hasil pemeriksaan kesehatan penyeimbang beban. (Penyeimbangan beban tipe CLB tidak didukung.)

    Nilai default: ECS.

    Catatan

    Untuk mengaktifkan baik pemeriksaan kesehatan instans maupun pemeriksaan kesehatan penyeimbang beban, gunakan parameter HealthCheckTypes.

    ECS
    ScalingPolicy

    string

    No

    Mode reklamasi grup penskalaan. Nilai valid:

    • recycle: grup penskalaan menggunakan mode shutdown dan reklamasi.

    • release: grup penskalaan menggunakan mode rilis.

    • forcerelease: grup penskalaan menggunakan mode rilis paksa.

      Catatan

      Jika Anda memilih forcerelease, instans yang berjalan dilepaskan secara paksa selama aktivitas scale-in. Rilis paksa setara dengan operasi mematikan daya, yang menghapus data sementara di memori dan penyimpanan instans. Data tidak dapat dipulihkan. Lanjutkan dengan hati-hati.

    • forcerecycle: grup penskalaan menggunakan mode shutdown paksa dan reklamasi.

      Catatan

      Jika Anda memilih forcerecycle, instans yang berjalan dimatikan secara paksa selama aktivitas scale-in. Shutdown 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 grup penskalaan. Namun, aksi spesifik yang diambil saat instans dihapus dari grup penskalaan ditentukan oleh parameter RemovePolicy dari RemoveInstances. Untuk informasi lebih lanjut, lihat RemoveInstances.

    recycle
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Hasilkan nilai dari klien Anda yang unik di antara permintaan berbeda. Nilai hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

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

    integer

    No

    Jumlah minimum instans pay-as-you-go yang diperlukan dalam grup penskalaan. Nilai valid: 0 hingga 1000. Ketika jumlah instans pay-as-you-go kurang dari nilai ini, instans pay-as-you-go diprioritaskan untuk dibuat.

    Ketika parameter MultiAZPolicy diatur ke COMPOSABLE, nilai default 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 valid: 0 hingga 100.

    Ketika parameter MultiAZPolicy diatur ke COMPOSABLE, nilai default adalah 100.

    20
    SpotInstanceRemedy

    boolean

    No

    Apakah akan melengkapi spot instans. Jika fitur ini diaktifkan, Penyesuaian Skala Otomatis mencoba membuat instans baru untuk menggantikan spot instans ketika sistem mengirimkan notifikasi bahwa spot instans akan direklamasi.

    true
    CompensateWithOnDemand

    boolean

    No

    Apakah akan secara otomatis membuat instans pay-as-you-go untuk memenuhi jumlah Instance ECS yang diperlukan ketika spot instans tidak dapat dibuat karena alasan harga atau persediaan. Parameter ini hanya berlaku ketika MultiAZPolicy diatur ke COST_OPTIMIZED. Nilai valid:

    • true: mengizinkan pembuatan otomatis.

    • false: tidak mengizinkan pembuatan otomatis.

    Nilai default: true.

    true
    SpotInstancePools

    integer

    No

    Jumlah tipe instans yang tersedia. Penyesuaian Skala Otomatis secara merata membuat spot instans dari beberapa tipe yang menawarkan biaya terendah. Nilai valid: 1 hingga 10.

    Ketika parameter MultiAZPolicy diatur ke COMPOSABLE, nilai default adalah 2.

    5
    DesiredCapacity

    integer

    No

    Jumlah instans yang diharapkan dalam grup penskalaan. Grup penskalaan secara otomatis mempertahankan jumlah Instance ECS pada jumlah instans yang diharapkan. Nilai tidak boleh lebih besar dari MaxSize atau kurang dari MinSize.

    5
    GroupDeletionProtection

    boolean

    No

    Apakah akan mengaktifkan perlindungan penghapusan untuk grup penskalaan. Nilai valid:

    • true: mengaktifkan perlindungan penghapusan. Grup penskalaan tidak dapat dihapus.

    • false: menonaktifkan perlindungan penghapusan.

    Nilai default: false.

    true
    GroupType

    string

    No

    Tipe instans yang dikelola oleh grup penskalaan. Nilai valid:

    • ECS: grup penskalaan mengelola Instance ECS.

    • ECI: grup penskalaan mengelola instans Elastic Container Instance (ECI).

    Nilai default: ECS.

    ECS
    ContainerGroupId

    string

    No

    ID instans dari instans ECI, yaitu ID kelompok kontainer.

    eci-uf6fonnghi50u374****
    VSwitchIds

    array

    No

    ID satu atau beberapa vSwitch. Jika Anda menentukan parameter VSwitchIds, parameter VSwitchId diabaikan. Jika Anda menentukan parameter ini, jenis jaringan grup penskalaan adalah VPC.

    Saat Anda menentukan beberapa vSwitch:

    • vSwitch harus berada di VPC yang sama.

    • vSwitch dapat berada di zona berbeda.

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

    Catatan

    Jika neither VSwitchId maupun VSwitchIds ditentukan untuk grup penskalaan, jenis jaringan grup penskalaan default ke jaringan klasik.

    vsw-bp14zolna43z266bq****

    string

    No

    ID satu atau beberapa vSwitch. Jika Anda menentukan parameter VSwitchIds.N, parameter VSwitchId diabaikan. Jika Anda menentukan parameter ini, jenis jaringan grup penskalaan adalah VPC.

    Saat Anda menentukan beberapa vSwitch:

    • vSwitch harus berada di VPC yang sama.

    • vSwitch dapat berada di zona berbeda.

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

    Catatan

    Jika neither VSwitchId maupun VSwitchIds.N ditentukan untuk grup penskalaan, jenis jaringan grup penskalaan default ke jaringan klasik.

    vsw-bp14zolna43z266bq****
    LifecycleHook

    array<object>

    No

    Informasi kait siklus hidup.

    object

    No

    Informasi kait siklus hidup.

    DefaultResult

    string

    No

    Aksi yang diambil setelah keadaan tunggu berakhir. Nilai valid:

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

    • ABANDON: melepaskan Instance ECS yang dibuat selama event scale-out, atau langsung menghapus Instance ECS dari grup penskalaan selama event scale-in.

    Ketika event scale-in (SCALE_IN) terjadi di grup penskalaan dan memicu beberapa panggilan balik siklus hidup, jika keadaan tunggu panggilan balik siklus hidup dengan DefaultResult diatur ke ABANDON berakhir, keadaan tunggu panggilan balik siklus hidup lainnya berakhir lebih awal. Dalam kasus lain, aksi ditentukan oleh panggilan balik siklus hidup terakhir yang keadaan tunggunya berakhir.

    Nilai default: CONTINUE.

    CONTINUE
    LifecycleHookName

    string

    No

    Nama panggilan balik siklus hidup. Setelah nama ditentukan, nama tidak dapat diubah. Jika tidak ditentukan, nama default ke ID panggilan balik siklus hidup.

    kait-siklus-hidup****
    LifecycleTransition

    string

    No

    Tipe aktivitas penskalaan yang diterapkan oleh panggilan balik siklus hidup. Nilai valid:

    • SCALE_OUT: event scale-out dari grup penskalaan.

    • SCALE_IN: event scale-in dari grup penskalaan.

    Catatan

    Jika panggilan balik siklus hidup ditentukan untuk grup penskalaan, parameter ini wajib. Parameter terkait lainnya bersifat opsional.

    SCALE_OUT
    NotificationMetadata

    string

    No

    Informasi string tetap untuk keadaan tunggu aktivitas penskalaan. Panjang nilai parameter tidak boleh melebihi 128 karakter. Setiap kali Penyesuaian Skala Otomatis mendorong paket ke Penerima Notifikasi, ia juga mengirimkan nilai parameter NotificationMetadata yang Anda tentukan, yang membantu Anda mengelola dan menandai kategori informasi notifikasi berbeda. Parameter ini hanya berlaku ketika parameter NotificationArn juga ditentukan.

    Test
    NotificationArn

    string

    No

    Pengidentifikasi Penerima Notifikasi untuk panggilan balik siklus hidup. Tipe objek notifikasi berikut didukung: Antrian Pesan Simple (sebelumnya MNS) dan topik. Tentukan nilai parameter dalam format berikut: acs:ess:{region}:{account-id}:{resource-relative-id}.

    • region: wilayah tempat grup penskalaan berada.

    • account-id: ID akun Alibaba Cloud.

    Contoh:

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

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

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

    integer

    No

    Waktu tunggu yang diatur oleh panggilan balik siklus hidup untuk aktivitas grup penskalaan. Aksi berikutnya dilakukan setelah waktu tunggu habis. Nilai valid: 30 hingga 21600. Unit: detik.

    Setelah panggilan balik siklus hidup dibuat, Anda dapat memanggil RecordLifecycleActionHeartbeat untuk memperpanjang waktu tunggu Instance ECS, atau memanggil CompleteLifecycleAction untuk mengakhiri keadaan tunggu aktivitas penskalaan lebih awal.

    Nilai default: 600.

    600
    VServerGroup

    array<object>

    No

    Informasi tentang kelompok layanan virtual yang dikaitkan dengan grup penskalaan.

    array<object>

    No

    Informasi tentang kelompok layanan virtual yang dikaitkan dengan grup penskalaan.

    VServerGroupAttribute

    array<object>

    No

    Atribut kelompok server backend.

    object

    No

    Atribut kelompok server backend.

    VServerGroupId

    string

    No

    ID kelompok layanan virtual.

    Untuk informasi lebih lanjut, lihat AttachVServerGroups.

    rsp-bp1443g77****
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Penyesuaian Skala Otomatis menambahkan instans ke kelompok layanan virtual. Bobot lebih tinggi menunjukkan bahwa instans dialokasikan lebih banyak permintaan akses. Jika bobot adalah 0, instans tidak menerima permintaan akses. Nilai valid: 0 hingga 100. Nilai default: 50.

    Untuk informasi lebih lanjut, lihat AttachVServerGroups.

    100
    Port

    integer

    No

    Nomor Port yang digunakan oleh instans setelah Penyesuaian Skala Otomatis menambahkan instans ke kelompok layanan virtual. Nilai valid: 1 hingga 65535.

    Untuk informasi lebih lanjut, lihat AttachVServerGroups.

    22
    LoadBalancerId

    string

    No

    ID instans CLB (sebelumnya SLB) tempat kelompok layanan virtual berada.

    Untuk informasi lebih lanjut, lihat AttachVServerGroups.

    lb-bp1u7etiogg38yvwz****
    Tag

    array<object>

    No

    Tag grup penskalaan.

    object

    No

    Tag grup penskalaan.

    Key

    string

    No

    Kunci tag grup penskalaan.

    Department
    Value

    string

    No

    Nilai tag grup penskalaan.

    Finance
    Propagate

    boolean

    No

    Apakah tag adalah tag yang dapat disebarkan. Nilai valid:

    • true: Tag pada grup penskalaan hanya disebarkan ke instans yang baru dibuat, bukan ke instans yang sudah berjalan di grup penskalaan.

    • false: Tag pada grup penskalaan tidak disebarkan ke instans.

    Nilai default: false.

    false
    LaunchTemplateOverride

    array<object>

    No

    Informasi override template peluncuran.

    object

    No

    Informasi override template peluncuran.

    InstanceType

    string

    No

    Untuk menskalakan grup penskalaan berdasarkan kapasitas tipe instans, tentukan baik parameter ini maupun LaunchTemplateOverride.N.WeightedCapacity.

    Parameter ini menentukan tipe instans dan mengoverride tipe instans dalam template peluncuran. Anda dapat menentukan N nilai untuk parameter ini untuk memperluas template peluncuran agar mendukung N tipe instans. Nilai valid N: 1 hingga 20.

    Catatan

    Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.

    Nilai valid InstanceType: Tipe instans ECS yang tersedia untuk dibeli. Untuk informasi lebih lanjut, lihat Keluarga instans.

    ecs.c5.xlarge
    WeightedCapacity

    integer

    No

    Untuk menskalakan grup penskalaan berdasarkan kapasitas tipe instans, tentukan parameter ini setelah Anda menentukan LaunchTemplateOverride.N.InstanceType. Kedua parameter saling berkaitan, dan N harus konsisten.

    Parameter ini menentukan bobot tipe instans, yang mewakili kapasitas satu instans dari tipe ini dalam grup penskalaan. Bobot lebih besar berarti lebih sedikit instans dari tipe ini yang diperlukan untuk memenuhi kapasitas yang diharapkan.

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

    Contoh:

    • Kapasitas saat ini: 0.

    • Kapasitas yang diharapkan: 6.

    • Kapasitas ecs.c5.xlarge: 4.

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

    Catatan

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

    Nilai valid WeightedCapacity: 1 hingga 500.

    4
    SpotPriceLimit

    number

    No

    Harga tawaran maksimum untuk tipe instans yang ditentukan oleh LaunchTemplateOverride.N.InstanceType. Anda dapat menentukan N nilai untuk parameter ini untuk memperluas template peluncuran agar mendukung N tipe instans. Nilai valid N: 1 hingga 20.

    Catatan

    Parameter ini hanya berlaku ketika parameter LaunchTemplateId menentukan template peluncuran.

    0.025
    AlbServerGroup

    array<object>

    No

    Informasi tentang grup server ALB.

    object

    No

    Informasi tentang grup server ALB.

    AlbServerGroupId

    string

    No

    ID grup server ALB.

    N menunjukkan nomor urut grup server ALB. Jumlah grup server ALB yang dapat dikaitkan dengan sebuah grup penskalaan memiliki batas. Untuk melihat atau meminta peningkatan kuota, buka Pusat Kuota.

    sgp-ddwb0y0g6y9bjm****
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Penyesuaian Skala Otomatis menambahkan instans ke grup server ALB. Bobot yang lebih tinggi menunjukkan bahwa instans menerima lebih banyak permintaan. Jika bobot adalah 0, instans tidak menerima permintaan apa pun. Nilai valid: 0 hingga 100.

    N menunjukkan nomor urut grup server ALB.

    100
    Port

    integer

    No

    Nomor Port yang digunakan oleh instans setelah Penyesuaian Skala Otomatis menambahkan instans ke grup server ALB. Nilai valid: 1 hingga 65535.

    N menunjukkan nomor urut grup server ALB.

    Catatan

    Jika nilai N sama tetapi nilai Port berbeda, sistem akan mengaitkan grup server ALB dengan grup penskalaan beberapa kali dengan Port yang berbeda.

    22
    ServerGroup

    array<object>

    No

    Informasi tentang grup server load balancing.

    Catatan

    Anda tidak dapat menetapkan 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

    Tipe grup server. Nilai 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 Penyesuaian Skala Otomatis menambahkan instans ke grup server. Nilai valid: 0 hingga 100.

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

    Catatan

    Parameter ini wajib diisi untuk grup server load balancing ALB dan NLB. Anda tidak dapat menetapkan parameter ini untuk grup server load balancing GWLB.

    100
    Port

    integer

    No

    Nomor Port yang digunakan oleh instans setelah Penyesuaian Skala Otomatis menambahkan instans ke grup server. Nilai valid: 1 hingga 65535.

    Catatan

    Parameter ini wajib diisi untuk grup server load balancing ALB dan NLB. Anda tidak dapat menetapkan parameter ini untuk grup server load balancing GWLB. Nilai default untuk GWLB adalah 6081.

    22
    AzBalance

    boolean

    No

    Apakah akan mendistribusikan kapasitas grup penskalaan secara merata di beberapa zona. Parameter ini hanya berlaku jika MultiAZPolicy diatur ke COMPOSABLE. Nilai valid:

    • true: Kapasitas grup penskalaan didistribusikan secara merata di beberapa zona.

    • false: Kapasitas grup penskalaan tidak didistribusikan secara merata di beberapa zona.

    Nilai default: false.

    false
    AllocationStrategy

    string

    No

    Strategi alokasi kapasitas yang menentukan bagaimana grup penskalaan memilih tipe instans yang tersedia untuk memenuhi persyaratan kapasitas. Strategi alokasi kapasitas berlaku untuk kapasitas pay-as-you-go maupun spot. Parameter ini hanya berlaku jika MultiAZPolicy diatur ke COMPOSABLE. Nilai valid:

    • priority: Instans dibuat berdasarkan urutan tipe instans yang dikonfigurasi.

    • lowestPrice: Instans dibuat berdasarkan harga vCPU per unit dari tipe instans dalam urutan menaik.

    Nilai default: priority.

    priority
    SpotAllocationStrategy

    string

    No

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

    • priority: Instans dibuat berdasarkan urutan tipe instans yang dikonfigurasi.

    • lowestPrice: Instans dibuat berdasarkan harga vCPU per unit dari tipe instans dalam urutan menaik.

    Nilai default: priority.

    lowestPrice
    MaxInstanceLifetime

    integer

    No

    Durasi maksimum sebuah instans dapat berada di dalam grup penskalaan. Unit: detik.

    Nilai valid: [86400, Integer.maxValue].

    Nilai default: null.

    Catatan

    Parameter ini tidak didukung untuk grup penskalaan bertipe Elastic Container Instance (ECI) atau grup penskalaan dengan mode hemat diaktifkan.

    86400
    CustomPolicyARN

    string

    No

    Alibaba Cloud Resource Name (ARN) dari fungsi kebijakan scale-in kustom China. Parameter ini hanya berlaku jika 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 kelompok sumber daya tempat grup penskalaan berada.

    Catatan

    Grup penskalaan yang baru dibuat akan ditambahkan ke kelompok sumber daya yang ditentukan. Jika Anda tidak menentukan parameter ini, grup penskalaan akan ditambahkan ke kelompok sumber daya default.

    rg-123****
    LoadBalancerConfig

    array<object>

    No

    Konfigurasi instans Classic Load Balancer (CLB, sebelumnya SLB).

    object

    No

    Konfigurasi instans Classic Load Balancer (CLB, sebelumnya SLB).

    LoadBalancerId

    string

    No

    ID instans Classic Load Balancer (CLB, sebelumnya SLB).

    147b46d767c-cn-qingdao-cm5****
    Weight

    integer

    No

    Bobot instans sebagai server backend setelah Penyesuaian Skala Otomatis menambahkan instans ke grup server CLB (sebelumnya SLB). Bobot yang lebih tinggi menunjukkan bahwa instans dialokasikan lebih banyak permintaan akses. Jika bobot adalah 0, instans tidak menerima permintaan akses.

    Nilai valid: 0 hingga 100.

    10
    HealthCheckTypes

    array

    No

    Mode pemeriksaan kesehatan grup penskalaan.

    Catatan

    Anda dapat menggunakan parameter ini untuk menentukan beberapa mode pemeriksaan kesehatan. Jika parameter HealthCheckType ditentukan, parameter ini akan diabaikan.

    string

    No

    Mode pemeriksaan kesehatan grup penskalaan. Nilai valid:

    • NONE: Pemeriksaan kesehatan dinonaktifkan.

    • ECS: Pemeriksaan kesehatan dilakukan pada instans di dalam grup penskalaan. Nilai ini berlaku untuk grup penskalaan bertipe ECS maupun ECI.

    • LOAD_BALANCER: Status kesehatan instans ditentukan berdasarkan hasil pemeriksaan kesehatan load balancing. Load balancing tipe CLB tidak didukung.

    Nilai default: ECS.

    ECS
    DBInstance

    array<object>

    No

    Database yang dikaitkan dengan grup penskalaan.

    object

    No

    Konfigurasi database yang dikaitkan dengan grup penskalaan.

    DBInstanceId

    string

    No

    ID instans database.

    rm-m5eqju85s45mu0***
    Type

    string

    No

    Tipe database. Nilai valid:

    • RDS.

    • Redis.

    • MongoDB.

    Nilai default: RDS.

    RDS
    AttachMode

    string

    No

    Mode pengaitan grup penskalaan dengan database. Nilai valid:

    • SecurityIp: Mode daftar putih IP. Instans yang ditambahkan selama event scale-out otomatis ditambahkan ke daftar putih IP database. Hanya database RDS yang didukung.

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

    SecurityIp
    StopInstanceTimeout

    integer

    No

    Periode waktu tunggu untuk menghentikan Instance ECS selama proses scale-in. Unit: detik. Nilai valid: 30 hingga 240.

    Catatan

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

    • Jika parameter ini ditentukan, sistem akan menunggu hingga periode StopInstanceTimeout agar instans berhenti. Setelah waktu habis, proses scale-in berlanjut terlepas dari apakah instans telah berhenti atau belum.

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

    60
    CapacityOptions

    object

    No

    Opsi kapasitas.

    OnDemandBaseCapacity

    integer

    No

    Jumlah minimum instans pay-as-you-go yang diperlukan di dalam grup penskalaan. Jika jumlah instans pay-as-you-go di dalam grup penskalaan kurang dari nilai ini, sistem akan memprioritaskan pembuatan instans pay-as-you-go. Nilai valid: 0 hingga 1000.

    Ketika MultiAZPolicy diatur ke COMPOSABLE, nilai default adalah 0.

    30
    OnDemandPercentageAboveBaseCapacity

    integer

    No

    Persentase instans pay-as-you-go di antara instans tambahan yang melebihi nilai OnDemandBaseCapacity. Nilai valid: 0 hingga 100.

    Ketika MultiAZPolicy diatur ke COMPOSABLE, nilai default adalah 100.

    20
    CompensateWithOnDemand

    boolean

    No

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

    • true: Mengizinkan pembuatan otomatis.

    • false: Tidak mengizinkan pembuatan otomatis.

    Nilai default: true.

    true
    SpotAutoReplaceOnDemand

    boolean

    No

    Apakah akan menggunakan spot instans untuk menggantikan instans pay-as-you-go ketika rasio pay-as-you-go melebihi nilai OnDemandPercentageAboveBaseCapacity setelah CompensateWithOnDemand diaktifkan. Skenario umum adalah ketika spot instans diturunkan menjadi instans pay-as-you-go karena masalah inventaris spot atau harga yang disebabkan oleh CompensateWithOnDemand. Untuk mencegah instans pay-as-you-go bertahan dalam jangka waktu lama, sistem akan mencoba mengganti kapasitas pay-as-you-go berlebih dengan spot instans. Nilai valid:

    • true: Diizinkan.

    • false: Tidak diizinkan.

    Nilai default: false.

    false
    PriceComparisonMode

    string

    No

    Mode perbandingan harga untuk strategi optimasi biaya grup penskalaan. Nilai valid:

    • PricePerUnit: Membandingkan harga berdasarkan harga per unit kapasitas.

      Kapasitas sebuah instans di dalam grup penskalaan sama dengan bobot yang dikonfigurasi untuk tipe instans tersebut. Bobot default adalah 1, yang berarti satu Instance ECS menempati kapasitas sebesar 1.

    • PricePerVCpu: Membandingkan harga berdasarkan harga per vCPU.

    Nilai default: PricePerUnit.

    PricePerUnit
    BalanceMode

    string

    No

    Mode keseimbangan zona. Parameter ini hanya berlaku jika penyeimbangan zona diaktifkan. Nilai valid:

    • BalancedBestEffort: Jika pembuatan Sumber daya gagal di sebuah zona, sistem akan beralih ke zona lain untuk memastikan pengiriman Sumber daya dengan upaya terbaik.

    • BalancedOnly: Jika pembuatan Sumber daya gagal di sebuah zona, sistem tidak akan beralih ke zona lain. Aktivitas penskalaan berhasil sebagian untuk mencegah ketidakseimbangan Sumber daya yang berlebihan antarzona.

    Nilai default: BalancedBestEffort.

    BalancedBestEffort
    AutoRebalance

    boolean

    No

    Apakah akan mengaktifkan penyeimbangan ulang otomatis untuk grup penskalaan. Parameter ini hanya berlaku jika BalancedOnly diaktifkan untuk grup penskalaan yang seimbang secara zona. Nilai valid:

    • false: Penyeimbangan ulang otomatis dinonaktifkan.

    • true: Ketika penyeimbangan ulang otomatis diaktifkan, grup penskalaan secara otomatis memantau kapasitas di seluruh zona. Jika kapasitas tidak seimbang di seluruh zona, grup penskalaan secara proaktif melakukan operasi scale-out dan scale-in untuk menyeimbangkan kembali kapasitas.

    Nilai default: false.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

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

    string

    ID grup penskalaan.

    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.