DescribeScalingRules - Auto Scaling - Alibaba Cloud Documentation Center

Kueri aturan penskalaan. Saat memanggil operasi ini, Anda dapat menentukan ID, nama, atau Alibaba Cloud Resource Name (ARN) dari aturan penskalaan untuk mengkueri detailnya, seperti metode penyesuaian, periode pemanasan instans, dan tugas berbasis peristiwa terkait.

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 ini untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	DescribeScalingRules	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeScalingRules.
RegionId	String	Ya	cn-qingdao	ID wilayah grup penskalaan.
PageNumber	Integer	Tidak	1	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	Tidak	50	Jumlah entri per halaman. Nilai valid: 1 hingga 50. Nilai default: 10.
ScalingGroupId	String	Tidak	asg-bp1ffogfdauy0jw0****	ID grup penskalaan yang aturan penskalaannya ingin Anda kueri.
ScalingRuleType	String	Tidak	SimpleScalingRule	Tipe aturan penskalaan. Nilai valid: SimpleScalingRule: Setelah aturan penskalaan sederhana dieksekusi, Auto Scaling menyesuaikan jumlah instans ECS atau instans kontainer elastis dalam grup penskalaan berdasarkan nilai AdjustmentType dan AdjustmentValue. TargetTrackingScalingRule: Setelah aturan penskalaan pelacakan target dieksekusi, Auto Scaling secara dinamis menghitung jumlah instans ECS atau instans kontainer elastis yang perlu diskalakan berdasarkan metrik yang telah ditentukan sebelumnya (MetricName) dan berusaha menjaga nilai metrik tersebut mendekati nilai target yang ditentukan (TargetValue). StepScalingRule: aturan penskalaan langkah. Setelah aturan penskalaan langkah dieksekusi, Auto Scaling menskalakan instans selangkah demi selangkah berdasarkan ambang batas dan nilai metrik yang telah ditentukan sebelumnya. PredictiveScalingRule: menggunakan pembelajaran mesin untuk menganalisis data pemantauan historis grup penskalaan dan memprediksi nilai metrik di masa depan. Selain itu, Auto Scaling membuat tugas terjadwal untuk menyesuaikan jumlah minimum dan maksimum instans untuk grup penskalaan.
ShowAlarmRules	Boolean	Tidak	false	Menentukan apakah akan mengembalikan tugas berbasis peristiwa yang terkait dengan aturan penskalaan. Nilai valid: true false Nilai default: false.
ScalingRuleId.N	String	Tidak	asr-bp1dvirgwkoowxk7****	ID aturan penskalaan N yang ingin Anda kueri. Nilai valid N: 1 hingga 10.
ScalingRuleName.N	String	Tidak	scalingrule****	Nama aturan penskalaan N yang ingin Anda kueri. Nilai valid N: 1 hingga 10.
ScalingRuleAri.N	String	Tidak	ari:acs:ess:cn-hangzhou:140692647406**:scalingrule/asr-bp1dvirgwkoowxk7**	ARN aturan penskalaan N yang ingin Anda kueri. Nilai valid N: 1 hingga 10.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.
PageNumber	Integer	1	Nomor halaman.
PageSize	Integer	50	Jumlah entri per halaman.
TotalCount	Integer	1	Jumlah total aturan penskalaan.
ScalingRules	Array of ScalingRule		Aturan penskalaan.
ScalingRule
MetricName	String	CpuUtilization	Metrik yang telah ditentukan sebelumnya untuk aturan penskalaan. Parameter ini berlaku jika ScalingRuleType diatur ke TargetTrackingScalingRule atau PredictiveScalingRule. Nilai valid jika ScalingRuleType diatur ke TargetTrackingScalingRule: CpuUtilization: rata-rata utilisasi CPU. ClassicInternetRx: rata-rata lalu lintas publik inbound melalui jaringan klasik. ClassicInternetTx: rata-rata lalu lintas publik outbound melalui jaringan klasik. VpcInternetRx: rata-rata lalu lintas publik inbound melalui virtual private cloud (VPC). VpcInternetTx: rata-rata lalu lintas publik outbound melalui VPC. IntranetRx: rata-rata lalu lintas inbound melalui jaringan internal. IntranetTx: rata-rata lalu lintas outbound melalui jaringan internal. Nilai valid jika ScalingRuleType diatur ke PredictiveScalingRule: CpuUtilization: rata-rata utilisasi CPU. IntranetRx: rata-rata lalu lintas inbound melalui jaringan internal. IntranetTx: rata-rata lalu lintas outbound melalui jaringan internal.
AdjustmentType	String	QuantityChangeInCapacity	Metode penyesuaian aturan penskalaan. Nilai valid: QuantityChangeInCapacity: menambahkan jumlah instans Elastic Compute Service (ECS) yang ditentukan ke grup penskalaan atau menghapus jumlah instans ECS yang ditentukan dari grup penskalaan. PercentChangeInCapacity: menambahkan persentase instans ECS yang ditentukan ke grup penskalaan atau menghapus persentase instans ECS yang ditentukan dari grup penskalaan. TotalCapacity: menyesuaikan jumlah instans ECS dalam grup penskalaan menjadi jumlah yang ditentukan.
InitialMaxSize	Integer	100	Jumlah maksimum instans ECS yang dapat ditambahkan ke grup penskalaan. Jika Anda menentukan InitialMaxSize, Anda juga harus menentukan PredictiveValueBehavior.
EstimatedInstanceWarmup	Integer	300	Periode pemanasan selama serangkaian langkah persiapan dilakukan pada instans baru. Auto Scaling tidak memantau data metrik instans yang sedang dalam proses pemanasan.
ScaleOutEvaluationCount	Integer	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	PredictAndScale	Mode aturan penskalaan prediktif. Nilai valid: PredictAndScale: menghasilkan prediksi dan membuat tugas prediksi. PredictOnly: memberikan prediksi tetapi tidak membuat tugas prediksi.
MinAdjustmentMagnitude	Integer	1	Jumlah minimum instans yang harus diskalakan. Parameter ini berlaku jika Anda mengatur `ScalingRuleType` ke `SimpleScalingRule` atau `StepScalingRule`, dan `AdjustmentType` ke PercentChangeInCapacity.
ScalingRuleAri	String	ari:acs:ess:cn-hangzhou:140692647406**:scalingrule/asr-bp1dvirgwkoowxk7**	ARN aturan penskalaan N.
PredictiveTaskBufferTime	Integer	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 resource sebelum tugas prediksi dijalankan. Nilai valid: 0 hingga 60. Satuan: menit.
MinSize	Integer	1	Jumlah minimum instans ECS yang harus dimiliki oleh grup penskalaan.
ScalingGroupId	String	asg-bp1ffogfdauy0jw0****	ID grup penskalaan yang aturan penskalaannya dikueri.
PredictiveValueBehavior	String	MaxOverridePredictiveValue	Menunjukkan apakah kapasitas maksimum awal atau nilai prediksi dapat digunakan sebagai nilai maksimum untuk tugas 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.
TargetValue	Float	0.125	Nilai target metrik. Jika Anda mengatur ScalingRuleType ke TargetTrackingScalingRule atau PredictiveScalingRule, Auto Scaling menjaga nilai metrik mendekati nilai target dengan menambahkan atau menghapus instans dari grup penskalaan.
Cooldown	Integer	20	Periode cooldown aturan penskalaan. Parameter ini hanya tersedia jika Anda mengatur ScalingRuleType ke SimpleScalingRule. Nilai valid: 0 hingga 86400. Satuan: detik.
MaxSize	Integer	2	Jumlah maksimum instans ECS yang dapat dimiliki oleh grup penskalaan.
PredictiveValueBuffer	Integer	50	Rasio berdasarkan mana nilai prediksi ditingkatkan jika Anda mengatur 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.
ScalingRuleType	String	SimpleScalingRule	Tipe aturan penskalaan. Nilai valid: SimpleScalingRule: Setelah aturan penskalaan sederhana dieksekusi, Auto Scaling menyesuaikan jumlah instans ECS atau instans kontainer elastis dalam grup penskalaan berdasarkan nilai AdjustmentType dan AdjustmentValue. TargetTrackingScalingRule: Setelah aturan penskalaan pelacakan target dieksekusi, Auto Scaling secara dinamis menghitung jumlah instans ECS atau instans kontainer elastis yang perlu diskalakan berdasarkan metrik yang telah ditentukan sebelumnya (MetricName) dan berusaha menjaga nilai metrik tersebut mendekati nilai target yang ditentukan (TargetValue). StepScalingRule: aturan penskalaan langkah. Setelah aturan penskalaan langkah dieksekusi, Auto Scaling menskalakan instans selangkah demi selangkah berdasarkan ambang batas dan nilai metrik yang telah ditentukan sebelumnya. PredictiveScalingRule: menggunakan pembelajaran mesin untuk menganalisis data pemantauan historis grup penskalaan dan memprediksi nilai metrik di masa depan. Selain itu, Auto Scaling membuat tugas terjadwal untuk menyesuaikan jumlah minimum dan maksimum instans untuk grup penskalaan.
AdjustmentValue	Integer	1	Nilai penyesuaian yang ditentukan dalam aturan penskalaan.
ScaleInEvaluationCount	Integer	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.
DisableScaleIn	Boolean	true	Menunjukkan apakah skala-masuk dinonaktifkan. Parameter ini hanya tersedia jika Anda mengatur ScalingRuleType ke TargetTrackingScalingRule. Nilai valid: true false
ScalingRuleName	String	scalingrule****	Nama aturan penskalaan.
ScalingRuleId	String	asr-bp1dvirgwkoowxk7****	ID aturan penskalaan.
Alarms	Array of Alarm		Tugas berbasis peristiwa yang terkait dengan aturan penskalaan. Parameter ini dikembalikan hanya jika Anda mengatur ShowAlarmRules ke true. Jika tidak, daftar kosong dikembalikan.
Alarm
AlarmTaskId	String	asg-bp18p2yfxow2dloq**_1f9458d1-70e1-4bee-8c7f-7a47695b**	ID tugas berbasis peristiwa yang terkait dengan aturan penskalaan.
ComparisonOperator	String	>=	Operator perbandingan antara nilai statistik dan ambang batas metrik yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan. Operator ini menentukan kondisi di mana nilai metrik dan ambang batas memenuhi kriteria peringatan. Nilai valid jika nilai metrik lebih besar dari atau sama dengan ambang batas metrik: >=. Nilai valid jika nilai metrik kurang dari atau sama dengan ambang batas metrik: <=. Nilai valid jika nilai metrik lebih besar dari ambang batas metrik: >. Nilai valid jika nilai metrik kurang dari ambang batas metrik: <.
MetricName	String	CpuUtilization	Nama metrik yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan.
EvaluationCount	Integer	3	Jumlah kali berturut-turut tugas berbasis peristiwa yang terkait dengan aturan penskalaan harus memenuhi ekspresi ambang batas sebelum peringatan dipicu.
AlarmTaskName	String	alarmtask****	Nama tugas berbasis peristiwa yang terkait dengan aturan penskalaan.
MetricType	String	system	Tipe tugas berbasis peristiwa yang terkait dengan aturan penskalaan. Nilai valid: system: tugas berbasis peristiwa tipe pemantauan sistem custom: tugas berbasis peristiwa tipe pemantauan kustom
Threshold	Float	50	Ambang batas metrik yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan.
Statistics	String	Average	Metode statistik yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan. Nilai valid: Average Maximum Minimum
Dimensions	Array of Dimension		Dimensi yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan.
Dimension
DimensionKey	String	scaling_group	Kunci dimensi yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan. Nilai valid: scaling_group: ID grup penskalaan userId: ID Akun Alibaba Cloud
DimensionValue	String	asg-bp18p2yfxow2dloq****	Nilai dimensi yang ditentukan dalam tugas berbasis peristiwa yang terkait dengan aturan penskalaan.
Period	Integer	60	Periode statistik data metrik dalam aturan penskalaan pelacakan target.
StepAdjustments	Array of StepAdjustment		Penyesuaian langkah aturan penskalaan langkah.
StepAdjustment
MetricIntervalUpperBound	Float	5.0	Batas atas setiap penyesuaian langkah. Nilai valid: -9.999999E18 hingga 9.999999E18.
ScalingAdjustment	Integer	1	Jumlah instans yang diskalakan dalam setiap penyesuaian langkah.
MetricIntervalLowerBound	Float	1.0	Batas bawah setiap penyesuaian langkah. Nilai valid: -9.999999E18 hingga 9.999999E18.
AlarmDimensions	Array of AlarmDimension		Dimensi metrik. Parameter ini hanya berlaku jika Anda mengatur `ScalingRuleType` ke `TargetTrackingScalingRule`. Misalnya, jika Anda menggunakan metrik LoadBalancerRealServerAverageQps, Anda harus menentukan dimensi rulePool.
AlarmDimension
DimensionKey	String	rulePool	Kunci dimensi metrik.
DimensionValue	String	sgp-l1cbirz451yxu2****	Nilai dimensi metrik.
MetricType	String	system	Tipe metrik. Nilai valid: system: metrik sistem CloudMonitor. custom: metrik kustom yang dilaporkan ke CloudMonitor. hybrid: metrik Pemantauan Cloud Hibrida.
HybridMonitorNamespace	String	aliyun-test	ID namespace Pemantauan Cloud Hibrida. Untuk informasi tentang cara mengelola namespace Pemantauan Cloud Hibrida, lihat Manage namespaces.
HybridMetrics	Array of HybridMetric		Metrik Pemantauan Cloud Hibrida. Untuk informasi selengkapnya, lihat Create a custom target tracking scaling rule.
HybridMetric
Id	String	a	ID referensi metrik dalam ekspresi metrik.
Expression	String	(a+b)/2	Ekspresi metrik yang terdiri dari beberapa metrik Pemantauan Cloud Hibrida. Ekspresi ini menghitung hasil yang digunakan untuk memicu event penskalaan. Ekspresi ditulis dalam format Reverse Polish Notation (RPN) dan hanya mencakup operator berikut: `+, -, *, /`.
MetricName	String	AliyunSmq_NumberOfMessagesVisible	Nama metrik Pemantauan Cloud Hibrida.
Statistic	String	Average	Metode statistik data metrik. Nilai valid: Average: Nilai rata-rata dari semua data metrik dalam interval tertentu dihitung. Minimum: Nilai minimum dari semua data metrik dalam interval tertentu dihitung. Maximum: Nilai maksimum dari semua data metrik dalam interval tertentu dihitung.
Dimensions	Array of Dimension		Dimensi metrik. Anda dapat menggunakan parameter ini untuk menentukan resource yang dipantau.
Dimension
DimensionKey	String	queue	Kunci dimensi metrik.
DimensionValue	String	testQueue	Nilai dimensi metrik.

