通過調用CreateScalingConfiguration接口,并指定伸縮組ID、實例規格、實例鏡像等信息,為伸縮組創建一個ECS類型的伸縮配置。
接口說明
伸縮配置用來指定彈性擴張時使用的ECS實例模板,支持以下實例配置方式:
- InstancePatternInfo.N:智能配置模式,無需指定具體的實例規格,只需根據業務需求指定實例的vCPU核數、內存大小、規格族級別以及最高價格,系統會自動篩選符合要求的實例規格,并優先選擇價格最低的實例規格創建ECS實例。該模式僅適用于伸縮組的網絡類型為專有網絡,能夠有效降低擴容時實例規格庫存不足的情況。
- InstanceType:指定一種實例規格。
- InstanceTypes.N:指定多種實例規格。
- InstanceTypeOverride.N:指定多種實例規格,并為不同的實例規格配置權重。
- Cpu和Memory:指定CPU和內存定義實例規格的范圍,彈性伸縮會結合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同時指定,此時,彈性伸縮會優先使用您指定的實例規格擴容,當指定的實例規格無庫存時,再使用符合InstancePatternInfo 配置的實例規格。 |
Cpu | Integer | 否 | 2 | vCPU個數。單位:核。 同時指定CPU和Memory可以定義實例規格范圍,例如,CPU=2且Memory=16可以定義配置為2 vCPU和16 GiB的所有實例規格。彈性伸縮會結合IO優化、可用區等因素確定可用實例規格集合,并根據價格排序為您創建價格最低的實例。 說明 該區間配置效果僅在成本優化模式下且伸縮配置未設置實例規格時生效。 |
Memory | Integer | 否 | 16 | 內存大小。單位:GiB。 同時指定CPU和Memory可以定義實例規格范圍。例如,CPU=2且Memory=16可以定義配置為2 vCPU和16 GiB的所有實例規格。彈性伸縮會結合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,專有網絡VPC下默認值為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**** | 是否在專有宿主機上創建ECS實例。由于專有宿主機不支持創建搶占式實例,指定DedicatedHostId參數后,會自動忽略請求中的SpotStrategy和SpotPriceLimit設置。 您可以調用DescribeDedicatedHosts查詢專有宿主機ID列表。 |
Affinity | String | 否 | default | 專有宿主機實例是否與專有宿主機關聯。取值范圍:
默認值:default。 |
Tenancy | String | 否 | default | 是否在專有宿主機上創建實例。取值范圍:
默認值: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的實例規格優先級最高,實例規格優先級隨著編號的增大依次降低。當無法根據優先級較高的實例規格創建出實例時,彈性伸縮服務會自動選擇下一優先級的實例規格來創建實例。 說明 InstanceType、InstanceTypes、InstanceTypeOverrides、Cpu和Memory這四種方式不能同時指定,但InstanceTypes可以與InstancePatternInfo同時指定。此時,彈性伸縮優先使用您指定的實例規格擴容,當指定的實例規格無庫存時,再使用符合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越小,優先級越高。當無法使用高優先級的磁盤類型時,彈性伸縮自動嘗試下一優先級的磁盤類型創建數據盤。取值范圍:
說明 指定本參數時,不允許同時指定 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個數,表示塊存儲處理讀寫(輸出/輸入)的能力,單位為次/秒。 |
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越小,優先級越高。當無法使用高優先級的磁盤類型時,彈性伸縮自動嘗試下一優先級的磁盤類型創建系統盤。取值范圍:
說明 指定本參數時,不允許同時指定 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個數,表示塊存儲處理讀寫(輸出/輸入)的能力,單位為次/秒。 |
SystemDisk.BurstingEnabled | Boolean | 否 | false | 系統盤是否開啟Burst(性能突發)。取值范圍:
更多信息,請參見ESSD AutoPL云盤。 |
ImageOptions.LoginAsNonRoot | Boolean | 否 | false | ECS實例是否使用
默認值:false。 |
DeletionProtection | Boolean | 否 | false | ECS實例釋放保護屬性。該項僅適用于按量付費實例,指是否支持通過ECS管理控制臺或API(DeleteInstance)直接釋放實例。取值范圍:
默認值:false。 說明 該屬性不影響彈性伸縮正常的縮容活動,即彈性伸縮發生縮容活動時,開啟實例釋放保護的按量付費實例可以被正常釋放掉。 |
StorageSetId | String | 否 | ss-bp67acfmxazb4p**** | 存儲集ID。 |
StorageSetPartitionNumber | Integer | 否 | 2 | 存儲集中的最大分區數量。取值為大于等于2的整數。 |
CustomPriorities.N.InstanceType | String | 否 | ecs.g6.large |
說明 該參數僅在伸縮組的 擴縮容策略 為優先級策略 時有效,且該實例規格(InstanceType)必須包含在伸縮配置的實例規格列表中。當無法根據優先級較高的ECS實例規格+虛擬交換機創建ECS實例時,彈性伸縮服務會自動選擇下一優先級的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**** | 專有宿主機集群ID。 |
SecurityOptions.ConfidentialComputingMode | String | 否 | TDX | 機密計算模式??赡苤担?/p>
|
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. |
指定的安全組和虛擬交換機不屬于同一個虛擬專有網絡。 |
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" 托管安全組。 |