You need to enable JavaScript to run this app.
导航

CreateScalingConfiguration - 创建一个伸缩配置

最近更新时间2024.05.21 17:43:39

首次发布时间2022.05.13 10:42:44

创建一个伸缩配置。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

CreateScalingConfiguration

要执行的操作,取值:CreateScalingConfiguration。

Version
String

2020-01-01

API的版本,取值:2020-01-01。

ScalingGroupId
String

scg-ybmssdnnhn5pkgyd****

伸缩配置所属的伸缩组ID。您可以调用DescribeScalingGroups查询伸缩组ID。

Eip.SecurityProtectionTypes.N
Array of String

AntiDDoS_Enhanced

公网IP的安全防护类型。

  • 参数 - N:表示安全防护类型的序号,当前仅支持取1。
  • 取值:
    • AntiDDoS_Enhanced:申请增强防护类型的公网IP(可加入到DDoS原生防护实例)。
    • 不填则表示基础防护类型的公网IP。
Eip.SecurityProtectionInstanceId
Integer

193

安全防护包的ID。

说明

Eip.SecurityProtectionTypes.N不为空时,本参数必填。

Eip.BandwidthPackageId
String

bwp-2zeo05qre24nhrqpy****

共享带宽包的ID,表示将公网IP加入到共享带宽包。 您可以调用 DescribeBandwidthPackages 接口,查询共享带宽包的ID。 公网IP加入到共享带宽包必须同时满足如下条件:

  • 二者的安全防护类型相同。
  • 二者的线路类型相同。
  • 共享带宽包为IPv4类型。
Ipv6AddressCount
Integer

0

是否为实例网卡分配IPv6地址。取值:

  • 0:不分配IPv6地址。
  • 1:分配IPv6地址,系统自动为您分配IPv6网段。
SpotStrategy
String

NoSpot

实例的抢占策略。取值:

  • NoSpot(默认):表示创建正常按量付费实例。
  • SpotAsPriceGo:表示系统自动出价,跟随当前市场实际价格的抢占式实例。
  • SpotWithPriceLimit:表示需要设置出价上限的抢占式实例。
ClientToken
String

333456899ff****

保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。取值:

  • 仅支持ASCII字符,且不能超过64个字符。
ProjectName
String

default

伸缩配置创建的实例所属项目,默认为空。一个资源只能归属于一个项目。

  • 只能包含字母、数字、下划线“_”、点“.”和中划线“-”。
  • 长度限制在64个字符以内。
ImageId
String

image-ybmhzqo8u4l8j1ii****

镜像ID,伸缩组自动创建实例时使用的镜像资源。您可以调用DescribeImages查询镜像ID。

SecurityGroupIds.N
Array of String

sg-3ti78x9h8t4bw****

实例主网卡关联的安全组ID。您可以调用DescribeSecurityGroups接口查询安全组ID。取值:

  • 参数 - N:表示主网卡关联的安全组的序号,最多支持同时绑定5个安全组,取值:1 ~ 5。
  • 参数 - SecurityGroupId:表示主网卡关联的第N个安全组的ID。
  • 多个安全组ID之间用&分隔。
HpcClusterId
String

hpcCluster-ycdj7d9ios38dfny****

实例所属的高性能计算集群的ID。
仅当InstanceTypes.N指定为“高性能计算GPU型”时有效。

Tags
String

"k1":"v1"

伸缩配置创建实例的标签。标签以键值对方式传入,最多传入20组标签。Key命名规则如下:

  • Key命名规则如下:

    • 不能以volc:sys:的任意大小写组合开头。

      说明

      volc:sys:开头为系统预留标签键,禁止创建。

    • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
    • 长度限制在1~128个字符之间。

    同一伸缩配置的标签键不允许重复。

  • Value命名规则如下:

    • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
    • 允许为空,长度限制在0~256个字符之间。
InstanceTypeOverrides.N.InstanceType
Array of String

ecs.g2i.large

