1. 云计算教程网首页
  2. 阿里云

CreateScalingConfiguration

调用CreateScalingConfiguration创建伸缩配置。

调试

前往【】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
ScalingGroupId String AG6CQdPU8OKdwLjgZcJ****

伸缩配置所属的伸缩组 ID。

Action String CreateScalingConfiguration

操作接口名,取值: CreateScalingConfiguration。

Cpu Integer 2

vCPU 个数。

同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU 16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。

DataDisk.N.Category String cloud_ssd

数据盘 N 的磁盘种类,N 的取值范围为 1~16。取值范围:

  • cloud:普通云盘。随实例创建的普通云盘的 DeleteWithInstance 属性为 true。
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD 云盘
  • ephemeral_ssd:本地 SSD 盘
  • cloud_essd:ESSD 云盘

默认值:cloud。

DataDisk.N.DeleteWithInstance Boolean true

指定数据盘是否随实例释放。取值范围:

  • true:释放实例时,该磁盘随实例一起释放
  • false:释放实例时,该磁盘保留不释放

默认值:true,该参数只可对独立云盘设置(DataDisk.n.Category 为 cloud、cloud_efficiency 或 cloud_ssd),否则会出现报错。

DataDisk.N.Description String FinanceDept

数据盘的描述。长度为 2~256 个英文或中文字符,不能以 http:// 和 https:// 开头。

DataDisk.N.Device String /dev/xvdb

数据盘挂载点,N 取值:1~4。如果您没有指定该参数,则默认在自动创建 ECS 实例时由 ECS 系统分配,从 /dev/xvdb 开始到 /dev/xvdz。

DataDisk.N.DiskName String cloud_ssdData

数据盘名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。默认值:空。

DataDisk.N.Encrypted String false

数据盘n是否加密。默认值:false。

DataDisk.N.KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40826X

数据盘对应的KMS密钥ID。

DataDisk.N.Size Integer 100

数据盘 N 的磁盘大小,内存单位为 GiB。取值范围:

  • cloud:5~2000
  • cloud_efficiency:20~32768
  • cloud_ssd:20~32768
  • ephemeral_ssd:5~800

指定该参数后,磁盘大小必须 ≥ 快照大小(快照通过 SnapshotId 指定)。

DataDisk.N.SnapshotId String s-280s7****

创建数据盘使用的快照。指定该参数后 DataDisk.n.Size 会被忽略,实际创建的磁盘大小为指定快照的大小。如果该快照创建于 2013 年 7 月 15 日或之前,该次调用会被拒绝,返回参数中最多可以输入
4 个 InvalidSnapshot.TooOld。

DeploymentSetId String ds-bp1frxuzdg87zh4pz****

部署集 ID。

HostName String Host****

云服务器的主机名,不能以点号(.)或短横线(-)开头或结束,不能连续使用点号(.)或短横线(-)。另外,不同类型实例的命名要求如下:

  • 对 Windows 实例:主机名长度为 2~15,可包含大小写字母、数字和短横线(-),不能包含点号(.),不能全是数字。
  • 对其他类型(Linux 等)实例:主机名长度为 2~64,可包含多个点号,两个点号之间为一段,每段可包含大小写字母、数字和短横线(-)。
ImageId String centos6u5_64_20G_aliaegis_20140703.vhd

镜像文件 ID,指定启动实例时选择的镜像资源。

ImageName String myimage

镜像名称,同一个地域内镜像名称唯一。如果设置了 ImageId 参数, ImageName 将被忽略。不支持通过 ImageName 设置镜像市场镜像。

InstanceName String Instance****

基于当前伸缩配置创建出来的实例的名称。

InstanceType String ecs.t1.xsmall

ECS 实例的资源规格。

InstanceTypes.N RepeatList ecs.t1.xsmall.1

多实例规格参数。如果使用了 InstanceTypes.N,InstanceType 将被忽略,其中 N 的取值范围:1~10,即一个伸缩配置内最多可以设置 10
种实例规格。N 代表当前伸缩配置中实例规格的优先级,编号为 1 的实例规格优先级最高,实例规格优先级随着编号的增大依次降低。当无法根据优先级较高的实例规格创建出实例时,弹性伸缩服务会自动选择下一优先级的实例规格来创建实例。

InternetChargeType String PayByBandwidth

