全部產品
Search
文件中心

Auto Scaling:CreateScalingConfiguration

更新時間:Jul 16, 2026

透過呼叫 CreateScalingConfiguration 介面,並指定伸縮群組 ID、執行個體規格、執行個體映像等資訊,為伸縮群組建立一個 ECS 類型的伸縮配置。

介面說明

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

  • InstancePatternInfos:智慧配置模式,無需指定具體的執行個體規格,只需根據業務需求指定執行個體的 vCPU 核心數、記憶體大小、規格族級別以及最高價格,系統會自動篩選符合要求的執行個體規格,並優先選擇價格最低的執行個體規格建立 ECS 執行個體。該模式僅適用於伸縮群組的網路類型為專有網路,能夠有效降低擴容時執行個體規格庫存不足的情況。

  • InstanceType:指定一種執行個體規格。

  • InstanceTypes:指定多種執行個體規格。

  • InstanceTypeOverrides:指定多種執行個體規格,並為不同的執行個體規格配置權重。

  • Cpu 和 Memory:指定 CPU 和記憶體定義執行個體規格的範圍,彈性伸縮會結合 IO 優化、可用區等因素確定可用執行個體規格集合,並根據價格排序為您建立價格最低的執行個體。該方式僅適用於伸縮群組的擴縮容策略為成本優化策略,且伸縮配置未指定執行個體規格的場景。

  • 支援以下任一方式綁定主網卡,但需要注意一次呼叫只能選用一種方式配置主網卡,同時使用兩種方式將會呼叫失敗並返回錯誤資訊。

    • 透過 SecurityGroupId、SecurityGroupIds 與 Ipv6AddressCount 等參數直接設定主網卡的相關配置資訊。

    • 透過 NetworkInterfaces 設定主網卡以及輔助網卡的配置資訊。當使用 NetworkInterface 參數時,必須設定主網卡資訊,其中 NetworkInterface.InstanceType 取值為 Primary 時,表示設定主網卡;當 NetworkInterface.InstanceType 取值為 Secondary 或空值時,表示設定輔助網卡。

說明

InstanceType、InstanceTypes、InstanceTypeOverrides、Cpu 和 Memory 這四種方式不能同時指定,但 InstanceType 或者 InstanceTypes 可以與 InstancePatternInfos 同時指定。與 InstancePatternInfos 同時指定時,彈性伸縮優先使用您指定的執行個體規格擴容,當指定的執行個體規格無庫存時,再使用符合 InstancePatternInfos 配置的執行個體規格。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ess:CreateScalingConfiguration

create

*全部資源。

*

請求參數

名稱

類型

必填

描述

樣本值

ScalingGroupId

string

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

asg-bp14wlu85wrpchm0****

ImageId

string

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

centos6u5_64_20G_aliaegis****.vhd

ImageName

string

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

不支援透過 ImageName 設定映像市場映像。

image****

InstanceType

string

ECS 執行個體的執行個體規格,更多資訊,請參見執行個體規格族。

ecs.g6.large

Cpu

integer

vCPU 個數。單位:核。

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

說明

該區間配置效果僅在成本優化模式下且伸縮配置未設定執行個體規格時生效。

2

Memory

integer

記憶體大小。單位:GiB。

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

說明

該區間配置效果僅在成本優化模式下且伸縮配置未設定執行個體規格時生效。

16

DeploymentSetId

string

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

ds-bp1frxuzdg87zh4pz****

SecurityGroupId

string

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

sg-280ih****

IoOptimized

string

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

none:非 I/O 優化執行個體。 optimized:I/O 優化執行個體。

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

optimized

InternetChargeType

string

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

  • PayByBandwidth:按頻寬計費。此時 InternetMaxBandwidthOut 即為所選的固定頻寬值。

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

如果未指定該參數,傳統網路下預設值為 PayByBandwidth,專有網路 VPC 下預設值為 PayByTraffic。

PayByTraffic

InternetMaxBandwidthIn

integer

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

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

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

10

InternetMaxBandwidthOut

integer

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

預設值:0。

10

SystemDisk.Category

string

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

  • cloud:普通雲端硬碟。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • ephemeral_ssd:本機 SSD 碟。

  • cloud_essd:ESSD 雲端硬碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

