API 概覽 - Auto Scaling

API標準及多語言預置SDK

本產品（Ess/2014-08-28）的OpenAPI採用RPC簽名風格。我們已經為開發人員封裝了常見程式設計語言的SDK，開發人員可通過下載SDK直接調用本產品OpenAPI而無需關心技術細節。如果現有SDK不能滿足使用需求，可通過簽名機制進行自簽名對接。由於自簽名細節非常複雜，需花費 5個工作日左右。因此建議加入我們的服務DingTalk群（147535001692），在專家指導下進行簽名對接。

在使用API前，您需要準備好身份帳號及存取金鑰（AccessKey），才能有效通過用戶端工具（SDK、CLI等）訪問API。細節請參見擷取AccessKey。

自訂簽名情境

若您的業務情境有特殊需求，需通過自簽名方式對接 API，建議優先諮詢我們的支援人員團隊（服務DingTalk群：147535001692），擷取專業指導以確保高效接入。

帳號與安全準備

阿里雲帳號具備對所有資源的完全系統管理權限。一旦 AccessKey 泄露，所有相關資源都將面臨未經授權訪問的風險。為確保安全，建議建立一個僅具備 API 存取權限的RAM使用者並配置其 AccessKey，同時基於最小許可權原則 (PoLP) 配置 RAM 策略。僅在明確需要阿里雲帳號許可權的特定情境下，才使用阿里雲帳號。

伸縮群組

API	標題	API概述
CreateScalingGroup	建立一個伸縮組	如果您需要根據業務變動需求與策略自動增加或減少指定類型的執行個體數量，則可以透過呼叫API CreateScalingGroup建立伸縮組來自動調整您的業務運算能力（即執行個體數量）。
DeleteScalingGroup	刪除一個伸縮組	刪除一個伸縮組。
ModifyScalingGroup	修改一個伸縮組	修改一個伸縮組。
EnableScalingGroup	啟用一個伸縮組	啟用一個伸縮組。
DisableScalingGroup	停用一個伸縮組	停用一個伸縮組。
SetGroupDeletionProtection	為伸縮組開啟或關閉刪除保護	為伸縮組開啟或關閉刪除保護。
AttachLoadBalancers	新增一個或多個負載平衡執行個體	新增一個或多個負載平衡執行個體。
DetachLoadBalancers	移除一個或多個負載平衡執行個體	移除一個或多個負載平衡執行個體。
DetachDBInstances	移除一個或多個 RDS 執行個體	移除一個或多個 RDS 執行個體。
AttachDBInstances	新增一個或多個 RDS 執行個體	新增一個或多個 RDS 執行個體。
AttachVServerGroups	AttachVServerGroups	新增負載平衡執行個體下的一個或者多個虛擬伺服器群組。
DetachVServerGroups	DetachVServerGroups	移除一個或者多個虛擬伺服器群組。
DescribeScalingGroups	查詢伸縮組列表	查詢伸縮組。
DescribeScalingInstances	查詢伸縮組內執行個體列表	查詢伸縮組內 ECS 執行個體、ECI 執行個體或託管執行個體的列表，並列出 ECS 執行個體、ECI 執行個體或託管執行個體的資訊。
DescribeScalingActivities	查詢伸縮活動	查詢伸縮活動。
DescribeScalingActivityDetail	查詢一個伸縮活動的詳細資訊	查詢一個伸縮活動的詳細資訊。
DescribeLimitation	查詢資源配額限制	查詢資源配額限制。
DescribeElasticStrength	查詢伸縮組的彈性強度	伸縮組配置的有效性很大程度決定了擴容過程的成功率。彈性伸縮透過彈性強度描述伸縮配置的有效性，讓配置的優良程度量化，幫助使用者針對性地最佳化伸縮配置。
VerifyAuthentication	偵測是否已授權彈性伸縮操作ECS資源	偵測是否已授權彈性伸縮調操作ECS資源。
SuspendProcesses	暫停伸縮組中的指定流程	暫停伸縮組中的指定流程。
ResumeProcesses	恢復伸縮組中被暫停的流程	恢復伸縮組中被暫停的流程。
VerifyUser	驗證是否已開通彈性伸縮服務	驗證是否已開通彈性伸縮服務。

伸縮配置

API	標題	API概述
CreateScalingConfiguration	CreateScalingConfiguration	透過呼叫 CreateScalingConfiguration 介面，並指定伸縮組 ID、執行個體規格、執行個體映像等資訊，為伸縮組建立一個 ECS 類型的伸縮配置。
DeleteScalingConfiguration	刪除一個伸縮配置	刪除一個伸縮配置。
ModifyScalingConfiguration	ModifyScalingConfiguration	如果當前的伸縮配置不滿足業務需求，您可以透過呼叫API ModifyScalingConfiguration修改ECS類型的伸縮配置（即待擴容的ECS執行個體範本）。
DescribeScalingConfigurations	查詢伸縮配置的資訊。	查詢伸縮配置的資訊。
DeactivateScalingConfiguration	使指定伸縮配置進入失效狀態	使指定伸縮配置進入失效狀態。

