ModifyScalingConfiguration
如果當前的伸縮配置不滿足業(yè)務需求,您可以通過調(diào)用API ModifyScalingConfiguration修改ECS類型的伸縮配置。
接口說明
- 如果修改伸縮配置的名稱,請注意同一伸縮組下不能存在名稱相同的伸縮配置。
- 支持以下任一方式綁定主網(wǎng)卡,但需要注意每次調(diào)用接口時只能選擇一種方式配置主網(wǎng)卡,如果同時使用兩種方式會導致接口調(diào)用失敗并返回錯誤信息。
- 通過
SecurityGroupId
、SecurityGroupIds.N
與Ipv6AddressCount
等參數(shù)直接設置主網(wǎng)卡的相關配置信息。 -
通過
NetworkInterfaces.N
設置主網(wǎng)卡以及輔助網(wǎng)卡的配置信息,且使用該參數(shù)必須設置主網(wǎng)卡信息。其中,NetworkInterfaces.N.InstanceType
取值為Primary
時,表示設置主網(wǎng)卡;當NetworkInterfaces.N.InstanceType
取值為Secondary
或空值時,表示設置輔助網(wǎng)卡。說明 修改伸縮配置時,選擇以上一種方式修改網(wǎng)卡配置時,會清空另一種方式設置的網(wǎng)卡配置。
- 通過
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | ModifyScalingConfiguration | 系統(tǒng)規(guī)定參數(shù)。取值:ModifyScalingConfiguration。 |
ScalingConfigurationId | String | 是 | asc-bp16har3jpj6fjbx**** | 待修改伸縮配置的ID。 |
IoOptimized | String | 否 | none | 是否為I/O優(yōu)化實例。取值范圍:
|
SpotStrategy | String | 否 | NoSpot | 后付費實例的搶占策略。取值范圍:
|
ScalingConfigurationName | String | 否 | test-modify | 伸縮配置的名稱,2~64個英文或中文字符,以數(shù)字、大小寫字母或中文開頭,可包含數(shù)字、下劃線(_)、短劃線(-)或半角句號(.)。 在同一地域下同一伸縮組內(nèi)伸縮配置名稱唯一。如果您沒有指定該參數(shù),則默認使用伸縮配置的ID。 |
InstanceName | String | 否 | inst**** | 使用本伸縮配置自動創(chuàng)建的ECS實例的名稱。 |
HostName | String | 否 | hos**** | 云服務器ECS的主機名。半角句號(.)或短劃線(-)不能作為首尾字符,不能連續(xù)使用半角句號(.)或短劃線(-)。另外,不同類型實例的命名要求如下:
|
ImageId | String | 否 | centos6u5_64_20G_aliaegis_2014****.vhd | 鏡像文件ID,自動創(chuàng)建實例時使用的鏡像資源。 說明 如果伸縮配置之前使用的鏡像包括系統(tǒng)盤和數(shù)據(jù)盤,修改此鏡像后,原數(shù)據(jù)盤信息會被清除。 |
ImageName | String | 否 | suse11sp3_64_20G_aliaegis_2015****.vhd | 鏡像文件名稱,同一個地域內(nèi)鏡像名稱唯一。如果設置了ImageId,ImageName將被忽略。 不支持通過ImageName設置鏡像市場鏡像。 |
Cpu | Integer | 否 | 2 | vCPU個數(shù)。 同時指定CPU和Memory可以定義實例規(guī)格范圍,例如,CPU=2且Memory=16可以定義配置為2 vCPU和16 GiB的所有實例規(guī)格。彈性伸縮會結合I/O優(yōu)化、可用區(qū)等因素確定可用實例規(guī)格集合,并根據(jù)價格排序為您創(chuàng)建價格最低的實例。 說明 該區(qū)間配置效果僅在成本優(yōu)化模式下且伸縮配置未設置實例規(guī)格時生效。 |
Memory | Integer | 否 | 16 | 內(nèi)存大小。 同時指定CPU和Memory可以定義實例規(guī)格范圍,例如,CPU=2且Memory=16可以定義配置為2 vCPU和16 GiB的所有實例規(guī)格。彈性伸縮會結合I/O優(yōu)化、可用區(qū)等因素確定可用實例規(guī)格集合,并根據(jù)價格排序為您創(chuàng)建價格最低的實例。 說明 該區(qū)間配置效果僅在成本優(yōu)化模式下且伸縮配置未設置實例規(guī)格時生效。 |
InternetChargeType | String | 否 | PayByBandwidth | 網(wǎng)絡計費類型。取值范圍:
|
InternetMaxBandwidthOut | Integer | 否 | 10 | 公網(wǎng)出帶寬最大值,單位為 Mbit/s。取值范圍:0~100。 默認值:0。 |
SystemDisk.Category | String | 否 | cloud_efficiency | 系統(tǒng)盤的磁盤種類。取值范圍:
該參數(shù)不能與 |
SystemDisk.Size | Integer | 否 | 50 | 系統(tǒng)盤的大小,單位:GiB。取值范圍:
指定該參數(shù)后,系統(tǒng)盤大小必須大于等于max{20, ImageSize}。 |
SystemDisk.DiskName | String | 否 | cloud_ssdSystem | 系統(tǒng)盤的名稱。長度為2~128個英文或中文字符。必須以大小寫字母或中文開頭,不能以 |
SystemDisk.Description | String | 否 | Test system disk. | 系統(tǒng)盤的描述。長度為2~256個英文或中文字符,不能以 |
SystemDisk.AutoSnapshotPolicyId | String | 否 | sp-bp12m37ccmxvbmi5**** | 系統(tǒng)盤使用的自動快照策略ID。 |
SystemDisk.PerformanceLevel | String | 否 | PL0 | 當系統(tǒng)盤為ESSD云盤時,設置云盤的性能等級。取值范圍:
說明 關于如何選擇ESSD云盤性能等級,請參見ESSD云盤。 |
LoadBalancerWeight | Integer | 否 | 50 | 后端服務器的權重,取值范圍:1~100。 |
UserData | String | 否 | ZWNobyBoZWxsbyBlY3Mh | ECS實例的自定義數(shù)據(jù),需要以Base64方式編碼,編碼前的原始數(shù)據(jù)最多為32 KB。 |
KeyPairName | String | 否 | KeyPair_Name | 登錄ECS實例時使用的密鑰對的名稱。
|
RamRoleName | String | 否 | RamRoleTest | ECS實例的RAM角色名稱。RAM角色名稱由RAM提供和維護,您可調(diào)用ListRoles接口查詢可用的RAM角色。創(chuàng)建RAM角色的方法,請參見API CreateRole。 |
PasswordInherit | Boolean | 否 | false | 是否使用鏡像預設的密碼。使用該參數(shù)時,您需要確保使用的鏡像已經(jīng)設置了密碼。 |
Tags | String | 否 | {"key1":"value1","key2":"value2", ... "key5":"value5"} | ECS實例的標簽。標簽以鍵值對方式傳入,最多可以使用20組標簽。Key和Value的使用要求如下:
|
DeploymentSetId | String | 否 | ds-bp13v7bjnj9gis**** | ECS實例所屬的部署集的ID。 |
SecurityGroupId | String | 否 | sg-F876F**** | ECS實例所屬的安全組的ID,同一個安全組內(nèi)的ECS實例可以互相訪問。 |
Override | Boolean | 否 | true | 是否覆蓋。取值范圍:
|
ResourceGroupId | String | 否 | abcd1234abcd**** | ECS實例所屬資源組的ID。 |
HpcClusterId | String | 否 | hpc-clusterid | ECS實例所屬的HPC集群的ID。 |
InstanceDescription | String | 否 | Test instance. | ECS實例的描述。長度為2~256個英文或中文字符,不能以 |
Ipv6AddressCount | Integer | 否 | 1 | 為彈性網(wǎng)卡指定隨機生成的IPv6地址數(shù)量。 |
CreditSpecification | String | 否 | Standard | 修改突發(fā)性能實例的運行模式。取值范圍:
|
ImageFamily | String | 否 | hangzhou-daily-update | 鏡像族系名稱,通過設置該參數(shù)來獲取當前鏡像族系內(nèi)最新的可用鏡像,用于創(chuàng)建實例。如果已經(jīng)設置了參數(shù) |
ZoneId | String | 否 | cn-hangzhou-g | ECS實例所屬的可用區(qū)ID。 |
DedicatedHostId | String | 否 | dh-bp67acfmxazb4p**** | 是否在專有宿主機上創(chuàng)建ECS實例。由于專有宿主機不支持創(chuàng)建搶占式實例,指定DedicatedHostId參數(shù)后,會自動忽略請求中的SpotStrategy和SpotPriceLimit設置。 您可以調(diào)用DescribeDedicatedHosts接口查詢專有宿主機ID列表。 |
Affinity | String | 否 | default | 專有宿主機實例是否與專有宿主機關聯(lián)。取值范圍:
|
Tenancy | String | 否 | default | 是否在專有宿主機上創(chuàng)建實例。取值范圍:
|
SchedulerOptions | Map | 否 | ["testManagedPrivateSpaceId****"] | 調(diào)度選項。 |
PrivatePoolOptions.MatchCriteria | String | 否 | Open | 實例啟動的私有池容量選項。彈性保障服務或容量預定服務在生效后會生成私有池容量,供實例啟動時選擇。取值范圍:
|
PrivatePoolOptions.Id | String | 否 | eap-bp67acfmxazb4**** | 私有池ID。即彈性保障服務ID或容量預定服務ID。 |
SpotDuration | Integer | 否 | 1 | 搶占式實例的保留時長,單位為小時。取值范圍:
說明 實例被回收前5分鐘內(nèi),阿里云會通過ECS系統(tǒng)事件向您發(fā)送通知。搶占式實例按秒計費,建議您結合具體任務執(zhí)行耗時來選擇合適的保留時長。 默認值:1。 |
SpotInterruptionBehavior | String | 否 | Terminate | 搶占實例中斷模式。目前僅支持Terminate(默認)直接釋放實例。 |
DataDisk.N.PerformanceLevel | String | 否 | PL1 | 當數(shù)據(jù)盤為ESSD云盤時,設置云盤的性能等級。N的取值必須和DataDisk.N.Category=cloud_essd中的N保持一致。取值范圍:
說明 關于如何選擇ESSD云盤性能等級,請參見ESSD云盤。 |
DataDisk.N.AutoSnapshotPolicyId | String | 否 | sp-bp19nq9enxqkomib**** | 數(shù)據(jù)盤使用的自動快照策略ID,N的取值范圍:1~16。 |
DataDisk.N.Encrypted | String | 否 | false | 數(shù)據(jù)盤N是否加密,N的取值范圍:1~16。該參數(shù)取值范圍:
|
DataDisk.N.Description | String | 否 | Test data disk. | 數(shù)據(jù)盤的描述,N的取值范圍:1~16。長度為2~256個英文或中文字符,不能以 |
DataDisk.N.SnapshotId | String | 否 | s-snapshot**** | 創(chuàng)建數(shù)據(jù)盤時使用的快照,N的取值范圍:1~16。指定該參數(shù)后,DataDisk.N.Size會被忽略,實際創(chuàng)建的磁盤大小為指定快照的大小。 如果該快照創(chuàng)建于2013年7月15日或之前,調(diào)用會被拒絕,返回參數(shù)中會提示InvalidSnapshot.TooOld。 |
DataDisk.N.Categories.N | String | 否 | cloud | 數(shù)據(jù)盤N的多磁盤類型。第一個N表示第N塊數(shù)據(jù)盤,取值范圍:1~16。第二個N表示第N塊數(shù)據(jù)盤的第N種磁盤類型,取值范圍:1~4,即一個伸縮配置內(nèi)最多可以為數(shù)據(jù)盤指定4種磁盤類型。N越小,優(yōu)先級越高。當無法使用高優(yōu)先級的磁盤類型時,彈性伸縮自動嘗試下一優(yōu)先級的磁盤類型創(chuàng)建數(shù)據(jù)盤。取值范圍:
說明 指定本參數(shù)時,不允許同時指定 DataDisk.N.Category 。 |
DataDisk.N.Size | Integer | 否 | 100 | 數(shù)據(jù)盤N的磁盤大小,N的取值范圍:1~16,內(nèi)存單位為GiB。取值范圍:
指定該參數(shù)后,磁盤大小必須大于等于快照大小(快照通過SnapshotId指定)。 |
DataDisk.N.Device | String | 否 | /dev/xvdb | 數(shù)據(jù)盤掛載點,N的取值范圍:1~16。如果您沒有指定該參數(shù),則默認在自動創(chuàng)建ECS實例時由系統(tǒng)分配,從/dev/xvdb開始,到/dev/xvdz結束。 |
DataDisk.N.DiskName | String | 否 | cloud_ssdData | 數(shù)據(jù)盤的名稱,N的取值范圍:1~16。長度為2~128個英文或中文字符。必須以大小寫字母或中文開頭,不能以 |
DataDisk.N.Category | String | 否 | cloud_ssd | 數(shù)據(jù)盤N的磁盤種類,N的取值范圍:1~16。該參數(shù)取值范圍:
該參數(shù)不能與
|
DataDisk.N.DeleteWithInstance | Boolean | 否 | true | 指定數(shù)據(jù)盤是否隨實例釋放,N的取值范圍:1~16。該參數(shù)取值范圍:
該參數(shù)只可對獨立云盤設置(DataDisk.N.Category為cloud、cloud_efficiency、cloud_ssd或cloud_essd),否則會出現(xiàn)報錯。 |
DataDisk.N.KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40**** | 數(shù)據(jù)盤對應的KMS密鑰的ID,N的取值范圍:1~16。 |
DataDisk.N.ProvisionedIops | Long | 否 | 100 | 數(shù)據(jù)盤預配置的IOPS(Input/Output Operations Per Second)性能指標。 說明 IOPS(Input/Output Operations Per Second)指每秒能處理的I/O個數(shù),表示塊存儲處理讀寫(輸出/輸入)的能力,單位為次。 |
DataDisk.N.BurstingEnabled | Boolean | 否 | false | 數(shù)據(jù)盤是否開啟Burst(性能突發(fā))。取值范圍:
更多信息,請參見ESSD AutoPL云盤。 |
SpotPriceLimit.N.PriceLimit | Float | 否 | 0.125 | 搶占式實例對應的出價,N的取值范圍:1~10。SpotStrategy取值為SpotWithPriceLimit時生效。 |
SpotPriceLimit.N.InstanceType | String | 否 | ecs.g6.large | 搶占式實例的實例規(guī)格,N的取值范圍:1~10。SpotStrategy取值為SpotWithPriceLimit時生效。 |
InstanceTypes.N | String | 否 | ecs.g6.large | 多實例規(guī)格參數(shù)。如果使用了InstanceTypes.N,InstanceType將被忽略,其中N的取值范圍:1~10,即一個伸縮配置內(nèi)最多可以設置10種實例規(guī)格。 N代表當前伸縮配置中實例規(guī)格的優(yōu)先級,編號為1的實例規(guī)格優(yōu)先級最高,實例規(guī)格優(yōu)先級隨著編號的增大依次降低。當無法根據(jù)優(yōu)先級較高的實例規(guī)格創(chuàng)建出實例時,彈性伸縮服務會自動選擇下一優(yōu)先級的實例規(guī)格來創(chuàng)建實例。 |
InstanceTypeOverride.N.InstanceType | String | 否 | ecs.c5.xlarge | 當您需要指定伸縮配置中實例規(guī)格的容量時,請同時指定本參數(shù)和InstanceTypeOverride.N.WeightedCapacity。 本參數(shù)用于指定實例規(guī)格。您可以指定N個本參數(shù),結合InstanceTypeOverride.N.WeightedCapacity參數(shù),擴展多實例規(guī)格支持自定義權重。N的取值范圍:1~10。 說明 指定本參數(shù)時,不允許同時指定instanceTypes。 InstanceType的取值范圍:在售的ECS實例規(guī)格,請參見實例規(guī)格族。 |
InstanceTypeOverride.N.WeightedCapacity | Integer | 否 | 4 | 當您需要指定伸縮配置中實例規(guī)格的容量時,在指定InstanceTypeOverride.N.InstanceType后,再指定本參數(shù)。兩個參數(shù)一一對應,N需要保持一致。 本參數(shù)用于指定實例規(guī)格的權重,即實例規(guī)格的單臺實例在伸縮組中表示的容量大小。權重越大,滿足期望容量所需的本實例規(guī)格的實例數(shù)量越少。 由于每個實例規(guī)格的vCPU個數(shù)、內(nèi)存大小等性能指標會有差異,您可以根據(jù)自身需求,給不同的實例規(guī)格配置不同的權重。 例如:
為滿足期望容量,伸縮組將為用戶擴容2臺ecs.c5.xlarge實例。 說明 擴容時伸縮組的容量不得超過最大容量(MaxSize)與實例規(guī)格的最大權重之和。 WeightedCapacity的取值范圍:1~500。 |
SecurityGroupIds.N | String | 否 | sg-bp18kz60mefs**** | 所屬安全組ID。 |
InstancePatternInfo.N.Cores | Integer | 否 | 2 | 智能配置模式下,實例規(guī)格的vCPU內(nèi)核數(shù)目,用于篩選符合要求的實例規(guī)格范圍。更多信息,請參見實例規(guī)格族。N的取值范圍:1~10。 請注意以下信息:
|
InstancePatternInfo.N.InstanceFamilyLevel | String | 否 | EnterpriseLevel | 智能配置模式下,實例規(guī)格族級別,用于篩選符合要求的實例規(guī)格范圍。取值范圍:
N的取值范圍:1~10。 |
InstancePatternInfo.N.MaxPrice | Float | 否 | 2 | 智能配置模式下,按量付費實例或者搶占式實例可接受的每小時最高價格,用于篩選符合要求的實例規(guī)格范圍。N的取值范圍:1~10。 說明 SpotStrategy設置為SpotWithPriceLimit時,該參數(shù)必選。其他情況下,該參數(shù)可選。 |
InstancePatternInfo.N.Memory | Float | 否 | 4 | 智能配置模式下,實例規(guī)格的內(nèi)存大小,單位為GiB,用于篩選符合要求的實例規(guī)格范圍。更多信息,請參見實例規(guī)格族。N的取值范圍:1~10。 |
InstancePatternInfo.N.Architecture.N | String | 否 | X86 | 實例規(guī)格所屬的架構類型。取值范圍:
默認值:包含所有架構類型。 |
InstancePatternInfo.N.BurstablePerformance | String | 否 | Include | 是否包含性能突發(fā)實例規(guī)格。取值范圍:
默認值:Include。 |
InstancePatternInfo.N.ExcludedInstanceType.N | String | 否 | ecs.n1.small/ecs.n1.*/*7* | 需要排除的實例規(guī)格。通過使用通配符(*)可以排除單個規(guī)格或者整個規(guī)格族。例如:
說明 如果需要排除多個實例規(guī)格,請使用分隔符(/)隔開單個實例規(guī)格。例如 ecs.n1.small/ecs.n1.*/*7* 。 |
InstancePatternInfo.N.InstanceTypeFamilies.N | String | 否 | ["ecs.g6", "ecs.c6", … "ecs.r6"] | 指定的實例規(guī)格族。N表示可以設置多個實例規(guī)格族,N的取值范圍:1~10。 |
InstancePatternInfo.N.MinimumCpuCoreCount | Integer | 否 | 2 | 實例規(guī)格的最小vCPU內(nèi)核數(shù)目。 |
InstancePatternInfo.N.MaximumCpuCoreCount | Integer | 否 | 4 | 實例規(guī)格的最大vCPU內(nèi)核數(shù)目。 說明 MaximumCpuCoreCount 參數(shù)值不能超過MinimumCpuCoreCount 參數(shù)值的4倍。 |
InstancePatternInfo.N.GpuSpecs.N | String | 否 | ["NVIDIA V100"] | 指定的GPU類型。 |
InstancePatternInfo.N.InstanceCategories.N | String | 否 | Compute-optimized with GPU | 實例規(guī)格分類。 說明 N表示可以設置多個實例分類,N的取值范圍:1~10。
|
InstancePatternInfo.N.CpuArchitectures.N | String | 否 | ["X86", "ARM"] | 指定實例的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 | 實例期望最小支持掛載的彈性網(wǎng)卡上限。 |
InstancePatternInfo.N.MinimumEniPrivateIpAddressQuantity | Integer | 否 | 2 | 實例的期望最小單塊彈性網(wǎng)卡的IPv4地址上限。 |
InstancePatternInfo.N.MinimumEniIpv6AddressQuantity | Integer | 否 | 1 | 實例期望的最小單塊彈性網(wǎng)卡的IPv6地址上限。 |
InstancePatternInfo.N.MinimumInitialCredit | Integer | 否 | 12 | 實例期望的最小突發(fā)性能實例 t5、t6的初始vCPU積分值。 |
InstancePatternInfo.N.MinimumBaselineCredit | Integer | 否 | 12 | 實例期望的最小突發(fā)性能實例t5、t6的基準vCPU計算性能(所有vCPU之和)。 |
InstancePatternInfo.N.MinimumMemorySize | Float | 否 | 4 | 實例期望的最小內(nèi)存。單位:GiB。 |
InstancePatternInfo.N.MaximumMemorySize | Float | 否 | 4 | 實例期望的最大內(nèi)存。單位:GiB。 |
InstancePatternInfo.N.MinimumGpuAmount | Integer | 否 | 2 | 實例期望的最小GPU數(shù)目。取值范圍:≥1的正整數(shù)。 |
InstancePatternInfo.N.MaximumGpuAmount | Integer | 否 | 2 | 實例期望的最大GPU數(shù)目。取值范圍:≥1的正整數(shù)。 |
SystemDiskCategories.N | String | 否 | cloud | 系統(tǒng)盤的多磁盤類型。N的取值范圍:1~4,即一個伸縮配置內(nèi)最多可以為系統(tǒng)盤指定4種磁盤類型。N越小,優(yōu)先級越高。當無法使用高優(yōu)先級的磁盤類型時,彈性伸縮自動嘗試下一優(yōu)先級的磁盤類型創(chuàng)建系統(tǒng)盤。取值范圍:
說明 指定本參數(shù)時,不允許同時指定 SystemDisk.Category 。 |
Password | String | 否 | 123abc**** | ECS實例的密碼。長度為8至30個字符,必須同時包含大小寫英文字母、數(shù)字和特殊符號中的三類字符。特殊符號可以是: ()~!@#$%^&*-_+=\|{}[]:;'<>,.?/
其中,Windows實例不能以斜線號(/)為密碼首字符。
> 如果傳入Password參數(shù),建議您使用HTTPS協(xié)議發(fā)送請求,避免密碼泄露。
|
SystemDisk.Encrypted | Boolean | 否 | false | 是否加密系統(tǒng)盤。取值范圍:
默認值:false。 |
SystemDisk.KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40**** | 系統(tǒng)盤使用的KMS密鑰ID。 |
SystemDisk.EncryptAlgorithm | String | 否 | AES-256 | 系統(tǒng)盤采用的加密算法。取值范圍:
默認值:AES-256。 |
SystemDisk.ProvisionedIops | Long | 否 | 100 | 系統(tǒng)盤預配置的IOPS(Input/Output Operations Per Second)性能指標。 說明 IOPS(Input/Output Operations Per Second)指每秒能處理的I/O個數(shù),表示塊存儲處理讀寫(輸出/輸入)的能力,單位為次。 |
SystemDisk.BurstingEnabled | Boolean | 否 | false | 系統(tǒng)盤是否開啟Burst(性能突發(fā))。取值范圍:
更多信息,請參見ESSD AutoPL云盤。 |
ImageOptions.LoginAsNonRoot | Boolean | 否 | false | ECS實例是否使用ecs-user用戶登錄,更多信息,請參見管理ECS實例的登錄名。取值范圍:
|
DeletionProtection | Boolean | 否 | false | ECS實例釋放保護屬性。該項僅適用于按量付費實例,指是否支持通過ECS管理控制臺或API(DeleteInstance)直接釋放實例。取值范圍:
說明 該屬性不影響彈性伸縮正常的縮容活動,即彈性伸縮發(fā)生縮容活動時,開啟實例釋放保護的按量付費實例可以被正常釋放掉。 |
StorageSetId | String | 否 | ss-bp67acfmxazb4p**** | 存儲集ID。 |
StorageSetPartitionNumber | Integer | 否 | 2 | 存儲集中的最大分區(qū)數(shù)量。取值范圍:大于等于2。 |
CustomPriorities.N.InstanceType | String | 否 | ecs.g6.large |
說明 該參數(shù)僅在伸縮組的 擴縮容策略 為優(yōu)先級策略 時有效,且該實例規(guī)格(InstanceType)必須包含在伸縮配置的實例規(guī)格列表中。當無法根據(jù)優(yōu)先級較高的ECS實例規(guī)格+虛擬交換機創(chuàng)建ECS實例時,彈性伸縮服務會自動選擇下一優(yōu)先級的ECS實例規(guī)格+虛擬交換機組合來創(chuàng)建ECS實例。 說明 如果僅指定了部分ECS實例規(guī)格+虛擬交換機組合的自定義優(yōu)先級,則未指定的組合優(yōu)先級低于指定的組合優(yōu)先級,且未指定的組合仍會依次按照伸縮組的虛擬交換機順序、伸縮配置的實例規(guī)格順序確定優(yōu)先級。例如:伸縮組的虛擬交換機順序依次為vsw1、vsw2,伸縮配置的實例規(guī)格順序依次為type1、type2,該組合的自定義優(yōu)先級順序為 ["vsw2+type2", "vsw1+type2"] ,則最終優(yōu)先級為vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1 。 |
CustomPriorities.N.VswitchId | String | 否 | vsw-bp14zolna43z266bq**** |
說明 該參數(shù)僅在伸縮組的 擴縮容策略 為優(yōu)先級策略 時有效,且該交換機(Vswitch)必須包含在伸縮組的交換機列表中。 |
NetworkInterfaces.N.InstanceType | String | 否 | Primary | 彈性網(wǎng)卡類型。使用此參數(shù)時表示必須使用
默認值:Secondary。 |
NetworkInterfaces.N.NetworkInterfaceTrafficMode | String | 否 | HighPerformance | 網(wǎng)卡的通訊模式。取值范圍:
默認值:Standard。 說明 RDMA模式的彈性網(wǎng)卡數(shù)量不能超過該實例規(guī)格族的限制。更多信息,請參見實例規(guī)格族。 |
NetworkInterfaces.N.Ipv6AddressCount | Integer | 否 | 1 | 為主網(wǎng)卡指定隨機生成的IPv6地址數(shù)量。 您需要注意以下事項:
|
NetworkInterfaces.N.SecurityGroupIds.N | String | 否 | sg-2ze55shrh**** | 彈性網(wǎng)卡所屬的一個或多個安全組ID。 您需要注意以下事項:
|
DedicatedHostClusterId | String | 否 | dc-2zedxc67zqzt7lb4**** | 專有宿主機集群ID。 |
SecurityOptions.ConfidentialComputingMode | String | 否 | TDX | 機密計算模式。可能值:
|
HttpEndpoint | String | 否 | enabled | 是否啟用實例元數(shù)據(jù)的訪問通道。取值范圍:
默認值:enabled。 說明 有關實例元數(shù)據(jù)的信息,請參見實例元數(shù)據(jù)概述。 |
HttpTokens | String | 否 | optional | 訪問實例元數(shù)據(jù)時是否強制使用加固模式(IMDSv2)。取值范圍:
默認值:optional。 說明 有關訪問實例元數(shù)據(jù)的模式,請參見實例元數(shù)據(jù)訪問模式。 |
InternetMaxBandwidthIn | Integer | 否 | 10 | 公網(wǎng)入帶寬最大值,單位為 Mbit/s。取值范圍:
|
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
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****
&公共請求參數(shù)
正常返回示例
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. |
經(jīng)典網(wǎng)絡實例不支持RamRoleName參數(shù)。 |
400 |
InvalidParamter |
The specified value of parameter is not valid. |
指定的參數(shù)值無效。 |
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. |
指定的安全組與伸縮組指定網(wǎng)絡類型不一致。 |
400 |
InvalidSecurityGroupId.VPCMismatch |
The specified security group and the specified virtual switch are not in the same VPC. |
指定的安全組和虛擬交換機不屬于同一個虛擬專有網(wǎng)絡。 |
400 |
InvalidTags.KeyValue |
The specified tags key/value cannot be empty. |
必須指定Tags參數(shù)。 |
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編碼規(guī)范。 |
400 |
InvalidUserData.SizeExceeded |
The specified parameter UserData exceeds the size. |
指定的UserData過長。 |
400 |
InvalidSecurityGroupId.IncorrectType |
The managed security group "XXX" is not supported. |
不支持 "XXX" 托管安全組。 |