該參數不能與 SystemDiskCategories 同時指定。當該參數與 SystemDiskCategories 都未指定時,該參數有預設值:

  • 對於 I/O 優化執行個體,預設值為 cloud_efficiency。

  • 對於非 I/O 優化執行個體,預設值為 cloud。

cloud_ssd

SystemDisk.Size

integer

系統磁碟大小,單位為 GiB。取值範圍:

  • 普通雲端硬碟:20~500。

  • ESSD 雲端硬碟:
    • PL0:1~2048。

    • PL1:20~2048。

    • PL2:461~2048。

    • PL3:1261~2048。

  • ESSD AutoPL 雲端硬碟:1~2048。

  • 其他雲端硬碟類型:20~2048。

該參數的取值必須大於或者等於 max{1, ImageSize}。

預設值:max{40, ImageSize}。

100

SystemDisk.DiskName

string

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

cloud_ssdSystem

SystemDisk.Description

string

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

Test system disk.

SystemDisk.AutoSnapshotPolicyId

string

系統磁碟使用的自動快照原則 ID。

sp-bp12m37ccmxvbmi5****

SystemDisk.PerformanceLevel

string

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

  • PL0:單碟最高隨機讀寫 IOPS 1 萬。

  • PL1:單碟最高隨機讀寫 IOPS 5 萬。

  • PL2:單碟最高隨機讀寫 IOPS 10 萬。

  • PL3:單碟最高隨機讀寫 IOPS 100 萬。

預設值:PL1。

PL0

ScalingConfigurationName

string

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

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

scalingconfig****

LoadBalancerWeight

integer

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

預設值:50。

50

Tags

string

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

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

  • Value 最多支援 128 個字元,不能以 aliyun 和 acs: 開頭,不能包含 http:// 或者 https://。Value 可以為空字串。

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

UserData

string

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

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

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

  • 對 Windows 執行個體,該參數將被忽略,預設為空。

  • 對 Linux 執行個體,密碼登入方式會被初始化成禁止。

KeyPairTest

RamRoleName

string

ECS 執行個體的 RAM 角色名稱。RAM 角色名稱由 RAM 提供和維護,您可呼叫 ListRoles 查詢可用的 RAM 角色。

ramrole****

SecurityEnhancementStrategy

string

是否開啟安全性加固。取值範圍:

  • Active:啟用安全性加固,只對公用映像生效。

  • Deactive:不啟用安全性加固,對所有映像類型生效。

Active

InstanceName

string

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

instance****

HostName

string

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

  • Windows 執行個體:主機名稱長度為 2~15,可以包含大小寫字母、數字和短劃線(-)。不能包含半形句號(.),不能全是數字。

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

host****

SpotStrategy

string

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

  • NoSpot:普通的隨用隨付執行個體。

  • SpotWithPriceLimit:設定上限價格的搶占式執行個體。

  • SpotAsPriceGo:系統自動出價,跟隨目前市場實際價格。

預設值:NoSpot。

NoSpot

PasswordInherit

boolean

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

  • true:使用映像預設密碼。

  • false:不使用映像預設密碼。

false

Password

string

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

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

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

說明

如果傳入 Password 參數,建議您使用 HTTPS 協議發送請求,避免密碼洩露。

123abc****

ResourceGroupId

string

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

rg-resource****

HpcClusterId

string

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

hpc-clusterid

InstanceDescription

string

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

Test instance.

ClientToken

string

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

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

Ipv6AddressCount

integer

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

1

CreditSpecification

string

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

  • Standard:標準模式。

  • Unlimited:無效能約束模式。

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

Standard

ImageFamily

string

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

hangzhou-daily-update

ZoneId

string

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

cn-hangzhou-g

DedicatedHostId

string

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

您可以呼叫 DescribeDedicatedHosts 介面查詢專用宿主機 ID 列表。

dh-bp67acfmxazb4p****

Affinity

string

專用宿主機執行個體是否與專用宿主機關聯。取值範圍:

  • default:執行個體不與專用宿主機關聯。已啟用節省停機模式的執行個體,停機後再次啟動時,若原專用宿主機可用資源不足,則執行個體被放置在自動部署資源池的其他專用宿主機上。

  • host:執行個體與專用宿主機關聯。已啟用節省停機模式的執行個體,停機後再次啟動時,仍放置在原專用宿主機上。若原專用宿主機可用資源不足,則執行個體重啟失敗。

