首页 弹性伸缩 API参考 API参考(2022-02-22) API目录 伸缩配置 CreateEciScalingConfiguration - 创建一个ECI类型伸缩配置

CreateEciScalingConfiguration - 创建一个ECI类型伸缩配置

创建一个ECI类型的伸缩配置。

接口说明

伸缩配置用来指定弹性扩张时使用的ECI实例模板。

参数Cpu和Memory用于指定CPU和内存定义实例规格的范围,弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。该方式仅适用于伸缩组的扩缩容策略为成本优化策略,且伸缩配置未指定实例规格的场景。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ScalingGroupIdstring

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

asg-bp14wlu85wrpchm0****
ScalingConfigurationNamestring

伸缩配置的名称。长度为2~64个英文或中文字符组成,以数字、大小写字母或中文开头,可包含数字、下划线(_)、短划线(-)或半角句号(.)。

在同一地域下同一伸缩组内伸缩配置名称唯一。如果您没有指定该参数,则默认使用伸缩配置的ID。

scalingconfig****
Descriptionstring
说明该参数未开放使用。
desc
SecurityGroupIdstring

ECI实例所属的安全组ID。同一个安全组内的ECI实例之间可以互相访问。

如果没有指定安全组,系统将自动使用您选择的地域下的默认安全组,您需要确保该安全组的入方向规则中包含容器需要暴露的协议和端口。如果您在该地域下没有默认安全组,系统将自动创建一个默认安全组,并将您声明的容器协议和端口添加到该安全组的入方向规则中。

sg-uf66jeqopgqa9hdn****
ContainerGroupNamestring

ECI实例名称,即容器组名称。

nginx-test
RestartPolicystring

ECI实例重启策略。取值范围:

  • Always:总是重启。
  • Never:从不重启。
  • OnFailure:失败时重启。

默认值:Always。

Always
Cpunumber

实例级别vCPU大小。单位:核。

1.0
Memorynumber

实例级别内存大小。单位:GiB。

2.0
ResourceGroupIdstring

资源组ID

rg-uf66jeqopgqa9hdn****
DnsPolicystring

DNS策略。取值范围:

  • None:使用DnsConfig字段设置的DNS。

  • Default:继承运行环境的DNS设置。

Default
EnableSlsboolean
说明该参数未开放使用。
false
ImageSnapshotIdstring

镜像缓存ID。

imc-2zebxkiifuyzzlhl****
RamRoleNamestring

实例RAM角色名称。其中,ECI与ECS共用实例RAM角色,更多信息,请参见通过API使用实例RAM角色

RamTestRole
TerminationGracePeriodSecondslong

程序的缓冲时间,用于处理关闭之前的操作。单位为秒。

60
AutoMatchImageCacheboolean

是否自动匹配镜像缓存。取值范围:

  • true:是。
  • false:否。

默认值:false。

false
Ipv6AddressCountinteger

IPv6地址数。

1
ActiveDeadlineSecondslong

有效期限。单位为秒。

1000
SpotStrategystring

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

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

默认值:NoSpot。

SpotPriceLimit
SpotPriceLimitnumber

设置抢占式实例的每小时最高价格,最多精确到小数点后3位。

当SpotStrategy取值为SpotWithPriceLimit时,必须设置SpotPriceLimit。

0.025
AutoCreateEipboolean

是否自动创建弹性公网IP,并绑定ECI实例。

true
EipBandwidthinteger

弹性公网IP的带宽。默认为5 M。

5
HostNamestring

主机名称,即容器组名称。

test
IngressBandwidthlong

入方向带宽限制。单位:Byte。

1024000
EgressBandwidthlong

出方向带宽限制。单位:Byte。

1024000
CpuOptionsCoreinteger

cpu物理核心数。仅部分实例规格支持自定义设置。更多信息,请参见自定义cpu选项

2
CpuOptionsThreadsPerCoreinteger

每核线程数。仅部分规格支持自定义设置。配置为1时表示关闭超线程。更多信息,请参见自定义cpu选项

2
EphemeralStorageinteger

临时存储空间大小,默认使用ESSD PL1类型的云盘。单位:GiB。

20
LoadBalancerWeightinteger

