All Products
Search

This Product

    Auto Scaling:CreateScalingRule

    Document Center

    Auto Scaling:CreateScalingRule

    Last Updated:Sep 17, 2026

    Membuat aturan penskalaan.

    Deskripsi operasi

    Deskripsi operasi

    Perhatikan informasi berikut mengenai parameter:

    • Jika AdjustmentType diatur ke TotalCapacity, jumlah Instance ECS atau ECI dalam grup penskalaan saat ini disesuaikan ke nilai yang ditentukan. AdjustmentValue yang sesuai harus lebih besar dari atau sama dengan 0.

    • Jika AdjustmentType diatur ke QuantityChangeInCapacity atau PercentChangeInCapacity, AdjustmentValue positif menunjukkan Instance ECS ditambahkan, dan nilai negatif menunjukkan Instance ECS dihapus.

    • Jika AdjustmentType diatur ke PercentChangeInCapacity, Penyesuaian Skala Otomatis menghitung jumlah Instance ECS atau ECI yang akan ditambahkan atau dihapus dengan menggunakan rumus berikut: Jumlah Instans saat ini dalam grup penskalaan (Total Capacity) × AdjustmentValue/100. Hasilnya dibulatkan ke bilangan bulat terdekat.

    • Jika waktu pendinginan (Cooldown) ditentukan dalam aturan penskalaan, waktu pendinginan yang ditentukan dalam aturan penskalaan berlaku setelah aktivitas penskalaan yang dipicu oleh aturan penskalaan selesai. Jika tidak ada waktu pendinginan yang ditentukan dalam aturan penskalaan, waktu pendinginan yang ditentukan untuk grup penskalaan (DefaultCooldown) berlaku.

    • Jumlah aturan penskalaan yang dapat dibuat dalam sebuah grup penskalaan dibatasi. Untuk informasi selengkapnya, lihat Batas.

    • Pengenal unik aturan penskalaan (ScalingRuleAri) yang dikembalikan dapat digunakan dalam operasi berikut:

      • Anda dapat menentukan parameter ScalingRuleAri saat memanggil operasi ExecuteScalingRule untuk menjalankan aturan penskalaan secara manual.

      • Anda dapat menentukan parameter ScheduledAction saat memanggil operasi CreateScheduledTask untuk menjalankan aturan penskalaan sesuai jadwal.

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

    create

    *ScalingGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupId

    string

    Yes

    ID grup penskalaan tempat aturan penskalaan berada.

    asg-bp1ffogfdauy0jw0****
    ScalingRuleName

    string

    No

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

    Nama aturan penskalaan harus unik dalam wilayah dan grup penskalaan yang sama di bawah akun yang sama.

    Catatan

    Jika Anda tidak menentukan parameter ini, nilai ScalingRuleId digunakan secara default.

    scalingrule****
    Cooldown

    integer

    No

    Waktu pendinginan aturan penskalaan. Parameter ini hanya berlaku untuk aturan skalabilitas sederhana. Nilai valid: 0 hingga 86400. Unit: seconds.

    Nilai default: kosong.

    60
    MinAdjustmentMagnitude

    integer

    No

    Jumlah minimum Instans yang akan disesuaikan dalam aturan penskalaan. Parameter ini hanya berlaku ketika tipe aturan penskalaan adalah SimpleScalingRule atau StepScalingRule dan AdjustmentType diatur ke PercentChangeInCapacity.

    1
    AdjustmentType

    string

    No

    Metode penyesuaian aturan penskalaan. Parameter ini berlaku untuk aturan skalabilitas sederhana dan aturan penskalaan bertahap, dan wajib diisi dalam kasus ini. Nilai valid:

    • QuantityChangeInCapacity: menambahkan atau menghapus sejumlah Instance ECS yang ditentukan.

    • PercentChangeInCapacity: menambahkan atau menghapus persentase Instance ECS yang ditentukan.

    • TotalCapacity: menyesuaikan jumlah Instance ECS dalam grup penskalaan saat ini ke nilai yang ditentukan.

    QuantityChangeInCapacity
    AdjustmentValue

    integer

    No

    Nilai penyesuaian aturan penskalaan. Parameter ini berlaku untuk aturan skalabilitas sederhana dan aturan penskalaan bertahap, dan wajib diisi dalam kasus ini. Jumlah Instance ECS yang disesuaikan dalam satu aktivitas penskalaan tidak boleh melebihi 1.000. Nilai valid bervariasi berdasarkan metode penyesuaian:

    • QuantityChangeInCapacity: -1000 hingga 1000.

    • PercentChangeInCapacity: -100 hingga 10000.

    • TotalCapacity: 0 hingga 2000.

    100
    ScalingRuleType

    string

    No

    Tipe aturan penskalaan. Nilai valid:

    • SimpleScalingRule: skalabilitas sederhana. Menyesuaikan jumlah Instance ECS atau ECI berdasarkan metode penyesuaian (AdjustmentType) dan nilai penyesuaian (AdjustmentValue).

    • TargetTrackingScalingRule: aturan penskalaan pelacakan target. Menghitung secara dinamis jumlah Instance ECS atau ECI yang akan diskalakan berdasarkan data deret waktu Pemantauan yang telah ditentukan sebelumnya (MetricName) dan berupaya menjaga nilai data deret waktu Pemantauan mendekati nilai target (TargetValue).

    • StepScalingRule: aturan penskalaan bertahap. Menyediakan ekstensi berbasis langkah berdasarkan ambang batas dan nilai data deret waktu.

    • PredictiveScalingRule: aturan penskalaan prediktif. Menggunakan pembelajaran mesin untuk menganalisis data Pemantauan historis grup penskalaan, memprediksi nilai data deret waktu Pemantauan di masa depan, dan mendukung pembuatan otomatis Tugas terjadwal untuk menetapkan batas grup penskalaan.

    Nilai default: SimpleScalingRule.

    SimpleScalingRule
    EstimatedInstanceWarmup

    integer

    No

    Periode pemanasan Instans. Parameter ini berlaku untuk aturan penskalaan pelacakan target dan aturan penskalaan bertahap. Instance ECS dalam status pemanasan ditambahkan ke grup penskalaan sesuai harapan, tetapi tidak melaporkan data Pemantauan ke CloudMonitor selama periode pemanasan.

    Catatan

    Ketika jumlah Instance ECS yang akan diskalakan dihitung secara dinamis, Instans dalam status pemanasan tidak dihitung ke dalam jumlah Instans saat ini.

    Nilai valid: 0 hingga 86400. Unit: seconds.

    Nilai default: 300.

    300
    MetricName

    string

    No

    Data deret waktu yang telah ditentukan sebelumnya. Parameter ini berlaku untuk aturan penskalaan pelacakan target dan aturan penskalaan prediktif, dan wajib diisi dalam kasus ini.

    Nilai valid untuk aturan penskalaan pelacakan target:

    • CpuUtilizationAgent: (Agen) utilisasi CPU (direkomendasikan).

    • MemoryUtilization: (Agen) utilisasi memori (direkomendasikan).

    • CpuUtilization: (ECS) utilisasi CPU rata-rata.

    • IntranetTx: (ECS) lalu lintas keluar rata-rata melalui jaringan internal.

    • IntranetRx: (ECS) lalu lintas masuk rata-rata melalui jaringan internal.

    • VpcInternetTx: (ECS) lalu lintas keluar rata-rata melalui Internet.

    • VpcInternetRx: (ECS) lalu lintas masuk rata-rata melalui Internet.

    • LoadBalancerRealServerAverageQps: (ALB) QPS rata-rata per server dalam kelompok server.

    Nilai valid untuk aturan penskalaan prediktif:

    • CpuUtilization: (ECS) utilisasi CPU rata-rata.

    • IntranetRx: (ECS) lalu lintas masuk rata-rata melalui jaringan internal.

    • IntranetTx: (ECS) lalu lintas keluar rata-rata melalui jaringan internal.

    Untuk informasi selengkapnya, lihat Tugas Pemicu event untuk Pemantauan sistem.

    CpuUtilization
    TargetValue

    number

    No

    Nilai target. Parameter ini berlaku untuk aturan penskalaan pelacakan target dan aturan penskalaan prediktif, dan wajib diisi dalam kasus ini. Nilai TargetValue dapat memiliki hingga tiga tempat desimal dan harus lebih besar dari 0.

    0.125
    DisableScaleIn

    boolean

    No

    Apakah akan menonaktifkan scale-in. Parameter ini hanya berlaku untuk aturan penskalaan pelacakan target.

    Nilai default: false.

    false
    ScaleInEvaluationCount

    integer

    No

    Setelah aturan penskalaan pelacakan target dibuat, Tugas Pemicu event dibuat secara otomatis. Parameter ini menentukan jumlah kali berturut-turut ambang batas bersyarat harus dipenuhi sebelum Tugas Pemicu event scale-in Pemicu alert.

    Nilai default: 15.

    15
    ScaleOutEvaluationCount

    integer

    No

    Setelah aturan penskalaan pelacakan target dibuat, Tugas Pemicu event dibuat secara otomatis. Parameter ini menentukan jumlah kali berturut-turut ambang batas bersyarat harus dipenuhi sebelum Tugas Pemicu event scale-out Pemicu alert.

    Nilai default: 3.

    3
    PredictiveScalingMode

    string

    No

    Mode aturan penskalaan prediktif. Nilai valid:

    • PredictAndScale: menghasilkan hasil prediksi dan membuat Tugas memprediksi.

    • PredictOnly: menghasilkan hasil prediksi tetapi tidak membuat Tugas memprediksi.

    Nilai default: PredictAndScale.

    PredictAndScale
    PredictiveValueBehavior

    string

    No

    Metode yang digunakan untuk handle nilai maksimum untuk aturan penskalaan prediktif. Nilai valid:

    • MaxOverridePredictiveValue: nilai maksimum awal mengesampingkan nilai yang diprediksi. Jika nilai yang diprediksi lebih besar dari nilai maksimum awal, nilai maksimum Tugas memprediksi diatur ke nilai maksimum awal.

    • PredictiveValueOverrideMax: nilai yang diprediksi mengesampingkan nilai maksimum awal. Jika nilai yang diprediksi lebih besar dari nilai maksimum awal, nilai maksimum Tugas memprediksi diatur ke nilai yang diprediksi.

    • PredictiveValueOverrideMaxWithBuffer: nilai yang diprediksi ditingkatkan dengan persentase yang ditentukan. Nilai yang diprediksi ditingkatkan berdasarkan rasio PredictiveValueBuffer. Jika nilai yang ditingkatkan lebih besar dari nilai maksimum awal, nilai yang ditingkatkan digunakan.

    Nilai default: MaxOverridePredictiveValue.

    MaxOverridePredictiveValue
    PredictiveValueBuffer

    integer

    No

    Parameter ini berlaku ketika PredictiveValueBehavior diatur ke PredictiveValueOverrideMaxWithBuffer. Nilai yang diprediksi ditingkatkan berdasarkan rasio ini. Jika nilai yang ditingkatkan lebih besar dari nilai maksimum awal, nilai yang ditingkatkan digunakan. Nilai valid: 0 hingga 100.

    Nilai default: 0.

    50
    PredictiveTaskBufferTime

    integer

    No

    Tugas memprediksi yang dibuat secara otomatis oleh aturan penskalaan prediktif dijalankan setiap jam secara default. Anda dapat mengonfigurasi pengatur waktu buffer untuk menjalankan Tugas memprediksi lebih awal dari jadwal guna menyiapkan resource terlebih dahulu. Nilai valid: 0 hingga 60. Unit: minutes.

    Nilai default: 0.

    30
    InitialMaxSize

    integer

    No

    Jumlah maksimum Instans dalam grup penskalaan. Parameter ini digunakan bersama dengan PredictiveValueBehavior.

    Nilai default: nilai MaxSize dari grup penskalaan.

    100
    StepAdjustment

    array<object>

    No

    Kumpulan informasi penyesuaian langkah untuk aturan penskalaan bertahap.

    object

    No

    Kumpulan informasi penyesuaian langkah untuk aturan penskalaan bertahap.

    MetricIntervalUpperBound

    number

    No

    Batas atas penyesuaian langkah. Parameter ini hanya berlaku untuk aturan penskalaan bertahap. Nilai valid: -9.999999E18 hingga 9.999999E18.

    5.0
    ScalingAdjustment

    integer

    No

    Jumlah Instans yang akan diskalakan untuk penyesuaian langkah. Parameter ini hanya berlaku untuk aturan penskalaan bertahap.

    1
    MetricIntervalLowerBound

    number

    No

    Batas bawah penyesuaian langkah. Parameter ini hanya berlaku untuk aturan penskalaan bertahap. Nilai valid: -9.999999E18 hingga 9.999999E18.

    1.0
    RegionId

    string

    No

    ID wilayah grup penskalaan.

    cn-hangzhou
    AlarmDimension

    array<object>

    No

    Informasi dimensi yang terkait dengan data deret waktu. Parameter ini berlaku untuk aturan penskalaan pelacakan target. Tentukan parameter ini ketika data deret waktu memerlukan informasi dimensi tambahan. Misalnya, data deret waktu LoadBalancerRealServerAverageQps memerlukan informasi dimensi rulePool.

    object

    No

    Informasi dimensi yang terkait dengan data deret waktu. Parameter ini berlaku untuk aturan penskalaan pelacakan target. Tentukan parameter ini ketika data deret waktu memerlukan informasi dimensi tambahan. Misalnya, data deret waktu LoadBalancerRealServerAverageQps memerlukan informasi dimensi rulePool.

    DimensionKey

    string

    No

    Kunci dimensi yang terkait dengan data deret waktu.

    rulePool
    DimensionValue

    string

    No

    Nilai dimensi yang terkait dengan data deret waktu.

    sgp-l1cbirz451yxu2****
    MetricType

    string

    No

    Tipe data deret waktu. Nilai valid:

    • system: menggunakan data deret waktu sistem CloudMonitor.

    • custom: menggunakan data deret waktu kustom yang dilaporkan ke CloudMonitor.

    • hybrid: menggunakan data deret waktu Cloud Hibrida.

    system
    HybridMonitorNamespace

    string

    No

    ID repositori data deret waktu Pemantauan Cloud Hibrida.

    Untuk mengelola repositori data deret waktu, lihat Mengelola repositori data deret waktu.

    aliyun-test
    HybridMetrics

    array<object>

    No

    Pengaturan data deret waktu Pemantauan Cloud Hibrida. Untuk informasi selengkapnya tentang cara mengonfigurasi parameter ini, lihat Menggunakan aturan penskalaan pelacakan target kustom berbasis rumus.

    array<object>

    No

    Id

    string

    No

    ID referensi data deret waktu dalam ekspresi data deret waktu.

    a
    Expression

    string

    No

    Ekspresi data deret waktu untuk beberapa data deret waktu Pemantauan Cloud Hibrida. Hasil perhitungan ekspresi digunakan untuk Pemicu aktivitas penskalaan.

    Ekspresi harus mematuhi spesifikasi Notasi Polandia Terbalik (RPN), dan hanya operator + - * / yang didukung.

    (a+b)/2
    MetricName

    string

    No

    Nama data deret waktu Pemantauan dalam repositori data deret waktu Pemantauan Cloud Hibrida.

    AliyunSmq_NumberOfMessagesVisible
    Statistic

    string

    No

    Metode statistik data deret waktu. Nilai valid:

    • Average: rata-rata dari semua titik data dalam interval yang ditentukan.

    • Minimum: nilai minimum dari semua titik data dalam interval yang ditentukan.

    • Maximum: nilai maksimum dari semua titik data dalam interval yang ditentukan.

    Average
    Dimensions

    array<object>

    No

    Dimensi data deret waktu. Menentukan resource yang akan dipantau untuk data deret waktu.

    object

    No

    DimensionKey

    string

    No

    Kunci dimensi data deret waktu.

    queue
    DimensionValue

    string

    No

    Nilai dimensi data deret waktu.

    testQueue
    AlarmOptions

    object

    No

    Definisi properti alert.

    Period

    integer

    No

    Periode statistik untuk data pemantauan dalam aturan penskalaan pelacakan target. Unit: seconds. Nilai valid:

    Catatan

    Nilai default: 60.

    60

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ScalingRuleAri

    string

    Pengenal unik aturan penskalaan.

    ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****
    RequestId

    string

    ID permintaan.

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

    string

    ID aturan penskalaan. ID dihasilkan oleh sistem dan bersifat unik secara global.

    asr-bp1dvirgwkoowxk7****

    Contoh

    Respons sukses

    JSONformat

    {
  "ScalingRuleAri": "ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingRuleId": "asr-bp1dvirgwkoowxk7****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.