全部產品
Search
文件中心

Auto Scaling:CreateScalingConfiguration

更新時間:Jan 14, 2025

通過調用CreateScalingConfiguration介面,並指定伸縮組ID、執行個體規格、執行個體鏡像等資訊,為伸縮組建立一個ECS類型的伸縮配置。

介面說明

伸縮配置用來指定彈性擴張時使用的ECS執行個體模板,支援以下執行個體配置方式:

  • InstancePatternInfo.N:智能配置模式,無需指定具體的執行個體規格,只需根據業務需求指定執行個體的vCPU核心數、記憶體大小、規格類型系列層級以及最高價格,系統會自動篩選符合要求的執行個體規格,並優先選擇價格最低的執行個體規格建立ECS執行個體。該模式僅適用於伸縮組的網路類型為專用網路,能夠有效降低擴容時執行個體規格庫存不足的情況。
  • InstanceType:指定一種執行個體規格。
  • InstanceTypes.N:指定多種執行個體規格。
  • InstanceTypeOverride.N:指定多種執行個體規格,並為不同的執行個體規格配置權重。
  • Cpu和Memory:指定CPU和記憶體定義執行個體規格的範圍,Auto Scaling會結合IO最佳化、可用性區域等因素確定可用執行個體規格集合,並根據價格排序為您建立價格最低的執行個體。該方式僅適用於伸縮組的擴縮容策略為成本最佳化策略,且伸縮配置未指定執行個體規格的情境。
  • 支援以下任一方式綁定主網卡。但需要注意每次調用介面時只能選用一種方式配置主網卡,兩種方式同時使用時將會導致介面調用失敗並返回錯誤資訊。
    • 通過SecurityGroupIdSecurityGroupIds.NIpv6AddressCount等參數直接設定主網卡的相關配置資訊。
    • 通過NetworkInterfaces.N設定主網卡以及輔助網卡的配置資訊,使用該參數時必須設定主網卡資訊。其中,NetworkInterfaces.N.InstanceType取值為Primary時,表示設定主網卡;當NetworkInterfaces.N.InstanceType取值為Secondary或空值時,表示設定輔助網卡。
說明 InstanceType、InstanceTypes.N、InstanceTypeOverride.N、Cpu和Memory這四種方式不能同時指定,但InstanceType或者InstanceTypes.N可以與InstancePatternInfo.N同時指定。與InstancePatternInfo.N同時指定時,Auto Scaling優先使用您指定的執行個體規格擴容,當指定的執行個體規格無庫存時,再使用符合InstancePatternInfo.N配置的執行個體規格。

調試

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

請求參數

名稱

類型

是否必選

樣本值

描述

Action String CreateScalingConfiguration

系統規定參數。取值:CreateScalingConfiguration

ScalingGroupId String asg-bp14wlu85wrpchm0****

伸縮配置所屬的伸縮組的ID。

ImageId String centos6u5_64_20G_aliaegis****.vhd

鏡像檔案ID,自動建立執行個體時使用的鏡像資源。

說明 該參數與ImageName參數作用相同,您可以根據實際情況進行二選一設定,即如果設定了ImageName參數,則ImageId參數將被忽略(非必填項)。
ImageName String image****

鏡像檔案名稱,同一個地區內鏡像名稱唯一。不支援通過該參數設定鏡像市場中的鏡像。

說明 該參數與ImageId參數作用相同,您可以根據實際情況進行二選一設定,即如果設定了ImageId參數,則ImageName參數將被忽略(非必填項)。
InstanceType String ecs.g6.large

ECS執行個體的一種執行個體規格,更多資訊,請參見執行個體規格類型系列

說明 InstanceType、InstanceTypes、InstanceTypeOverrides、Cpu和Memory 這四種方式不能同時指定,但InstanceType可以與InstancePatternInfo同時指定,此時,Auto Scaling會優先使用您指定的執行個體規格擴容,當指定的執行個體規格無庫存時,再使用符合InstancePatternInfo 配置的執行個體規格。
Cpu Integer 2

vCPU個數。單位:核。

同時指定CPU和Memory可以定義執行個體規格範圍,例如,CPU=2且Memory=16可以定義配置為2 vCPU和16 GiB的所有執行個體規格。Auto Scaling會結合IO最佳化、可用性區域等因素確定可用執行個體規格集合,並根據價格排序為您建立價格最低的執行個體。

說明 該區間配置效果僅在成本最佳化模式下且伸縮配置未設定執行個體規格時生效。
Memory Integer 16

記憶體大小。單位:GiB。

同時指定CPU和Memory可以定義執行個體規格範圍。例如,CPU=2且Memory=16可以定義配置為2 vCPU和16 GiB的所有執行個體規格。Auto Scaling會結合IO最佳化、可用性區域等因素確定可用執行個體規格集合,並根據價格排序為您建立價格最低的執行個體。

說明 該區間配置效果僅在成本最佳化模式下且伸縮配置未設定執行個體規格時生效。
DeploymentSetId String ds-bp1frxuzdg87zh4pz****

ECS執行個體所屬的部署集的ID。

SecurityGroupId String sg-280ih****

ECS執行個體所屬的安全性群組的ID,同一個安全性群組內的ECS執行個體可以互相訪問。

IoOptimized String optimized

是否為I/O最佳化執行個體。取值範圍:

  • none:非I/O最佳化執行個體。
  • optimized:I/O最佳化執行個體。

已停售的執行個體規格的執行個體預設值是none,其他執行個體規格的執行個體預設值是optimized。

InternetChargeType String PayByTraffic

網路計費類型。取值範圍:

  • PayByBandwidth:按頻寬計費。此時InternetMaxBandwidthOut即為所選的固定頻寬值。
  • PayByTraffic:按流量計費。此時InternetMaxBandwidthOut只是一個頻寬上限,計費以實際產生的網路流量為依據。

如果未指定該參數,傳統網路下預設值為PayByBandwidth,Virtual Private Cloud下預設值為PayByTraffic。