ECI实例作为负载均衡后端服务器时的权重,取值范围:1~100。

默认值:50。

50
Tagsarray

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

  • Key最多支持64个字符,不能以aliyun和acs:开头,不能包含http://或者https://。一旦使用标签,Key不允许为空字符串。
  • Value最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。Value可以为空字符串。
object

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

  • Key最多支持64个字符,不能以aliyunacs:开头,不能包含http://或者https://。一旦使用标签,Key不允许为空字符串。
  • Value最多支持128个字符,不能以aliyunacs:开头,不能包含http://或者https://。Value可以为空字符串。
Keystring

实例的标签键。

如果传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyunacs:开头,不能包含http://或者https://

version
Valuestring

实例的标签值。

如果传入该值,则允许为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或者https://

3
ImageRegistryCredentialsarray

镜像仓库的详细信息。

object

镜像仓库的详细信息。

Passwordstring

镜像仓库密码。

yourpaasword
Serverstring

镜像仓库注册地址。

registry-vpc.cn-shanghai.aliyuncs.com
UserNamestring

镜像仓库用户名。

yourusername
Containersarray

实例包含的容器列表。

object

容器的监控数据详情。

ReadinessProbe.TimeoutSecondsinteger

检查超时的时间,默认值为1秒,最小值为1秒。

5
ReadinessProbe.SuccessThresholdinteger

从上次检查失败后重新认定检查成功的检查次数阈值(必须是连续成功),默认为1。当前必须为1。

1
SecurityContext.Capability.Addarray

为容器内的进程授予某些特定的权限。目前仅支持配置为NET_ADMIN和NET_RAW。

说明NET_RAW默认不支持,需提交工单申请。
string

为容器内的进程授予某些特定的权限。目前仅支持配置为NET_ADMIN和NET_RAW。

说明NET_RAW默认不支持,需提交工单申请。
NET_ADMIN
ReadinessProbe.TcpSocket.Portinteger

使用TCP Socket方式进行健康检查时,TCP Socket检测的端口。

8000
ReadinessProbe.HttpGet.Schemestring

使用HTTP请求方式进行健康检查时,HTTP Get请求对应的协议类型,取值范围:

  • HTTP。
  • HTTPS。
HTTP
LivenessProbe.PeriodSecondsinteger

检查执行的周期,默认值为10秒,最小值为1秒。

5
Portsarray

端口列表。

object

端口列表。

Protocolstring

协议类型。取值范围:

  • TCP。
  • UDP。
TCP
Portinteger

端口号。取值范围:1~65535。

80
SecurityContext.ReadOnlyRootFilesystemboolean

容器运行的根文件系统是否为只读,目前仅支持配置为true。

true
EnvironmentVarsarray

环境变量的信息。

object

环境变量的信息。

Keystring

环境变量名。长度为1~128位。格式要求:[0-9a-zA-Z],以及下划线,不能以数字开头。

PATH
Valuestring

环境变量值。长度为0~256位。

/usr/local/bin
FieldRefFieldPathstring
说明该参数未开放使用。
fieldPath
LivenessProbe.TcpSocket.Portinteger

使用TCP Socket方式进行健康检查时,TCP Socket检测的端口。

8000
Ttyboolean

是否开启交互。取值范围:

  • true:开启。
  • false:未开启。

例如:当Command配置为/bin/bash时,需要配置为true。

默认值:false。

false
WorkingDirstring

容器工作目录。

/usr/local/
LivenessProbe.HttpGet.Schemestring

使用HTTP请求方式进行健康检查时,HTTP Get请求对应的协议类型,取值范围:

  • HTTP
  • HTTPS
HTTP
ReadinessProbe.HttpGet.Portinteger

使用HTTP请求方式进行健康检查时,HTTP Get请求检测的端口号。

8080
Argsarray

容器启动命令对应的参数。最多10个。

string

容器启动命令对应的参数。最多10个。

100
Gpuinteger

指定容器使用的GPU个数。

1
ReadinessProbe.InitialDelaySecondsinteger

检查开始执行的时间,以容器启动完成为起点计算。单位为秒。

3
Stdinboolean

此容器是否应在容器运行时为标准输入分配缓冲区。如果未设置,则容器中标准输入的读取值将导致EOF。