网络计费类型,可选值:

  • PayByBandwidth:按带宽计费。此时 InternetMaxBandwidthOut 即为所选的固定带宽值。
  • PayByTraffic:按流量计费。此时 InternetMaxBandwidthOut 只是一个带宽上限,计费以发生的网络流量为依据。

如果未指定该参数,经典网络下默认值为 PayByBandwidth,VPC 下默认值为 PayByTraffic。

InternetMaxBandwidthIn Integer 100

公网入带宽最大值,单位为 Mbps (Mega bit per second),取值范围:1~200。如果您没有指定该参数,则入带宽将自动被设置为 200 Mbps。该参数在任何情况下都不涉及计费,实例的入数据流量是免费的。

InternetMaxBandwidthOut Integer 50

公网出带宽最大值,单位为 Mbps (Mega bit per second),取值范围:

  • 按带宽计费:0~100,如果您没有指定该参数,则出带宽将自动被设置为 0 Mbps。
  • 按流量计费:0~100,如果您没有指定该参数,则会出现报错。
IoOptimized String optimized

是否为 I/O 优化实例,只支持非 I/O 优化的实例规格不能传入该参数。取值范围:

  • optimized:I/O 优化。
  • 未传入该参数时:
    • InstanceType 为系列 I 的规格默认为非 I/O 优化
    • InstanceType 为非系列 I 的规格默认为 I/O 优化
KeyPairName String KeyPairTest

密钥对名称。

  • 对 Windows ECS 实例,该参数将被忽略,默认为空。
  • 对 Linux ECS 实例,密码登录方式会被初始化成禁止。
LoadBalancerWeight Integer 50

后端服务器的权重,取值范围:0~100,默认值:50。

Memory Integer 16

内存大小。

同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU 16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。

Password String 123-abcABC

实例的密码。长度为 8 至 30 个字符,必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是:

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

其中,Windows 实例不能以斜线号(/)为密码首字符。

说明 如果传入 Password 参数,建议您使用 HTTPS 协议发送请求,避免密码泄露。

PasswordInherit Boolean false

是否使用镜像预设的密码。使用该参数时,您需要所用镜像已经预设了密码。

RamRoleName String RamRoleTest

实例 RAM 角色名称。本名称由 RAM 提供和维护,可通过 查询,您还可以参考 。

ResourceGroupId String rg-resource****

资源组 ID。

ScalingConfigurationName String 测试_sc

伸缩配置的显示名称,2~40 个英文或中文字符,以数字、大小写字母或中文开头,可包含数字、下划线(_)、短横线(-)或点号(.)。在同一账号的同一地域下,同一伸缩组内该名称是唯一的。如果您没有指定该参数,则默认使用伸缩配置
ID。

SecurityEnhancementStrategy String Active

是否开启安全加固。取值范围:

  • Active:启用安全加固,只对公共镜像生效。
  • Deactive:不启用安全加固,对所有镜像类型生效。
SecurityGroupId String sg-280ih****

安全组 ID,指定新创建实例所属于的安全组,同一个安全组内的实例可以互相访问。

SecurityGroupIds.N RepeatList sg-bp18kz60mefs****

自动创建的实例将加入的安全组。

SpotPriceLimit.N.InstanceType String ecs.t1.xsmall

抢占式实例的实例规格,其中 N 的取值范围:1~10。SpotStrategy 取值为 SpotWithPriceLimit 时生效。

SpotPriceLimit.N.PriceLimit Float 0.5

抢占式实例对应的出价,其中 N 的取值范围:1~10。SpotStrategy 取值为 SpotWithPriceLimit 时生效。

SpotStrategy String NoSpot

后付费实例的抢占策略。取值范围:

  • NoSpot:正常按量付费实例
  • SpotWithPriceLimit:设置上限价格的抢占式实例
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格

默认值:NoSpot

SystemDisk.Category String cloud_ssd

系统盘的磁盘种类。取值范围:

  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD 云盘
  • ephemeral_ssd:本地 SSD 盘
  • cloud_essd:ESSD 云盘

InstanceType 为系列 I 的规格且实例属于非 I/O 优化实例时,默认值:cloud。否则,默认值:cloud_efficiency。

SystemDisk.Description String FinanceDept

系统盘的描述。长度为 2~256 个英文或中文字符,不能以 http:// 和 https:// 开头。

SystemDisk.DiskName String cloud_ssdSystem

系统盘名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。默认值:空。

SystemDisk.Size Integer 100

系统盘大小,单位:GiB。取值范围:

  • cloud:40~500
  • cloud_efficiency:40~500
  • cloud_ssd:40~500
  • ephemeral_ssd:40~500