預設值:default。

default

Tenancy

string

是否在專用宿主機上建立執行個體。取值範圍:

  • default:建立非專用宿主機執行個體。

  • host:建立專用宿主機執行個體。若您不指定 DedicatedHostId,則由阿里雲自動選擇專用宿主機放置執行個體。

預設值:default。

default

SchedulerOptions

object

排程選項。

["testManagedPrivateSpaceId****"]

PrivatePoolOptions.MatchCriteria

string

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

  • Open:開放模式。將自動匹配開放類型的私有池容量。如果沒有符合條件的私有池容量,則使用公共池資源啟動。該模式下無需設定 PrivatePoolOptions.Id 參數。

  • Target:指定模式。使用指定的私有池容量啟動執行個體,如果該私有池容量不可用,則執行個體會啟動失敗。該模式下必須指定私有池 ID,即 PrivatePoolOptions.Id 參數為必填項。

  • None:不使用模式。執行個體啟動將不使用私有池容量。

Open

PrivatePoolOptions.Id

string

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

eap-bp67acfmxazb4****

SpotDuration

integer

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

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

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

說明

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

預設值:1。

1

SpotInterruptionBehavior

string

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

Terminate

InstanceTypes

array

多執行個體規格參數。如果使用了 InstanceTypes,InstanceType 將被忽略。

當無法根據優先順序較高的執行個體規格建立出執行個體時,彈性伸縮服務會自動選擇下一優先順序的執行個體規格來建立執行個體。

string

多執行個體規格參數。如果使用了 InstanceTypes,InstanceType 將被忽略。

當無法根據優先順序較高的執行個體規格建立出執行個體時,彈性伸縮服務會自動選擇下一優先順序的執行個體規格來建立執行個體。

ecs.g6.large

InstanceTypeOverrides

array<object>

用於指定的執行個體規格相關資訊。

object

用於指定的執行個體規格相關資訊。

InstanceType

string

當您需要伸縮群組按照執行個體規格容量進行伸縮時,請同時指定本參數和 WeightedCapacity。

本參數用於指定執行個體規格,會覆蓋啟動範本中的執行個體規格。您可以指定 N 個本參數,擴展啟動範本支援 N 個執行個體規格。N 的取值範圍:1~20。

說明

僅當 LaunchTemplateId 參數指定了啟動範本時,本參數生效。

InstanceType 的取值範圍:在售的 ECS 執行個體規格。

ecs.c5.xlarge

WeightedCapacity

integer

當您需要指定伸縮配置中執行個體規格的容量時,在指定 InstanceTypeOverrides.InstanceType 後,再指定本參數。

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

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

例如:

  • 目前容量:0。

  • 期望容量:6。

  • ecs.c5.xlarge 規格容量:4。

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

說明

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

WeightedCapacity 的取值範圍:1~500。

4

DataDisks

array<object>

資料磁碟資訊的集合。

object

資料磁碟資訊的集合。

PerformanceLevel

string

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

  • PL0:單碟最高隨機讀寫 IOPS 1 萬。

  • PL1:單碟最高隨機讀寫 IOPS 5 萬。

  • PL2:單碟最高隨機讀寫 IOPS 10 萬。

  • PL3:單碟最高隨機讀寫 IOPS 100 萬。

說明

關於如何選擇 ESSD 雲端硬碟效能等級,請參見ESSD 雲端硬碟

PL0

AutoSnapshotPolicyId

string

資料磁碟使用的自動快照原則 ID。

sp-bp19nq9enxqkomib****

Encrypted

string

資料磁碟是否加密。該參數取值範圍:

  • true:加密。

  • false:不加密。

預設值:false。

false

Description

string

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

Test data disk.

SnapshotId

string

建立資料磁碟時使用的快照。指定該參數後,DataDisks.Size 會被忽略,實際建立的磁碟大小為指定快照的大小。

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

s-280s7****

Categories

array

