全部產品
Search
文件中心

Auto Scaling:ModifyScalingConfiguration

更新時間:Jan 14, 2025

如果當前的伸縮配置不滿足業務需求,您可以通過調用API ModifyScalingConfiguration修改ECS類型的伸縮配置。

介面說明

  • 如果修改伸縮配置的名稱,請注意同一伸縮組下不能存在名稱相同的伸縮配置。
  • 支援以下任一方式綁定主網卡,但需要注意每次調用介面時只能選擇一種方式配置主網卡,如果同時使用兩種方式會導致介面調用失敗並返回錯誤資訊。
    • 通過SecurityGroupIdSecurityGroupIds.NIpv6AddressCount等參數直接設定主網卡的相關配置資訊。
    • 通過NetworkInterfaces.N設定主網卡以及輔助網卡的配置資訊,且使用該參數必須設定主網卡資訊。其中,NetworkInterfaces.N.InstanceType取值為Primary時,表示設定主網卡;當NetworkInterfaces.N.InstanceType取值為Secondary或空值時,表示設定輔助網卡。

      說明 修改伸縮配置時,選擇以上一種方式修改網卡配置時,會清空另一種方式設定的網卡配置。

調試

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

請求參數

名稱

類型

是否必選

樣本值

描述

Action String ModifyScalingConfiguration

系統規定參數。取值:ModifyScalingConfiguration

ScalingConfigurationId String asc-bp16har3jpj6fjbx****

待修改伸縮配置的ID。

IoOptimized String none

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

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

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

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

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

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

InstanceName String inst****

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

HostName String hos****

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

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

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

說明 如果伸縮配置之前使用的鏡像包括系統硬碟和資料盤,修改此鏡像後,原資料盤資訊會被清除。
ImageName String suse11sp3_64_20G_aliaegis_2015****.vhd

鏡像檔案名稱,同一個地區內鏡像名稱唯一。如果設定了ImageId,ImageName將被忽略。

不支援通過ImageName設定鏡像市場鏡像。

Cpu Integer 2

vCPU個數。

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

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

記憶體大小。

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

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

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

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

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

預設值:0。

SystemDisk.Category String cloud_efficiency

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

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

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

SystemDisk.Size Integer 50

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

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

指定該參數後,系統硬碟大小必須大於等於max{20, 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 PL0

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

  • PL0:單盤最高隨機讀寫IOPS 1萬。
  • PL1:單盤最高隨機讀寫IOPS 5萬。
  • PL2:單盤最高隨機讀寫IOPS 10萬。
  • PL3:單盤最高隨機讀寫IOPS 100萬。
說明 關於如何選擇ESSD雲端硬碟效能等級,請參見ESSD雲端硬碟
LoadBalancerWeight Integer 50

後端伺服器的權重,取值範圍:1~100。

UserData String ZWNobyBoZWxsbyBlY3Mh

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

KeyPairName String KeyPair_Name

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

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

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

PasswordInherit Boolean false

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

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

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

  • Key最多支援64個字元,不能以aliyunacs:開頭,不能包含http://或者https://。一旦使用標籤,Key不允許為空白字串。
  • Value最多支援128個字元,不能以aliyunacs:開頭,不能包含http://或者https://。Value可以為空白字串。
DeploymentSetId String ds-bp13v7bjnj9gis****

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

SecurityGroupId String sg-F876F****

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

Override Boolean true

是否覆蓋。取值範圍:

  • true:覆蓋。
  • false:不覆蓋。
ResourceGroupId String abcd1234abcd****

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

HpcClusterId String hpc-clusterid

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

InstanceDescription String Test instance.

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

Ipv6AddressCount Integer 1

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

CreditSpecification String Standard

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

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可用資源不足,則執行個體重啟失敗。
Tenancy String default

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

  • default:建立非Dedicated Host執行個體。
  • host:建立Dedicated Host執行個體。若您不指定DedicatedHostId,則由阿里雲自動選擇Dedicated Host放置執行個體。
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(預設)直接釋放執行個體。

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萬。
說明 關於如何選擇ESSD雲端硬碟效能等級,請參見ESSD雲端硬碟
DataDisk.N.AutoSnapshotPolicyId String sp-bp19nq9enxqkomib****

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

DataDisk.N.Encrypted String false

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

  • true:加密。
  • false:不加密。
DataDisk.N.Description String Test data disk.

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

DataDisk.N.SnapshotId String s-snapshot****

建立資料盤時使用的快照,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_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雲端硬碟。
  • cloud_essd:ESSD雲端硬碟。
  • ephemeral_ssd:本地SSD盤。
  • 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),否則會出現報錯。

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時才支援設定該參數。

SpotPriceLimit.N.PriceLimit Float 0.125

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

SpotPriceLimit.N.InstanceType String ecs.g6.large

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

InstanceTypes.N String ecs.g6.large

多執行個體規格參數。如果使用了InstanceTypes.N,InstanceType將被忽略,其中N的取值範圍:1~10,即一個伸縮配置內最多可以設定10種執行個體規格。

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

InstanceTypeOverride.N.InstanceType String ecs.c5.xlarge

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

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

說明 指定本參數時,不允許同時指定instanceTypes。

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。

SecurityGroupIds.N String sg-bp18kz60mefs****

所屬安全性群組ID。

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.Architecture.N String X86

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

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

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

InstancePatternInfo.N.BurstablePerformance String Include

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

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

預設值:Include。

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

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

  • ecs.c6.large:表示排除ecs.c6.large執行個體規格。
  • ecs.c6.*:表示排除整個c6規格類型系列的執行個體規格。
