全部產品
Search
文件中心

Auto Scaling:CreateScalingConfiguration

更新時間:Oct 13, 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。

本參數僅指定一種系統磁碟類型。如果需要在首選磁碟類型不可用時自動嘗試其他類型,請改用SystemDiskCategories並按優先順序配置多個磁碟類型。

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****"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情。