默认值:false。

false
Memorynumber

容器内存大小。单位:GiB。

0.5
Namestring

容器镜像名称。

nginx
Imagestring

容器镜像。

registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest
LivenessProbe.InitialDelaySecondsinteger

检查开始执行的时间,以容器启动完成为起点计算。单位为秒。

5
VolumeMountsarray

容器挂载的数据卷信息。

object

容器挂载的数据卷信息。

MountPropagationstring

数据卷的挂载传播设置。挂载传播允许将Container挂载的卷共享到同一Pod中的其他Container,甚至可以共享到同一节点上的其他Pod。取值范围:

  • None:该卷不感知任何后续在此卷或其子目录上执行的挂载操作。
  • HostToCotainer:该卷将会感知到后续在此卷或其子目录上的挂载操作。
  • Bidirectional:和HostToCotainer类似,能感知挂载操作。另外,该卷将被传播回主机和使用同一卷的所有Pod的所有容器。

默认值:None。

None
MountPathstring

容器挂载数据卷的目录。

注意容器挂载目录下的内容会被Volume的内容直接覆盖,请您谨慎使用。
/pod/data
ReadOnlyboolean

数据卷是否只读。取值范围:

  • true:是。

  • false:否。

默认值:false。

false
Namestring

数据卷名称。同Volumes中的Name。

default-volume1
SubPathstring

数据卷子路径。

data2/
LivenessProbe.FailureThresholdinteger

从上次检查成功后认定检查失败的检查次数阈值(必须是连续失败)。

默认为3。

3
ReadinessProbe.Exec.Commandsarray

使用命令行方式进行健康检查时,在容器内执行的命令。

string

使用命令行方式进行健康检查时,在容器内执行的命令。

cat/tmp/healthy
ReadinessProbe.FailureThresholdinteger

从上次检查成功后认定检查失败的检查次数阈值(必须是连续失败)。默认值:3。

3
ImagePullPolicystring

容器的镜像拉取策略。取值范围:

  • Alway:总是拉取。每次都拉取镜像。
  • IfNotPresent:按需拉取。优先使用本地镜像,本地没有镜像时则拉取镜像。
  • Never:从不拉取。使用本地镜像,不拉取镜像。
Always
StdinOnceboolean

当标准输入为true时,标准输入流将在多个附加会话中是否保持开启状态。

如果StdinOnce设为true,标准输入在容器开启时被打开,在首个客户端附加到标准输入之前都为空,然后会一直保持开启状态,接收数据,直到客户端连接断开,此时标准输入被关闭,在容器重启前一直保持关闭状态。

false
Cpunumber

容器CPU核数。

0.25
LivenessProbe.HttpGet.Portinteger

使用HTTP请求方式进行健康检查时,HTTP Get请求检测的端口号。

8888
LivenessProbe.HttpGet.Pathstring

使用HTTP请求方式进行健康检查时,HTTP Get请求检测的路径。

/healthyz
LivenessProbe.SuccessThresholdinteger

从上次检查失败后重新认定检查成功的检查次数阈值(必须是连续成功),默认值为1。当前值必须为1。

1
ReadinessProbe.PeriodSecondsinteger

检查执行的周期,默认值为10秒,最小值为1秒。

3
LivenessProbe.TimeoutSecondsinteger

检查超时的时间,默认值为1秒,最小值为1秒。

1
Commandsarray

容器启动命令。最多20个。每个命令最多包含256个字符。

string

容器启动命令。最多20个。每个命令最多包含256个字符。

sleep
SecurityContext.RunAsUserlong

设置运行容器的用户ID。

1000
ReadinessProbe.HttpGet.Pathstring

使用HTTP请求方式进行健康检查时,HTTP Get请求检测的路径。

/healthz
LivenessProbe.Exec.Commandsarray

使用命令行方式进行健康检查时,在容器内执行的命令。

string

使用命令行方式进行健康检查时,在容器内执行的命令。

cat/tmp/healthy
Volumesarray

数据卷信息。

object

数据卷信息。

Typestring

