ModifyScalingRule
創(chuàng)建伸縮規(guī)則后,如果當(dāng)前伸縮規(guī)則不再滿足需求,您可以調(diào)用API ModifyScalingRule修改一項或多項伸縮規(guī)則屬性,無需重新創(chuàng)建新的伸縮規(guī)則,避免不必要的重復(fù)操作,節(jié)約時間和資源成本。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ModifyScalingRule | 系統(tǒng)規(guī)定參數(shù)。取值:ModifyScalingRule。 |
ScalingRuleId | String | 是 | asr-bp1dvirgwkoowxk7**** | 待修改伸縮規(guī)則的ID。 |
ScalingRuleName | String | 否 | scalingrule**** | 伸縮規(guī)則的名稱,由2~64個字符組成,以數(shù)字、大小字母或中文開頭,可包含數(shù)字、下劃線(_)、短劃線(-)或半角句號(.)。 說明 同一用戶賬號同一地域同一伸縮組內(nèi)伸縮規(guī)則唯一。 |
Cooldown | Integer | 否 | 60 | 伸縮規(guī)則的冷卻時間,僅適用于簡單規(guī)則。 取值范圍:0~86400,單位:秒。 |
MinAdjustmentMagnitude | Integer | 否 | 1 | 伸縮規(guī)則最小調(diào)整實例數(shù),僅當(dāng)伸縮規(guī)則類型為 |
AdjustmentType | String | 否 | QuantityChangeInCapacity | 伸縮規(guī)則的調(diào)整方式,適用于簡單規(guī)則和步進規(guī)則,且此時該項必選。取值范圍:
|
AdjustmentValue | Integer | 否 | 100 | 伸縮規(guī)則的調(diào)整值,適用于簡單規(guī)則和步進規(guī)則,且此時該項必選。任何情況下,單次調(diào)整的ECS實例臺數(shù)都不能超過1000。不同調(diào)整方式對應(yīng)的取值范圍:
|
EstimatedInstanceWarmup | Integer | 否 | 60 | 實例預(yù)熱時間,適用于目標(biāo)追蹤規(guī)則和步進規(guī)則。處于預(yù)熱狀態(tài)的ECS實例將正常的加入伸縮組,但是期間將不會向云監(jiān)控上報監(jiān)控數(shù)據(jù)。 說明 動態(tài)計算需要擴縮容的ECS實例數(shù)量時,處于預(yù)熱狀態(tài)的實例不計入現(xiàn)有實例數(shù)量。 取值范圍:0~86400,單位:秒。 |
MetricName | String | 否 | CpuUtilization | 預(yù)定義監(jiān)控項,適用于目標(biāo)追蹤規(guī)則和預(yù)測規(guī)則,且此時該項必選。 目標(biāo)追蹤規(guī)則取值范圍:
預(yù)測規(guī)則取值范圍:
更多信息,請參見系統(tǒng)監(jiān)控報警任務(wù)。 |
TargetValue | Float | 否 | 0.125 | 目標(biāo)值,適用于目標(biāo)追蹤規(guī)則和預(yù)測規(guī)則。TargetValue最多保留小數(shù)點后三位,且必須大于0。 |
DisableScaleIn | Boolean | 否 | true | 是否禁用縮容,僅適用于目標(biāo)追蹤規(guī)則。 |
ScaleInEvaluationCount | Integer | 否 | 15 | 創(chuàng)建目標(biāo)追蹤規(guī)則后,會自動創(chuàng)建報警任務(wù)。本參數(shù)用于指定對應(yīng)的縮容報警任務(wù)觸發(fā)報警時,所需連續(xù)滿足閾值條件的次數(shù)。 |
ScaleOutEvaluationCount | Integer | 否 | 3 | 創(chuàng)建目標(biāo)追蹤規(guī)則后,會自動創(chuàng)建報警任務(wù)。本參數(shù)用于指定對應(yīng)的擴容報警任務(wù)觸發(fā)報警時,所需連續(xù)滿足閾值條件的次數(shù)。 |
PredictiveScalingMode | String | 否 | PredictAndScale | 預(yù)測規(guī)則的模式。取值范圍:
|
PredictiveValueBehavior | String | 否 | MaxOverridePredictiveValue | 預(yù)測規(guī)則最大值處理方式。取值范圍:
|
PredictiveValueBuffer | Integer | 否 | 50 |
|
PredictiveTaskBufferTime | Integer | 否 | 30 | 預(yù)測規(guī)則自動創(chuàng)建的預(yù)測任務(wù)默認均在整點執(zhí)行,您可以設(shè)置預(yù)啟動時間提前執(zhí)行預(yù)測任務(wù),預(yù)先準(zhǔn)備資源。取值范圍:0~60。 |
InitialMaxSize | Integer | 否 | 100 | 伸縮組實例數(shù)上限,和PredictiveValueBehavior結(jié)合使用。 |
StepAdjustment.N.MetricIntervalUpperBound | Float | 否 | 5.0 | 分步步驟的上邊界,僅適用于步進規(guī)則。取值范圍:-9.999999E18~9.999999E18。 |
StepAdjustment.N.ScalingAdjustment | Integer | 否 | 1 | 分步步驟對應(yīng)的實例擴展數(shù)量,僅適用于步進規(guī)則。 |
StepAdjustment.N.MetricIntervalLowerBound | Float | 否 | 1.0 | 分步步驟的下邊界,僅適用于步進規(guī)則。取值范圍:-9.999999E18~9.999999E18。 |
AlarmDimension.N.DimensionKey | String | 否 | rulePool | 監(jiān)控項關(guān)聯(lián)的維度信息鍵。 |
AlarmDimension.N.DimensionValue | String | 否 | sgp-l1cbirz451yxu2**** | 監(jiān)控項關(guān)聯(lián)的維度信息值。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 請求ID。 |
示例
請求示例
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****"}]
&公共請求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyScalingRuleResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingRuleResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
404 |
InvalidScalingRuleId.NotFound |
The specified scaling rule does not exist. |
指定的伸縮組規(guī)則在該用戶賬號下不存在。 |
400 |
InvalidScalingRuleName.Duplicate |
The specified value of parameter <parameter name> is duplicated. |
伸縮規(guī)則名字已存在。 |
400 |
QuotaExceeded.ScalingRule |
Scaling rule quota exceeded in the specified scaling group. |
用戶的伸縮規(guī)則使用個數(shù)達到上限。 |
400 |
TargetTrackingScalingRule.UnsupportedMetric |
Specific metric is not supported for target tracking scaling rule. |
目標(biāo)追蹤規(guī)則不支持當(dāng)前監(jiān)控指標(biāo)。 |
400 |
TargetTrackingScalingRule.DumplicateMetric |
Only one TargetTrackingScaling rule for a given metric specification is allowed. |
一個伸縮組中,同一監(jiān)控指標(biāo)只能存在一條目標(biāo)追蹤規(guī)則。 |
400 |
InvalidMinAdjustmentMagnitudeMismatchAdjustmentType |
MinAdjustmentMagnitude is not supported by the specified adjustment type. |
MinAdjustmentMagnitude不支持當(dāng)前伸縮規(guī)則調(diào)整類型。 |
400 |
InvalidStepAdjustments.MultipleNullUpperBound |
At most one StepAdjustment may have an unspecified upper bound. |
最多只能有一個分步步驟不指定分步上界。 |
400 |
InvalidStepAdjustments.MultipleNullLowerBound |
At most one StepAdjustment may have an unspecified lower bound. |
最多只能有一個分步步驟不指定分步下界。 |
400 |
InvalidStepAdjustments.NoNullLowerBound |
There must be a StepAdjustment with an unspecified lower bound when one StepAdjustment has a negative lower bound. |
當(dāng)存在一個分步下界為負數(shù)時,則必須有一個未指定分步下界的分步步驟。 |
400 |
InvalidStepAdjustments.NoNullUpperBound |
There must be a StepAdjustment with an unspecified upper bound when one StepAdjustment has a positive upper bound. |
當(dāng)存在一個正數(shù)的分步上界時,則必有一個未指定分步上界的分步步驟。 |
400 |
InvalidStepAdjustments.Gap |
StepAdjustment intervals can not have gaps between them. |
分步步驟之間不能有間隔。 |
400 |
InvalidStepAdjustments.Overlap |
StepAdjustment intervals can not overlap. |
分步步驟之間不能重疊。 |
400 |
InvalidStepAdjustments.LowerGtUpper |
LowerBound must be less than the UpperBound for StepAdjustment :%s. |
同一分步步驟中,分步下界必須小于分步上界。 |
400 |
InvalidStepAdjustments.BothNull |
Both lower and upper bounds of a StepAdjustment can not be left unspecified. |
同一分步步驟中,分步上界和分步下界不能同時不指定。 |
400 |
InvalidStepAdjustments.MaxNum |
Your scaling rule can have at most %s StepAdjustments. |
同一伸縮組中分步步驟數(shù)量超過閾值。 |
400 |
StepBeyondPermitRange |
Specific parameter "%s" beyond permit range. |
分步步驟的上界或下界超過了可選范圍。 |