全部產品
Search
文件中心

Auto Scaling:ExecuteScalingRule - 執行一條伸縮規則

更新時間:May 21, 2026

執行伸縮規則可以實現手動或自動調整ECS執行個體或ECI執行個體資源。其中,對於簡單規則和步進規則,您才可以調用API ExecuteScalingRule執行一條伸縮規則,而對於目標追蹤規則和預測規則,Auto Scaling會自動執行伸縮規則。

介面說明

調用該介面前請確保滿足以下條件:

  • 伸縮組處於 Active 狀態。

  • 伸縮組沒有執行中的伸縮活動。

當伸縮組沒有執行中的伸縮活動時,該介面可以繞過冷卻時間(Cooldown)直接執行伸縮活動。

調用該介面返回成功,只是表示Auto Scaling服務接受了該介面的調用請求,可以執行伸縮活動,但不代表伸縮活動能夠執行成功。您需要通過返回的 ScalingActivityId 查看該伸縮活動的執行狀態。

如果伸縮規則需要增加的 ECS 執行個體數加上當前伸縮組的執行個體數(Total Capacity)大於 MaxSize,則按 Total Capacity = MaxSize 執行伸縮活動。

如果當前伸縮組的執行個體數(Total Capacity)減去伸縮規則需要減少的 ECS 執行個體數小於 MinSize,則按 Total Capacity = MinSize 執行伸縮活動。

單次調整的 ECS 執行個體台數存在限制,請參見 CreateScalingRule 中的 AdjustmentValue 參數說明。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ess:ExecuteScalingRule

update

*ScalingGroup

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

請求參數

名稱

類型

必填

描述

樣本值

ScalingRuleAri

string

伸縮規則唯一識別碼。

說明

調用 API 執行伸縮規則時,只支援執行簡單規則和步進規則,且執行步進規則時必須同時指定BreachThresholdMetricValue

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

ClientToken

string

用於保證請求的等冪性。

由用戶端產生該參數值,要保證在不同請求間唯一,最大不超過 64 個 ASCII 字元。詳情請參見如何保證等冪性

123e4567-e89b-12d3-a456-426655440000

BreachThreshold

number

執行步進伸縮規則時指定的當前閾值,取值範圍:-9.999999E18~9.999999E18。

1.0

MetricValue

number

執行步進伸縮規則時指定的當前指標值,取值範圍:-9.999999E18~9.999999E18。

1.0

RegionId

string

伸縮組所屬地區的 ID。

cn-qingdao

返回參數

名稱

類型

描述

樣本值

object

ScalingActivityId

string

伸縮活動的 ID。

asa-bp13o672yeautiil****

RequestId

string

請求 ID。

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

樣本

正常返回樣本

JSON格式

{
  "ScalingActivityId": "asa-bp13o672yeautiil****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情