All Products
Search

This Product

    Auto Scaling:CreateEciScalingConfiguration

    Document Center

    Auto Scaling:CreateEciScalingConfiguration

    Last Updated:Aug 28, 2026

    Creates an Elastic Container Instance (ECI) scaling configuration. Auto Scaling uses this configuration as a template to automatically create ECI instances during scale-out events.

    Operation description

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

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

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ess:CreateEciScalingConfiguration

    create

    *ScalingGroup

    acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupId

    string

    Yes

    The ID of the scaling group to which the scaling configuration belongs.

    asg-bp14wlu85wrpchm0****
    ScalingConfigurationName

    string

    No

    The scaling configuration name. The name must be 2 to 64 characters in length and can contain letters, digits, underscores (_), hyphens (-), and periods (.). It must start with a letter or a digit.

    The scaling configuration name must be unique within a scaling group in a region. If you do not specify this parameter, the value of ScalingConfigurationId is used.

    scalingconfig****
    Description

    string

    No

    Note

    This parameter is unavailable for use.

    desc
    SecurityGroupId

    string

    No

    The ID of the security group for elastic container instances. Instances in the same security group can communicate with each other.

    If you do not specify a security group, the system uses the default security group in the selected region. Make sure that the inbound rules of the security group contain the protocols and port numbers of the containers to expose. If no default security group exists in the region, the system creates one and adds the specified container protocols and port numbers to its inbound rules.

    sg-uf66jeqopgqa9hdn****
    ContainerGroupName

    string

    No

    The name series of elastic container instances.

    If you want to use an ordered instance name, specify the value for this parameter in the following format: name_prefix[begin_number,bits]name_suffix.

    nginx-test-(AUTO_INCREMENT)[0,3]
    RestartPolicy

    string

    No

    The restart policy of elastic container instances. Valid values:

    • Always: always restarts elastic container instances.

    • Never: never restarts elastic container instances.

    • OnFailure: restarts elastic container instances upon failures.

    Default value: Always.

    Always
    Cpu

    number

    No

    The number of vCPUs per elastic container instance.

    1.0
    Memory

    number

    No

    The memory size per elastic container instance. Unit: GiB.

    2.0
    ResourceGroupId

    string

    No

    The ID of the resource group.

    rg-uf66jeqopgqa9hdn****
    DnsPolicy

    string

    No

    The Domain Name System (DNS) policy. Valid values:

    • None: uses the DNS that is specified by DnsConfig.

    • Default: uses the DNS that is specified for the runtime environment.

    Default
    EnableSls

    boolean

    No

    Note

    This parameter is unavailable for use.

    false
    ImageSnapshotId

    string

    No

    The ID of the image cache.

    imc-2zebxkiifuyzzlhl****
    RamRoleName

    string

    No

    The name of the instance Resource Access Management (RAM) role. Elastic container instances and Elastic Compute Service (ECS) instances can share the same RAM role. For more information, see RAM roles.

    RamTestRole
    TerminationGracePeriodSeconds

    integer

    No

    The grace period for a program to handle operations before it stops. Unit: seconds.

    60
    AutoMatchImageCache

    boolean

    No

    Specifies whether to automatically match the image cache. Valid values:

    • true

    • false

    Default value: false.

    false
    Ipv6AddressCount

    integer

    No

    The number of IPv6 addresses.

    1
    ActiveDeadlineSeconds

    integer

    No

    The validity period of the scaling configuration. Unit: seconds.

    1000
    SpotStrategy

    string

    No

    The instance bidding policy. Valid values:

    • NoSpot: The instances are created as pay-as-you-go instances.

    • SpotWithPriceLimit: Preemptible instances with a maximum hourly price that you specify.

    • SpotAsPriceGo: Preemptible instances that use the market price at the time of purchase as the bid price.

    Default value: NoSpot.

    SpotWithPriceLimit
    SpotPriceLimit

    number

    No

    The maximum hourly price for preemptible elastic container instances. The value can be accurate to three decimal places.

    If you set SpotStrategy to SpotWithPriceLimit, you must specify SpotPriceLimit.

    0.025
    AutoCreateEip

    boolean

    No

    Specifies whether to automatically create and bind elastic IP addresses (EIPs) to elastic container instances.

    true
    EipBandwidth

    integer

    No

    The EIP bandwidth. Default value: 5. Unit: Mbit/s.

    5
    HostName

    string

    No

    The hostname series of elastic container instances.

    test
    IngressBandwidth

    integer

    No

    The maximum inbound bandwidth. Unit: bit/s.

    1024000
    EgressBandwidth

    integer

    No

    The maximum outbound bandwidth. Unit: bit/s.

    1024000
    CpuOptionsCore

    integer

    No

    The number of physical CPU cores. You can specify this parameter for specific instance types. For more information, see Specify CPU options.

    2
    CpuOptionsThreadsPerCore

    integer

    No

    The number of threads per core. You can specify this parameter for specific instance types. A value of 1 specifies that Hyper-Threading is disabled. For more information, see Specify CPU options.

    2
    EphemeralStorage

    integer

    No

    The size of the temporary storage space. By default, an Enterprise SSD (ESSD) of performance level 1 (PL1) is used. Unit: GiB.

    20
    LoadBalancerWeight

    integer

    No

    The load balancing weight of each elastic container instance. Valid values: 1 to 100.

    Default value: 50.

    50
    Tags

    array<object>

    No

    The tags of elastic container instances. Tags must be specified as key-value pairs. You can specify up to 20 tags for each elastic container instance. When you specify Key and Value, take note of the following items:

    • A tag key can be up to 64 characters in length. The key cannot start with acs: or aliyun or contain http:// or https://. You cannot specify an empty string as a tag key.

    • A tag value can be up to 128 characters in length. The value cannot start with acs: or aliyun or contain http:// or https://. You can specify an empty string as a tag value.

    object

    No

    The tag of the elastic container instance. Tags must be specified as key-value pairs. You can specify up to 20 tags for each elastic container instance. When you specify Key and Value, take note of the following items:

    • A tag key can be up to 64 characters in length. The key cannot start with acs: or aliyun or contain http:// or https://. You cannot specify an empty string as a tag key.

    • A tag value can be up to 128 characters in length. The value cannot start with acs: or aliyun or contain http:// or https://. You can specify an empty string as a tag value.

    Key

    string

    No

    The tag key of the elastic container instance.

    The tag key cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with acs: or aliyun or contain http:// or https://.

    version
    Value

    string

    No

    The tag value of the elastic container instance.

    The tag value can be an empty string. The tag value can be up to 128 characters in length. It cannot start with acs: and cannot contain http:// or https://.

    3
    ImageRegistryCredentials

    array<object>

    No

    The image repositories.

    object

    No

    The image repository.

    Password

    string

    No

    The password of the image repository.

    yourpassword

    Server

    string

    No

    The endpoint of the image repository.

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

    string

    No

    The username of the image repository.

    yourusername

    Containers

    array<object>

    No

    The containers per elastic container instance.

    array<object>

    No

    The monitoring data of containers.

    ReadinessProbe.TimeoutSeconds

    integer

    No

    The timeout limit for a readiness probe to be complete. Unit: seconds. Default value: 1. Minimum value: 1.

    5
    ReadinessProbe.SuccessThreshold

    integer

    No

    The minimum count of consecutive successes that must occur for a readiness probe to be classified as successful. Default value: 1. Set the value to 1.

    1
    SecurityContext.Capability.Add

    array

    No

    The permissions that you want to grant to the processes in the container. Valid values: NET_ADMIN and NET_RAW.

    Note

    To use NET_RAW, you must submit a ticket.

    string

    No

    The permission that you want to grant to the process in the container. Valid values: NET_ADMIN and NET_RAW.

    Note

    To use NET_RAW, submit a ticket.

    NET_ADMIN
    ReadinessProbe.TcpSocket.Port

    integer

    No

    The port detected by TCP sockets for readiness probing.

    8000
    ReadinessProbe.HttpGet.Scheme

    string

    No

    The protocol type of HTTP GET requests for readiness probing. Valid values:

    • HTTP

    • HTTPS

    HTTP
    LivenessProbe.PeriodSeconds

    integer

    No

    The interval at which liveness probes are performed. Unit: seconds. Default value: 10. Minimum value: 1.

    5
    Ports

    array<object>

    No

    The ports.

    object

    No

    The port.

    Protocol

    string

    No

    The type of the protocol. Valid values:

    • TCP.

    • UDP

    TCP
    Port

    integer

    No

    The port. Valid values: 1 to 65535.

    80
    SecurityContext.ReadOnlyRootFilesystem

    boolean

    No

    Specifies whether the root file system on which the container runs is read-only.

    true
    EnvironmentVars

    array<object>

    No

    The environment variables.

    object

    No

    The environment variable.

    Key

    string

    No

    The name of the environment variable. The name can be 1 to 128 characters in length and can contain letters, underscores (_), and digits. It cannot start with a digit. Specify the value in the [0-9a-zA-Z] format.

    PATH
    Value

    string

    No

    The value of the environment variable. The value can be up to 256 characters in length.

    /usr/local/bin

    FieldRefFieldPath

    string

    No

    Note

    This parameter is unavailable for use.

    fieldPath
    LivenessProbe.TcpSocket.Port

    integer

    No

    The port detected by TCP sockets for liveness probing.

    8000
    Tty

    boolean

    No

    Specifies whether to enable interaction. Valid values:

    • true

    • false

    If the command is a /bin/bash command, set the value to true.

    Default value: false.

    false
    WorkingDir

    string

    No

    The working directory of the container.

    /usr/local/

    LivenessProbe.HttpGet.Scheme

    string

    No

    The protocol type of HTTP GET requests for liveness probing. Valid values:

    • HTTP

    • HTTPS

    HTTP
    ReadinessProbe.HttpGet.Port

    integer

    No

    The port over which you want to send HTTP GET requests for readiness probing.

    8080
    Args

    array

    No

    The startup arguments of the container. You can specify up to 10 arguments.

    string

    No

    The startup argument of the container. You can specify up to 10 arguments.

    100
    Gpu

    integer

    No

    The number of GPUs per container.

    1
    ReadinessProbe.InitialDelaySeconds

    integer

    No

    The number of seconds that elapse from the startup of the container to the start time of a readiness probe. Unit: seconds.

    3
    Stdin

    boolean

    No

    Specifies whether the container allocates buffer resources to standard input streams. If you do not specify this parameter, an end-of-file (EOF) error occurs when standard input streams in the container are read.

    Default value: false.

    false
    Memory

    number

    No

    The memory size that you want to allocate to the container. Unit: GiB.

    0.5
    Name

    string

    No

    The name of the container image.

    nginx

    Image

    string

    No

    The image in the container.

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

    integer

    No

    The number of seconds that elapse from the startup of the container to the start time of a liveness probe. Unit: seconds.

    5
    VolumeMounts

    array<object>

    No

    The volume mounts of the container.

    object

    No

    The volume mount of the container.

    MountPropagation

    string

    No

    The mount propagation setting. Mount propagation allows volumes to be shared between containers in the same pod or across pods on the same node. Valid values:

    • None: Subsequent mounts executed on the volume or its subdirectories are not propagated to the volume.

    • HostToCotainer: Subsequent mounts executed on the volume or its subdirectories are propagated to the volume.

    • Bidirectional: This value is similar to HostToCotainer. Subsequent mounts executed on the volume or its subdirectories are propagated to the volume. All volume mounts executed on the container are not only propagate back to the underlying host but also to all containers across every pod that uses the same volume.

    Default value: None.

    None
    MountPath

    string

    No

    The directory in which the container mounts the volume.

    Note

    Data in this directory is overwritten by data on the volume. Specify this parameter with caution.

    /pod/data
    ReadOnly

    boolean

    No

    Specifies whether the volume is read-only. Valid values:

    • true

    • false

    Default value: false.

    false
    Name

    string

    No

    The volume name. The value of this parameter is the same as the value of Volumes.Name.

    default-volume1

    SubPath

    string

    No

    The volume subdirectory.

    data2/

    LivenessProbe.FailureThreshold

    integer

    No

    The minimum count of consecutive failures that must occur for a liveness probe to be classified as failed.

    Default value: 3.

    3
    ReadinessProbe.Exec.Commands

    array

    No

    The commands executed in the container when using the command line to perform the health check.

    string

    No

    The command.

    cat/tmp/healthy
    ReadinessProbe.FailureThreshold

    integer

    No

    The minimum count of consecutive failures that must occur for a readiness probe to be classified as failed. Default value: 3.

    3
    ImagePullPolicy

    string

    No

    The image pulling policy. Valid values:

    • Always: Each time instances are created, image pulling is performed.

    • IfNotPresent: On-premises images are used first. If no on-premises images are available, images are pulled from remote sources.

    • Never: Image pulling is not performed. On-premises images are always used. Image pulling is not performed.

    Always
    StdinOnce

    boolean

    No

    Specifies whether standard input streams remain connected during multiple sessions if Stdin is set to true.

    If you set StdinOnce to true, standard input streams are connected after the container is started, and remain idle until a client is connected to receive data. After the client is disconnected, streams are also disconnected and remain disconnected until the container is restarted.

    false
    Cpu

    number

    No

    The number of vCPUs per container.

    0.25
    LivenessProbe.HttpGet.Port

    integer

    No

    The port over which you want to send HTTP GET requests for liveness probing.

    8888
    LivenessProbe.HttpGet.Path

    string

    No

    The path to which you want to send HTTP GET requests for liveness probing.

    /healthyz

    LivenessProbe.SuccessThreshold

    integer

    No

    The minimum count of consecutive successes that must occur for a liveness probe to be classified as successful. Default value: 1. Set the value to 1.

    1
    ReadinessProbe.PeriodSeconds

    integer

    No

    The interval at which readiness probes are performed. Unit: seconds. Default value: 10. Minimum value: 1.

    3
    LivenessProbe.TimeoutSeconds

    integer

    No

    The timeout limit for a liveness probe to be complete. Unit: seconds. Default value: 1. Minimum value: 1.

    1
    Commands

    array

    No

    The commands that you want to run by using the CLI for liveness probing within the container.

    string

    No

    The command that you want to run by using the CLI for liveness probing within the container.

    sleep
    SecurityContext.RunAsUser

    integer

    No

    The ID of the user that runs the container.

    1000
    ReadinessProbe.HttpGet.Path

    string

    No

    The path to which you want to send HTTP GET requests for readiness probing.

    /healthz

    LivenessProbe.Exec.Commands

    array

    No

    The commands executed in the container when using the command line to perform the health check.

    string

    No

    The command.

    cat/tmp/healthy
    LifecyclePostStartHandlerHttpGetHost

    string

    No

    The IP address of the host to which you want to send HTTP GET requests to configure the postStart callback function.

    10.0.XX.XX
    LifecyclePostStartHandlerHttpGetPort

    integer

    No

    The port over which you want to send HTTP GET requests to configure the postStart callback function.

    5050
    LifecyclePostStartHandlerHttpGetPath

    string

    No

    The path to which you want to send HTTP GET requests to configure the postStart callback function.

    /healthyz
    LifecyclePostStartHandlerHttpGetScheme

    string

    No

    The protocol type of HTTP GET requests that you want to send to configure the postStart callback function. Valid values:

    • HTTP

    • HTTPS

    HTTPS
    LifecyclePostStartHandlerExecs

    array

    No

    The commands that you want to run by using the CLI to configure the postStart callback function within the container.

    string

    No

    The command that you want to run by using the CLI to configure the postStart callback function within the container.

    ["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
    LifecyclePostStartHandlerTcpSocketHost

    string

    No

    The IP address of the host detected by the TCP sockets that you want to use to configure the postStart callback function.

    10.0.XX.XX
    LifecyclePostStartHandlerTcpSocketPort

    integer

    No

    The port detected by the TCP sockets that you want to use to configure the postStart callback function.

    80
    LifecyclePreStopHandlerHttpGetHost

    string

    No

    The IP address of the host to which you want to send HTTP GET requests to configure the preStop callback function.

    10.0.XX.XX
    LifecyclePreStopHandlerHttpGetPort

    integer

    No

    The port over which you want to send HTTP GET requests to configure the preStop callback function.

    88
    LifecyclePreStopHandlerHttpGetPath

    string

    No

    The path to which you want to send HTTP GET requests to configure the preStop callback function.

    /healthyz
    LifecyclePreStopHandlerHttpGetScheme

    string

    No

    The protocol type of the HTTP GET requests that you want to send to configure the preStop callback function. Valid values:

    • HTTP

    • HTTPS

    HTTP
    LifecyclePreStopHandlerExecs

    array

    No

    The commands that you want to run by using the CLI to configure the preStop callback function within the container.

    string

    No

    The command that you want to run by using the CLI to configure the preStop callback function within the container.

    ["/bin/sh", "-c","echo Hello from the preStop handler > /usr/share/message"]
    LifecyclePreStopHandlerTcpSocketHost

    string

    No

    The IP address of the host detected by the TCP sockets that you want to use to configure the preStop callback function.

    10.0.XX.XX
    LifecyclePreStopHandlerTcpSocketPort

    integer

    No

    The port detected by the TCP sockets that you want to use to configure the preStop callback function.

    90
    Volumes

    array<object>

    No

    The volumes.

    array<object>

    No

    The volume.

    Type

    string

    No

    The type of the Host directory. Examples: File, Directory, and Socket.

    ConfigFileVolume
    DiskVolume.DiskSize

    integer

    No

    The size of the volume. Unit: GiB.

    15
    NFSVolume.Path

    string

    No

    The path to the NFS volume.

    /share

    FlexVolume.FsType

    string

    No

    The type of the file system that you want to mount. The default value is determined by the script of FlexVolume.

    ext4

    DiskVolume.FsType

    string

    No

    The type of the disk volume. We recommend that you specify FlexVolume.FsType instead of DiskVolume.FsType.

    xfs
    HostPathVolume.Type

    string

    No

    The type of host directory. For example: File, Directory, Socket, etc.

    Directory
    NFSVolume.ReadOnly

    boolean

    No

    Specifies whether the permissions on the NFS volume are read-only. Valid values:

    • true

    • false

    Default value: false.

    false
    HostPathVolume.Path

    string

    No

    The absolute path on the host.

    /xx/xx/path

    FlexVolume.Options

    string

    No

    The options of the FlexVolume object. Each option is a key-value pair in a JSON string.

    For example, if you use FlexVolume to mount a disk, specify the value in the {"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"} format.

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

    string

    No

    The name of the FlexVolume driver.

    flexvolume
    ConfigFileVolumeDefaultMode

    integer

    No

    The default permissions on the ConfigFile volume.

    0644
    NFSVolume.Server

    string

    No

    The endpoint of the NFS server.

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

    string

    No

    The ID of the disk volume.

    d-xx

    Name

    string

    No

    The name of the volume.

    default-volume1

    EmptyDirVolume.Medium

    string

    No

    The storage medium of the emptyDir volume. By default, this parameter is left empty, and the emptyDir volume uses the node file system as the storage medium. A value of memory specifies that the emptyDir volume uses memory as the storage medium.

    memory
    ConfigFileVolumeConfigFileToPaths

    array<object>

    No

    The paths to the configuration files.

    object

    No

    The path to the configuration file.

    Path

    string

    No

    The name of the environment variable.

    PATH
    Mode

    integer

    No

    The permissions on the configuration file.

    0644
    Content

    string

    No

    The content of the configuration file (32 KB).

    bGl1bWk=

    EmptyDirVolume.SizeLimit

    string

    No

    The size of the emptyDir volume. The value contains a unit. We recommend that you use Gi or Mi as the unit.

    256Mi
    InitContainers

    array<object>

    No

    The init containers.

    array<object>

    No

    The init container.

    InitContainerEnvironmentVars

    array<object>

    No

    The environment variables of the init container.

    object

    No

    The environment variable of the init container.

    Key

    string

    No

    The name of the environment variable. The name can be 1 to 128 characters in length and can contain letters, underscores (_), and digits. It cannot start with a digit. Specify the value in the [0-9a-zA-Z] format.

    Path

    Value

    string

    No

    The value of the environment variable. The value can be up to 256 characters in length.

    /usr/bin/

    FieldRefFieldPath

    string

    No

    Note

    This parameter is unavailable for use.

    path
    SecurityContext.Capability.Adds

    array

    No

    The permissions that you want to grant to the processes in the init container. Valid values: NET_ADMIN and NET_RAW.

    Note

    To use NET_RAW, submit a ticket.

    string

    No

    The permissions that you want to grant to the process in the init container. Valid values: NET_ADMIN and NET_RAW.

    Note

    To use NET_RAW, submit a ticket.

    NET_ADMIN
    Image

    string

    No

    The image of the init container.

    nginx
    InitContainerPorts

    array<object>

    No

    The ports of init containers.

    object

    No

    The port of the init container.

    Protocol

    string

    No

    The protocol type. Valid values:

    • TCP

    • UDP

    TCP
    Port

    integer

    No

    The port number. Valid values: 1 to 65535.

    1
    InitContainerVolumeMounts

    array<object>

    No

    The volume mounts of the init container.

    object

    No

    The volume mount of the init container.

    MountPropagation

    string

    No

    The mount propagation settings of the volume. Mount propagation allows volumes to be shared between containers in the same pod or across pods on the same node. Valid values:

    • None: Subsequent mounts executed on the volume or its subdirectories do not propagate to the volume.

    • HostToCotainer: Subsequent mounts executed on the volume or its subdirectories propagate to the volume.

    • Bidirectional: This value is similar to HostToCotainer. Subsequent mounts executed on the volume or its subdirectories propagate to the volume. All volume mounts executed on the container not only propagate back to the underlying host but also to all containers across every pod that uses the same volume.

    None
    MountPath

    string

    No

    The directory to which the init container mounts the volume. The data stored in this directory is overwritten by the data on the volume. Specify this parameter with caution.

    /usr/share/
    ReadOnly

    boolean

    No

    Specifies whether the mount path is read-only.

    Default value: false.

    false
    Name

    string

    No

    The name of the volume.

    test-empty

    SubPath

    string

    No

    The subdirectory of the volume. The pod can mount different directories of the same volume to different subdirectories of init containers.

    /usr/sub/
    SecurityContext.ReadOnlyRootFilesystem

    boolean

    No

    Specifies whether the root file system on which the init container runs is read-only. Valid value: true.

    true
    ImagePullPolicy

    string

    No

    The image pulling policy.

    Always
    Cpu

    number

    No

    The number of vCPUs per init container.

    0.5
    WorkingDir

    string

    No

    The working directory of the init container.

    /usr/local

    Commands

    array

    No

    The startup commands of the init container.

    string

    No

    The startup command of the init container.

    sleep

    Args

    array

    No

    The startup arguments of the init container. You can specify up to 10 arguments.

    string

    No

    The startup argument of the init container. You can specify up to 10 arguments.

    100
    SecurityContext.RunAsUser

    integer

    No

    The ID of the user that runs the init container.

    587
    Gpu

    integer

    No

    The number of GPUs per init container.

    1
    Memory

    number

    No

    The memory size per init container. Unit: GiB.

    1.0
    Name

    string

    No

    The name of the init container.

    test-init

    DnsConfigNameServers

    array

    No

    The IP addresses of the DNS servers.

    string

    No

    The IP address of the DNS server.

    172.10.*.**

    DnsConfigSearchs

    array

    No

    The search domains of the DNS servers.

    string

    No

    The search domain of the DNS server.

    svc.local.kubenetes

    DnsConfigOptions

    array<object>

    No

    The options. Each option is a name-value pair. The value in the name-value pair is optional.

    object

    No

    The option. Each option is a name-value pair. The value in the name-value pair is optional.

    Value

    string

    No

    The variable value of the option.

    value

    Name

    string

    No

    The variable name of the option.

    name
    HostAliases

    array<object>

    No

    The custom hostnames of the containers.

    object

    No

    The custom hostname of the container.

    Ip

    string

    No

    The IP address of the container that you want to add.

    1.1.1.1

    Hostnames

    array

    No

    The hostnames of the containers that you want to add.

    string

    No

    The hostname of the container that you want to add.

    hehe.com
    SecurityContextSysctls

    array<object>

    No

    The system information of the security context in which the elastic container instance runs.

    object

    No

    The system information of the security context in which the elastic container instance runs.

    Value

    string

    No

    The variable value of the security context in which the elastic container instance runs.

    65536
    Name

    string

    No

    The variable name of the security context in which the container group runs.

    kernel.msgmax

    NtpServers

    array

    No

    The endpoints of the Network Time Protocol (NTP) servers.

    string

    No

    The endpoint of the NTP server.

    ntp.cloud.aliyuncs.com
    AcrRegistryInfos

    array<object>

    No

    The Container Registry Enterprise Edition instances.

    object

    No

    The Container Registry Enterprise Edition instance.

    Domains

    array

    No

    The domain names of the Container Registry Enterprise Edition instances. By default, all domain names are displayed. Separate multiple domain names with commas (,).

    string

    No

    The domain name of the Container Registry Enterprise Edition instance. By default, all domain names are displayed. Separate multiple domain names with commas (,).

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

    InstanceName

    string

    No

    The name of the Container Registry Enterprise Edition instance.

    acr-test

    InstanceId

    string

    No

    The ID of the Container Registry Enterprise Edition instance.

    cri-nwj395hgf6f3****

    RegionId

    string

    No

    The region ID of the Container Registry Enterprise Edition instance.

    cn-beijing

    CostOptimization

    boolean

    No

    Specifies whether to enable the Cost Optimization feature. Valid values:

    • true

    • false

    false
    InstanceFamilyLevel

    string

    No

    The instance family level, used to match available instance types. This parameter takes effect only if you set CostOptimization to true. Valid values:

    • EntryLevel: entry level (shared instance types). Instance types of this level are the most cost-effective, but may not ensure stable computing performance. Instance types of this level are suitable for scenarios in which the CPU utilization is low. For more information, see Shared instance families.

    • EnterpriseLevel: enterprise level. Instance types of this level provide stable performance and dedicated resources, and are suitable for business scenarios that require high stability. For more information, see Overview of instance families.

    • CreditEntryLevel: credit-based entry level (burstable instance types). CPU credits are used to ensure computing performance. Instance types of this level are suitable for scenarios in which the CPU utilization is low but may fluctuate in specific cases. For more information, see Overview of burstable instances.

    EnterpriseLevel
    InstanceTypes

    array

    No

    The ECS instance types that you want to use to create elastic container instances. You can specify up to five ECS instance types.

    string

    No

    The ECS instance type to use for creating elastic container instances. You can specify up to five ECS instance types. For more information, see Specify ECS instance types to create an elastic container instance.

    ecs.g6.large
    DataCacheBucket

    string

    No

    The bucket that you want to use to store data caches.

    default
    DataCachePL

    string

    No

    The PL of the cloud disk that you want to use to store data caches. We recommend that you use ESSDs. Valid values:

    • PL0: An ESSD can provide up to 10,000 random read/write IOPS.

    • PL1: An ESSD can provide up to 50,000 random read/write IOPS.

    • PL2: An ESSD can provide up to 100,000 random read/write IOPS.

    • PL3: An ESSD can provide up to 1,000,000 random read/write IOPS.

    Default value: PL1.

    Note

    For more information about ESSDs, see ESSDs.

    PL1
    DataCacheProvisionedIops

    integer

    No

    The provisioned IOPS of the ESSD AutoPL disk that you want to use to store data caches. Valid values: 0 to min{50,000, 1,000 × *Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × *Capacity, 50,000}.

    Note

    For more information about ESSD AutoPL disks, see ESSD AutoPL disks.

    40000
    DataCacheBurstingEnabled

    boolean

    No

    Specifies whether to enable the performance burst feature when ESSD AutoPL disks are used to store data caches. Valid values:

    • true

    • false

    Default value: false.

    Note

    For more information about ESSD AutoPL disks, see ESSD AutoPL disks.

    false
    GpuDriverVersion

    string

    No

    The version of the GPU driver. Valid values:

    • tesla=470.82.01 (default)

    • tesla=525.85.12

    Note

    You can switch the GPU driver version only for a few Elastic Compute Service (ECS) instance types. For more information, see Specify GPU-accelerated ECS instance types to create an elastic container instance.

    tesla=525.85.12

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    ScalingConfigurationId

    string

    The ID of the elastic container instance (container group).

    eci-uf6fonnghi50u374****
    RequestId

    string

    The request ID.

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

    Examples

    Success response

    JSON format

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

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    403 Forbidden.RiskControl Forbidden.RiskControl

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.