InternetMaxBandwidthIn Integer 10

公網入頻寬最大值,單位為 Mbit/s。取值範圍:

  • 當所購公網出頻寬小於等於 10 Mbit/s 時:1~10,預設為 10。
  • 當所購公網出頻寬大於 10 Mbit/s 時:1~InternetMaxBandwidthOut的取值,預設為InternetMaxBandwidthOut的取值。
InternetMaxBandwidthOut Integer 10

公網出頻寬最大值,單位為 Mbit/s。取值範圍:0~100。

預設值:0。

SystemDisk.Category String cloud_ssd

系統硬碟的磁碟種類。取值範圍:

  • cloud:普通雲端硬碟。
  • cloud_efficiency:高效雲端硬碟。
  • cloud_ssd:SSD雲端硬碟。
  • ephemeral_ssd:本地SSD盤。
  • cloud_essd:ESSD雲端硬碟。
  • cloud_auto:ESSD AutoPL雲端硬碟。

該參數不能與SystemDiskCategories.N同時指定。當該參數與SystemDiskCategories.N都未指定時,該參數有預設值。InstanceType為系列I的執行個體規格且執行個體屬於非I/O最佳化執行個體時,預設值:cloud。否則,預設值:cloud_efficiency。

SystemDisk.Size Integer 100

系統硬碟的大小,單位:GiB。取值範圍:

  • cloud:20~500。
  • cloud_efficiency:20~500。
  • cloud_ssd:20~500。
  • cloud_essd:20~500。
  • ephemeral_ssd:20~500。

指定該參數後,系統硬碟大小必須大於等於max{20, ImageSize}。

預設值:max{40, ImageSize}。

SystemDisk.DiskName String cloud_ssdSystem

系統硬碟的名稱。長度為2~128個英文或中文字元。必須以大小寫字母或中文開頭,不能以http://https://開頭。可以包含數字、半形冒號(:)、底線(_)或者短劃線(-)。

SystemDisk.Description String Test system disk.

系統硬碟的描述。長度為2~256個英文或中文字元,不能以http://https://開頭。

SystemDisk.AutoSnapshotPolicyId String sp-bp12m37ccmxvbmi5****

系統硬碟使用的自動快照策略ID。

SystemDisk.PerformanceLevel String PL1

當系統硬碟為ESSD雲端硬碟時,設定雲端硬碟的效能等級。取值範圍:

  • PL0:單盤最高隨機讀寫IOPS 1萬。
  • PL1:單盤最高隨機讀寫IOPS 5萬。
  • PL2:單盤最高隨機讀寫IOPS 10萬。
  • PL3:單盤最高隨機讀寫IOPS 100萬。

預設值:PL1。

說明 關於如何選擇ESSD雲端硬碟效能等級,請參見ESSD雲端硬碟
ScalingConfigurationName String scalingconfig****

伸縮配置的名稱,2~64英文或中文字元,以數字、大小寫字母或中文開頭,可包含數字、底線(_)、短劃線(-)或半形句號(.)。

在同一地區下同一伸縮組內伸縮配置名稱唯一。如果您沒有指定該參數,則預設使用伸縮配置的ID。

LoadBalancerWeight Integer 50

ECS執行個體作為負載平衡後端伺服器時的權重,取值範圍:1~100。

預設值:50。

Tags String {"key1":"value1","key2":"value2", ... "key5":"value5"}

ECS執行個體的標籤。標籤以索引值對方式傳入,最多可以使用20組標籤。Key和Value的使用要求如下:

  • Key最多支援64個字元,不能以aliyun和acs:開頭,不能包含http://或者https://。一旦使用標籤,Key不允許為空白字串。
  • Value最多支援128個字元,不能以aliyun和acs:開頭,不能包含http://或者https://。Value可以為空白字串。
UserData String ZWNobyBoZWxsbyBlY3Mh

ECS執行個體的自訂資料,需要以Base64方式編碼,編碼前的未經處理資料最多為32 KB。

KeyPairName String KeyPairTest

登入ECS執行個體時使用的金鑰組的名稱。

  • 對Windows執行個體,該參數將被忽略,預設為空白。
  • 對Linux執行個體,密碼登入方式會被初始化成禁止。
RamRoleName String ramrole****

ECS執行個體的RAM角色名稱。RAM角色名稱由RAM提供和維護,您可調用ListRoles查詢可用的RAM角色。建立RAM角色的具體操作,請參見CreateRole

SecurityEnhancementStrategy String Active

是否開啟安全強化。取值範圍:

  • Active:啟用安全強化,只對公用鏡像生效。
  • Deactive:不啟用安全強化,對所有鏡像類型生效。
InstanceName String instance****

使用本伸縮配置自動建立的ECS執行個體的名稱。

HostName String host****

雲端服務器的主機名稱。半形句號(.)或短劃線(-)不能作為首尾字元,不能連續使用半形句號(.)或短劃線(-)。另外,不同類型執行個體的命名要求如下:

  • Windows執行個體:主機名稱長度為2~15,可以包含大小寫字母、數字和短劃線(-)。不能包含半形句號(.),不能全是數字。
  • 其他類型執行個體(Linux等):主機名稱長度為2~64,可以包含多個半形句號(.)。兩個半形句號(.)之間為一段,每段可以包含大小寫字母、數字和短劃線(-)。
SpotStrategy String NoSpot

後付費執行個體的搶佔策略。取值範圍:

  • NoSpot:普通的隨用隨付執行個體。
  • SpotWithPriceLimit:設定上限價格的搶佔式執行個體。
  • SpotAsPriceGo:系統自動出價,跟隨當前市場實際價格。

預設值:NoSpot。

PasswordInherit Boolean false

是否使用鏡像預設的密碼。使用該參數時,您需要確保使用的鏡像已經設定了密碼。取值範圍:

  • true:使用鏡像預設密碼。
  • false:不使用鏡像預設密碼。
Password String 123abc****