指定抢占式实例的规格。

  • 参数 - N:表示实例规格的序号,取值为1 ~ 10。
  • 取值 - InstanceType:表示抢占式实例的规格。
  • 多个规格之间用&分隔。

说明

本参数仅当SpotStrategy取值为SpotWithPriceLimit时生效。

InstanceTypeOverrides.N.PriceLimit
Array of Float

0.01

指定抢占式实例规格每小时的最高价格。

  • 参数 - N:表示实例规格的序号,取值为1 ~ 10。
  • 取值 - PriceLimit:表示抢占式实例规格每小时的最高价格。取值:大于0,且最大不超过3位小数。
  • 多个价格之间用&分隔。

说明

本参数仅当SpotStrategy取值为SpotWithPriceLimit时生效。

Eip.Bandwidth
Integer

1

公网IP的带宽峰值,默认为1,单位:Mbps。取值:

  • 当Eip.BillingType取值为PostPaidByBandwidth时,取值为1 ~ 500。
  • 当Eip.BillingType取值为PostPaidByTraffic时,取值为1 ~ 200。

说明

如果您需要使实例在加入伸缩组时自动分配公网IP,则必须至少配置Eip.Bandwidth、Eip.ISP、Eip.BillingType中的任意一项,均不配置则表示不分配公网IP。

Eip.BillingType
String

PostPaidByBandwidth

公网IP的计费类型,取值:

  • PostPaidByBandwidth(默认):按量计费-按带宽上限计费。
  • PostPaidByTraffic:按量计费-按实际流量计费。

说明

如果您需要使实例在加入伸缩组时自动分配公网IP,则必须至少配置Eip.Bandwidth、Eip.ISP、Eip.BillingType中的任意一项,均不配置则表示不分配公网IP。

Eip.ISP
String

BGP

线路类型,取值:

  • BGP(默认):BGP线路。
  • 若您的账号已申请使用静态单线,ISP还可以传入ChinaMobile(表示中国移动)、ChinaTelecom(表示中国电信)、ChinaUnicom(表示中国联通)。

说明

如果您需要使实例在加入伸缩组时自动分配公网IP,则必须至少配置Eip.Bandwidth、Eip.ISP、Eip.BillingType中的任意一项,均不配置则表示不分配公网IP。

HostName
String

instance-host-name

实例的主机名。取值:

  • Linux实例
    • 允许使用点号分隔字符成多段,每段中允许使用字母、数字或中划线“-”。
    • 不能以点号“.”或中划线“-”开头或结尾,且不能连续使用点号“.”或中划线“-”。
    • Linux系统的主机名长度限制为2~63个字符。
  • Windows实例
    • 允许使用字母、数字或中划线“-”,不能完全是数字。
    • 不能以中划线“-”开头或结尾,且不能连续使用中划线“-”。
    • Windows系统的主机名长度限制在2~15个字符。

如不填,则遵循以下规则自动生成:

  • 结构:iv- + 初始主机名,例如iv-3tigy72q3u3vj0******
    已创建实例保持原主机名生成逻辑,不随实例重启发生变化。
  • 初始主机名生成逻辑:
    • Linux:提取实例IDi-之后的全部字符。
    • Windows:提取实例IDi-之后的后12位字符。

说明

您可以为扩容的各实例设置有序且唯一的实例名称或主机名称,配置规则请参见配置有序且唯一的实例名称或主机名称.

InstanceDescription
String

云服务器实例。

实例的描述,取值:

  • 不能以数字、中划线开头。
  • 只能包含中文、字母、数字、下划线和中划线。
  • 长度限制在0 ~ 255之间。
  • 不填默认为空字符串。
InstanceName
String

instance-test

实例的名称,取值:

  • 以字母或中文开头。
  • 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。
  • 长度限制为1~128个字符。

说明

您可以为扩容的各实例设置有序且唯一的实例名称或主机名称,配置规则请参见配置有序且唯一的实例名称或主机名称

InstanceTypes.N
Array of String