数据卷类型。取值范围:

  • EmptyDirVolume:EmptyDir类型的数据卷,表示空目录。

  • NFSVolume:NFS类型的数据卷,表示网络文件系统。

  • ConfigFileVolume:ConfigFile类型的数据卷,表示配置文件。

  • FlexVolume:使用FlexVolume插件扩展存储类型,支持挂载云盘。

  • HostPathVolume:HostPath类型的数据卷,表示主机节点的文件或目录。

  • DiskVolume(不推荐):云盘数据卷。建议使用FlexVolume挂载云盘。

ConfigFileVolume
DiskVolume.DiskSizeinteger

DiskVolume的大小。单位:GiB。

15
NFSVolume.Pathstring

NFS数据卷路径。

/share
FlexVolume.FsTypestring

挂载的文件系统类型,默认取决于FlexVolume的script。

ext4
DiskVolume.FsTypestring

该系统类型不推荐使用,建议您使用FlexVolume.FsType参数。

xfs
HostPathVolume.Typestring

Host目录的类型。例如:File、Directory、Socket等。

Directory
NFSVolume.ReadOnlyboolean

NFS数据卷是否只读。取值范围:

  • true:是。

  • false:否。

默认值:false。

false
HostPathVolume.Pathstring

Host上的绝对路径。

/xx/xx/path
FlexVolume.Optionsstring

FlexVolume对象选项列表。为KV形式,采用JSON传递。

例如:通过FlexVolume挂载云盘时,Options的格式为{"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"}

{"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"}
FlexVolume.Driverstring

用于FlexVolume的驱动程序名称。

flexvolume
ConfigFileVolumeDefaultModeinteger

ConfigFileVolume默认的权限。

0644
NFSVolume.Serverstring

NFS服务器地址。

3f9cd4a596-naw76.cn-shanghai.nas.aliyuncs.com
DiskVolume.DiskIdstring

DiskVolume的ID。

d-xx
Namestring

数据卷名称。

default-volume1
EmptyDirVolume.Mediumstring

EmptyDirVolume的存储媒介,默认为空,使用node文件系统;支持memory,表示使用内存。

memory
ConfigFileVolumeConfigFileToPathsarray

配置文件路径列表。

object

配置文件路径列表。

Pathstring

环境变量名。

PATH
Modeinteger

ConfigFileVolume目录权限。

0644
Contentstring

配置文件内容(32 KB)。

bGl1bWk=
InitContainersarray

init容器列表。

object

init容器列表。

InitContainerEnvironmentVarsarray

init容器的环境变量信息。

object

init容器的环境变量信息。

Keystring

环境变量名。长度为1~128位,格式要求:[0-9a-zA-Z],以及下划线,不能以数字开头。

Path
Valuestring

环境变量值。长度为0~256位。

/usr/bin/
FieldRefFieldPathstring
说明该参数未开放使用。
path
SecurityContext.Capability.Addsarray

为容器内的进程授予某些特定的权限。目前仅支持配置为NET_ADMIN和NET_RAW。

说明NET_RAW默认不支持,需提交工单申请。
string

为容器内的进程授予某些特定的权限。目前仅支持配置为NET_ADMIN和NET_RAW。

说明NET_RAW默认不支持,需提交工单申请。
NET_ADMIN
Imagestring

容器使用的镜像。

nginx
InitContainerPortsarray

init容器端口映射列表。

object

init容器端口映射列表。

Protocolstring

协议类型。取值范围:

  • TCP。
  • UDP。
TCP
Portinteger

端口号。可能值:1~65535。

1
InitContainerVolumeMountsarray

init容器的挂载点信息数组。

object

init容器的挂载点信息数组。

MountPropagationstring

数据卷的挂载传播设置。挂载传播允许将Container挂载的卷共享到同一Pod中的其他Container,甚至可以共享到同一节点上的其他Pod。可能值:

  • None:该卷不感知任何后续在此卷或其子目录上执行的挂载操作。

  • HostToCotainer:该卷将会感知到后续在此卷或其子目录上的挂载操作。

  • Bidirectional:和HostToCotainer类似,能感知挂载操作。另外,该卷将被传播回主机和使用同一卷的所有Pod的所有容器。

None
MountPathstring

挂载目录,容器的挂载目录下的内容被volume的内容直接覆盖,所以要慎用。

