通过OpenAPI指定算力类别创建ECI实例_弹性容器实例(ECI)-阿里云帮助中心

大部分场景下，如果没有特殊的规格需求（如GPU、本地盘等），推荐您指定vCPU和内存来创建ECI实例。在此基础上，您可以进一步指定算力类别。例如：对于0.25~8 vCPU的规格需求，在轻量型应用等入门场景，您可以选择经济型规格来满足降低成本的需求；对于1 vCPU及以上的规格需求，如果性能需求较高，则可以选择通用型规格。

算力类别说明

为了更好地满足低成本或性能稳定的需求，ECI推出了指定算力类别功能。当您采用指定vCPU和内存方式创建ECI实例时，ECI会将底层规格分为经济型和通用型两个算力类别。您可以按需选择，系统会从对应类别的底层规格中自动选择合适的规格。

经济型（economy）
支持的vCPU范围为0.25~8 vCPU，规格单价相比通用型更低。
通用型（general）
支持的vCPU范围为1~64 vCPU，规格单价与未开通指定算力类别时的ECI规格定价一致。在相同vCPU和内存条件下，通用型规格的性能更优。

如何选择算力类别

您可以根据业务情况，以及对低成本、性能稳定或高可用等需求，来选择合适的算力类别。建议如下：

对于轻量型应用等入门场景，可以选择经济型规格来降低资源成本。
对于性能需求较高的业务场景，可以选择通用型规格，该类别规格性能更优，并且与未指定算力类别相比，性能表现更稳定。
为了避免库存不足的情况，如果您的业务对性能波动有一定的容忍，可以指定多个算力类别来保证高可用。

规格说明

ECI支持的经济型和通用型的详细规格如下：

说明

各规格支持的临时存储空间大小默认均为30 GiB。

经济型规格

所有ECI支持地域均支持的规格

vCPU	内存（GiB）	网络基准带宽能力（出+入）（Gbit/s）
0.25	0.5、1	0.08
0.5	1、2	0.08
1	2、4、8	0.08
2	1、2、4、8、16	0.2
4	2、4、8、16、32	0.4
8	4、8、16、32、64	0.8

仅部分地域支持的规格

重要

下表中的规格仅在部分地域支持，创建以下规格的ECI实例时请确保已指定支持的地域和可用区，否则会因为无库存而导致创建失败。
支持的地域为：华东1（杭州）、华东2（上海）、华北1（青岛）、华北2（北京）、华北3（张家口）、华北5（呼和浩特）、华北6（乌兰察布）、华南1（深圳）、华南2（河源）、华南3（广州）、西南1（成都）、新加坡。
不支持指定下表中的规格创建抢占式实例。

vCPU	内存（GiB）	网络基准带宽能力（出+入）（Gbit/s）
2	6、10、12、14	0.2
4	6、10、12、14、18、20、22、24、26、28、30	0.4
6	6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48	0.8
8	10、12、14、18、20、22、24、26、28、30、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62	0.8

通用型规格

所有ECI支持地域均支持的规格

vCPU	内存（GiB）	网络基准带宽能力（出+入）（Gbit/s）
1	2、4、8	1
2	1、2、4、8、16	1
4	2、4、8、16、32	1.5
8	4、8、16、32、64	2
12	12、24、48、96	2.5
16	16、32、64 、128	3
24	24、48、96、192	4.5
32	32、64、128、256	6
52	96、192、384	12.5
64	128、256、512	20

仅部分地域支持的规格

重要

下表中的规格仅在部分地域支持，创建以下规格的ECI实例时请确保已指定支持的地域和可用区，否则会因为无库存而导致创建失败。
支持的地域为：华东1（杭州）、华东2（上海）、华北1（青岛）、华北2（北京）、华北3（张家口）、华北5（呼和浩特）、华北6（乌兰察布）、华南1（深圳）、华南2（河源）、华南3（广州）、西南1（成都）、新加坡。
不支持指定下表中的规格创建抢占式实例。

vCPU	内存（GiB）	网络基准带宽能力（出+入）（Gbit/s）
2	6、10、12、14	1
4	6、10、12、14、18、20、22、24、26、28、30	1.5
6	6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48	1.5
8	10、12、14、18、20、22、24、26、28、30、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62	2.5

计费说明

重要

经济型规格和通用型规格目前处于公测中。

经济型规格
相比于未指定算力类别时的规格，经济型规格的内存单价与之前一致，vCPU单价更低。
- vCPU单价（vCPU）：0.000027 元/秒（0.0972 元/小时）
- 内存单价（GiB）： 0.00000613 元/秒（0.0221 元/小时）
通用型规格
与未开通指定算力类别时的ECI规格定价一致。
- vCPU单价（vCPU）：0.000049 元/秒（0.1764 元/小时）
- 内存单价（GiB）： 0.00000613 元/秒（0.0221 元/小时）

重要

ECI实例创建成功后，您可以调用DescribeContainerGroups接口查询实例详情，通过返回的ComputeCategory参数确认ECI实例实际使用的算力类别。计费会按照对应类别的规格单价计算。

使用限制

指定算力类别功能具有以下限制：

