All Products
Search

This Product

    Auto Scaling:ModifyScalingRule

    Document Center

    Auto Scaling:ModifyScalingRule

    Last Updated:May 25, 2026

    Modifikasi aturan penskalaan. Jika aturan penskalaan yang ada tidak memenuhi kebutuhan bisnis Anda, Anda dapat memanggil operasi ModifyScalingRule untuk mengubahnya tanpa perlu membuat aturan baru. Operasi ini menyederhanakan tugas Anda dengan menghilangkan kebutuhan akan tindakan berulang, sehingga secara signifikan mengurangi waktu dan meminimalkan penggunaan sumber daya.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    ModifyScalingRule

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyScalingRule.

    ScalingRuleId

    String

    Yes

    asr-bp1dvirgwkoowxk7****

    ID aturan penskalaan yang ingin Anda modifikasi.

    ScalingRuleName

    String

    No

    scalingrule****

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

    Catatan

    Nama setiap aturan penskalaan harus unik dalam satu Akun Alibaba Cloud dan Wilayah yang sama.

    Cooldown

    Integer

    No

    60

    Periode cooldown aturan penskalaan. Parameter ini hanya tersedia jika Anda menetapkan ScalingRuleType ke SimpleScalingRule.

    Nilai valid: 0 hingga 86400. Satuan: detik.

    MinAdjustmentMagnitude

    Integer

    No

    1

    Jumlah minimum instans yang harus diskalakan. Parameter ini berlaku jika Anda menetapkan ScalingRuleType ke SimpleScalingRule atau StepScalingRule, dan AdjustmentType ke PercentChangeInCapacity.

    AdjustmentType

    String

    No

    QuantityChangeInCapacity

    Metode penyesuaian yang digunakan oleh aturan penskalaan. Jika Anda menetapkan ScalingRuleType ke SimpleScalingRule atau StepScalingRule, Anda harus menentukan parameter ini. Nilai valid:

    • QuantityChangeInCapacity: menambahkan jumlah tertentu Instance Elastic Compute Service (ECS) ke grup penskalaan atau menghapus jumlah tertentu Instance ECS dari grup penskalaan.

    • PercentChangeInCapacity: menambahkan persentase tertentu Instance ECS ke grup penskalaan atau menghapus persentase tertentu Instance ECS dari grup penskalaan.

    • TotalCapacity: menyesuaikan jumlah Instance ECS dalam grup penskalaan menjadi jumlah yang ditentukan.

    AdjustmentValue

    Integer

    No

    100

    Jumlah instans yang dapat ditambahkan ke atau dihapus dari grup penskalaan berdasarkan aturan penskalaan. Jika Anda menetapkan ScalingRuleType ke SimpleScalingRule atau StepScalingRule, Anda harus menentukan parameter ini. Jumlah maksimum Instance ECS yang dapat ditambahkan atau dihapus dalam satu operasi penskalaan adalah 1.000, terlepas dari skenarionya. Rentang nilai parameter ini bervariasi tergantung pada nilai AdjustmentType.

    • Nilai valid jika Anda menetapkan AdjustmentType ke QuantityChangeInCapacity: -1000 hingga 1000.

    • Nilai valid jika Anda menetapkan AdjustmentType ke PercentChangeInCapacity: -100 hingga 10000.

    • Nilai valid jika Anda menetapkan AdjustmentType ke TotalCapacity: 0 hingga 2000.

    EstimatedInstanceWarmup

    Integer

    No

    60

    Periode warmup instans yang dapat ditambahkan ke atau dihapus dari grup penskalaan. Anda hanya dapat menentukan parameter ini untuk aturan penskalaan simple dan aturan penskalaan langkah. Auto Scaling menambahkan Instance ECS dalam status Warmup ke grup penskalaan tetapi tidak mengirimkan data pemantauan ke CloudMonitor selama periode warmup.

    Catatan

    Instance ECS dalam status Warmup tidak termasuk dalam perhitungan kapasitas saat Auto Scaling menentukan jumlah instans yang akan diskalakan.

    Nilai valid: 0 hingga 86400. Satuan: detik.

    MetricName

    String

    No

    CpuUtilization

    Metrik yang telah ditentukan sebelumnya untuk aturan penskalaan. Jika Anda menetapkan ScalingRuleType ke TargetTrackingScalingRule atau PredictiveScalingRule, Anda juga harus menentukan parameter ini.

    Nilai valid jika Anda menetapkan ScalingRuleType ke TargetTrackingScalingRule:

    • CpuUtilizationAgent (disarankan): utilisasi CPU.

    • MemoryUtilization (disarankan): Penggunaan memori.

    • CpuUtilization: rata-rata utilisasi CPU.

    • IntranetTx: lalu lintas keluar melalui jaringan internal.

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

    • VpcInternetTx: lalu lintas keluar dari virtual private cloud (VPC) ke Internet.

    • VpcInternetRx: lalu lintas masuk dari Internet ke VPC.

    • LoadBalancerRealServerAverageQps: permintaan per detik (QPS) per kelompok server Application Load Balancer (ALB).

    Nilai valid jika Anda menetapkan ScalingRuleType ke PredictiveScalingRule:

    • CpuUtilization: rata-rata utilisasi CPU.

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

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

    Untuk informasi lebih lanjut, lihat Tugas berbasis peristiwa jenis pemantauan sistem.

    TargetValue

    Float

    No

    0.125

    Nilai target. Parameter ini hanya tersedia jika Anda menetapkan ScalingRuleType ke TargetTrackingScalingRule atau PredictiveScalingRule. Nilainya harus lebih besar dari 0 dan dapat memiliki maksimal tiga tempat desimal.

    DisableScaleIn

    Boolean

    No

    true

    Menentukan apakah skala-masuk dinonaktifkan. Parameter ini tersedia jika Anda menetapkan ScalingRuleType ke TargetTrackingScalingRule.

    ScaleInEvaluationCount

    Integer

    No

    15

    Setelah Anda membuat aturan penskalaan pelacakan target, tugas berbasis peristiwa akan dibuat secara otomatis dan dikaitkan dengan aturan penskalaan tersebut. Parameter ini menentukan jumlah kali berturut-turut kondisi peringatan harus terpenuhi sebelum tugas berbasis peristiwa memulai operasi skala-masuk.

    ScaleOutEvaluationCount

    Integer

    No

    3

    Setelah Anda membuat aturan penskalaan pelacakan target, tugas berbasis peristiwa akan dibuat secara otomatis dan dikaitkan dengan aturan penskalaan tersebut. Parameter ini menentukan jumlah kali berturut-turut kondisi peringatan harus terpenuhi sebelum tugas berbasis peristiwa memulai operasi skala keluar.

    PredictiveScalingMode

    String

    No

    PredictAndScale

    Mode aturan penskalaan prediktif. Nilai valid:

    • PredictAndScale: memberikan prediksi dan membuat tugas prediksi.

    • PredictOnly: memberikan prediksi tetapi tidak membuat tugas prediksi.

    PredictiveValueBehavior

    String

    No

    MaxOverridePredictiveValue

    Aksi yang ingin Anda ambil terhadap nilai maksimum prediksi. Nilai valid:

    • MaxOverridePredictiveValue: menggunakan kapasitas maksimum awal sebagai nilai maksimum untuk tugas prediksi jika nilai prediksi lebih besar daripada kapasitas maksimum awal.

    • PredictiveValueOverrideMax: menggunakan nilai prediksi sebagai nilai maksimum untuk tugas prediksi jika nilai prediksi lebih besar daripada kapasitas maksimum awal.

    • PredictiveValueOverrideMaxWithBuffer: meningkatkan nilai prediksi berdasarkan rasio yang ditentukan oleh PredictiveValueBuffer, dan menggunakan nilai yang ditingkatkan tersebut sebagai nilai maksimum untuk tugas prediksi jika nilai prediksi yang ditingkatkan lebih besar daripada kapasitas maksimum awal.

    PredictiveValueBuffer

    Integer

    No

    50

    Rasio yang digunakan untuk meningkatkan nilai prediksi jika Anda menetapkan PredictiveValueBehavior ke PredictiveValueOverrideMaxWithBuffer. Jika nilai prediksi yang ditingkatkan berdasarkan rasio ini lebih besar daripada kapasitas maksimum awal, nilai yang ditingkatkan tersebut digunakan sebagai nilai maksimum untuk tugas prediksi. Nilai valid: 0 hingga 100.

    PredictiveTaskBufferTime

    Integer

    No

    30

    Jumlah waktu buffer sebelum tugas prediksi dijalankan. Secara default, semua tugas prediksi yang dibuat secara otomatis berdasarkan aturan penskalaan prediktif dijalankan tepat pada jam tertentu. Anda dapat menentukan waktu buffer untuk persiapan sumber daya sebelum tugas prediksi dijalankan. Nilai valid: 0 hingga 60.

    InitialMaxSize

    Integer

    No

    100

    Jumlah maksimum Instance ECS yang dapat ditambahkan ke grup penskalaan. Jika Anda menentukan InitialMaxSize, Anda juga harus menentukan PredictiveValueBehavior.

    StepAdjustment.N.MetricIntervalUpperBound

    Float

    No

    5.0

    Batas atas penyesuaian langkah. Parameter ini hanya berlaku jika Anda menetapkan ScalingRuleType ke StepScalingRule. Nilai valid: -9.999999E18 hingga 9.999999E18.

    StepAdjustment.N.ScalingAdjustment

    Integer

    No

    1

    Jumlah Instance ECS yang ingin Anda skalakan dalam setiap penyesuaian langkah. Parameter ini hanya tersedia jika Anda menetapkan ScalingRuleType ke StepScalingRule.

    StepAdjustment.N.MetricIntervalLowerBound

    Float

    No

    1.0

    Batas bawah dalam penyesuaian langkah. Parameter ini hanya tersedia jika Anda menetapkan ScalingRuleType ke StepScalingRule. Nilai valid: -9.999999E18 hingga 9.999999E18.

    AlarmDimension.N.DimensionKey

    String

    No

    rulePool

    Kunci dimensi metrik.

    AlarmDimension.N.DimensionValue

    String

    No

    sgp-l1cbirz451yxu2****

    Nilai dimensi metrik.

    MetricType

    String

    No

    system

    Jenis metrik yang digunakan oleh tugas berbasis peristiwa. Nilai valid:

    • system: metrik sistem CloudMonitor.

    • custom: metrik kustom yang dilaporkan ke CloudMonitor.

    • hybrid: metrik Pemantauan Cloud Hibrida.

    HybridMonitorNamespace

    String

    No

    aliyun-test

    ID namespace Pemantauan Cloud Hibrida.

    Untuk informasi tentang cara mengelola namespace Pemantauan Cloud Hibrida, lihat Kelola namespace.

    HybridMetrics.N.Id

    String

    No

    a

    ID referensi metrik dalam ekspresi metrik.

    HybridMetrics.N.Expression

    String

    No

    (a+b)/2

    Ekspresi metrik yang terdiri dari beberapa metrik Pemantauan Cloud Hibrida. Ekspresi ini menghitung hasil yang digunakan untuk memicu event penskalaan.

    Ekspresi harus ditulis dalam format Reverse Polish Notation (RPN) dan hanya mendukung operator berikut: +, -, *, /.

    HybridMetrics.N.MetricName

    String

    No

    AliyunSmq_NumberOfMessagesVisible

    Nama metrik Pemantauan Cloud Hibrida.

    HybridMetrics.N.Statistic

    String

    No

    Average

    Metode statistik nilai metrik. Nilai valid:

    • Average: menghitung nilai rata-rata dari semua nilai metrik dalam interval tertentu.

    • Minimum: menghitung nilai minimum dari semua nilai metrik dalam interval tertentu.

    • Maximum: menghitung nilai maksimum dari semua nilai metrik dalam interval tertentu.

    HybridMetrics.N.Dimensions.N.DimensionKey

    String

    No

    queue

    Kunci dimensi metrik.

    HybridMetrics.N.Dimensions.N.DimensionValue

    String

    No

    testQueue

    Nilai dimensi metrik.

    AlarmOptions.Period

    Integer

    No

    60

    Periode statistik data metrik dalam aturan penskalaan pelacakan target. Satuan: detik. Nilai valid:

    • 15

    • 60

    • 120

    • 300

    • 900

    Catatan

    Nilai default: 60.

    Parameter respons

    Parameter

    Type

    Example

    Description

    RequestId

    String

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

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://ess.aliyuncs.com/?Action=ModifyScalingRule
&ScalingRuleId=asr-bp1dvirgwkoowxk7****
&ScalingRuleName=scalingrule****
&Cooldown=60
&MinAdjustmentMagnitude=1
&AdjustmentType=QuantityChangeInCapacity
&AdjustmentValue=100
&EstimatedInstanceWarmup=60
&MetricName=CpuUtilization
&TargetValue=0.125
&DisableScaleIn=true
&ScaleInEvaluationCount=15
&ScaleOutEvaluationCount=3
&PredictiveScalingMode=PredictAndScale
&PredictiveValueBehavior=MaxOverridePredictiveValue
&PredictiveValueBuffer=50
&PredictiveTaskBufferTime=30
&InitialMaxSize=100
&StepAdjustment=[{"MetricIntervalUpperBound":5.0,"ScalingAdjustment":1,"MetricIntervalLowerBound":1.0}]
&AlarmDimension=[{"DimensionKey":"rulePool","DimensionValue":"sgp-l1cbirz451yxu2****"}]
&MetricType=system
&HybridMonitorNamespace=aliyun-test
&HybridMetrics=[{"Id":"a","MetricName":"AliyunSmq_NumberOfMessagesVisible","Statistic":"Average","Dimensions":[{"DimensionKey":"queue","DimensionValue":"testQueue"}]}]
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyScalingRuleResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingRuleResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

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

    Kode kesalahan

    Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.

    HTTP status code

    Error code

    Error message

    Description

    404

    InvalidScalingRuleId.NotFound

    The specified scaling rule does not exist.

    Aturan penskalaan yang ditentukan tidak ada dalam Akun Alibaba Cloud.

    400

    InvalidScalingRuleName.Duplicate

    The specified value of parameter <parameter name> is duplicated.

    Nama aturan penskalaan sudah ada.

    400

    QuotaExceeded.ScalingRule

    Scaling rule quota exceeded in the specified scaling group.

    Jumlah maksimum aturan penskalaan dalam grup penskalaan telah tercapai.

    400

    TargetTrackingScalingRule.UnsupportedMetric

    Specific metric is not supported for target tracking scaling rule.

    Aturan penskalaan pelacakan target tidak mendukung metrik yang ditentukan.

    400

    TargetTrackingScalingRule.DumplicateMetric

    Only one TargetTrackingScaling rule for a given metric specification is allowed.

    Metrik tersebut sudah ditentukan untuk aturan penskalaan pelacakan target lain dalam grup penskalaan.

    400

    InvalidMinAdjustmentMagnitudeMismatchAdjustmentType

    MinAdjustmentMagnitude is not supported by the specified adjustment type.

    MinAdjustmentMagnitude tidak mendukung metode penyesuaian aturan penskalaan.

    400

    InvalidStepAdjustments.MultipleNullUpperBound

    At most one StepAdjustment may have an unspecified upper bound.

    Penyesuaian langkah yang tidak memiliki batas atas sudah ada.

    400

    InvalidStepAdjustments.MultipleNullLowerBound

    At most one StepAdjustment may have an unspecified lower bound.

    Penyesuaian langkah yang tidak memiliki batas bawah sudah ada.

    400

    InvalidStepAdjustments.NoNullLowerBound

    There must be a StepAdjustment with an unspecified lower bound when one StepAdjustment has a negative lower bound.

    Penyesuaian langkah memiliki batas bawah negatif, tetapi tidak ada penyesuaian langkah tanpa batas bawah.

    400

    InvalidStepAdjustments.NoNullUpperBound

    There must be a StepAdjustment with an unspecified upper bound when one StepAdjustment has a positive upper bound.

    Penyesuaian langkah memiliki batas atas positif, tetapi tidak ada penyesuaian langkah tanpa batas atas.

    400

    InvalidStepAdjustments.Gap

    StepAdjustment intervals can not have gaps between them.

    Penyesuaian langkah memiliki celah.

    400

    InvalidStepAdjustments.Overlap

    StepAdjustment intervals can not overlap.

    Rentang penyesuaian langkah tumpang tindih.

    400

    InvalidStepAdjustments.LowerGtUpper

    LowerBound must be less than the UpperBound for StepAdjustment :%s.

    Batas bawah penyesuaian langkah lebih besar dari atau sama dengan batas atas.

    400

    InvalidStepAdjustments.BothNull

    Both lower and upper bounds of a StepAdjustment can not be left unspecified.

    Anda tidak dapat menentukan batas atas dan batas bawah untuk penyesuaian langkah secara bersamaan.

    400

    InvalidStepAdjustments.MaxNum

    Your scaling rule can have at most %s StepAdjustments.

    Jumlah maksimum penyesuaian langkah dalam grup penskalaan telah tercapai.

    400

    StepBeyondPermitRange

    Specific parameter "%s" beyond permit range.

    Batas atas atau batas bawah yang ditentukan untuk penyesuaian langkah tidak valid.