查詢伸縮組下的伸縮規則，並列出伸縮規則的資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ess:DescribeScalingRules |
get |
*ScalingGroup
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
伸縮規則所屬伸縮組的地域 ID。 |
cn-qingdao |
| PageNumber |
integer |
否 |
伸縮規則列表的頁碼，起始值：1。 預設值：1。 |
1 |
| PageSize |
integer |
否 |
分頁查詢時設定的每頁行數，最大值：50。 預設值：10。 |
50 |
| ScalingGroupId |
string |
否 |
伸縮組的 ID。 |
asg-bp1ffogfdauy0jw0**** |
| ScalingRuleType |
string |
否 |
伸縮規則的類型。取值範圍：
|
SimpleScalingRule |
| ShowAlarmRules |
boolean |
否 |
是否返回伸縮規則關聯的雲端監控報警任務。取值範圍：
預設值：false。 |
false |
| ScalingRuleId |
array |
否 |
ScalingRuleId.N 為待查詢伸縮規則的 ID，N 的取值範圍：1～10。 |
asr-bp1dvirgwkoowxk7**** |
|
string |
否 |
ScalingRuleId.N 為待查詢伸縮規則的 ID，N 的取值範圍：1～10。 |
asr-bp1dvirgwkoowxk7**** |
|
| ScalingRuleName |
array |
否 |
ScalingRuleName.N 為待查詢伸縮規則的名稱，N 的取值範圍：1～10。 |
scalingrule**** |
|
string |
否 |
ScalingRuleName.N 為待查詢伸縮規則的名稱，N 的取值範圍：1～10。 |
scalingrule**** |
|
| ScalingRuleAri |
array |
否 |
ScalingRuleAri.N 為待查詢伸縮規則的唯一標識符，N 的取值範圍：1～10。 |
ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7**** |
|
string |
否 |
ScalingRuleAri.N 為待查詢伸縮規則的唯一標識符，N 的取值範圍：1～10。 |
ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| PageNumber |
integer |
當前頁碼。 |
1 |
| PageSize |
integer |
每頁行數。 |
50 |
| TotalCount |
integer |
伸縮規則總數。 |
1 |
| ScalingRules |
object |
||
| ScalingRule |
array<object> |
伸縮規則資訊組成的集合。 |
|
|
array<object> |
伸縮規則資訊組成的集合。 |
||
| MetricName |
string |
預定義監控項目，適用於目標追蹤規則和預測規則。 目標追蹤伸縮規則的可能值：
預測規則的可能值：
|
CpuUtilization |
| AdjustmentType |
string |
伸縮規則的調整方式。可能值如下：
|
QuantityChangeInCapacity |
| InitialMaxSize |
integer |
伸縮組實例數的上限，與 PredictiveValueBehavior 搭配使用。 |
100 |
| EstimatedInstanceWarmup |
integer |
新建立的執行個體需要進行一系列準備動作（即預熱）所需的時間。在預熱期間內，已啟動的執行個體不會影響自動調整群組的監控指標。 |
300 |
| ScaleOutEvaluationCount |
integer |
建立目標追蹤規則後，系統會自動建立警示任務。本參數用於指定對應的擴容警示任務觸發警示時，所需連續滿足閾值條件的次數。 |
3 |
| PredictiveScalingMode |
string |
預測規則的模式。可能值：
|
PredictAndScale |
| MinAdjustmentMagnitude |
integer |
伸縮規則的最小調整實例數量，僅在伸縮規則類型為 |
1 |
| ScalingRuleAri |
string |
伸縮規則的唯一識別碼。 |
ari:acs:ess:cn-hangzhou:140692647406****:scalingrule/asr-bp1dvirgwkoowxk7**** |
| PredictiveTaskBufferTime |
integer |
預測規則自動建立的預測任務預設皆於整點執行，您可以設定預先啟動時間，提前執行預測任務以預先準備資源。可能值：0～60，單位：分鐘。 |
30 |
| MinSize |
integer |
伸縮群組的最小執行個體數。 |
1 |
| ScalingGroupId |
string |
自動調整群組的 ID。 |
asg-bp1ffogfdauy0jw0**** |
| PredictiveValueBehavior |
string |
預測規則最大值處理方式。可能值：
|
MaxOverridePredictiveValue |
| TargetValue |
number |
目標值。當自動調整規則為目標追蹤規則或預測規則時，該自動調整規則會透過新增或移除執行個體，將指標維持在目標值附近。 |
0.125 |
| Cooldown |
integer |
伸縮規則的冷卻時間，僅適用於簡單規則。可能值：0～86400，單位：秒。 |
20 |
| MaxSize |
integer |
伸縮群組的最大執行個體數。 |
2 |
| PredictiveValueBuffer |
integer |
當 PredictiveValueBehavior 設為 PredictiveValueOverrideMaxWithBuffer 時生效，預測值會依照此比例增加；若增加後的數值大於初始最大值，則採用增加後的數值。可能值：0～100。 |
50 |
| ScalingRuleType |
string |
伸縮規則類型。可能值：
|
SimpleScalingRule |
| AdjustmentValue |
integer |
伸縮規則的調整值。 |
1 |
| ScaleInEvaluationCount |
integer |
建立目標追蹤規則後，會自動建立告警任務。本參數用於指定對應的縮容告警任務觸發告警時，所需連續滿足閾值條件的次數。 |
15 |
| DisableScaleIn |
boolean |
是否停用縮容，僅適用於目標追蹤規則。可能值：
|
true |
| ScalingRuleName |
string |
伸縮規則的名稱。 |
scalingrule**** |
| ScalingRuleId |
string |
自動調整規則的 ID。 |
asr-bp1dvirgwkoowxk7**** |
| Alarms |
object |
||
| Alarm |
array<object> |
自動調整規則所關聯的雲端監控警示任務。僅在 ShowAlarmRules 參數為 true 時，才會傳回自動調整規則所關聯的雲端監控警示任務；否則傳回空清單。 |
|
|
array<object> |
與伸縮規則關聯的雲監控告警任務。僅在 ShowAlarmRules 參數為 true 時，返回與伸縮規則關聯的雲監控告警任務；否則返回空列表。 |
||
| AlarmTaskId |
string |
與伸縮規則關聯的警示任務 ID。 |
asg-bp18p2yfxow2dloq****_1f9458d1-70e1-4bee-8c7f-7a47695b**** |
| ComparisonOperator |
string |
與伸縮規則關聯的告警任務所使用的監控項統計值與閾值之間的比較運算符，用於指定監控項統計值與閾值在何種關係下符合觸發條件。可能的取值如下：
|
>= |
| MetricName |
string |
與伸縮規則關聯的告警任務所監控的監控項名稱。 |
CpuUtilization |
| EvaluationCount |
integer |
與伸縮規則關聯的告警任務需連續滿足閾值表達式的次數，才會進入告警狀態。 |
3 |
| AlarmTaskName |
string |
與伸縮規則關聯的警示任務名稱。 |
alarmtask**** |
| MetricType |
string |
與伸縮規則關聯的告警任務類型。可能的取值如下：
|
system |
| Threshold |
number |
與伸縮規則關聯的警示任務的警示閾值。 |
50 |
| Statistics |
string |
與伸縮規則關聯的警示任務的統計方式。可能值：
|
Average |
| Dimensions |
object |
||
| Dimension |
array<object> |
與伸縮規則關聯的警報任務的維度資訊。 |
|
|
object |
與伸縮規則關聯的警報任務的維度資訊。 |
||
| DimensionKey |
string |
監控項目關聯的警報任務的維度資訊鍵。可能值：
|
scaling_group |
| DimensionValue |
string |
監控項目關聯的警報任務的維度資訊值。 |
asg-bp18p2yfxow2dloq**** |
| Period |
integer |
目標追蹤規則中統計監控項目資料的週期。 |
60 |
| StepAdjustments |
object |
||
| StepAdjustment |
array<object> |
步進規則的分步步驟。 |
|
|
object |
步進規則的分步步驟。 |
||
| MetricIntervalUpperBound |
number |
分步步驟的上邊界，可能值：-9.999999E18～9.999999E18。 |
5.0 |
| ScalingAdjustment |
integer |
分步調整對應的實例擴展數量。 |
1 |
| MetricIntervalLowerBound |
number |
分步調整的下界，可能值：-9.999999E18～9.999999E18。 |
1.0 |
| AlarmDimensions |
object |
||
| AlarmDimension |
array<object> |
監控項目關聯的維度資訊，適用於目標追蹤規則；當監控項目需要額外維度資訊時設定，例如 |
|
|
object |
監控項目關聯的維度資訊，適用於目標追蹤規則；當監控項目需要額外維度資訊時設定，例如 |
||
| DimensionKey |
string |
監控項關聯的維度資訊鍵。 |
rulePool |
| DimensionValue |
string |
監控項目關聯的維度資訊值。 |
sgp-l1cbirz451yxu2**** |
| MetricType |
string |
監控項類型。可能值：
|
system |
| HybridMonitorNamespace |
string |
企業雲監控指標倉儲 ID。 管理指標倉儲，請參見管理指標倉儲。 |
aliyun-test |
| HybridMetrics |
object |
||
| HybridMetric |
array<object> |
企業雲監控指標設定。如何設定，請參閱 使用公式運算自訂目標追蹤規則。 |
|
|
array<object> |
|||
| Id |
string |
公制運算表達式中指標的引用 ID。 |
a |
| Expression |
string |
多個企業雲監控指標的公制運算表達式，表達式的計算結果將用於觸發擴縮容。 運算表達式需符合逆波蘭表示法（RPN）規範，且運算子僅支援 |
(a+b)/2 |
| MetricName |
string |
企業雲監控指標倉儲中的指標名稱。 |
AliyunSmq_NumberOfMessagesVisible |
| Statistic |
string |
指標的統計方式。可能值：
|
Average |
| Dimensions |
object |
||
| Dimension |
array<object> |
指標維度。用於指定指標監控的資源。 |
|
|
object |
|||
| DimensionKey |
string |
指標維度鍵。 |
queue |
| DimensionValue |
string |
指標維度值。 |
testQueue |
樣本
正常返回樣本
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"PageNumber": 1,
"PageSize": 50,
"TotalCount": 1,
"ScalingRules": {
"ScalingRule": [
{
"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": {
"Alarm": [
{
"AlarmTaskId": "asg-bp18p2yfxow2dloq****_1f9458d1-70e1-4bee-8c7f-7a47695b****",
"ComparisonOperator": ">=",
"MetricName": "CpuUtilization",
"EvaluationCount": 3,
"AlarmTaskName": "alarmtask****",
"MetricType": "system",
"Threshold": 50,
"Statistics": "Average",
"Dimensions": {
"Dimension": [
{
"DimensionKey": "scaling_group",
"DimensionValue": "asg-bp18p2yfxow2dloq****"
}
]
},
"Period": 60
}
]
},
"StepAdjustments": {
"StepAdjustment": [
{
"MetricIntervalUpperBound": 5,
"ScalingAdjustment": 1,
"MetricIntervalLowerBound": 1
}
]
},
"AlarmDimensions": {
"AlarmDimension": [
{
"DimensionKey": "rulePool",
"DimensionValue": "sgp-l1cbirz451yxu2****"
}
]
},
"MetricType": "system",
"HybridMonitorNamespace": "aliyun-test",
"HybridMetrics": {
"HybridMetric": [
{
"Id": "a",
"Expression": "(a+b)/2",
"MetricName": "AliyunSmq_NumberOfMessagesVisible",
"Statistic": "Average",
"Dimensions": {
"Dimension": [
{
"DimensionKey": "queue",
"DimensionValue": "testQueue"
}
]
}
}
]
}
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。