仅适用于指定vCPU和内存创建ECI实例。
如果指定了ECS规格，则优先会采用指定的ECS规格，即无法指定算力类别。
不支持抢占式实例功能。
如果同时配置了抢占式实例和指定算力类别，系统会报错（错误码为FeatureBasedConstraintConflict）。
不支持ARM架构的规格。
如果同时配置了指定ARM架构和指定算力类别，系统会报错（错误码为FeatureBasedConstraintConflict）。

配置说明

调用CreateContainerGroup接口创建ECI实例时，在设置vCPU和内存的基础上，您可以通过ComputeCategory参数来指定算力类别。

指定vCPU和内存可以通过以下几种方式：

方式一：仅指定容器级别vCPU和内存，系统自动汇总到实例级别。
方式二：指定实例级别vCPU和内存，按需设置容器级别vCPU和内存。
方式三：通过InstanceType参数设置实例级别vCPU和内存。

相关参数如下表所示。更多信息，请参见CreateContainerGroup。

名称	类型	示例值	描述
Cpu	number	2.0	实例级别vCPU大小。单位：核。
Memory	number	4.0	实例级别内存大小。单位：GiB。
Container.N.Cpu	number	0.5	容器的vCPU大小。单位：核。
Container.N.Memory	number	1.0	容器的内存大小。单位：GiB。
InstanceType	String	2-4Gi	指定实例规格。支持指定多个规格（单次最多5个），各规格之间用半角逗号（,）进行分隔。可以指定vCPU和内存规格，也可以指定ECS规格。本文介绍的指定算力类别功能仅适用于指定vCPU和内存规格。
ComputeCategory	string[]	economy	指定算力类别。取值范围： economy：经济型 general：通用型支持设置多个算力类别，系统会按照设置顺序创建。

生效规则

开通指定算力类别功能后，根据创建ECI实例时设置的条件，实际创建的ECI实例所使用的规格和算力类别按以下规则生效：

重要

创建ECI实例时设置的条件	实际生效情况
未指定vCPU和内存，但指定了算力类别。	创建2 vCPU，4 GiB内存的实例，算力类别为指定的类别。
指定了vCPU和内存，且指定了算力类别，两者组合后符合ECI的规格要求。	按照指定的条件创建实例。
指定的vCPU小于1 vCPU，但指定算力类别为通用型。	不符合ECI的规格要求，会自动规整到1 vCPU的通用型规格。
指定的vCPU大于8 vCPU，但指定算力类别为经济型。	不符合ECI的规格要求，无法自动规整，会出现报错。
指定了vCPU和内存，且指定了算力类别，指定的vCPU属于该算力类别的vCPU范围，但不符合ECI的规格要求。	自动按照ECI支持的规格进行规整。规整时将向最接近的ECI规格进行规整，需满足指定的vCPU和内存≤ECI规格的vCPU和内存。例如：指定vCPU和内存为`7-13Gi`，指定算力类别为`general`，会自动规整到8 vCPU，16 GiB内存的通用型规格。
指定了多个vCPU和内存规格，或者多个算力类别。	系统按照以下规则选择规格：多个vCPU和内存规格，或者多个算力类别均按照设置顺序依次创建。规格优先级高于算力类别。规格和算力类别组合后需符合ECI的规格要求。例如：指定vCPU和内存为`4-8Gi,8-16Gi,16-32Gi`，指定算力类别为`general,economy`，则系统会按以下顺序尝试创建： 4-8Gi，general 4-8Gi，economy 8-16Gi，general 8-16Gi，economy 16-32Gi，general 16-32Gi，economy（不符合要求，自动忽略）重要由于规格优先级高于算力类别。在指定多个算力类别的情况下，如果指定的vCPU和内存不符合ECI的规格要求，资源规整时，系统会考虑所有算力类别的合集，选择最接近您指定的vCPU和内存规格来向上规整，如果此时规整的vCPU和内存在某一算力类别内不合法，那么该算力类别在当前vCPU和内存规格的调度中不予考虑。例如：指定vCPU和内存为`0.5-1.9Gi`，指定算力类别为`general,economy`时，由于经济型规格有0.5 vCPU，2 GiB内存的规格，因此会规整到`0.5-2Gi`。但由于0.5 vCPU，2 GiB内存的规格不属于通用型规格的范围，因此当前vCPU和内存规格（`0.5-1.9Gi`）的调度只会考虑`0.5-2Gi`+`economy`。

配置示例

示例一：指定容器级别的vCPU和内存规格，并指定算力类别为经济型

ContainerGroupName=test-category
# 指定算力类别
ComputeCategory.1=economy
# 指定容器的vCPU和内存
Container.1.Cpu=1.0
Container.1.Memory=2.0
Container.1.Name=nginx
Container.1.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.14.2

示例二：指定实例级别的vCPU和内存规格，并指定算力类别优先通用型，其次经济型

ContainerGroupName=test-category
# 指定实例的vCPU和内存规格
Cpu=4.0
Memory=8.0
# 指定算力类别
ComputeCategory.1=general
ComputeCategory.2=economy
# 配置容器
Container.1.Name=nginx
Container.1.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.14.2

示例三：指定多个实例级别的vCPU和内存规格，并指定算力类别为通用型

ContainerGroupName=test-category
# 指定多个实例级别的vCPU和内存规格
InstanceType=2-4Gi,4-8Gi
# 指定算力类别
ComputeCategory.1=general
# 配置容器
Container.1.Name=nginx
Container.1.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.14.2