伸縮規則

API	標題	API概述
CreateScalingRule	CreateScalingRule	建立一條伸縮規則。
DeleteScalingRule	刪除一條伸縮規則	刪除一條伸縮規則。
ModifyScalingRule	修改一條伸縮規則	修改一條伸縮規則。
DescribeScalingRules	查詢伸縮規則	查詢伸縮組下的伸縮規則，並列出伸縮規則的資訊。

觸發任務

API	標題	API概述
AttachInstances	為伸縮組手動添加ECS執行個體	為伸縮組手動添加ECS執行個體。
DetachInstances	從一個伸縮組移出一台或多台ECS執行個體	從一個伸縮組移出一台或多台ECS執行個體。
ExecuteScalingRule	執行一條伸縮規則	執行一條伸縮規則。
RemoveInstances	從一個伸縮組刪除一台或多台ECS執行個體	從一個伸縮組刪除一台或多台ECS執行個體。

排程任務

API	標題	API概述
CreateScheduledTask	建立一個定時任務	建立一個定時任務。
DeleteScheduledTask	刪除一個定時任務	刪除一個定時任務。
ModifyScheduledTask	修改一個定時任務的資訊	修改一個定時任務的資訊。
DescribeScheduledTasks	查詢定時任務的資訊	查詢定時任務的資訊。

生命週期掛鉤

API	標題	API概述
CreateLifecycleHook	為伸縮組建立一個或多個生命週期掛鉤	為伸縮組建立一個或多個生命週期掛鉤。
DeleteLifecycleHook	刪除一個生命週期掛鉤	刪除一個生命週期掛鉤。。
ModifyLifecycleHook	修改一個生命週期掛鉤的資訊	修改一個生命週期掛鉤的資訊。
DescribeLifecycleActions	查詢 Lifecycle Token	根據伸縮活動ID和狀態查詢 Lifecycle Token。
DescribeLifecycleHooks	DescribeLifecycleHooks	查詢生命週期掛鉤。
RecordLifecycleActionHeartbeat	延長生命週期掛鉤觸發後被掛起等待時間	延長一個生命週期掛鉤觸發後被掛起的 ECS 執行個體的等待時間。
CompleteLifecycleAction	提前結束伸縮活動的等待狀態	提前結束伸縮活動的等待狀態。

事件通知

API	標題	API概述
CreateNotificationConfiguration	建立彈性伸縮事件及資源變化通知	建立彈性伸縮事件及資源變化通知。
DeleteNotificationConfiguration	刪除一條彈性伸縮事件及資源變化通知	刪除一條彈性伸縮事件及資源變化通知。
ModifyNotificationConfiguration	修改一條彈性伸縮事件及資源變化通知	修改一條彈性伸縮事件及資源變化通知。
DescribeNotificationConfigurations	查詢彈性伸縮事件及資源變化通知	查詢您建立的彈性伸縮事件及資源變化通知。
DescribeNotificationTypes	查詢彈性伸縮事件及資源變化通知的類型	查詢彈性伸縮事件及資源變化通知的類型。

執行個體

API	標題	API概述
SetInstancesProtection	開始或停止保護伸縮組內ECS執行個體	開始保護或者停止保護伸縮組內的一台或者多台ECS執行個體。
SetInstanceHealth	設定伸縮組內 ECS 執行個體的健康狀態	設定伸縮組內 ECS 執行個體的健康狀態。
EnterStandby	將伸縮組內的ECS執行個體設定為備用狀態	將伸縮組內的ECS執行個體設定為備用狀態。
ExitStandby	使備用狀態執行個體進入運行狀態	使伸縮組內處於備用狀態的ECS執行個體進入運行狀態。
RebalanceInstances	重新平衡ECS執行個體分佈	重新平衡多可用區伸縮組內 ECS 執行個體的分佈。

地域

API	標題	API概述
DescribeRegions	查詢可以使用彈性伸縮服務的地域	查詢可以使用彈性伸縮服務的地域。

API	標題	API概述
ListTagResources	ListTagResources	查詢一個或多個彈性伸縮資源已經綁定的標籤列表。
ListTagKeys	查詢彈性伸縮資源標籤鍵的列表	查詢彈性伸縮資源標籤鍵的列表。
ListTagValues	查詢彈性伸縮資源標籤鍵對應的標籤值	查詢彈性伸縮資源標籤鍵對應的標籤值。
TagResources	TagResources	為指定的彈性伸縮資源列表統一建立並繫結標籤。
UntagResources	為指定的彈性伸縮資源列表統一解除綁定標籤	解除綁定後，如果該標籤沒有綁定其他任何資源，會被自動刪除。

警示

API	標題	API概述
CreateAlarm	建立一個報警任務	建立一個報警任務。
DeleteAlarm	刪除一個報警任務	刪除一個報警任務。
DisableAlarm	停用一個報警任務	停用一個報警任務。
EnableAlarm	啟用一個報警任務	啟用一個報警任務。
ModifyAlarm	ModifyAlarm	修改一個報警任務。
DescribeAlarms	查詢報警任務的資訊	查詢報警任務的資訊。

