Create an ECI instance by specifying vCPU and memory - Elastic Container Instance

Specifications

You can create an ECI instance by specifying the vCPU and memory for the instance or for the containers within the instance. If your specified vCPU and memory do not match a supported ECI specification, the system automatically rounds them up to the nearest supported specification. The adjusted resources will meet or exceed your specifications. For example, if you request 7 vCPUs and 13 GiB of memory when creating an ECI instance in the China (Hangzhou) region, the system provisions an instance with 8 vCPUs and 14 GiB of memory.

ECI supports the following specifications:

Note

If you do not specify vCPU and memory, the system creates an ECI instance with 2 vCPUs and 4 GiB of memory by default.
ECI instances support only one elastic network interface.
The default temporary storage is 30 GiB for all specifications.

Specifications supported in all regions where Elastic Container Instance is available

vCPU	Memory (GiB)	Bandwidth (bidirectional, Gbit/s, theoretical upper limit)
0.25	0.5 and 1	0.08
0.5	1 and 2	0.08
1	2, 4, and 8	0.1
2	1, 2, 4, 8, and 16	1
4	2, 4, 8, 16, and 32	1.5
8	4, 8, 16, 32, and 64	2
12	12, 24, 48, and 96	2.5
16	16, 32, 64, and 128	3
24	24, 48, 96, and 192	4.5
32	32, 64, 128, and 256	6
52	96, 192, and 384	12.5
64	128, 256, and 512	20

Specifications supported only in some regions

Important

The specifications contained in the following table are supported only in some regions. When you create an elastic container instance that has one of the following specifications, make sure that the corresponding specifications are supported in the specified region and zone. Otherwise, the instance cannot be created because no resources exist in the region and zone.
The regions that support the specifications contained in the following table include: China (Hangzhou), China (Shanghai), China (Qingdao), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Ulanqab), China (Shenzhen), China (Heyuan), China (Guangzhou), China (Chengdu), and Singapore.
You cannot use the specifications in the following table to create preemptible instances.

vCPU	Memory (GiB)	Bandwidth (bidirectional, Gbit/s, theoretical upper limit)
2	6, 10, 12, and 14	1
4	6, 10, 12, 14, 18, 20, 22, 24, 26, 28, and 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, and 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, and 62	2.5

Specify container vCPU and memory

An ECI instance supports up to 20 containers. You can define custom vCPU and memory specifications for each container. However, the combined resources of all containers must not exceed the instance's vCPU and memory limits. If the total resources exceed the instance's limits, the system automatically adjusts the specifications and bills you accordingly.

Note

You can set an environment variable for a specific container, such as a sidecar container, to exclude it from resource adjustment. This helps prevent resource waste. For more information, see Configure resource adjustment to ignore specific containers.

OpenAPI

When calling the CreateContainerGroup operation to create an ECI instance, you can use the Container.N.Cpu and Container.N.Memory parameters to specify the vCPU and memory for each container. The following table describes these parameters. For more information, see CreateContainerGroup.

Parameter	Type	Example	Description
Container.N.Cpu	number	2	The number of vCPUs for container N, where N is a value from 1 to 20.
Container.N.Memory	number	4	The memory size in GiB for container N, where N is a value from 1 to 20.

Console

When you create an ECI instance in the ECI console, you can set the vCPU and memory for each container in its Advanced Settings. The total vCPU and memory of all containers cannot exceed the vCPU and memory configured for the instance (container group).

In the Container Configuration area, click the tab for the target container, such as container-1, expand the Advanced Settings section for that container, and enter the values for vCPU and memory.

Specify vCPU and memory for an instance

This method provisions resources from a variety of ECS instance types based on the vCPU and memory you specify for the ECI instance. This approach offers better elasticity and resource availability. It also provides the following benefits:

Containers within the instance do not require specific vCPU and memory settings or resource limits. This allows them to share the allocated instance resources more flexibly.
In use cases like genetic computing and Istio, where the service framework automatically adds sidecar containers to pods, explicitly specifying the ECI instance specifications enables ECI to integrate seamlessly with these frameworks.

Note

Some specifications are not available in the console. If a supported ECI specification cannot be selected in the console, use OpenAPI.

OpenAPI

When calling the CreateContainerGroup operation to create an ECI instance, you can use the Cpu and Memory parameters to specify the vCPU and memory for the instance. The following table describes these parameters. For more information, see CreateContainerGroup.

Parameter	Type	Example	Description
Cpu	number	2	The number of vCPUs for the instance.
Memory	number	4	The memory size in GiB for the instance.

Console

When you create an ECI instance in the ECI console, you can select the vCPU and memory for the instance (container group) on the Basic Mode tab of the Container Group Configuration section.