/usr/share/
ReadOnlyboolean

挂载路径是否只读。

默认值:false。

false
Namestring

挂载数据卷的名称。

test-empty
SubPathstring

数据卷下的子目录,方便Pod将同一个Volume下不同目录挂载到容器不同目录。

/usr/sub/
SecurityContext.ReadOnlyRootFilesystemboolean

容器运行的根文件系统是否为只读。目前仅支持配置为true。

true
ImagePullPolicystring

镜像拉取策略。

Always
Cpunumber

容器的vCPU大小。单位:核。

0.5
WorkingDirstring

工作目录。

/usr/local
Commandsarray

容器启动指令。

string

容器启动指令。

sleep
Argsarray

容器启动命令对应的参数。最多10个。

string

容器启动命令对应的参数。最多10个。

100
SecurityContext.RunAsUserlong

设置运行容器的用户ID。

587
Gpuinteger

指定容器使用的GPU个数。

1
Memorynumber

内存大小。单位:GiB。

1.0
Namestring

容器名称。

test-init
DnsConfigNameServersarray

DNS服务器的IP地址列表。

string

DNS服务器的IP地址列表。

172.10.*.**
DnsConfigSearchsarray

DNS搜索域列表。

string

DNS搜索域列表。

svc.local.kubenetes
DnsConfigOptionsarray

对象选项列表,每个对象由Name和Value(可选)构成。

object

对象选项列表,每个对象由Name和Value(可选)构成。

Valuestring

对象变量值。

value
Namestring

对象变量名。

name
HostAliasesarray

自定义实例内一个容器的Hostname映射。

object

自定义实例内一个容器的Hostname映射。

Ipstring

添加IP。

1.1.1.1
Hostnamesarray

添加主机名。

string

添加主机名。

hehe.com
SecurityContextSysctlsarray

实例运行的安全上下文系统信息。

object

实例运行的安全上下文系统信息。

Valuestring

实例运行的安全上下文的变量值。

65536
Namestring

实例运行的安全上下文系统名称。

kernel.msgmax
NtpServersarray

NTP服务器。

string

NTP服务器。

ntp.cloud.aliyuncs.com
AcrRegistryInfosarray

ACR企业版实例的信息。

object

ACR企业版实例的信息。

Domainsarray

ACR企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名,多个以半角逗号(,)分隔。

string

ACR企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名,多个以半角逗号(,)分隔。

*****-****-registry.cn-beijing.cr.aliyuncs.com
InstanceNamestring

ACR企业版实例的名称。

acr-test
InstanceIdstring

ACR企业版实例ID。

cri-nwj395hgf6f3****
RegionIdstring

ACR企业版实例所属地域。

cn-beijing
CostOptimizationboolean

是否开启成本优化开关。可能值:

  • true:开启。
  • false:未开启。
false
InstanceFamilyLevelstring

实例规格族级别,用于筛选符合要求的实例规格范围,当CostOptimization开启时生效。可能值:

  • EntryLevel:入门级,即共享型实例规格。成本更低,但是无法保证实例计算性能的稳定。适用于平时CPU使用率低的业务场景。更多信息,请参见共享型
  • EnterpriseLevel:企业级。性能稳定且资源独享,适用于对稳定性要求高的业务场景。更多信息,请参见实例规格族
  • CreditEntryLevel:积分入门级,即突发性能实例。通过CPU积分来保证计算性能,适用于平时CPU使用率低、偶有突发CPU使用率的业务场景。更多信息,请参见突发性能实例概述
EnterpriseLevel

返回参数

名称类型描述示例值
object

创建伸缩配置后的返回信息。

ScalingConfigurationIdstring

实例ID,即容器组ID。

eci-uf6fonnghi50u374****
RequestIdstring

请求ID,唯一标识。

89945DD3-9072-47D0-A318-353284CF****

示例

正常返回示例

JSON格式

{
  "ScalingConfigurationId": "eci-uf6fonnghi50u374****",
  "RequestId": "89945DD3-9072-47D0-A318-353284CF****"
}

错误码

Http code错误码错误信息
403Forbidden.RiskControlForbidden.RiskControl

访问错误中心查看更多错误码。

阿里云首页 弹性伸缩 相关技术圈