ScaleoutApplicationWithNewInstances - 代購執行個體並擴容到指定分組 -

在EDAS中代購ECS執行個體，並將代購的執行個體擴容到指定的應用分組。

介面說明

限制說明

若應用配置並開啟了Auto Scaling規則，在觸發自動縮容時將優先移除此介面代購的執行個體。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

edas:ECSPurchase

update

*全部資源

*

無

請求文法

POST /pop/v5/scaling/scale_out HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
AppId	string	否	擴容的目標應用 ID，可通過調用 ListApplication 介面來擷取，詳情請參見 ListApplication 。	e370c17f-*****-3df0721a327
GroupId	string	否	擴容應用的目標分組 ID，可通過調用 ListDeployGroup 介面來擷取，詳情請參見 ListDeployGroup 。	e37**********-33df0721a327
ScalingNum	integer	是	此次擴容的執行個體數量。	2
TemplateId	string	否	ECS 啟動模板 ID，可通過調用 DescribeLaunchTemplates 介面擷取，詳情請參見 DescribeLaunchTemplates 。	lt-****hy9s2
TemplateVersion	string	否	ECS 啟動模板版本，可通過調用 DescribeLaunchTemplateVersions 介面擷取，詳情請參見 DescribeLaunchTemplateVersions 。說明設定為`-1`代表使用預設的啟動模板版本。	-1
ScalingPolicy	string	否	指定伸縮組的回收模式，取值範圍： recycle：伸縮組的回收模式為停機回收模式。 release：伸縮組的回收模式為釋放模式。從一個伸縮組刪除執行個體，詳情請參見 RemoveInstances 。	release
TemplateInstanceId	string	否	擴容時使用的現有 ECS 執行個體 ID，若填寫此項，將以指定的 ECS 執行個體的規格和配置為模板來購買新的 ECS 執行個體。	i-28wt4****
ClusterId	string	否	擴容的叢集 ID，若指定了應用和分組進行擴容，此參數將被忽略。	e37**********-33df0721a327
InstanceChargeType	string	否	執行個體的付費方式。取值範圍： PrePaid：訂用帳戶。 PostPaid（預設）：隨用隨付。	PrePaid
InstanceChargePeriodUnit	string	否	訂用帳戶計費方式的時間長度單位。取值範圍： Week：按周計費。 Month（預設）：按月計費。	Month
InstanceChargePeriod	integer	否	購買資源的時間長度，單位由 InstanceChargePeriodUnit 指定。當參數 InstanceChargeType 取值為 PrePaid 時才生效。 InstanceChargePeriodUnit=Week 時，Period 取值：{“1”, “2”, “3”, “4”}。 InstanceChargePeriodUnit=Month 時，Period 取值：{“1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “10”, “11”, “12”, “24”, “36”, ”48”, ”60”}。	1
AutoRenew	boolean	否	是否要自動續約。當參數 InstanceChargeType 取值 PrePaid 時才生效。取值範圍： true：自動續約。 false（預設）：不自動續約。	true
AutoRenewPeriod	integer	否	單次自動續約的續約時間長度。取值範圍： InstanceChargePeriodUnit=Week 時：{“1”, “2”, “3”}。 InstanceChargePeriodUnit=Month 時：{“1”, “2”, “3”, “6”, “12”, "24", "36", "48", "60"}。預設值：1。	1

返回參數

名稱	類型	描述	樣本值
	object	介面響應。
ChangeOrderId	string	應用擴容的變更記錄 ID。	e370c17f-*****-3df0721a327
Code	integer	介面狀態或 POP 錯誤碼。	200
Message	string	附加訊息。	success
RequestId	string	請求 ID。	e370c17f-*****-3df0721a327
InstanceIds	array	ECS 執行個體 ID 列表。
	string	代購產生的 ECS 執行個體列表。	["i-28wt4**","i-28wt4**"]

樣本

正常返回樣本

JSON格式

{
  "ChangeOrderId": "e370c17f-*****-3df0721a327",
  "Code": 200,
  "Message": "success",
  "RequestId": "e370c17f-*****-3df0721a327",
  "InstanceIds": [
    "[\"i-28wt4****\",\"i-28wt4****\"]"
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
500	Edas.errorcode.PermissionDenied.message	You are not authorized to perform the operation.	無許可權操作

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

變更歷史

更多資訊，參考變更詳情。