通過調用CreateScalingConfiguration介面,並指定伸縮組ID、執行個體規格、執行個體鏡像等資訊,為伸縮組建立一個ECS類型的伸縮配置。
介面說明
伸縮配置用來指定彈性擴張時使用的ECS執行個體模板,支援以下執行個體配置方式:
- InstancePatternInfo.N:智能配置模式,無需指定具體的執行個體規格,只需根據業務需求指定執行個體的vCPU核心數、記憶體大小、規格類型系列層級以及最高價格,系統會自動篩選符合要求的執行個體規格,並優先選擇價格最低的執行個體規格建立ECS執行個體。該模式僅適用於伸縮組的網路類型為專用網路,能夠有效降低擴容時執行個體規格庫存不足的情況。
- InstanceType:指定一種執行個體規格。
- InstanceTypes.N:指定多種執行個體規格。
- InstanceTypeOverride.N:指定多種執行個體規格,並為不同的執行個體規格配置權重。
- Cpu和Memory:指定CPU和記憶體定義執行個體規格的範圍,Auto Scaling會結合IO最佳化、可用性區域等因素確定可用執行個體規格集合,並根據價格排序為您建立價格最低的執行個體。該方式僅適用於伸縮組的擴縮容策略為成本最佳化策略,且伸縮配置未指定執行個體規格的情境。
- 支援以下任一方式綁定主網卡。但需要注意每次調用介面時只能選用一種方式配置主網卡,兩種方式同時使用時將會導致介面調用失敗並返回錯誤資訊。
- 通過
SecurityGroupId
、SecurityGroupIds.N
與Ipv6AddressCount
等參數直接設定主網卡的相關配置資訊。 - 通過
NetworkInterfaces.N
設定主網卡以及輔助網卡的配置資訊,使用該參數時必須設定主網卡資訊。其中,NetworkInterfaces.N.InstanceType
取值為Primary
時,表示設定主網卡;當NetworkInterfaces.N.InstanceType
取值為Secondary
或空值時,表示設定輔助網卡。
- 通過
調試
您可以在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,其他執行個體規格的執行個體預設值是optimized。 |
InternetChargeType | String | 否 | PayByTraffic | 網路計費類型。取值範圍:
如果未指定該參數,傳統網路下預設值為PayByBandwidth,Virtual Private Cloud下預設值為PayByTraffic。 |
InternetMaxBandwidthIn | Integer | 否 | 10 | 公網入頻寬最大值,單位為 Mbit/s。取值範圍:
|
InternetMaxBandwidthOut | Integer | 否 | 10 | 公網出頻寬最大值,單位為 Mbit/s。取值範圍:0~100。 預設值:0。 |
SystemDisk.Category | String | 否 | cloud_ssd | 系統硬碟的磁碟種類。取值範圍:
該參數不能與 |
SystemDisk.Size | Integer | 否 | 100 | 系統硬碟的大小,單位:GiB。取值範圍:
指定該參數後,系統硬碟大小必須大於等於max{20, ImageSize}。 預設值:max{40, ImageSize}。 |
SystemDisk.DiskName | String | 否 | cloud_ssdSystem | 系統硬碟的名稱。長度為2~128個英文或中文字元。必須以大小寫字母或中文開頭,不能以 |
SystemDisk.Description | String | 否 | Test system disk. | 系統硬碟的描述。長度為2~256個英文或中文字元,不能以 |
SystemDisk.AutoSnapshotPolicyId | String | 否 | sp-bp12m37ccmxvbmi5**** | 系統硬碟使用的自動快照策略ID。 |
SystemDisk.PerformanceLevel | String | 否 | PL1 | 當系統硬碟為ESSD雲端硬碟時,設定雲端硬碟的效能等級。取值範圍:
預設值: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的使用要求如下:
|
UserData | String | 否 | ZWNobyBoZWxsbyBlY3Mh | ECS執行個體的自訂資料,需要以Base64方式編碼,編碼前的未經處理資料最多為32 KB。 |
KeyPairName | String | 否 | KeyPairTest | 登入ECS執行個體時使用的金鑰組的名稱。
|
RamRoleName | String | 否 | ramrole**** | ECS執行個體的RAM角色名稱。RAM角色名稱由RAM提供和維護,您可調用ListRoles查詢可用的RAM角色。建立RAM角色的具體操作,請參見CreateRole。 |
SecurityEnhancementStrategy | String | 否 | Active | 是否開啟安全強化。取值範圍:
|
InstanceName | String | 否 | instance**** | 使用本伸縮配置自動建立的ECS執行個體的名稱。 |
HostName | String | 否 | host**** | 雲端服務器的主機名稱。半形句號(.)或短劃線(-)不能作為首尾字元,不能連續使用半形句號(.)或短劃線(-)。另外,不同類型執行個體的命名要求如下:
|
SpotStrategy | String | 否 | NoSpot | 後付費執行個體的搶佔策略。取值範圍:
預設值:NoSpot。 |
PasswordInherit | Boolean | 否 | 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個英文或中文字元,不能以 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保證請求等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。只支援ASCII字元,且不能超過64個字元。更多資訊,請參見如何保證等冪性。 |
Ipv6AddressCount | Integer | 否 | 1 | 為彈性網卡指定隨機產生的IPv6地址數量。 |
CreditSpecification | String | 否 | Standard | 指定突發效能執行個體的運行模式。取值範圍:
更多資訊,請參見突發效能執行個體概述下的效能模式章節。 |
ImageFamily | String | 否 | hangzhou-daily-update | 鏡像族系名稱,通過設定該參數來擷取當前鏡像族系內最新的可用鏡像,用於建立執行個體。如果已經設定了參數 |
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。 |
Tenancy | String | 否 | default | 是否在Dedicated Host上建立執行個體。取值範圍:
預設值:default。 |
SchedulerOptions | Map | 否 | ["testManagedPrivateSpaceId****"] | 調度選項。 |
PrivatePoolOptions.MatchCriteria | String | 否 | Open | 執行個體啟動的私人池容量選項。彈性保障服務或容量預定服務在生效後會產生私人池容量,供執行個體啟動時選擇。取值範圍:
|
PrivatePoolOptions.Id | String | 否 | eap-bp67acfmxazb4**** | 私人池ID。即彈性保障服務ID或容量預定服務ID。 |
SpotDuration | Integer | 否 | 1 | 搶佔式執行個體的保留時間長度,單位為小時。取值範圍:
預設值: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個數、記憶體大小等效能指標會有差異,您可以根據自身需求,給不同的執行個體規格配置不同的權重。 例如:
為滿足期望容量,伸縮組將為使用者擴容2台ecs.c5.xlarge執行個體。 說明 擴容時伸縮組的容量不得超過最大容量(MaxSize)與執行個體規格的最大權重之和。 WeightedCapacity的取值範圍:1~500。 |
DataDisk.N.PerformanceLevel | String | 否 | PL1 | 當資料盤為ESSD雲端硬碟時,設定雲端硬碟的效能等級。N的取值必須和DataDisk.N.Category=cloud_essd中的N保持一致。取值範圍:
預設值:PL1。 說明 關於如何選擇ESSD雲端硬碟效能等級,請參見ESSD雲端硬碟。 |
DataDisk.N.AutoSnapshotPolicyId | String | 否 | sp-bp19nq9enxqkomib**** | 資料盤使用的自動快照策略ID,N的取值範圍:1~16。 |
DataDisk.N.Encrypted | String | 否 | false | 資料盤N是否加密,N的取值範圍:1~16。該參數取值範圍:
預設值:false。 |
DataDisk.N.Description | String | 否 | Test data disk. | 資料盤的描述,N的取值範圍:1~16。長度為2~256個英文或中文字元,不能以 |
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自動嘗試下一優先順序的磁碟類型建立資料盤。取值範圍:
說明 指定本參數時,不允許同時指定 DataDisk.N.Category 。 |
DataDisk.N.Size | Integer | 否 | 100 | 資料盤N的磁碟大小,N的取值範圍:1~16,記憶體單位為GiB。取值範圍:
指定該參數後,磁碟大小必須大於等於快照大小(快照通過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個英文或中文字元。必須以大小寫字母或中文開頭,不能以 |
DataDisk.N.Category | String | 否 | cloud_ssd | 資料盤N的磁碟種類,N的取值範圍:1~16。該參數取值範圍:
該參數不能與
|
DataDisk.N.DeleteWithInstance | Boolean | 否 | true | 指定資料盤是否隨執行個體釋放,N的取值範圍:1~16。該參數取值範圍:
該參數只可對獨立雲端硬碟設定(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(效能突發)。取值範圍:
更多資訊,請參見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.InstanceFamilyLevel | String | 否 | EnterpriseLevel | 智能配置模式下,執行個體規格類型系列層級,用於篩選符合要求的執行個體規格範圍。取值範圍:
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* | 需要排除的執行個體規格。通過使用萬用字元(*)可以排除單個規格或者整個規格類型系列。例如:
|
InstancePatternInfo.N.Architecture.N | String | 否 | X86 | 執行個體規格所屬的架構類型。取值範圍:
預設值:包含所有架構類型。 |
InstancePatternInfo.N.BurstablePerformance | String | 否 | Include | 是否為效能突發執行個體規格。取值範圍:
預設值: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。
|
InstancePatternInfo.N.CpuArchitectures.N | String | 否 | X86 | 執行個體的CPU架構。取值範圍: 說明 N表示可以設定多個CPU架構,N的取值範圍:1~2。
|
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自動嘗試下一優先順序的磁碟類型建立系統硬碟。取值範圍:
說明 指定本參數時,不允許同時指定 SystemDisk.Category 。 |
SystemDisk.Encrypted | Boolean | 否 | false | 是否加密系統硬碟。取值範圍:
預設值:false。 |
SystemDisk.KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40**** | 系統硬碟使用的KMS密鑰ID。 |
SystemDisk.EncryptAlgorithm | String | 否 | AES-256 | 系統硬碟採用的密碼編譯演算法。取值範圍:
預設值: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(效能突發)。取值範圍:
更多資訊,請參見ESSD AutoPL雲端硬碟。 |
ImageOptions.LoginAsNonRoot | Boolean | 否 | false | ECS執行個體是否使用
預設值:false。 |
DeletionProtection | Boolean | 否 | false | ECS執行個體釋放保護屬性。該項僅適用於隨用隨付執行個體,指是否支援通過ECS管理主控台或API(DeleteInstance)直接釋放執行個體。取值範圍:
預設值:false。 說明 該屬性不影響Auto Scaling正常的縮容活動,即Auto Scaling發生縮容活動時,開啟執行個體釋放保護的隨用隨付執行個體可以被正常釋放掉。 |
StorageSetId | String | 否 | ss-bp67acfmxazb4p**** | 儲存集ID。 |
StorageSetPartitionNumber | Integer | 否 | 2 | 儲存集中的最大分區數量。取值為大於等於2的整數。 |
CustomPriorities.N.InstanceType | String | 否 | ecs.g6.large |
說明 該參數僅在伸縮組的 擴縮容策略 為優先順序策略 時有效,且該執行個體規格(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**** |
說明 該參數僅在伸縮組的 擴縮容策略 為優先順序策略 時有效,且該交換器(Vswitch)必須包含在伸縮組的交換器列表中。 |
NetworkInterfaces.N.InstanceType | String | 否 | Primary | 彈性網卡類型。使用
預設值:Secondary。 |
NetworkInterfaces.N.NetworkInterfaceTrafficMode | String | 否 | HighPerformance | 網卡的通訊模式。取值範圍:
預設值:Standard。 說明 RDMA模式的彈性網卡數量不能超過該執行個體規格類型系列的限制。更多資訊,請參見執行個體規格類型系列。 |
NetworkInterfaces.N.Ipv6AddressCount | Integer | 否 | 1 | 為主網卡指定隨機產生的IPv6地址數量。您需要注意以下事項:
|
NetworkInterfaces.N.SecurityGroupIds.N | String | 否 | sg-uf6ij8dwxh**** | 彈性網卡所屬的一個或多個安全性群組 ID。您需要注意以下事項:
|
DedicatedHostClusterId | String | 否 | dc-2zedxc67zqzt7lb4**** | Dedicated Host叢集ID。 |
SecurityOptions.ConfidentialComputingMode | String | 否 | TDX | 機密計算模式。可能值:
|
HttpEndpoint | String | 否 | enabled | 是否啟用執行個體中繼資料的訪問通道。取值範圍:
預設值:enabled。 說明 有關執行個體中繼資料的資訊,請參見執行個體中繼資料概述。 |
HttpTokens | String | 否 | optional | 訪問執行個體中繼資料時是否強制使用加固模式(IMDSv2)。取值範圍:
預設值: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" 託管安全性群組。 |