資料磁碟的多磁碟類型。當無法使用高優先順序的磁碟類型時,彈性伸縮自動嘗試下一優先順序的磁碟類型建立資料磁碟。取值範圍:

  • cloud:普通雲端硬碟。隨執行個體建立的普通雲端硬碟的 DeleteWithInstance 屬性為 true。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • ephemeral_ssd:本機 SSD 碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_regional_disk_auto:ESSD 同城冗餘雲端硬碟。

說明

指定本參數時,不允許同時指定 DataDisks.Category

string

資料磁碟的多磁碟類型。當無法使用高優先順序的磁碟類型時,彈性伸縮自動嘗試下一優先順序的磁碟類型建立資料磁碟。取值範圍:

  • cloud:普通雲端硬碟。隨執行個體建立的普通雲端硬碟的 DeleteWithInstance 屬性為 true。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • ephemeral_ssd:本機 SSD 碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_regional_disk_auto:ESSD 同城冗餘雲端硬碟。

說明

指定本參數時,不允許同時指定 DataDisks.Category

cloud

Size

integer

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

  • cloud:5~2000。

  • cloud_efficiency:20~32768。

  • cloud_essd:20~32768。

  • ephemeral_ssd:5~800。

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

100

Device

string

資料磁碟掛載點。如果您沒有指定該參數,則預設在自動建立 ECS 執行個體時由系統分配,從 /dev/xvdb 開始,到 /dev/xvdz 結束。

/dev/xvdb

DiskName

string

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

cloud_ssdData

Category

string

資料磁碟的磁碟種類。取值範圍:

  • cloud:普通雲端硬碟。隨執行個體建立的普通雲端硬碟的 DeleteWithInstance 屬性為 true。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • ephemeral_ssd:本機 SSD 碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_regional_disk_auto:ESSD 同城冗餘雲端硬碟。

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

  • 對於 I/O 優化執行個體,預設值為 cloud_efficiency。

  • 對於非 I/O 優化執行個體,預設值為 cloud。

cloud_ssd

DeleteWithInstance

boolean

指定資料磁碟是否隨執行個體釋放。該參數取值範圍:

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

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

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

預設值:true。

true

KMSKeyId

string

資料磁碟對應的 KMS 金鑰的 ID。

0e478b7a-4262-4802-b8cb-00d3fb40****

ProvisionedIops

integer

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

說明

IOPS(Input/Output Operations Per Second)指每秒能處理的 I/O 個數,表示區塊儲存處理讀寫(輸出/輸入)的能力,單位為次。

100

BurstingEnabled

boolean

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

  • true:開啟。

  • false:未開啟。

說明

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

false

SpotPriceLimits

array<object>

搶占式執行個體相關的計費資訊組成的集合。

object

搶占式執行個體相關的計費資訊組成的集合。

PriceLimit

number

搶占式執行個體對應的出價。SpotStrategy 取值為 SpotWithPriceLimit 時生效。

0.5

InstanceType

string

搶占式執行個體的執行個體規格。SpotStrategy 取值為 SpotWithPriceLimit 時生效。

ecs.g6.large

SecurityGroupIds

array

將 ECS 執行個體同時加入多個安全性群組。更多詳情,請參見使用限制下的安全性群組章節。

說明

不支援同時指定 SecurityGroupId 和 SecurityGroupIds。

string

將 ECS 執行個體同時加入多個安全性群組。更多詳情,請參見使用限制下的安全性群組章節。

說明

不支援同時指定 SecurityGroupId 和 SecurityGroupIds。

sg-bp18kz60mefs****

InstancePatternInfos

array<object>

智慧配置的資訊集合,用於篩選符合要求的執行個體規格範圍。

object

智慧配置的資訊集合,用於篩選符合要求的執行個體規格範圍。

Cores

integer

智慧配置模式下,執行個體規格的 vCPU 核心數目,用於篩選符合要求的執行個體規格範圍。更多資訊,請參見執行個體規格族

請注意以下資訊:

  • InstancePatternInfos 參數僅適用於伸縮群組的網路類型為專有網路。

  • InstancePatternInfos 參數必須同時配置 InstancePatternInfos.Cores 和 InstancePatternInfos.Memory。

  • 如果您已經透過 InstanceType 或 InstanceTypes 參數指定了執行個體規格,彈性伸縮優先使用您指定的執行個體規格擴容,當指定的執行個體規格無庫存時,再從符合 InstancePatternInfos 參數值的執行個體規格中優先使用價格最低的執行個體規格擴容。