默认值:max{40, ImageSize},指定该参数后,系统盘大小必须 ≥ max{40, ImageSize}。

Tags String {“key1″:”value1″,”key2″:”value2”, … “key5″:”value5”}

实例标签。标签以键值对方式传入,最多可以使用 5 组标签。Key 和 Value 的使用要求如下:

  • Key 最多支持 64 个字符,不支持以 aliyun、http:// 和 https:// 开头。一旦使用标签,Key 不允许为空字符串。
  • Value 最多支持 128 个字符,不支持以 aliyun、http:// 和 https:// 开头。Value 可以为空字符串。
UserData String echo hello ecs!

实例自定义数据,需要以 Base64 方式编码,原始数据最多为 16 KB。

返回参数

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。无论调用接口成功与否,我们都会返回请求 ID。

ScalingConfigurationId String eOs27Kb0oXvQcUYjEGel****

伸缩配置 ID,由系统生成,全局唯一。

示例

请求示例


http(s)://[Endpoint]/?Action=CreateScalingConfiguration
&ScalingGroupId=AG6CQdPU8OKdwLjgZcJ****
&SecurityGroupId=sg-280ih****
&<公共请求参数>

正常返回示例

XML 格式

<CreateScalingConfigurationResponse>
  <ScalingConfigurationId>eOs27Kb0oXvQcUYjEGel****</ScalingConfigurationId>
  <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</CreateScalingConfigurationResponse>

JSON 格式

{
	"ScalingConfigurationId":"eOs27Kb0oXvQcUYjEGel****",
	"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HttpCode

错误码

错误信息

描述

400

InstanceType.Mismatch

The specified scaling configuration and existing active scaling configuration have
different instance type.

指定的伸缩配置的实例规格与当前的伸缩配置的实例规格不匹配。

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.

指定快照的大小超过了磁盘大小的限制。

403

InvalidDevice.InUse

Device “XXX” has been occupied.

数据盘挂载点重复。

400

InvalidImageId.InstanceTypeMismatch

The specified image does not support the specified instance type.

不允许在指定的实例规格下使用该镜像。

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

InvalidParameter

The specified value of parameter KeyPairName is not valid.

Windows 系统不支持 KeyPairName 参数。

400

InvalidParameter.Conflict

The value of parameter SystemDisk.Category and parameter DataDisk.N.Category are conflict.

指定的系统盘类型和数据盘类型冲突。

400

InvalidRamRole.NotFound

The specified RamRoleName does not exist.

不存在指定的 RamRoleName。

400

InvalidScalingConfigurationName.Duplicate

The specified value of parameter ScalingConfigurationName is duplicated.

已存在相同伸缩配置名。

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

该账号下不存在指定的伸缩组。

400

InvalidSecurityGroupId.IncorrectNetworkType

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

指定的安全组与伸缩组指定网络类型不一致。

404

InvalidSecurityGroupId.NotFound

The specified security group does not exist.

该账号下不存在指定的安全组。

400

InvalidSecurityGroupId.VPCMismatch

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

指定的安全组和虚拟交换机不属于同一个虚拟专有网络。

403

InvalidSnapshot.TooOld

This operation is denied because the specified snapshot is created before 2013-07-15.

该快照创建于 2013 年 7 月 15 日或之前,调用被拒绝。

403

InvalidSystemDiskCategory.ValueUnauthorized

The system disk category is not authorized.

没有创建临时磁盘系统盘的权限。

400

InvalidUserData.Base64FormatInvalid

The specified parameter UserData must be base64 encoded.

UserData 不符合 Base64 编码规范。

400

InvalidUserData.SizeExceeded

The specified parameter UserData exceeds the size.

指定的 UserData 过长。

403

QuotaExceeded.EphemeralDiskSize

Ephemeral disk size quota exceeded.

临时磁盘数据盘总容量超过2T (2048G)。

400

QuotaExceeded.ScalingConfiguration

Scaling configuration quota exceeded in the specified scaling group.

您目前拥有的伸缩配置个数已经达到上限。

400

QuotaExceeded.SecurityGroupInstance

Instance quota exceeded in the specified security group.

指定的安全组中添加的 ECS 实例个数已经达到上限。

发布者:lidazhuang,转转请注明出处:https://www.cms2.cn/aliyun/4567.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注

联系我们

400-800-8888

在线咨询:点击这里给我发消息

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

QR code