Contoh

Permintaan contoh

http(s)://ess.aliyuncs.com/?Action=DescribeScalingRules
&RegionId=cn-qingdao
&PageNumber=1
&PageSize=50
&ScalingGroupId=asg-bp1ffogfdauy0jw0****
&ScalingRuleType=SimpleScalingRule
&ShowAlarmRules=false
&ScalingRuleId=["asr-bp1dvirgwkoowxk7****"]
&ScalingRuleName=["scalingrule****"]
&ScalingRuleAri=["ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****"]
&<Common request parameters>

Respons sukses contoh

XML format

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

<DescribeScalingRulesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>50</PageSize>
    <TotalCount>1</TotalCount>
    <ScalingRules>
        <MetricName>CpuUtilization</MetricName>
        <AdjustmentType>QuantityChangeInCapacity</AdjustmentType>
        <InitialMaxSize>100</InitialMaxSize>
        <EstimatedInstanceWarmup>300</EstimatedInstanceWarmup>
        <ScaleOutEvaluationCount>3</ScaleOutEvaluationCount>
        <PredictiveScalingMode>PredictAndScale</PredictiveScalingMode>
        <MinAdjustmentMagnitude>1</MinAdjustmentMagnitude>
        <ScalingRuleAri>ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****</ScalingRuleAri>
        <PredictiveTaskBufferTime>30</PredictiveTaskBufferTime>
        <MinSize>1</MinSize>
        <ScalingGroupId>asg-bp1ffogfdauy0jw0****</ScalingGroupId>
        <PredictiveValueBehavior>MaxOverridePredictiveValue</PredictiveValueBehavior>
        <TargetValue>0.125</TargetValue>
        <Cooldown>20</Cooldown>
        <MaxSize>2</MaxSize>
        <PredictiveValueBuffer>50</PredictiveValueBuffer>
        <ScalingRuleType>SimpleScalingRule</ScalingRuleType>
        <AdjustmentValue>1</AdjustmentValue>
        <ScaleInEvaluationCount>15</ScaleInEvaluationCount>
        <DisableScaleIn>true</DisableScaleIn>
        <ScalingRuleName>scalingrule****</ScalingRuleName>
        <ScalingRuleId>asr-bp1dvirgwkoowxk7****</ScalingRuleId>
        <Alarms>
            <AlarmTaskId>asg-bp18p2yfxow2dloq****_1f9458d1-70e1-4bee-8c7f-7a47695b****</AlarmTaskId>
            <ComparisonOperator>&gt;=</ComparisonOperator>
            <MetricName>CpuUtilization</MetricName>
            <EvaluationCount>3</EvaluationCount>
            <AlarmTaskName>alarmtask****</AlarmTaskName>
            <MetricType>system</MetricType>
            <Threshold>50</Threshold>
            <Statistics>Average</Statistics>
            <Dimensions>
                <DimensionKey>scaling_group</DimensionKey>
                <DimensionValue>asg-bp18p2yfxow2dloq****</DimensionValue>
            </Dimensions>
        </Alarms>
        <StepAdjustments>
            <MetricIntervalUpperBound>5</MetricIntervalUpperBound>
            <ScalingAdjustment>1</ScalingAdjustment>
            <MetricIntervalLowerBound>1</MetricIntervalLowerBound>
        </StepAdjustments>
        <AlarmDimensions>
            <DimensionKey>rulePool</DimensionKey>
            <DimensionValue>sgp-l1cbirz451yxu2****</DimensionValue>
        </AlarmDimensions>
    </ScalingRules>
</DescribeScalingRulesResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PageNumber" : 1,
  "PageSize" : 50,
  "TotalCount" : 1,
  "ScalingRules" : [ {
    "MetricName" : "CpuUtilization",
    "AdjustmentType" : "QuantityChangeInCapacity",
    "InitialMaxSize" : 100,
    "EstimatedInstanceWarmup" : 300,
    "ScaleOutEvaluationCount" : 3,
    "PredictiveScalingMode" : "PredictAndScale",
    "MinAdjustmentMagnitude" : 1,
    "ScalingRuleAri" : "ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7****",
    "PredictiveTaskBufferTime" : 30,
    "MinSize" : 1,
    "ScalingGroupId" : "asg-bp1ffogfdauy0jw0****",
    "PredictiveValueBehavior" : "MaxOverridePredictiveValue",
    "TargetValue" : 0.125,
    "Cooldown" : 20,
    "MaxSize" : 2,
    "PredictiveValueBuffer" : 50,
    "ScalingRuleType" : "SimpleScalingRule",
    "AdjustmentValue" : 1,
    "ScaleInEvaluationCount" : 15,
    "DisableScaleIn" : true,
    "ScalingRuleName" : "scalingrule****",
    "ScalingRuleId" : "asr-bp1dvirgwkoowxk7****",
    "Alarms" : [ {
      "AlarmTaskId" : "asg-bp18p2yfxow2dloq****_1f9458d1-70e1-4bee-8c7f-7a47695b****",
      "ComparisonOperator" : ">=",
      "MetricName" : "CpuUtilization",
      "EvaluationCount" : 3,
      "AlarmTaskName" : "alarmtask****",
      "MetricType" : "system",
      "Threshold" : 50,
      "Statistics" : "Average",
      "Dimensions" : [ {
        "DimensionKey" : "scaling_group",
        "DimensionValue" : "asg-bp18p2yfxow2dloq****"
      } ]
    } ],
    "StepAdjustments" : [ {
      "MetricIntervalUpperBound" : 5,
      "ScalingAdjustment" : 1,
      "MetricIntervalLowerBound" : 1
    } ],
    "AlarmDimensions" : [ {
      "DimensionKey" : "rulePool",
      "DimensionValue" : "sgp-l1cbirz451yxu2****"
    } ]
  } ]
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.