2

InstanceFamilyLevel

string

執行個體規格族級別,用於篩選符合要求的執行個體規格範圍,當 CostOptimization 開啟時生效。取值範圍:

  • EntryLevel:入門級,即共用型執行個體規格。成本更低,但是無法保證執行個體計算效能的穩定。適用於平時 CPU 使用率低的業務場景。更多資訊,請參見共用型

  • EnterpriseLevel:企業級。效能穩定且資源獨享,適用於對穩定性要求高的業務場景。更多資訊,請參見執行個體規格族

  • CreditEntryLevel:積分入門級,即突發效能執行個體。透過 CPU 積分來保證計算效能,適用於平時 CPU 使用率低、偶有突發 CPU 使用率的業務場景。更多資訊,請參見突發效能執行個體概述

EnterpriseLevel

MaxPrice

number

智慧配置模式下,隨用隨付執行個體或者搶占式執行個體可接受的每小時最高價格,用於篩選符合要求的執行個體規格範圍。

說明

SpotStrategy 設定為 SpotWithPriceLimit 時,該參數必選。其他情況下,該參數可選。

2

Memory

number

智慧配置模式下,執行個體規格的記憶體大小,單位為 GiB,用於篩選符合要求的執行個體規格範圍。

4

ExcludedInstanceTypes

array

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

  • ecs.c6.large:表示排除 ecs.c6.large 執行個體規格。

  • ecs.c6.*:表示排除整個 c6 規格族的執行個體規格。

string

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

  • ecs.c6.large:表示排除 ecs.c6.large 執行個體規格。

  • ecs.c6.*:表示排除整個 c6 規格族的執行個體規格。