其他

API	標題	API概述
AttachAlbServerGroups	添加一個或多個 ALB 伺服器組	向伸縮組添加一個或多個 ALB 伺服器組。
CreateEciScalingConfiguration	建立一個伸縮配置	建立一個 ECI 類型的伸縮配置。
DeleteEciScalingConfiguration	刪除一個伸縮配置	刪除一個 ECI 類型的伸縮配置。
DescribeEciScalingConfigurations	查詢伸縮配置的資訊	查詢 ECI 型別的伸縮配置資訊。
DetachAlbServerGroups	移出一個或多個 ALB 伺服器組	從伸縮組移出一個或多個 ALB 伺服器組。
ModifyEciScalingConfiguration	修改一個伸縮配置	呼叫ModifyScalingConfiguration修改一個ECI型別的伸縮配置。
ScaleWithAdjustment	基於指定調整規則觸發彈性擴縮容	基於指定調整規則觸發彈性擴縮容。
ChangeResourceGroup	變更伸縮組所屬的資源組	將一個伸縮組作為資源加入一個資源組。
AttachServerGroups	添加一個或多個負載平衡伺服器組	從伸縮組添加一個或多個負載平衡伺服器組，支援的伺服器組類型包括：應用型負載平衡ALB (Application Load Balancer)、網路型負載平衡NLB (Network Load Balancer)。
DetachServerGroups	移除一個或多個負載平衡伺服器群組	從伸縮組移除一個或多個負載平衡伺服器群組，支援的伺服器群組類型包括應用型負載平衡ALB（Application Load Balancer）和網路型負載平衡NLB（Network Load Balancer）。
ModifyInstanceAttribute	修改伸縮組中一台ECS執行個體的部分資訊	呼叫 API ModifyInstanceAttribute 修改伸縮組中一台 ECS 執行個體的部分資訊，目前僅支援修改手動添加到伸縮組中的執行個體的生命週期託管屬性，方便彈性伸縮更加靈活地管理伸縮組中的 ECS 執行個體。
DescribePatternTypes	DescribePatternTypes	使用指定執行個體屬性方式配置伸縮配置時，呼叫 API DescribePatternTypes 介面根據指定執行個體的 vCPU 核數、記憶體大小、規格族級別以及可接受的最高價格等屬性，篩選出符合要求的執行個體規格。
ApplyScalingGroup	ApplyScalingGroup	如果您需要透過設定檔方式快速建立和管理ECI類型的伸縮組，則可以透過呼叫API ApplyScalingGroup來實現該功能。
ModifyAlertConfiguration	ModifyAlertConfiguration	伸縮活動在執行成功、失敗或者被拒絕時，彈性伸縮支援透過簡訊、郵件方式傳送訊息通知，您需要在接收到訊息後自行處理相關事件。您可以呼叫 API ModifyAlertConfiguration 設定伸縮組中需要傳送簡訊、郵件通知的伸縮活動狀態，方便您及時了解某個伸縮活動的變化，快速回應提高擴縮容效率。
DescribeAlertConfiguration	DescribeAlertConfiguration	伸縮活動在執行成功、失敗或者被拒絕時，彈性伸縮支援透過簡訊、郵件方式傳送訊息通知，您需要在接收到訊息後自行處理相關事件。您可以呼叫 API DescribeAlertConfiguration 查詢伸縮組中的傳送簡訊、郵件通知的伸縮活動狀態，方便您及時了解某個伸縮活動的變化，快速回應提高擴縮容效率。
SuspendInstanceRefresh	SuspendInstanceRefresh	執行個體重新整理任務執行期間，如果您覺得配置存在問題，但不確定是否需要回滾，您可以呼叫此 API 暫停執行個體重新整理任務，在此期間，您可以檢查配置是否正確。
ResumeInstanceRefresh	ResumeInstanceRefresh	恢復一個處於暫停狀態的執行個體重新整理任務。
CancelInstanceRefresh	CancelInstanceRefresh	取消執行個體重新整理任務，會保留已經完成替換和擴容的新執行個體。
DescribeInstanceRefreshes	DescribeInstanceRefreshes	如果您需要查看執行個體重新整理任務的基本資訊、執行個體重新整理任務的進度等資訊，您可以呼叫 DescribeInstanceRefreshes 查詢該伸縮組的執行個體重新整理任務。
RollbackInstanceRefresh	RollbackInstanceRefresh	在執行個體重新整理任務執行過程中，如果發現期望配置不符合需求，您可以呼叫此 API 來回滾執行個體重新整理任務。在回滾時，系統將使用伸縮組當前生效的配置來建立新的執行個體，以替換那些基於期望配置建立的執行個體。
StartInstanceRefresh	StartInstanceRefresh	當您需要將新的伸縮配置套用至伸縮群組執行個體中，或需要更新伸縮群組中執行個體的映像時，您可以呼叫本介面完成伸縮群組中執行個體的重新整理。