All Products
Search

This Product

    Auto Scaling:ModifyEciScalingConfiguration

    Document Center

    Auto Scaling:ModifyEciScalingConfiguration

    Last Updated:Sep 10, 2026

    Modifies a scaling configuration of the Elastic Container Instance (ECI) type.

    Operation description

    Operation description

    • If you modify the name of a scaling configuration, make sure that no scaling configuration with the same name exists in the same scaling group.

    • You can call DescribeEciScalingConfigurations to query and verify the modification result.

    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:ModifyEciScalingConfiguration

    update

    *ScalingGroup

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ScalingConfigurationId

    string

    Yes

    The ID of the scaling configuration that you want to modify.

    asc-bp16har3jpj6fjbx****
    ScalingConfigurationName

    string

    No

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

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

    test-modify
    SecurityGroupId

    string

    No

    The ID of the security group to which the ECI instance belongs. ECI instances in the same security group can access each other.

    If you do not specify a security group, the system uses the default security group in the region that you select. Make sure that the inbound rules of the security group contain the protocols and ports that the containers need to expose. If no default security group exists in the region, the system uses automatic creation to create a default security group and adds the container protocols and ports that you declare to the inbound rules of the security group.

    sg-uf66jeqopgqa9hdn****
    ContainerGroupName

    string

    No

    The name of the ECI instance, which is also the container group name. The name must meet the following requirements:

    • The name must be 2 to 128 characters in length.

    • The name can contain lowercase letters, digits, and hyphens (-). It cannot start or end with a hyphen (-).

    nginx-test
    RestartPolicy

    string

    No

    The restart policy of the instance. Valid values:

    • Always: always restarts the instance.

    • Never: never restarts the instance.

    • OnFailure: restarts the instance upon failure.

    Default value: Always.

    Always
    Cpu

    number

    No

    The number of vCPUs at the instance level. Unit: cores.

    1.0
    Memory

    number

    No

    The memory size at the instance level. Unit: GiB.

    2.0
    ResourceGroupId

    string

    No

    The resource group ID.

    rg-uf66jeqopgqa9hdn****
    DnsPolicy

    string

    No

    The DNS policy. Valid values:

    • None: uses the DNS configured by the DnsConfig field.

    • Default: inherits the DNS settings from the runtime environment.

    Default
    ImageSnapshotId

    string

    No

    The image cache ID.

    imc-2zebxkiifuyzzlhl****
    RamRoleName

    string

    No

    The name of the instance RAM role. ECI and ECS share the same instance RAM role. For more information, see Use an instance RAM role by calling API operations.

    RamTestRole
    TerminationGracePeriodSeconds

    integer

    No

    The buffer time during which a program handles operations before the program is stopped. Unit: seconds.

    60
    AutoMatchImageCache

    boolean

    No

    Specifies whether to automatically match image caches. Valid values:

    • true: Automatically matches image caches.

    • false: Does not automatically match image caches.

    Default value: false.

    false
    Ipv6AddressCount

    integer

    No

    The number of IPv6 addresses.

    1
    ActiveDeadlineSeconds

    integer

    No

    The validity period. Unit: seconds.

    1000
    SpotStrategy

    string

    No

    The bidding policy for the instance. Valid values:

    • NoSpot: a pay-as-you-go instance.

    • SpotWithPriceLimit: a spot instance with a maximum price limit.

    • SpotAsPriceGo: a spot instance that uses the market price at the time of purchase as the bid price.

    Default value: NoSpot.

    SpotPriceLimit
    SpotPriceLimit

    number

    No

    The maximum hourly price of the spot instance. The value can be accurate to three decimal places.

    This parameter is required when SpotStrategy is set to SpotWithPriceLimit.

    0.025
    AutoCreateEip

    boolean

    No

    Specifies whether to automatically create an elastic IP address (EIP) and attach it to the ECI instance.

    true
    EipBandwidth

    integer

    No

    The bandwidth of the EIP.

    Default value: 5 Mbit/s.

    5
    HostName

    string

    No

    The hostname, which is also the container group name.

    test
    IngressBandwidth

    integer

    No

    The inbound bandwidth limit. Unit: bytes.

    1024000
    EgressBandwidth

    integer

    No

    The outbound bandwidth limit. Unit: bytes.

    1024000
    CpuOptionsCore

    integer

    No

    The number of physical CPU cores. Only specific instance types support custom settings. For more information, see Customize CPU options.

    2
    CpuOptionsThreadsPerCore

    integer

    No

    The number of threads per core. Only specific instance types support custom settings. A value of 1 indicates that hyper-threading is disabled. For more information, see Customize CPU options.

    2
    EphemeralStorage

    integer

    No

    The size of the ephemeral storage. ESSD PL1 cloud disks are used by default. Unit: GiB.

    20
    LoadBalancerWeight

    integer

    No

    The weight of the backend server. Valid values: 1 to 100.

    50
    Tag

    array<object>

    No

    The tag key-value pairs of the instance.

    object

    No

    The tag key-value pairs of the instance.

    Key

    string

    No

    The tag key.

    version
    Value

    string

    No

    The tag value.

    3
    ImageRegistryCredential

    array<object>

    No

    The information about the image repository.

    object

    No

    The information about the image repository.

    Password

    string

    No

    The password of the image repository.

    yourpaasword
    Server

    string

    No

    The address of the image repository.

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

    string

    No

    The username of the image repository.

    yourusername
    Container

    array<object>

    No

    The list of containers in the instance.

    array<object>

    No

    The list of containers in the instance.

    ReadinessProbe.TimeoutSeconds

    integer

    No

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

    1
    ReadinessProbe.SuccessThreshold

    integer

    No

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

    1
    SecurityContext.Capability.Add

    array

    No

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

    Note

    NET_RAW 默认不支持，需提交工单申请。

    string

    No

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

    Note

    NET_RAW 默认不支持，需提交工单申请。

    NET_ADMIN
    ReadinessProbe.TcpSocket.Port

    integer

    No

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

    8000
    ReadinessProbe.HttpGet.Scheme

    string

    No

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

    • HTTP。

    • HTTPS。

    HTTP
    LivenessProbe.PeriodSeconds

    integer

    No

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

    5
    Port

    array<object>

    No

    The exposed ports and protocols.

    object

    No

    The exposed ports and protocols.

    Protocol

    string

    No

    The protocol type. Valid values:

    • TCP.

    • UDP.

    TCP
    Port

    integer

    No

    The port number. Valid values: 1 to 65535.

    80
    SecurityContext.ReadOnlyRootFilesystem

    boolean

    No

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

    true
    EnvironmentVar

    array<object>

    No

    The information about environment variables.

    object

    No

    The information about environment variables.

    Key

    string

    No

    The name of the environment variable. The name must be 1 to 128 characters in length and must match the format [0-9a-zA-Z] and underscores. It cannot start with a digit.

    PATH
    Value

    string

    No

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

    /usr/local/bin
    LivenessProbe.TcpSocket.Port

    integer

    No

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

    8000
    Tty

    boolean

    No

    Specifies whether to enable interaction. Default value: false.

    Set this parameter to true when Command is set to /bin/bash.

    false
    WorkingDir

    string

    No

    The working directory of the container.

    /usr/local/
    LivenessProbe.HttpGet.Scheme

    string

    No

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

    • HTTP。

    • HTTPS。

    HTTP
    ReadinessProbe.HttpGet.Port

    integer

    No

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

    8080
    Arg

    array

    No

    The arguments that correspond to the startup command of the container. A maximum of 10 arguments are supported.

    string

    No

    The arguments that correspond to the startup command of the container. A maximum of 10 arguments are supported.

    100
    Gpu

    integer

    No

    The number of GPUs for the container.

    1
    ReadinessProbe.InitialDelaySeconds

    integer

    No

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

    3
    Stdin

    boolean

    No

    Specifies whether this container should allocate a buffer for standard input in the container runtime. If this parameter is not set, reads from standard input in the container will result in EOF.

    Default value: false.

    false
    Memory

    number

    No

    The memory size of the container. Unit: GiB.

    0.5
    Name

    string

    No

    The name of the container image.

    nginx
    Image

    string

    No

    The container image.

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

    integer

    No

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

    5
    VolumeMount

    array<object>

    No

    The volume mount information.

    object

    No

    The volume mount information.

    MountPropagation

    string

    No

    The mount propagation setting of the volume. Mount propagation allows volumes mounted by a container to be shared with other containers in the same pod, or even with other pods on the same node. Valid values:

    • None: the volume does not sense any subsequent mounts performed on this volume or its subdirectories.

    • HostToCotainer: the volume senses subsequent mounts performed on this volume or its subdirectories.

    • Bidirectional: similar to HostToCotainer, the volume senses mount operations. In addition, the volume is propagated back to the host and all containers of all pods that use the same volume.

    Default value: None.

    None
    MountPath

    string

    No

    The directory to which the volume is mounted in the container.

    Important The content in the container mount directory is overwritten by the content of the volume. Use this parameter with caution.
    .

    /pod/data
    ReadOnly

    boolean

    No

    Specifies whether the volume is read-only.

    • true: read-only.

    • false: read and write.

    Default value: false.

    false
    Name

    string

    No

    The name of the volume. This value is the same as the Name value in Volume.

    default-volume1
    SubPath

    string

    No

    The sub-path of the volume.

    data2/
    LivenessProbe.FailureThreshold

    integer

    No

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

    默认值：3。

    3
    ReadinessProbe.Exec.Command

    array

    No

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

    string

    No

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

    cat/tmp/healthy
    ReadinessProbe.FailureThreshold

    integer

    No

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

    默认值：3。

    3
    ImagePullPolicy

    string

    No

    The image pull policy of the container. Valid values:

    • Always: always pulls the image. The image is pulled each time.

    • IfNotPresent: pulls the image only when needed. The local image is used first. If no local image is available, the image is pulled.

    • Never: never pulls the image. Only the local image is used.

    Always
    StdinOnce

    boolean

    No

    Specifies whether the standard input stream remains in the enabling status across multiple attach sessions when standard input is set to true.

    If StdinOnce is set to true, standard input is opened when the container starts and remains empty until the first client attaches to it. It then remains open and accepts data until the client disconnects, at which point standard input undergoes shutdown and remains closed until the container restarts.

    false
    Cpu

    number

    No

    The number of vCPUs of the container. Unit: cores.

    0.25
    LivenessProbe.HttpGet.Port

    integer

    No

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

    8888
    LivenessProbe.HttpGet.Path

    string

    No

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

    /healthyz
    LivenessProbe.SuccessThreshold

    integer

    No

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

    1
    ReadinessProbe.PeriodSeconds

    integer

    No

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

    3
    LivenessProbe.TimeoutSeconds

    integer

    No

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

    1
    Command

    array

    No

    The startup commands of the container. A maximum of 20 commands are supported. Each command can contain up to 256 characters.

    string

    No

    The startup commands of the container. A maximum of 20 commands are supported. Each command can contain up to 256 characters.

    sleep
    SecurityContext.RunAsUser

    integer

    No

    设置运行容器的用户 ID。

    1000
    ReadinessProbe.HttpGet.Path

    string

    No

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

    /healthz
    LivenessProbe.Exec.Command

    array

    No

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

    string

    No

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

    cat /tmp/healthy
    LifecyclePostStartHandlerHttpGetHost

    string

    No

    The host address that receives the HTTP Get request when the HTTP request method is used to set the PostStart callback function.

    10.0.XX.XX
    LifecyclePostStartHandlerHttpGetPort

    integer

    No

    The port number for HTTP Get request detection when the HTTP request method is used to set the PostStart callback function.

    5050
    LifecyclePostStartHandlerHttpGetPath

    string

    No

    The path for HTTP Get request detection when the HTTP request method is used to set the PostStart callback function.

    /healthyz
    LifecyclePostStartHandlerHttpGetScheme

    string

    No

    The protocol type for HTTP Get requests when the HTTP request method is used to set the PostStart callback function. Valid values:

    • HTTP.

    • HTTPS.

    HTTPS
    LifecyclePostStartHandlerExec

    array

    No

    The command to run in the container when the command-line method is used to set the PostStart callback function.

    string

    No

    The command to run in the container when the command-line method is used to set the PostStart callback function.

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

    string

    No

    The host address for TCP Socket detection when the TCP Socket method is used to set the PostStart callback function.

    10.0.XX.XX
    LifecyclePostStartHandlerTcpSocketPort

    integer

    No

    The port for TCP Socket detection when the TCP Socket method is used to set the PostStart callback function.

    80
    LifecyclePreStopHandlerHttpGetHost

    string

    No

    The host address that receives the HTTP Get request when the HTTP request method is used to set the PreStop callback function.

    10.0.XX.XX
    LifecyclePreStopHandlerHttpGetPort

    integer

    No

    The port number for HTTP Get request detection when the HTTP request method is used to set the PreStop callback function.

    80
    LifecyclePreStopHandlerHttpGetPath

    string

    No

    The path for HTTP Get request detection when the HTTP request method is used to set the PreStop callback function.

    /healthyz
    LifecyclePreStopHandlerHttpGetScheme

    string

    No

    The protocol type for HTTP Get requests when the HTTP request method is used to set the PreStop callback function. Valid values:

    • HTTP.

    • HTTPS.

    HTTP
    LifecyclePreStopHandlerExec

    array

    No

    The command to run in the container when the command-line method is used to set the PreStop callback function.

    string

    No

    The command to run in the container when the command-line method is used to set the PreStop callback function.

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

    string

    No

    The host address for TCP Socket detection when the TCP Socket method is used to set the PreStop callback function.

    10.0.XX.XX
    LifecyclePreStopHandlerTcpSocketPort

    integer

    No

    The port for TCP Socket detection when the TCP Socket method is used to set the PreStop callback function.

    80
    Volume

    array<object>

    No

    The volume information.

    array<object>

    No

    The volume information.

    Type

    string

    No

    The type of the volume. Valid values:

    • EmptyDirVolume.

    • NFSVolume.

    • ConfigFileVolume.

    • FlexVolume.

    EmptyDirVolume
    DiskVolume.DiskSize

    integer

    No

    DiskVolume 的大小。单位：GiB。

    15
    NFSVolume.Path

    string

    No

    NFS 数据卷路径。

    /share
    FlexVolume.FsType

    string

    No

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

    ext4
    DiskVolume.FsType

    string

    No

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

    xfs
    HostPathVolume.Type

    string

    No

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

    Directory
    NFSVolume.ReadOnly

    boolean

    No

    NFS 数据卷是否只读。

    • true：只读。

    • false：可读可写。

    默认值：false。

    false
    HostPathVolume.Path

    string

    No

    Host 上的绝对路径。

    /xx/xx/name
    FlexVolume.Options

    string

    No

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

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

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

    string

    No

    用于 FlexVolume 的驱动程序名称。

    flexvolume
    ConfigFileVolumeDefaultMode

    integer

    No

    The default permissions of the ConfigFileVolume.

    0644
    NFSVolume.Server

    string

    No

    NFS 服务器地址。

    3f9cd4a596-n****.cn-shanghai.nas.aliyuncs.com
    DiskVolume.DiskId

    string

    No

    DiskVolume 的 ID。

    d-xx
    Name

    string

    No

    The name of the volume.

    default-volume1
    EmptyDirVolume.Medium

    string

    No

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

    memory
    ConfigFileVolumeConfigFileToPath

    array<object>

    No

    The list of configuration file paths.

    object

    No

    The list of configuration file paths.

    Path

    string

    No

    The relative file path.

    /usr/bin/
    Mode

    integer

    No

    The permissions of the ConfigFileVolume directory.

    0644
    Content

    string

    No

    The content of the configuration file (32 KB).

    bGl1bWk=
    EmptyDirVolume.SizeLimit

    string

    No

    EmptyDir 数据卷的大小。取值时请带上单位，建议使用 Gi 或 Mi。

    256 Mi
    InitContainer

    array<object>

    No

    The list of init containers.

    array<object>

    No

    The list of init containers.

    InitContainerEnvironmentVar

    array<object>

    No

    The information about environment variables.

    object

    No

    The information about environment variables.

    Key

    string

    No

    The name of the environment variable. The name must be 1 to 128 characters in length and must match the format [0-9a-zA-Z] and underscores. It cannot start with a digit.

    Path
    Value

    string

    No

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

    /usr/bin/
    SecurityContext.Capability.Add

    array

    No

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

    Note

    NET_RAW 默认不支持，需提交工单申请。

    string

    No

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

    Note

    NET_RAW 默认不支持，需提交工单申请。

    NET_ADMIN
    Image

    string

    No

    The image used by the container.

    nginx
    InitContainerVolumeMount

    array<object>

    No

    The volume mount information.

    object

    No

    The volume mount information.

    MountPropagation

    string

    No

    The mount propagation setting of the volume. Mount propagation allows volumes mounted by a container to be shared with other containers in the same pod, or even with other pods on the same node. Valid values:

    • None: the volume does not sense any subsequent mounts performed on this volume or its subdirectories.

    • HostToCotainer: the volume senses subsequent mounts performed on this volume or its subdirectories.

    • Bidirectional: similar to HostToCotainer, the volume senses mount operations. In addition, the volume is propagated back to the host and all containers of all pods that use the same volume.

    Default value: None.

    None
    MountPath

    string

    No

    The mount directory.

    Important The content in the container mount directory is overwritten by the content of the volume. Use this parameter with caution.
    .

    /usr/share/
    ReadOnly

    boolean

    No

    Specifies whether the mount path is read-only.

    • true: read-only.

    • false: read and write.

    Default value: false.

    false
    Name

    string

    No

    The name of the mounted volume.

    test-empty
    SubPath

    string

    No

    The subdirectory of the volume. This allows a pod to mount different directories of the same volume to different directories in the container.

    /usr/sub/
    ImagePullPolicy

    string

    No

    The image pull policy. Valid values:

    • Always: always pulls the image. The image is pulled each time.

    • IfNotPresent: pulls the image only when needed. The local image is used first. If no local image is available, the image is pulled.

    • Never: never pulls the image. Only the local image is used.

    Always
    Cpu

    number

    No

    The number of vCPUs of the container. Unit: cores.

    0.5
    WorkingDir

    string

    No

    The working directory.

    /usr/local
    Command

    array

    No

    The startup commands of the container.

    string

    No

    The startup commands of the container.

    sleep
    Arg

    array

    No

    The startup arguments of the container.

    string

    No

    The startup arguments of the container.

    10
    SecurityContext.RunAsUser

    integer

    No

    设置运行容器的用户 ID。

    587
    Gpu

    integer

    No

    The number of GPUs for the container.

    1
    Memory

    number

    No

    The memory size. Unit: GiB.

    1.0
    Name

    string

    No

    The container name.

    test-init
    DnsConfigNameServer

    array

    No

    The list of IP addresses of DNS servers.

    string

    No

    The list of IP addresses of DNS servers.

    172.10.*.**
    DnsConfigSearch

    array

    No

    The list of DNS search domains.

    string

    No

    The list of DNS search domains.

    svc.local.kubenetes
    DnsConfigOption

    array<object>

    No

    The list of object options. Each object consists of a Name and an optional Value.

    object

    No

    The list of object options. Each object consists of a Name and an optional Value.

    Value

    string

    No

    The value of the object variable.

    value
    Name

    string

    No

    The name of the object variable.

    name
    HostAliase

    array<object>

    No

    The custom hostname mapping for a container in the instance.

    object

    No

    The custom hostname mapping for a container in the instance.

    Ip

    string

    No

    The IP address to add.

    192.0.XX.XX
    Hostname

    array

    No

    The hostname to add.

    string

    No

    The hostname to add.

    ['hehe.com', 'haha.com']
    SecurityContextSysctl

    array<object>

    No

    The security context in which the container group runs.

    object

    No

    The security context in which the container group runs.

    Value

    string

    No

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

    65536
    Name

    string

    No

    The system name of the security context in which the instance runs.

    kernel.msgmax
    NtpServer

    array

    No

    The NTP server.

    string

    No

    The NTP server.

    ntp.cloud.aliyuncs.com
    AcrRegistryInfo

    array<object>

    No

    The information about the ACR Enterprise instance.

    object

    No

    The information about the ACR Enterprise instance.

    Domain

    array

    No

    The domain name of the ACR Enterprise instance. By default, all domain names of the instance are used. You can specify individual domain names. Separate multiple domain names with commas (,).

    string

    No

    The domain name of the ACR Enterprise instance. By default, all domain names of the instance are used. You can specify individual domain names. Separate multiple domain names with commas (,).

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

    string

    No

    The name of the ACR Enterprise instance.

    acr-test
    InstanceId

    string

    No

    The instance ID of the ACR Enterprise instance.

    cri-nwj395hgf6f3****
    RegionId

    string

    No

    The region of the ACR Enterprise instance.

    cn-hangzhou
    CostOptimization

    boolean

    No

    Specifies whether to enable cost optimization. Valid values:

    • true: Enabled.

    • false: Not enabled.

    Default value: false.

    false
    InstanceFamilyLevel

    string

    No

    The level of the instance family, which is used to filter instance types that meet the requirements. This parameter takes effect when CostOptimization is enabled. Valid values:

    • EntryLevel: shared instance types. Lower cost, but instance computing performance is not guaranteed to be stable. Applicable to scenarios with low CPU usage. For more information, see Shared instance families.

    • EnterpriseLevel: enterprise-level instance types. Stable performance with dedicated resources. Applicable to scenarios that require high stability. For more information, see Instance families.

    • CreditEntryLevel: burstable instance types. CPU credits are used to ensure computing performance. Applicable to scenarios with low average CPU usage and occasional bursts. For more information, see Overview of burstable instances.

    EnterpriseLevel
    ContainersUpdateType

    string

    No

    The control request parameter for the Containers parameter update method. Valid values:

    • RenewUpdate: full update. The Containers request parameters in the update request overwrite the existing Containers parameter configurations.

    • IncrementalUpdate: incremental update. Containers are matched by Containers.Name, and only the request parameters specified in the request are updated. Parameters that are not specified are not updated.

    Default value: RenewUpdate.

    RenewUpdate
    InstanceType

    array

    No

    The specified ECS instance types. You can specify up to five instance types.

    string

    No

    The specified ECS instance type. You can specify up to five instance types. For more information, see Create instances by specifying ECS instance types.

    ecs.g6.large
    DataCacheBucket

    string

    No

    The data cache bucket.

    default
    DataCachePL

    string

    No

    数据缓存使用的云盘的性能等级。建议优先使用 ESSD 云盘，该云盘的性能等级取值范围：

    • PL0：单盘最高随机读写 IOPS 1 万。

    • PL1：单盘最高随机读写 IOPS 5 万。

    • PL2：单盘最高随机读写 IOPS 10 万。

    • PL3：单盘最高随机读写 IOPS 100 万。

    默认值：PL1。

    Note

    关于 ESSD 云盘的更多信息，请参见 ESSD 云盘。

    PL1
    DataCacheProvisionedIops

    integer

    No

    The provisioned read/write IOPS of the ESSD AutoPL disk when the data cache uses an ESSD AutoPL disk. Valid values: 0 to min{50000, 1000 × Capacity - Baseline performance}, where Baseline performance = min{1800 + 50 × Capacity, 50000}.

    Note

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

    40000
    DataCacheBurstingEnabled

    boolean

    No

    Specifies whether to enable burst (performance bursting) when the data cache uses an ESSD AutoPL disk. Valid values:

    • true: Enabled.

    • false: Not enabled.

    Default value: false.

    Note

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

    false
    GpuDriverVersion

    string

    No

    The GPU driver version. Valid values:

    • tesla=470.82.01 (default)

    • tesla=525.85.12

    Note

    Only specific instance types support switching the GPU driver version. For more information, see Create instances by specifying GPU specifications.

    tesla=525.85.12
    Override

    boolean

    No

    Specifies whether to overwrite. Valid values:

    • true: Overwrite.

    • false: Do not overwrite.

    false

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID, which is a unique identifier.

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

    Examples

    Success response

    JSON format

    {
  "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.