ecs.n1.small/ecs.n1.*/*7*

Architectures

array

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

  • X86:X86 運算。

  • Heterogeneous:異構運算,例如 GPU 或 FPGA 等。

  • BareMental:彈性裸金屬伺服器。

  • Arm:Arm 運算。

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

string

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

  • X86:X86 運算。

  • Heterogeneous:異構運算,例如 GPU 或 FPGA 等。

  • BareMental:彈性裸金屬伺服器。

  • Arm:Arm 運算。

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

X86

BurstablePerformance

string

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

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

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

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

預設值:Include。

Include

InstanceTypeFamilies

array

指定查詢的執行個體規格族。N 表示可以設定多個執行個體規格族,N 的取值範圍:1~10。

string

指定查詢的執行個體規格族。N 表示可以設定多個執行個體規格族,N 的取值範圍:1~10。

ecs.g6

MinimumCpuCoreCount

integer

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

2

MaximumCpuCoreCount

integer

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

說明

MaximumCpuCoreCount 不支援超過 MinimumCpuCoreCount 的 4 倍。

4

GpuSpecs

array

GPU 類型。

string

GPU 類型。

NVIDIA V100

InstanceCategories

array

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

說明

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 :彈性裸金屬伺服器。

  • High Performance Compute:高效能計算型。

string

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

說明

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 :彈性裸金屬伺服器。

  • High Performance Compute:高效能計算型。

Compute-optimized with GPU

CpuArchitectures

array

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

說明

N 表示可以設定多個 CPU 架構,N 的取值範圍:1~2。

  • X86。

  • ARM。

string

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

說明

N 表示可以設定多個 CPU 架構,N 的取值範圍:1~2。

  • X86。

  • ARM。

X86

PhysicalProcessorModels

array

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

string

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

Intel Xeon(Ice Lake) Platinum 8369B

MinimumEniQuantity

integer

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

2

MinimumEniPrivateIpAddressQuantity

integer

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

2

MinimumEniIpv6AddressQuantity

integer

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

1

MinimumInitialCredit

integer

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

12

MinimumBaselineCredit

integer

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

12

MinimumMemorySize

number

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

4

MaximumMemorySize

number

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

4

MinimumGpuAmount

integer

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

2

MaximumGpuAmount

integer

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

2

SystemDiskCategories

array

系統磁碟的多磁碟類型。當無法使用高優先順序的磁碟類型時,彈性伸縮自動嘗試下一優先順序的磁碟類型建立系統磁碟。取值範圍:

  • cloud:普通雲端硬碟。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

說明

指定本參數時,不允許同時指定 SystemDisk.Category

string

系統磁碟的多磁碟類型。當無法使用高優先順序的磁碟類型時,彈性伸縮自動嘗試下一優先順序的磁碟類型建立系統磁碟。取值範圍:

  • cloud:普通雲端硬碟。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

說明

指定本參數時,不允許同時指定 SystemDisk.Category

cloud

SystemDisk.Encrypted

boolean

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

  • true:加密。

  • false:不加密。

預設值:false。

false

SystemDisk.KMSKeyId

string

系統磁碟使用的 KMS 金鑰 ID。

0e478b7a-4262-4802-b8cb-00d3fb40****

SystemDisk.EncryptAlgorithm

string

系統磁碟採用的加密演算法。取值範圍:

  • AES-256。

  • SM4-128。

預設值:AES-256。

AES-256

SystemDisk.ProvisionedIops

integer

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

說明

IOPS(Input/Output Operations Per Second)指每秒能處理的 I/O 個數,表示區塊儲存處理讀寫(輸出/輸入)的能力,單位為次。

100

SystemDisk.BurstingEnabled

boolean

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

  • true:開啟。

  • false:未開啟。

說明

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

false

ImageOptions.LoginAsNonRoot

boolean

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

  • true:是。

  • false:否。

預設值:false。

false

DeletionProtection

boolean

執行個體釋放保護屬性,指定是否支援透過 ECS 主控台或 API(DeleteInstance)直接釋放執行個體,防止執行個體被誤刪除。取值範圍:

  • true:開啟執行個體釋放保護,無法透過 ECS 主控台或 API(DeleteInstance)直接釋放執行個體。

  • false:關閉執行個體釋放保護,可以透過 ECS 主控台或 API(DeleteInstance)直接釋放執行個體。

預設值:false。

說明

該屬性僅

false

StorageSetId

string

儲存集 ID。

ss-bp67acfmxazb4p****

StorageSetPartitionNumber

integer

儲存集中的最大分割區數量。取值範圍:大於等於 2。

2

CustomPriorities

array<object>

ECS 執行個體規格+交換器的自訂優先順序。

重要 僅在伸縮群組的擴縮容策略為優先順序策略時有效。

當無法根據優先順序較高的執行個體規格+交換器建立出執行個體時,彈性伸縮服務會自動選擇下一優先順序的執行個體規格+交換器組合來建立執行個體。

說明

如果僅指定了部分執行個體規格+交換器的自訂優先順序,則未指定的部分優先順序低於指定的部分,且未指定部分仍會依次按照伸縮群組的交換器順序、伸縮配置的執行個體規格順序確定優先順序。

  • 例如:伸縮群組的交換器順序為 vsw1、vsw2,伸縮配置的執行個體規格順序為 type1、type2,自訂優先順序順序為 ["vsw2+type2", "vsw1+type2"],則最終優先順序為:"vsw2+type2" > "vsw1+type2" > "vsw1+type1" > "vsw2+type1"

object

InstanceType

string

ECS 執行個體的執行個體規格。

重要 必須包含在伸縮配置的執行個體規格列表中。

ecs.g6.large

VswitchId

string

虛擬交換器的 ID。

重要 必須包含在伸縮群組的交換器列表中。

vsw-bp14zolna43z266bq****

NetworkInterfaces

array<object>

彈性網卡列表。

object

彈性網卡。

InstanceType

string

彈性網卡類型。使用此參數時,必須使用 NetworkInterfaces 設定主網卡,同時不能設定 SecurityGroupId 或 SecurityGroupIds 參數取值範圍:

  • Primary:主網卡。

  • Secondary:輔助網卡。

預設值:Secondary。

Primary

NetworkInterfaceTrafficMode

string

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

  • Standard:使用 TCP 通訊模式。

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

預設值:Standard。

說明

RDMA 模式的彈性網卡數量不能超過該執行個體規格族的限制。更多資訊,請參見[執行個體 实例规格族

HighPerformance

Ipv6AddressCount

integer

为主网卡指定随机生成的 IPv6 地址数量。 您需要注意:

  • NetworkInterface.InstanceType 取值为 Primary 时,设置该参数才会生效。如果 NetworkInterface.InstanceType 取值为 Secondary 或空值,则不能设置该参数。

  • 设置该参数后,您不能再设置 Ipv6AddressCount。

1

SecurityGroupIds

array

弹性网卡所属的一个或多个安全组 ID。

string

弹性网卡所属的一个或多个安全组 ID。 您需要注意:

  • 如果 NetworkInterface.InstanceType 取值为 Primary,则必须设置该参数。此时该参数的作用等同于 SecurityGroupIds,但需要注意不能再设置 SecurityGroupId、SecurityGroupIds。

  • 如果 NetworkInterface.InstanceType 取值为 Secondary 或空值,则该参数为非必填参数。默认值为 ECS 实例所属的安全组,即主网卡的安全组。

sg-uf6ij8dwxxxxxx

SecondaryPrivateIpAddressCount

integer

为网卡指定辅助私网 IPv4 地址数量。取值范围:1~49。

  • 取值不能超过该实例规格对于 ip 数量的限制。更多信息,请参见实例规格族

  • NetworkInterface.N.SecondaryPrivateIpAddressCount 用于为网卡分配辅助私网 IPv4 地址数量(不包含该网卡的主私网 IP),系统将从该网卡所在虚拟交换机(NetworkInterface.N.VSwitchId)的可用网段中随机分配。

6

VSwitchIds

array

弹性网卡所属的虚拟交换机 ID。N 表示可以设置多个交换机,N 的取值范围:1~10。

您需要注意:

  • 如果 InstanceType 取值为 Primary,则不能设置该参数,默认为实例所属的虚拟交换机。

  • 如果 InstanceType 取值为 Secondary 或空值,则该参数为非必填参数。

  • 系统将选择一个与主网卡处于相同可用区且剩余 IP 多的虚拟交换机。

string

弹性网卡所属的虚拟交换机 ID。N 表示可以设置多个交换机,N 的取值范围:1~10。

您需要注意:

  • 如果 InstanceType 取值为 Primary,则不能设置该参数,默认为实例所属的虚拟交换机。

  • 如果 InstanceType 取值为 Secondary 或空值,则该参数为非必填参数。

  • 系统将选择一个与主网卡处于相同可用区且剩余 IP 多的虚拟交换机。

vsw-bp67acfmxazb4p****

DedicatedHostClusterId

string

专有宿主机集群 ID。

dc-2zedxc67zqzt7lb4****

SecurityOptions

object

安全选项。

ConfidentialComputingMode

string

机密计算模式。可能值:

TDX

HttpEndpoint

string

是否启用实例元数据的访问通道。取值范围:

  • enabled:启用。

  • disabled:禁用。

默认值:enabled。

說明

有关实例元数据的信息,请参见实例元数据概述

enabled

HttpTokens

string

访问实例元数据时是否强制使用加固模式(IMDSv2)。取值范围:

  • optional:不强制使用。

  • required:强制使用。设置该取值后,普通模式无法访问实例元数据。

默认值:optional。

說明

有关访问实例元数据的模式,请参见实例元数据访问模式

optional

ResourcePoolOptions

object

创建实例时使用的资源池策略。当您设置该参数后,需要注意:

  • 该参数只在创建按量付费实例时生效。

  • 该参数不能与 PrivatePoolOptions.MatchCriteria、PrivatePoolOptions.Id 同时设置。

Strategy

string

资源池包括弹性保障服务或容量预定服务生效后生成的私有池以及公共池,供实例启动时选择。取值范围:

  • PrivatePoolFirst:私有池优先。选择此种策略时,当指定了 ResourcePoolOptions.PrivatePoolIds 或满足 PrivatePoolTags 条件,优先使用对应的私有池。如果未指定私有池或指定的私有池容量不足,将自动匹配开放类型的私有池。如果没有符合条件的私有池,则使用公共池创建实例。

  • PrivatePoolOnly:仅限私有池。选择此种策略时,必须指定 ResourcePoolOptions.PrivatePoolIds。如果指定的私有池容量不足,则实例会启动失败。

  • PublicPoolFirst:公有池资源优先。优先使用公共池创建实例,当公有池资源不足时,采用私有池资源进行补充。优先自动匹配开放类型的私有池,如果没有符合条件的私有池,则使用指定的 ResourcePoolOptions.PrivatePoolIds 或满足 PrivatePoolTags 条件的 Target 类型私有池。(该策略正在邀测中,暂不支持使用。)

  • None:不使用资源池策略。

默认值:None。

PrivatePoolFirst

PrivatePoolIds

array

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。该参数只能传入 Target 模式私有池 ID 且与 PrivatePoolTags 参数不能同时指定。

string

私有池 ID。即弹性保障服务 ID 或容量预定服务 ID。该参数只能传入 Target 模式私有池 ID 且与 PrivatePoolTags 参数不能同时指定。N 的取值范围:1~20。

eap-bp67acfmxazb4****

PrivatePoolTags

array<object>

按标签筛选可用的 Target 私有池。N 的取值范围:1~20。 说明:

  • 当配置该参数时,系统仅从账号下已关联的 Target 私有池中,筛选出标签匹配且同时满足伸缩组约束(如可用区、实例规格等)的私有池。

  • 标签匹配规则:私有池需匹配所有传入标签。

  • 该参数与 PrivatePoolIds 参数不能同时指定。

object

按标签筛选可用的 Target 私有池。N 的取值范围:1~20。 说明:

  • 当配置该参数时,系统仅从账号下已关联的 Target 私有池中,筛选出标签匹配且同时满足伸缩组约束(如可用区、实例规格等)的私有池。

  • 标签匹配规则:私有池需匹配所有传入标签。

  • 该参数与 PrivatePoolIds 参数不能同时指定。

Key

string

私有池的标签键。

TestKey

Value

string

私有池的标签值。

TestValue

InstanceTypeCandidateOptions

object

设置备选模式后,当遇到库存不足等问题时,会根据当前已选的实例规格补充相同大小的近似规格,或者创建备选可用区的交换机并添加到伸缩组。

Enabled

boolean

是否开启备选模式

true

MaxPrice

number

备选实例规格的价格上限。

2.10

AllowDifferentGeneration

boolean

是否允许补充其他代系的实例规格。

  • 例如当前规格为 ecs.c7.large,开启后可备选 ecs.c6.large 和 ecs.c8.large 等规格。

true

AllowCrossAz

boolean

是否允许补充其他可用区的交换机。

說明

规格不变,仅备选新的可用区。当伸缩组由于库存等问题导致所有已选可用区均无法扩容时,会根据此配置自动增加新的可用区交换机到伸缩组中。 例如,伸缩组配置了 cn-hangzhou-h 和 cn-hangzhou-g 可用区,当两个可用区均无法扩容时 ESS 可能会根据实时库存状况创建一个 cn-hangzhou-k 的交换机并添加到伸缩组中。

true

AllowCidrBlocks

array

允许补充其他可用区交换机时,需要指定可选的交换机的网段。

string

交换机网段要求如下:

  • 交换机的网段的掩码长度范围为 16~29 位。

  • 交换机的网段必须从属于所在 VPC 的网段。

  • 交换机的网段不能与所在 VPC 中路由条目的目标网段相同,但可以是目标网段的子集。

  • 交换机的网段不能是 100.64.0.0/10 及其子网网段。

172.16.0.0/24

SecondaryEniVSwitchConstraint

string

当辅助网卡设置 VSwitchIds 参数时,是否必须从列表中选择一个可用于辅助弹性网卡的虚拟交换机。

  • Strict:严格模式。若 VSwitchIds 中不存在任何满足条件的虚拟交换机,则创建实例失败。

  • Tolerant:容错模式。若 VSwitchIds 中不存在任何满足条件的虚拟交换机,则不设置任何辅助网卡,实例仍可正常创建。

默认值:Strict。

Strict

返回參數

名稱

類型

描述

樣本值

object

创建伸缩配置相关信息。

ScalingConfigurationId

string

伸缩配置 ID。

asc-bp1ffogfdauy0nu5****

RequestId

string

请求 ID。

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

樣本

正常返回樣本

JSON格式

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

錯誤碼

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

變更歷史

更多資訊,參考變更詳情