說明 如果需要排除多個執行個體規格,請使用分隔字元(/)隔開單個執行個體規格。例如ecs.n1.small/ecs.n1.*/*7*
InstancePatternInfo.N.InstanceTypeFamilies.N String ["ecs.g6", "ecs.c6", … "ecs.r6"]

指定的執行個體規格類型系列。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", "ARM"]

指定執行個體的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數目。取值範圍:≥1的正整數。

InstancePatternInfo.N.MaximumGpuAmount Integer 2

執行個體期望的最大GPU數目。取值範圍:≥1的正整數。

SystemDiskCategories.N String cloud

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

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

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

()~!@#$%^&*-_+=\|{}[]:;'<>,.?/ 其中,Windows執行個體不能以斜線號(/)為密碼首字元。 > 如果傳入Password參數,建議您使用HTTPS協議發送請求,避免密碼泄露。
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時才支援設定該參數。

ImageOptions.LoginAsNonRoot Boolean false

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

  • true:是。
  • false:否。
DeletionProtection Boolean false

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

  • true:開啟執行個體釋放保護屬性,表示不支援通過ECS管理主控台或API直接釋放執行個體(即防止Auto Scaling中擴容的執行個體被誤刪)。
  • false:關閉執行個體釋放保護屬性,表示支援通過ECS管理主控台或API直接釋放執行個體。
說明 該屬性不影響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時,設定該參數才會生效。
  • 如果NetworkInterfaces.N.InstanceType取值為Secondary或空值,則不能設定該參數。
  • 設定該參數後,您不能再設定Ipv6AddressCount參數。
NetworkInterfaces.N.SecurityGroupIds.N String sg-2ze55shrh****

彈性網卡所屬的一個或多個安全性群組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。

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

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

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

返回資料

名稱

類型

樣本值

描述

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

請求ID。

樣本

請求樣本

http(s)://ess.aliyuncs.com/?Action=ModifyScalingConfiguration
&ScalingConfigurationId=asc-bp16har3jpj6fjbx****
&IoOptimized=none
&SpotStrategy=NoSpot
&ScalingConfigurationName=test-modify
&InstanceName=inst****
&HostName=hos****
&ImageId=centos6u5_64_20G_aliaegis_2014****.vhd
&ImageName=suse11sp3_64_20G_aliaegis_2015****.vhd
&Cpu=2
&Memory=16
&InternetChargeType=PayByBandwidth
&InternetMaxBandwidthOut=50
&SystemDisk.Category=cloud_efficiency
&SystemDisk.Size=50
&SystemDisk.DiskName=cloud_ssdSystem
&SystemDisk.Description=Test system disk.
&SystemDisk.AutoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&SystemDisk.PerformanceLevel=PL0
&LoadBalancerWeight=50
&UserData=ZWNobyBoZWxsbyBlY3Mh
&KeyPairName=KeyPair_Name
&RamRoleName=RamRoleTest
&PasswordInherit=false
&Tags={"key1":"value1","key2":"value2", ... "key5":"value5"}
&DeploymentSetId=ds-bp13v7bjnj9gis****
&SecurityGroupId=sg-F876F****
&Override=true
&ResourceGroupId=abcd1234abcd****
&HpcClusterId=hpc-clusterid
&InstanceDescription=Test instance.
&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
&DataDisk=[{"PerformanceLevel":"PL1","AutoSnapshotPolicyId":"sp-bp19nq9enxqkomib****","Encrypted":"false","Description":"Test data disk.","SnapshotId":"s-snapshot****","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.125,"InstanceType":"ecs.g6.large"}]
&InstanceTypes=["ecs.g6.large"]
&InstanceTypeOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&SecurityGroupIds=["sg-bp18kz60mefs****"]
&InstancePatternInfo=[{"Cores":2,"InstanceFamilyLevel":"EnterpriseLevel","MaxPrice":2.0,"Memory":4.0,"Architecture":["X86"],"BurstablePerformance":"Include","ExcludedInstanceType":["ecs.n1.small/ecs.n1.*/*7*"],"InstanceTypeFamilies":["[\"ecs.g6\", \"ecs.c6\", … \"ecs.r6\"]"],"MinimumCpuCoreCount":2,"MaximumCpuCoreCount":4,"GpuSpecs":["[\"NVIDIA V100\"]"],"InstanceCategories":["[\"Compute-optimized with GPU\" ]"],"CpuArchitectures":["[\"X86\", \"ARM\"]"],"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-2ze55shrh****"]}]
&DedicatedHostClusterId=dc-2zedxc67zqzt7lb4****
&公用請求參數

正常返回樣本

XML格式

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

<ModifyScalingConfigurationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingConfigurationResponse>

JSON格式

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

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

HttpCode

錯誤碼

錯誤資訊

描述

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

未授權操作當前Action。

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.

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

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

InvalidParamter

The specified value of parameter is not valid.

指定的參數值無效。

400

InvalidScalingConfigurationName.Duplicate

The specified value of parameter is duplicated.

伸縮配置名已存在。

400

InvalidSecurityGroupId.IncorrectNetworkType

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

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

400

InvalidSecurityGroupId.VPCMismatch

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

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

400

InvalidTags.KeyValue

The specified tags key/value cannot be empty.

必須指定Tags參數。

400

InvalidTags.ListSize

The specified tags list size cannot be more than "20".

Tags列表長度超過限制長度。

400

InvalidUserData.Base64FormatInvalid

The specified parameter UserData must be base64 encoded.

UserData不符合Base64編碼規範。

400

InvalidUserData.SizeExceeded

The specified parameter UserData exceeds the size.

指定的UserData過長。

400

InvalidSecurityGroupId.IncorrectType

The managed security group "XXX" is not supported.

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