ECS執行個體的密碼。長度為8至30個字元,必須同時包含大小寫英文字母、數字和特殊符號中的三類字元。特殊符號可以是:

()` ~!@#$%^&*-_+=\|{}[]:;'<>,.?/

其中,Windows執行個體不能以斜線號(/)為密碼首字元。

說明 如果傳入Password參數,建議您使用HTTPS協議發送請求,避免密碼泄露。
ResourceGroupId String rg-resource****

ECS執行個體所屬資源群組的ID。

HpcClusterId String hpc-clusterid

ECS執行個體所屬的HPC叢集的ID。

InstanceDescription String Test instance.

ECS執行個體的描述。長度為2~256個英文或中文字元,不能以http://https://開頭。

ClientToken String 123e4567-e89b-12d3-a456-42665544****

保證請求等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。只支援ASCII字元,且不能超過64個字元。更多資訊,請參見如何保證等冪性

Ipv6AddressCount Integer 1

為彈性網卡指定隨機產生的IPv6地址數量。

CreditSpecification String Standard

指定突發效能執行個體的運行模式。取值範圍:

  • Standard:標準模式。
  • Unlimited:無效能約束模式。

更多資訊,請參見突發效能執行個體概述下的效能模式章節。

ImageFamily String hangzhou-daily-update

鏡像族系名稱,通過設定該參數來擷取當前鏡像族系內最新的可用鏡像,用於建立執行個體。如果已經設定了參數ImageId,則不能設定該參數。

ZoneId String cn-hangzhou-g

ECS執行個體所屬的可用性區域ID。

DedicatedHostId String dh-bp67acfmxazb4p****

是否在Dedicated Host上建立ECS執行個體。由於Dedicated Host不支援建立搶佔式執行個體,指定DedicatedHostId參數後,會自動忽略請求中的SpotStrategy和SpotPriceLimit設定。

您可以調用DescribeDedicatedHosts查詢Dedicated HostID列表。

Affinity String default

Dedicated Host執行個體是否與Dedicated Host關聯。取值範圍:

  • default:執行個體不與Dedicated Host關聯。已啟用節省停機模式的執行個體,停機後再次啟動時,若原Dedicated Host可用資源不足,則執行個體被放置在自動部署資源集區的其他Dedicated Host上。
  • host:執行個體與Dedicated Host關聯。已啟用節省停機模式的執行個體,停機後再次啟動時,仍放置在原Dedicated Host上。若原Dedicated Host可用資源不足,則執行個體重啟失敗。

預設值:default。

Tenancy String default

是否在Dedicated Host上建立執行個體。取值範圍:

  • default:建立非Dedicated Host執行個體。
  • host:建立Dedicated Host執行個體。若您不指定DedicatedHostId,則由阿里雲自動選擇Dedicated Host放置執行個體。

預設值:default。

SchedulerOptions Map ["testManagedPrivateSpaceId****"]

調度選項。

PrivatePoolOptions.MatchCriteria String Open

執行個體啟動的私人池容量選項。彈性保障服務或容量預定服務在生效後會產生私人池容量,供執行個體啟動時選擇。取值範圍:

  • Open:開放模式。將自動匹配開放類型的私人池容量。如果沒有合格私人池容量,則使用公用池資源啟動。該模式下無需設定PrivatePoolOptions.Id參數。
  • Target:指定模式。使用指定的私人池容量啟動執行個體,如果該私人池容量不可用,則執行個體會啟動失敗。該模式下必須指定私人池ID,即PrivatePoolOptions.Id參數為必填項。
  • None:不使用模式。執行個體啟動將不使用私人池容量。
PrivatePoolOptions.Id String eap-bp67acfmxazb4****

私人池ID。即彈性保障服務ID或容量預定服務ID。

SpotDuration Integer 1

搶佔式執行個體的保留時間長度,單位為小時。取值範圍:

  • 1:建立後阿里雲會保證執行個體運行1小時不會被自動釋放;超過1小時後,系統會自動比較出價與市場價格、檢查資產庫存,來決定執行個體的保留或回收。
  • 0:建立後,阿里雲不能保證執行個體運行1小時,系統會自動比較出價與市場價格、檢查資產庫存,來決定執行個體的保留或回收。

    說明 執行個體被回收前5分鐘內,阿里雲會通過ECS系統事件向您發送通知。搶佔式執行個體按秒計費,建議您結合具體任務執行耗時來選擇合適的保留時間長度。

預設值:1。

SpotInterruptionBehavior String Terminate

搶佔執行個體中斷模式。目前僅支援Terminate(預設)直接釋放執行個體。

InstanceTypes.N String ecs.g6.large

多種執行個體規格參數。其中N的取值範圍:1~10,即一個伸縮配置內最多可以設定10種執行個體規格。

N代表當前伸縮配置中執行個體規格的優先順序,編號為1的執行個體規格優先順序最高,執行個體規格優先順序隨著編號的增大依次降低。當無法根據優先順序較高的執行個體規格建立出執行個體時,Auto Scaling服務會自動選擇下一優先順序的執行個體規格來建立執行個體。

說明 InstanceType、InstanceTypes、InstanceTypeOverrides、Cpu和Memory這四種方式不能同時指定,但InstanceTypes可以與InstancePatternInfo同時指定。此時,Auto Scaling優先使用您指定的執行個體規格擴容,當指定的執行個體規格無庫存時,再使用符合InstancePatternInfo配置的執行個體規格。
InstanceTypeOverride.N.InstanceType String ecs.c5.xlarge

當您需要指定伸縮配置中執行個體規格的容量時,請同時指定本參數和InstanceTypeOverride.N.WeightedCapacity。

本參數用於指定執行個體規格。您可以指定N個本參數,結合InstanceTypeOverride.N.WeightedCapacity參數,擴充多執行個體規格支援自訂權重。N的取值範圍:1~10。

說明 指定本參數時,不允許同時指定InstanceTypes.N或InstanceType。

InstanceType的取值範圍:在售的ECS執行個體規格,請參見執行個體規格類型系列

InstanceTypeOverride.N.WeightedCapacity Integer 4

當您需要指定伸縮配置中執行個體規格的容量時,先指定InstanceTypeOverride.N.InstanceType後,再指定本參數。兩個參數一一對應,N需要保持一致。

本參數用於指定執行個體規格的權重,即執行個體規格的單台執行個體在伸縮組中表示的容量大小。權重越大,滿足期望容量所需的本執行個體規格的執行個體數量越少。

由於每個執行個體規格的vCPU個數、記憶體大小等效能指標會有差異,您可以根據自身需求,給不同的執行個體規格配置不同的權重。

例如:

  • 當前容量:0。
  • 期望容量:6。
  • ecs.c5.xlarge規格容量:4。

為滿足期望容量,伸縮組將為使用者擴容2台ecs.c5.xlarge執行個體。

說明 擴容時伸縮組的容量不得超過最大容量(MaxSize)與執行個體規格的最大權重之和。

WeightedCapacity的取值範圍:1~500。

DataDisk.N.PerformanceLevel String PL1

當資料盤為ESSD雲端硬碟時,設定雲端硬碟的效能等級。N的取值必須和DataDisk.N.Category=cloud_essd中的N保持一致。取值範圍:

  • PL0:單盤最高隨機讀寫IOPS 1萬。
  • PL1:單盤最高隨機讀寫IOPS 5萬。
  • PL2:單盤最高隨機讀寫IOPS 10萬。
  • PL3:單盤最高隨機讀寫IOPS 100萬。

預設值:PL1。

說明 關於如何選擇ESSD雲端硬碟效能等級,請參見ESSD雲端硬碟
DataDisk.N.AutoSnapshotPolicyId String sp-bp19nq9enxqkomib****

資料盤使用的自動快照策略ID,N的取值範圍:1~16。

DataDisk.N.Encrypted String false

資料盤N是否加密,N的取值範圍:1~16。該參數取值範圍:

  • true:加密。
  • false:不加密。

預設值:false。

DataDisk.N.Description String Test data disk.

資料盤的描述,N的取值範圍:1~16。長度為2~256個英文或中文字元,不能以http://https://開頭。

DataDisk.N.SnapshotId String s-280s7****

建立資料盤時使用的快照,N的取值範圍:1~16。指定該參數後,DataDisk.N.Size會被忽略,實際建立的磁碟大小為指定快照的大小。

如果該快照建立於2013年7月15日或之前,調用會被拒絕,返回參數中會提示InvalidSnapshot.TooOld。

DataDisk.N.Categories.N String cloud

資料盤N的多磁碟類型。第一個N表示第N塊資料盤,取值範圍:1~16。第二個N表示第N塊資料盤的第N種磁碟類型,取值範圍:1~4,即一個伸縮配置內最多可以為資料盤指定4種磁碟類型。N越小,優先順序越高。當無法使用高優先順序的磁碟類型時,Auto Scaling自動嘗試下一優先順序的磁碟類型建立資料盤。取值範圍:

  • cloud:普通雲端硬碟。隨執行個體建立的普通雲端硬碟的DeleteWithInstance屬性為true。
  • cloud_efficiency:高效雲端硬碟。
  • cloud_ssd:SSD雲端硬碟。
  • cloud_essd:ESSD雲端硬碟。
說明 指定本參數時,不允許同時指定DataDisk.N.Category
DataDisk.N.Size Integer 100

資料盤N的磁碟大小,N的取值範圍:1~16,記憶體單位為GiB。取值範圍:

  • cloud:5~2000。
  • cloud_efficiency:20~32768。
  • cloud_ssd:20~32768。
  • cloud_essd:20~32768。
  • ephemeral_ssd:5~800。

指定該參數後,磁碟大小必須大於等於快照大小(快照通過SnapshotId指定)。

DataDisk.N.Device String /dev/xvdb

資料盤掛載點,N的取值範圍:1~16。如果您沒有指定該參數,則預設在自動建立ECS執行個體時由系統分配,從/dev/xvdb開始,到/dev/xvdz結束。

DataDisk.N.DiskName String cloud_ssdData

資料盤的名稱,N的取值範圍:1~16。長度為2~128個英文或中文字元。必須以大小寫字母或中文開頭,不能以http://https://開頭。可以包含數字、半形冒號(:)、底線(_)或者短劃線(-)。

DataDisk.N.Category String cloud_ssd

資料盤N的磁碟種類,N的取值範圍:1~16。該參數取值範圍:

  • cloud:普通雲端硬碟。隨執行個體建立的普通雲端硬碟的DeleteWithInstance屬性為true。
  • cloud_efficiency:高效雲端硬碟。
  • cloud_ssd:SSD雲端硬碟。
  • ephemeral_ssd:本地SSD盤。
  • cloud_essd:ESSD雲端硬碟。
  • cloud_auto:ESSD AutoPL雲端硬碟。

該參數不能與DataDisk.N.Categories.N同時指定。當該參數與DataDisk.N.Categories.N都未指定時,該參數預設值:

  • 對於I/O最佳化執行個體,預設值為cloud_efficiency。
  • 對於非I/O最佳化執行個體,預設值為cloud。
DataDisk.N.DeleteWithInstance Boolean true

指定資料盤是否隨執行個體釋放,N的取值範圍:1~16。該參數取值範圍:

  • true:釋放執行個體時,該磁碟隨執行個體一起釋放。
  • false:釋放執行個體時,該磁碟保留不釋放。

該參數只可對獨立雲端硬碟設定(DataDisk.N.Category為cloud、cloud_efficiency、cloud_ssd、cloud_essd或者cloud_auto),否則會出現報錯。

預設值:true。

DataDisk.N.KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

資料盤對應的KMS密鑰的ID,N的取值範圍:1~16。

DataDisk.N.ProvisionedIops Long 100

資料盤預配置的IOPS(Input/Output Operations Per Second)效能指標。

說明 IOPS(Input/Output Operations Per Second)指每秒能處理的I/O個數,表示Block Storage處理讀寫(輸出/輸入)的能力,單位為次/秒。
DataDisk.N.BurstingEnabled Boolean false

資料盤是否開啟Burst(效能突發)。取值範圍:

  • true:開啟。
  • false:未開啟。

    說明 DataDisk.Category取值為cloud_auto時才支援設定該參數。

更多資訊,請參見ESSD AutoPL雲端硬碟

SpotPriceLimit.N.PriceLimit Float 0.5

搶佔式執行個體對應的出價,N的取值範圍:1~10。SpotStrategy取值為SpotWithPriceLimit時生效。

SpotPriceLimit.N.InstanceType String ecs.g6.large

搶佔式執行個體的執行個體規格,N的取值範圍:1~10。SpotStrategy取值為SpotWithPriceLimit時生效。

SecurityGroupIds.N String sg-bp18kz60mefs****

將ECS執行個體同時加入多個安全性群組。N的取值範圍與執行個體能夠加入安全性群組上限有關。更多資訊,請參見使用限制下的安全性群組章節。

說明 不支援同時指定SecurityGroupId和SecurityGroupIds.N。
InstancePatternInfo.N.Cores Integer 2

智能配置模式下,執行個體規格的vCPU核心數目,用於篩選符合要求的執行個體規格範圍。更多資訊,請參見執行個體規格類型系列。N的取值範圍:1~10。

請注意以下資訊:

  • InstancePatternInfo.N參數僅適用於伸縮組的網路類型為專用網路。
  • InstancePatternInfo.N參數必須同時配置InstancePatternInfo.N.Cores和InstancePatternInfo.N.Memory。
  • 如果您已經通過InstanceType或InstanceTypes.N參數指定了執行個體規格,Auto Scaling優先使用您指定的執行個體規格擴容,當指定的執行個體規格無庫存時,再從符合InstancePatternInfo.N參數值的執行個體規格中優先使用價格最低的執行個體規格擴容。
InstancePatternInfo.N.InstanceFamilyLevel String EnterpriseLevel

智能配置模式下,執行個體規格類型系列層級,用於篩選符合要求的執行個體規格範圍。取值範圍:

  • EntryLevel:入門級,即共用型執行個體規格。成本更低,但是無法保證執行個體計算效能的穩定。適用於平時CPU使用率低的業務情境。更多資訊,請參見共用型
  • EnterpriseLevel:企業級。效能穩定,資源獨享,適用於對穩定性要求高的業務情境。更多資訊,請參見執行個體規格類型系列
  • CreditEntryLevel:積分入門級,即突發效能執行個體。通過CPU積分來保證計算效能,適用於平時CPU使用率低、偶有突發CPU使用率的情況。更多資訊,請參見突發效能執行個體

N的取值範圍:1~10。

InstancePatternInfo.N.MaxPrice Float 2

智能配置模式下,隨用隨付執行個體或者搶佔式執行個體可接受的每小時最高價格,用於篩選符合要求的執行個體規格範圍。N的取值範圍:1~10。

說明 SpotStrategy設定為SpotWithPriceLimit時,該參數必選。其他情況下,該參數可選。
InstancePatternInfo.N.Memory Float 4

智能配置模式下,執行個體規格的記憶體大小,單位為GiB,用於篩選符合要求的執行個體規格範圍。更多資訊,請參見執行個體規格類型系列。N的取值範圍:1~10。

InstancePatternInfo.N.ExcludedInstanceType.N String ecs.n1.small/ecs.n1.*/*7*

需要排除的執行個體規格。通過使用萬用字元(*)可以排除單個規格或者整個規格類型系列。例如:

  • ecs.c6.large:表示排除ecs.c6.large執行個體規格。
  • ecs.c6.*:表示排除整個c6規格類型系列的執行個體規格。
InstancePatternInfo.N.Architecture.N String X86

執行個體規格所屬的架構類型。取值範圍:

  • X86:X86計算。
  • Heterogeneous:異構計算,例如GPU或FPGA等。
  • BareMetal:ECS Bare Metal Instance。
  • Arm:Arm計算。

預設值:包含所有架構類型。

InstancePatternInfo.N.BurstablePerformance String Include

是否為效能突發執行個體規格。取值範圍:

  • Exclude:不包含效能突發執行個體規格。
  • Include:包含效能突發執行個體規格。
  • Required:只包含效能突發執行個體規格。

預設值:Include。

InstancePatternInfo.N.InstanceTypeFamilies.N String ecs.g6

指定的執行個體規格類型系列。N表示可以設定多個執行個體規格類型系列,N的取值範圍:1~10。

InstancePatternInfo.N.MinimumCpuCoreCount Integer 2

執行個體規格的最小vCPU核心數目。

InstancePatternInfo.N.MaximumCpuCoreCount Integer 4

執行個體規格的最大vCPU核心數目。

說明 MaximumCpuCoreCount參數值不能超過MinimumCpuCoreCount參數值的4倍。
InstancePatternInfo.N.GpuSpecs.N String NVIDIA V100

GPU 類型。

InstancePatternInfo.N.InstanceCategories.N String Compute-optimized with GPU

執行個體分類。取值範圍:

說明 N表示可以設定多個執行個體分類,N的取值範圍:1~10。
  • General-purpose:通用型。
  • Compute-optimized:計算型。
  • Memory-optimized:記憶體型。
  • Big data:巨量資料型。
  • Local SSDs:本地SSD型。
  • High Clock Speed:高主頻型。
  • Enhanced:增強型。
  • Shared:共用型。
  • Compute-optimized with GPU:GPU計算型。
  • Visual Compute-optimized:視覺計算型。
  • Heterogeneous Service:異構服務型。
  • Compute-optimized with FPGA:FPGA計算型。
  • Compute-optimized with NPU:NPU計算型。
  • ECS Bare Metal:ECS Bare Metal Instance。
  • High Performance Compute:高效能運算型。
InstancePatternInfo.N.CpuArchitectures.N String X86

執行個體的CPU架構。取值範圍:

說明 N表示可以設定多個CPU架構,N的取值範圍:1~2。
  • X86。
  • ARM。
InstancePatternInfo.N.PhysicalProcessorModels.N String Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY

執行個體的處理器型號。N表示可以設定多個處理器型號,N的取值範圍:1~10。

InstancePatternInfo.N.MinimumEniQuantity Integer 2

執行個體最小支援掛載的彈性網卡上限。

InstancePatternInfo.N.MinimumEniPrivateIpAddressQuantity Integer 2

執行個體最小單塊彈性網卡的IPv4地址上限。

InstancePatternInfo.N.MinimumEniIpv6AddressQuantity Integer 1

執行個體最小單塊彈性網卡的IPv6地址上限。

InstancePatternInfo.N.MinimumInitialCredit Integer 12

執行個體最小突發效能執行個體t5、t6的初始vCPU積分值。

InstancePatternInfo.N.MinimumBaselineCredit Integer 12

執行個體最小突發效能執行個體t5、t6的基準vCPU計算效能(所有vCPU之和)。

InstancePatternInfo.N.MinimumMemorySize Float 4

執行個體最小記憶體。單位:GiB。

InstancePatternInfo.N.MaximumMemorySize Float 4

執行個體最大記憶體。單位:GiB。

InstancePatternInfo.N.MinimumGpuAmount Integer 2

執行個體最小 GPU 數目。取值範圍:正整數。

InstancePatternInfo.N.MaximumGpuAmount Integer 2

執行個體最大 GPU 數目。取值範圍:正整數。

SystemDiskCategories.N String cloud

系統硬碟的多磁碟類型。N的取值範圍:1~4,即一個伸縮配置內最多可以為系統硬碟指定4種磁碟類型。N越小,優先順序越高。當無法使用高優先順序的磁碟類型時,Auto Scaling自動嘗試下一優先順序的磁碟類型建立系統硬碟。取值範圍:

  • cloud:普通雲端硬碟。
  • cloud_efficiency:高效雲端硬碟。
  • cloud_ssd:SSD雲端硬碟。
  • cloud_essd:ESSD雲端硬碟。
說明 指定本參數時,不允許同時指定SystemDisk.Category
SystemDisk.Encrypted Boolean false

是否加密系統硬碟。取值範圍:

  • true:加密。
  • false:不加密。

預設值:false。

SystemDisk.KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

系統硬碟使用的KMS密鑰ID。

SystemDisk.EncryptAlgorithm String AES-256

系統硬碟採用的密碼編譯演算法。取值範圍:

  • AES-256。
  • SM4-128。

預設值:AES-256。

SystemDisk.ProvisionedIops Long 100

系統硬碟預配置的IOPS(Input/Output Operations Per Second)效能指標。

說明 IOPS(Input/Output Operations Per Second)指每秒能處理的I/O個數,表示Block Storage處理讀寫(輸出/輸入)的能力,單位為次/秒。
SystemDisk.BurstingEnabled Boolean false

系統硬碟是否開啟Burst(效能突發)。取值範圍:

  • true:開啟。
  • false:未開啟。

    說明 SystemDisk.Category取值為cloud_auto時才支援設定該參數。

更多資訊,請參見ESSD AutoPL雲端硬碟

ImageOptions.LoginAsNonRoot Boolean false

ECS執行個體是否使用ecs-user使用者登入,更多資訊,請參見管理ECS執行個體的登入名稱。取值範圍:

  • true:是。
  • false:否。

預設值:false。

DeletionProtection Boolean false

ECS執行個體釋放保護屬性。該項僅適用於隨用隨付執行個體,指是否支援通過ECS管理主控台或API(DeleteInstance)直接釋放執行個體。取值範圍:

  • true:開啟執行個體釋放保護屬性,表示不支援通過ECS管理主控台或API直接釋放執行個體(即防止Auto Scaling中擴容的執行個體被誤刪)。
  • false:關閉執行個體釋放保護屬性,表示支援通過ECS管理主控台或API直接釋放執行個體。

預設值:false。

說明 該屬性不影響Auto Scaling正常的縮容活動,即Auto Scaling發生縮容活動時,開啟執行個體釋放保護的隨用隨付執行個體可以被正常釋放掉。
StorageSetId String ss-bp67acfmxazb4p****

儲存集ID。

StorageSetPartitionNumber Integer 2

儲存集中的最大分區數量。取值為大於等於2的整數。

CustomPriorities.N.InstanceType String ecs.g6.large

CustomPriorities欄位表示ECS執行個體規格+虛擬交換器組合的自訂優先順序。CustomPriorities.N.InstanceType參數表示自訂優先順序中的ECS執行個體的執行個體規格。

說明 該參數僅在伸縮組的擴縮容策略優先順序策略時有效,且該執行個體規格(InstanceType)必須包含在伸縮配置的執行個體規格列表中。

當無法根據優先順序較高的ECS執行個體規格+虛擬交換器建立ECS執行個體時,Auto Scaling服務會自動選擇下一優先順序的ECS執行個體規格+虛擬交換器組合來建立ECS執行個體。

說明 如果僅指定了部分ECS執行個體規格+虛擬交換器組合的自訂優先順序,則未指定的組合優先順序低於指定的組合優先順序,且未指定的組合仍會依次按照伸縮組的虛擬交換器順序、伸縮配置的執行個體規格順序確定優先順序。例如:伸縮組的虛擬交換器順序依次為vsw1、vsw2,伸縮配置的執行個體規格順序依次為type1、type2,該組合的自訂優先順序順序為["vsw2+type2", "vsw1+type2"],則最終優先順序為vsw2+type2> vsw1+type2 > vsw1+type1 > vsw2+type1
CustomPriorities.N.VswitchId String vsw-bp14zolna43z266bq****

CustomPriorities.N.VswitchId參數表示自訂優先順序中的虛擬交換器的ID。

說明 該參數僅在伸縮組的擴縮容策略優先順序策略時有效,且該交換器(Vswitch)必須包含在伸縮組的交換器列表中。
NetworkInterfaces.N.InstanceType String Primary

彈性網卡類型。使用NetworkInterfaces.N時必須設定主網卡,但不能同時設定SecurityGroupIdSecurityGroupIds.N參數。取值範圍:

  • Primary:主網卡。
  • Secondary:輔助網卡。

預設值:Secondary。

NetworkInterfaces.N.NetworkInterfaceTrafficMode String HighPerformance

網卡的通訊模式。取值範圍:

  • Standard:使用TCP通訊模式。
  • HighPerformance:開啟ERI(Elastic RDMA Interface)介面,使用RDMA通訊模式。

預設值:Standard。

說明 RDMA模式的彈性網卡數量不能超過該執行個體規格類型系列的限制。更多資訊,請參見執行個體規格類型系列
NetworkInterfaces.N.Ipv6AddressCount Integer 1

為主網卡指定隨機產生的IPv6地址數量。您需要注意以下事項:

  • 如果NetworkInterfaces.N.InstanceType取值為Primary時,設定該參數才會生效。
  • 如果NetworkInterface.N.InstanceType取值為Secondary或空值,則不能設定該參數。
  • 設定該參數後,您不能再設定Ipv6AddressCount參數。
NetworkInterfaces.N.SecurityGroupIds.N String sg-uf6ij8dwxh****

彈性網卡所屬的一個或多個安全性群組 ID。您需要注意以下事項:

  • 如果NetworkInterfaces.N.InstanceType取值為Primary時,則必須設定該參數。此時該參數的作用等同於SecurityGroupIds.N,但不能同時再設定SecurityGroupIdSecurityGroupIds.N參數。
  • 如果NetworkInterfaces.N.InstanceType取值為Secondary或空值,則該參數為非必填參數。預設值為ECS執行個體所屬的安全性群組(即主網卡的安全性群組)。
DedicatedHostClusterId String dc-2zedxc67zqzt7lb4****

Dedicated Host叢集ID。

SecurityOptions.ConfidentialComputingMode String TDX

機密計算模式。可能值:

HttpEndpoint String enabled

是否啟用執行個體中繼資料的訪問通道。取值範圍:

  • enabled:啟用。
  • disabled:禁用。

預設值:enabled。

說明 有關執行個體中繼資料的資訊,請參見執行個體中繼資料概述
HttpTokens String optional

訪問執行個體中繼資料時是否強制使用加固模式(IMDSv2)。取值範圍:

  • optional:不強制使用。
  • required:強制使用。設定該取值後,普通模式無法訪問執行個體中繼資料。

預設值:optional。

說明 有關訪問執行個體中繼資料的模式,請參見執行個體中繼資料訪問模式

返回資料

名稱

類型

樣本值

描述

ScalingConfigurationId String asc-bp1ffogfdauy0nu5****

伸縮配置ID。

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

請求ID。

樣本

請求樣本

http(s)://ess.aliyuncs.com/?Action=CreateScalingConfiguration
&ScalingGroupId=asg-bp14wlu85wrpchm0****
&ImageId=centos6u5_64_20G_aliaegis****.vhd
&ImageName=image****
&InstanceType=ecs.g6.large
&Cpu=2
&Memory=16
&DeploymentSetId=ds-bp1frxuzdg87zh4pz****
&SecurityGroupId=sg-280ih****
&IoOptimized=optimized
&InternetChargeType=PayByTraffic
&InternetMaxBandwidthIn=10
&InternetMaxBandwidthOut=10
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=100
&SystemDisk.DiskName=cloud_ssdSystem
&SystemDisk.Description=Test system disk.
&SystemDisk.AutoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&SystemDisk.PerformanceLevel=PL1
&ScalingConfigurationName=scalingconfig****
&LoadBalancerWeight=50
&Tags={"key1":"value1","key2":"value2", ... "key5":"value5"}
&UserData=ZWNobyBoZWxsbyBlY3Mh
&KeyPairName=KeyPairTest
&RamRoleName=ramrole****
&SecurityEnhancementStrategy=Active
&InstanceName=instance****
&HostName=host****
&SpotStrategy=NoSpot
&PasswordInherit=false
&Password=123abc****
&ResourceGroupId=rg-resource****
&HpcClusterId=hpc-clusterid
&InstanceDescription=Test instance.
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Ipv6AddressCount=1
&CreditSpecification=Standard
&ImageFamily=hangzhou-daily-update
&ZoneId=cn-hangzhou-g
&DedicatedHostId=dh-bp67acfmxazb4p****
&Affinity=default
&Tenancy=default
&PrivatePoolOptions.MatchCriteria=Open
&PrivatePoolOptions.Id=eap-bp67acfmxazb4****
&SpotDuration=1
&SpotInterruptionBehavior=Terminate
&InstanceTypes=["ecs.g6.large"]
&InstanceTypeOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&DataDisk=[{"PerformanceLevel":"PL1","AutoSnapshotPolicyId":"sp-bp19nq9enxqkomib****","Encrypted":"false","Description":"Test data disk.","SnapshotId":"s-280s7****","Categories":["cloud"],"Size":100,"Device":"/dev/xvdb","DiskName":"cloud_ssdData","Category":"cloud_ssd","DeleteWithInstance":true,"KMSKeyId":"0e478b7a-4262-4802-b8cb-00d3fb40****","ProvisionedIops":100,"BurstingEnabled":false}]
&SpotPriceLimit=[{"PriceLimit":0.5,"InstanceType":"ecs.g6.large"}]
&SecurityGroupIds=["sg-bp18kz60mefs****"]
&InstancePatternInfo=[{"Cores":2,"InstanceFamilyLevel":"EnterpriseLevel","MaxPrice":2.0,"Memory":4.0,"ExcludedInstanceType":["ecs.n1.small/ecs.n1.*/*7*"],"Architecture":["X86"],"BurstablePerformance":"Include","InstanceTypeFamilies":["ecs.g6"],"MinimumCpuCoreCount":2,"MaximumCpuCoreCount":4,"GpuSpecs":["NVIDIA V100"],"InstanceCategories":["Compute-optimized with GPU"],"CpuArchitectures":["X86"],"PhysicalProcessorModels":["Intel Xeon(Ice Lake) Platinum 8369B\", \"Intel Xeon(Skylake) Platinum 8163\", … \"Intel Xeon(Cascade Lake) Platinum 8269CY"],"MinimumEniQuantity":2,"MinimumEniPrivateIpAddressQuantity":2,"MinimumEniIpv6AddressQuantity":1,"MinimumInitialCredit":12,"MinimumBaselineCredit":12,"MinimumMemorySize":4.0,"MaximumMemorySize":4.0,"MinimumGpuAmount":2,"MaximumGpuAmount":2}]
&SystemDiskCategories=["cloud"]
&SystemDisk.Encrypted=false
&SystemDisk.KMSKeyId=0e478b7a-4262-4802-b8cb-00d3fb40****
&SystemDisk.EncryptAlgorithm=AES-256
&SystemDisk.ProvisionedIops=100
&SystemDisk.BurstingEnabled=false
&ImageOptions.LoginAsNonRoot=false
&DeletionProtection=false
&StorageSetId=ss-bp67acfmxazb4p****
&StorageSetPartitionNumber=2
&CustomPriorities=[{"InstanceType":"ecs.g6.large","VswitchId":"vsw-bp14zolna43z266bq****"}]
&NetworkInterfaces=[{"InstanceType":"Primary","NetworkInterfaceTrafficMode":"HighPerformance","Ipv6AddressCount":1,"SecurityGroupIds":["sg-uf6ij8dwxh****"]}]
&DedicatedHostClusterId=dc-2zedxc67zqzt7lb4****
&SecurityOptions={"ConfidentialComputingMode":"TDX"}
&HttpEndpoint=enabled
&HttpTokens=optional
&公用請求參數

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateScalingConfigurationResponse>
    <ScalingConfigurationId>asc-bp1ffogfdauy0nu5****</ScalingConfigurationId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateScalingConfigurationResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ScalingConfigurationId" : "asc-bp1ffogfdauy0nu5****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

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

HttpCode

錯誤碼

錯誤資訊

描述

400

InstanceType.Mismatch

The specified scaling configuration and existing active scaling configuration have different instance type.

指定的伸縮配置的執行個體規格與當前的伸縮配置的執行個體規格不匹配。

404

InvalidDataDiskSnapshotId.NotFound

Snapshot "XXX" does not exist.

不存在指定的快照。

400

InvalidDataDiskSnapshotId.SizeNotSupported

The capacity of snapshot "XXX" exceeds the size limit of the specified disk category.

指定快照的大小超過了磁碟大小的限制。

403

InvalidDevice.InUse

Device "XXX" has been occupied.

資料盤掛載點重複。

400

InvalidImageId.InstanceTypeMismatch

The specified image does not support the specified instance type.

不允許在指定的執行個體規格下使用該鏡像。

404

InvalidImageId.NotFound

The specified image does not exist.

該帳號下不存在指定的鏡像。

400

InvalidKeyPairName.NotFound

The specified KeyPairName does not exist in our records.

指定的KeyPairName不存在。

400

InvalidNetworkType.ForRAMRole

RAMRole can't be used For classic instance.

傳統網路執行個體不支援RamRoleName參數。

400

InvalidParameter

The specified value of parameter KeyPairName is not valid.

Windows系統不支援KeyPairName參數。

400

InvalidParameter.Conflict

The value of parameter SystemDisk.Category and parameter DataDisk.N.Category are conflict.

指定的系統硬碟類型和資料盤類型衝突。

400

InvalidRamRole.NotFound

The specified RamRoleName does not exist.

不存在指定的RamRoleName。

400

InvalidScalingConfigurationName.Duplicate

The specified value of parameter ScalingConfigurationName is duplicated.

已存在相同伸縮配置名。

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

該帳號下不存在指定的伸縮組。

400

InvalidSecurityGroupId.IncorrectNetworkType

The network type of specified security Group does not support this action.

指定的安全性群組與伸縮組指定網路類型不一致。

404

InvalidSecurityGroupId.NotFound

The specified security group does not exist.

該帳號下不存在指定的安全性群組。

400

InvalidSecurityGroupId.VPCMismatch

The specified security group and the specified virtual switch are not in the same VPC.

指定的安全性群組和虛擬交換器不屬於同一個Virtual Private Cloud絡。

403

InvalidSnapshot.TooOld

This operation is denied because the specified snapshot is created before 2013-07-15.

該快照建立於2013年7月15日或之前,調用被拒絕。

403

InvalidSystemDiskCategory.ValueUnauthorized

The system disk category is not authorized.

沒有建立臨時磁碟系統硬碟的許可權。

400

InvalidUserData.Base64FormatInvalid

The specified parameter UserData must be base64 encoded.

UserData不符合Base64編碼規範。

400

InvalidUserData.SizeExceeded

The specified parameter UserData exceeds the size.

指定的UserData過長。

403

QuotaExceeded.EphemeralDiskSize

Ephemeral disk size quota exceeded.

臨時磁碟資料盤總容量超過2 TiB(2048 GiB)。

400

QuotaExceeded.ScalingConfiguration

Scaling configuration quota exceeded in the specified scaling group.

您目前擁有的伸縮配置個數已經達到上限。

400

QuotaExceeded.SecurityGroupInstance

Instance quota exceeded in the specified security group.

指定的安全性群組中添加的ECS執行個體個數已經達到上限。

400

InvalidSecurityGroupId.IncorrectType

The managed security group "XXX" is not supported.

不支援 "XXX" 託管安全性群組。