ecs.g2a.large

实例的计算规格列表。您可以调用DescribeAvailableResource查询计算规格的库存信息。

KeyPairName
String

kp-test-123

使用“SSH密钥对”登录实例时,请输入密钥对的名称。
如果同时设置了KeyPairNamePassword,则仅生效KeyPairName

Password
String

password@123

使用“密码”方式登录实例时,请设置root登录密码:

  • 长度限制在8 ~ 30之间
  • 密码只能由大写字母、小写字母、数字和特殊字符组成,且必须包含至少三项
  • 特殊字符可以使用:`~!@#$%^&*()_-+= |
  • 不能以“/”和“$6$”开头
ScalingConfigurationName
String

scaling-config-test

伸缩配置的名称,在同一地域下同一伸缩组内伸缩配置名称唯一。取值:

  • 只能以中文、字母开头。
  • 只能包含中文、字母、数字、下划线和中划线。
  • 长度限制为1 ~ 128个字符。
  • 暂不支持特殊字符。
SecurityEnhancementStrategy
String

Active

是否开启安全加固,取值:

  • Active:开启安全加固,仅对公共镜像生效。
  • InActive:关闭安全加固,对所有镜像生效。
UserData
String

ZWNobyBoZWxsbyBlY3Mh

实例自定义数据。设置的自定义数据必须经过Base64编码,且Base64编码前的自定义数据大小不能超过16KB。
不填则默认为空。

Volumes.N.DeleteWithInstance
Array of Boolean

true

云盘是否随实例释放:

  • 参数 - N:表示云盘的序号,序号为“1”表示系统盘;序号为“2”或大于“2”表示数据盘。取值:1 - 15。
  • 参数 - DeleteWithInstance:云盘是否随实例释放。
    • true(默认值):云盘随实例释放。
    • false:云盘不随实例释放。
  • 取值为false时对系统盘无效,系统盘默认随实例释放,不允许保留。
Volumes.N.Size
Array of Integer

100

云盘的容量,单位为GiB。

  • 参数 - N:表示云盘的序号,序号为“1”表示系统盘;序号为“2”或大于“2”表示数据盘。取值:1 ~ 15。
  • 取值 - Size:表述第N个云盘的容量,单位为GiB。
    • 系统盘取值范围:10 - 500。
    • 数据盘取值范围:10 - 8192。
  • 多个云盘之间用&分隔。
Volumes.N.VolumeType
Array of String

ESSD_PL0

云盘的类型:

  • 参数 - N:表示云盘的序号,序号为“1”表示系统盘,序号为“2”或大于“2”表示数据盘。取值:1 ~ 15。
  • 参数 - VolumeType:表示第N个云盘的类型,取值:
    • ESSD_FlexPL:极速型SSDFlexPL。
    • ESSD_PL0:极速型SSD PL0。
  • 多个云盘之间用&分隔。
ZoneId
String

cn-beijing-a

伸缩配置可用区ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
ScalingConfigurationId
String

scc-ybmt16auaugh9zfy****

伸缩配置ID。

请求示例

GET /?Action=CreateScalingConfiguration&ImageId=image-ybmhzqo8u4l8j1ii****&InstanceName=instance-test&ScalingConfigurationName=scaling-config-test&ScalingGroupId=scg-ybmssdnnhn5pkgyd****&SecurityGroupIds.1=sg-3ti78x9h8t4bw****&Version=2020-01-01 HTTP/1.1
Host: open.volcengineapi.com
X-Date: 20240507T095226Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240507/cn-beijing/auto_scaling/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f


返回示例

{
  "ResponseMetadata": {
    "RequestId": "2024050717525307619002119613E896",
    "Version": "2020-01-01",
    "Service": "auto_scaling",
    "Region": "cn-beijing"
  },
  "Result": {
    "ScalingConfigurationId": "scc-ybmt16auaugh9zfy****"
  }
}

错误码

您可访问公共错误码,获取更多错误码信息。