All Products
Search

This Product

    Auto Scaling：ModifyEciScalingConfiguration

    Document Center

    Auto Scaling：ModifyEciScalingConfiguration

    更新時間：Dec 24, 2024

    Modifies a scaling configuration of the Elastic Container Instance type. When you call the ModifyEciScalingConfiguration operation, you can specify the ID, name, and instance properties of the scaling configuration whose information you want to modify. You can modify the instance restart policy, instance bidding policy, and elastic IP address (EIP) bandwidth.

    Usage notes

    • If you want to modify the name of a scaling configuration in a scaling group, make sure that the new name is unique in the scaling group.

    • You can call the DescribeEciScalingConfiguration operation to check the modification result.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

    Request parameters

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    ModifyEciScalingConfiguration

    The operation that you want to perform. Set the value to ModifyEciScalingConfiguration.

    ScalingConfigurationId

    String

    Yes

    asc-bp16har3jpj6fjbx****

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

    ScalingConfigurationName

    String

    Yes

    test-modify

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

    The name of the scaling configuration must be unique in a region. If you leave this parameter empty, the scaling configuration ID is used.

    SecurityGroupId

    String

    Yes

    sg-uf66jeqopgqa9hdn****

    The ID of the security group with which you want to associate elastic container instances created from the scaling configuration. Elastic container instances that are associated with 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 region that you selected. Make sure that the inbound rules of the security group contain the protocols and the port numbers of the containers that you want to expose. If a default security group does not exist in the region, the system automatically creates a default security group and adds the specified container protocols and ports to the inbound rules of the security group.

    ContainerGroupName

    String

    Yes

    nginx-test

    The name series of elastic container instances. Naming conventions:

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

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

    RestartPolicy

    String

    No

    Always

    The instance restart policy. Valid values:

    • Always: always restarts elastic container instances.

    • Never: never restarts elastic container instances.

    • OnFailure: restarts elastic container instances upon failure.

    Default value: Always.

    Cpu

    Float

    No

    1.0

    The number of vCPUs per elastic container instance.

    Memory

    Float

    No

    2.0

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

    ResourceGroupId

    String

    No

    rg-uf66jeqopgqa9hdn****

    The ID of the resource group.

    DnsPolicy

    String

    No

    Default

    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.

    ImageSnapshotId

    String

    No

    imc-2zebxkiifuyzzlhl****

    The ID of the image cache.

    RamRoleName

    String

    No

    RamTestRole

    The name of the Resource Access Management (RAM) role that you want to assign to elastic container instances. Elastic container instances and Elastic Compute Service (ECS) instances can share the same RAM role. For more information, see Use an instance RAM role by calling API operations.

    TerminationGracePeriodSeconds

    Long

    No

    60

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

    AutoMatchImageCache

    Boolean

    No

    false

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

    • true

    • false

    Default value: false.

    Ipv6AddressCount

    Integer

    No

    1

    The number of IPv6 addresses.

    ActiveDeadlineSeconds

    Long

    No

    1000

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

    SpotStrategy

    String

    No

    SpotPriceLimit

    The bidding policy of elastic container instances. Valid values:

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

    • SpotWithPriceLimit: The elastic container instances are preemptible instances for which you can specify the maximum hourly price.

    • SpotAsPriceGo: The elastic container instances are created as preemptible instances for which the market price at the time of purchase is used as the bid price.

    Default value: NoSpot.

    SpotPriceLimit

    Float

    No

    0.025

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

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

    AutoCreateEip

    Boolean

    No

    true

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

    EipBandwidth

    Integer

    No

    5

    The EIP bandwidth.

    Default value: 5. Unit: Mbit/s.

    HostName

    String

    No

    test

    The hostname series of elastic container instances.

    IngressBandwidth

    Long

    No

    1024000

    The maximum inbound bandwidth. Unit: bit/s.

    EgressBandwidth

    Long

    No

    1024000

    The maximum outbound bandwidth. Unit: bit/s.

    CpuOptionsCore

    Integer

    No

    2

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

    CpuOptionsThreadsPerCore

    Integer

    No

    2

    The number of threads per core. You can specify this parameter only for specific instance types. If you set this parameter to 1, Hyper-Threading is disabled. For more information, see Specify CPU options.

    EphemeralStorage

    Integer

    No

    20

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

    LoadBalancerWeight

    Integer

    No

    50

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

    Tag.N.Key

    String

    No

    version

    The key of tag N.

    Tag.N.Value

    String

    No

    3

    The value of tag N.

    ImageRegistryCredential.N.Password

    String

    No

    yourpaasword

    The password that you can use to access image repository N.

    ImageRegistryCredential.N.Server

    String

    No

    registry-vpc.cn-shanghai.aliyuncs.com

    The domain name of image repository N.

    ImageRegistryCredential.N.UserName

    String

    No

    yourusername

    The username of image repository N.

    Container.N.ReadinessProbe.TimeoutSeconds

    Integer

    No

    1

    The time limit within which a readiness probe must be completed. Default value: 1. Minimum value: 1.

    Container.N.ReadinessProbe.SuccessThreshold

    Integer

    No

    1

    The minimum number of consecutive successes before a failed readiness probe is considered successful. Default value: 1. Set the value to 1.

    Container.N.SecurityContext.Capability.Add.N

    String

    No

    NET_ADMIN

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

    Note

    If you want to use NET_RAW, submit a ticket.

    Container.N.ReadinessProbe.TcpSocket.Port

    Integer

    No

    8000

    The port detected by the TCP sockets that you want to use to perform readiness probes.

    Container.N.ReadinessProbe.HttpGet.Scheme

    String

    No

    HTTP

    The protocol type of the HTTP GET requests that you want to use to perform readiness probes. Valid values:

    • HTTP

    • HTTPS

    Container.N.LivenessProbe.PeriodSeconds

    Integer

    No

    5

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

    Container.N.Port.N.Protocol

    String

    No

    TCP

    The protocol type. Valid values:

    • TCP

    • UDP

    Container.N.Port.N.Port

    Integer

    No

    80

    The port number. Valid values: 1 to 65535.

    Container.N.SecurityContext.ReadOnlyRootFilesystem

    Boolean

    No

    true

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

    Container.N.EnvironmentVar.N.Key

    String

    No

    PATH

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

    Container.N.EnvironmentVar.N.Value

    String

    No

    /usr/local/bin

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

    Container.N.LivenessProbe.TcpSocket.Port

    Integer

    No

    8000

    The port detected by the TCP sockets that you want to use to perform readiness probes.

    Container.N.Tty

    Boolean

    No

    false

    Specifies whether to enable the Interaction feature. Default value: false.

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

    Container.N.WorkingDir

    String

    No

    /usr/local/

    The working directory of container N.

    Container.N.LivenessProbe.HttpGet.Scheme

    String

    No

    HTTP

    The protocol type of the HTTP GET requests that you want to use to perform liveness probes. Valid values:

    • HTTP

    • HTTPS

    Container.N.ReadinessProbe.HttpGet.Port

    Integer

    No

    8080

    The port over which you want to send the HTTP GET requests to perform readiness probes.

    Container.N.Arg.N

    String

    No

    100

    Argument N that corresponds to the command that you run to start container N. Maximum value of N: 10.

    Container.N.Gpu

    Integer

    No

    1

    The number of GPUs of container N.

    Container.N.ReadinessProbe.InitialDelaySeconds

    Integer

    No

    3

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

    Container.N.Stdin

    Boolean

    No

    false

    Specifies whether container N allocates buffer resources to standard input streams during the active container runtime. If you do not specify this parameter, an end-of-file (EOF) error may occur.

    Default value: false.

    Container.N.Memory

    Float

    No

    0.5

    The memory size of container N. Unit: GiB.

    Container.N.Name

    String

    No

    nginx

    The image name of container N.

    Container.N.Image

    String

    No

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

    The image of container N.

    Container.N.LivenessProbe.InitialDelaySeconds

    Integer

    No

    5

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

    Container.N.VolumeMount.N.MountPropagation

    String

    No

    None

    The mount propagation settings of volume N. Mount propagation allows you to share volumes that are mounted on a container to other containers in the same pod or to other 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. Volume mounts executed on the container are also propagated back to the underlying instance and to all containers across pods that use the same volume.

    Default value: None.

    Container.N.VolumeMount.N.MountPath

    String

    No

    /pod/data

    The directory to which you want to mount volume N.

    Important

    After you mount the volume to the directory, the data in the directory is overwritten by data on the volume. Proceed with caution.

    Container.N.VolumeMount.N.ReadOnly

    Boolean

    No

    false

    Specifies whether volume N is read-only.

    • true

    • false

    Default value: false.

    Container.N.VolumeMount.N.Name

    String

    No

    default-volume1

    The name of volume N that you want to mount to container N. The value of this parameter is the same as the value of Volumne.N.Name.

    Container.N.VolumeMount.N.SubPath

    String

    No

    data2/

    The subdirectory of volume N.

    Container.N.LivenessProbe.FailureThreshold

    Integer

    No

    3

    The minimum number of consecutive failures before a successful liveness probe is considered failed.

    Default value: 3.

    Container.N.ReadinessProbe.Exec.Command.N

    String

    No

    cat/tmp/healthy

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

    Container.N.ReadinessProbe.FailureThreshold

    Integer

    No

    3

    The minimum number of consecutive failures before a successful readiness probe is considered failed.

    Default value: 3.

    Container.N.ImagePullPolicy

    String

    No

    Always

    The image pulling policy. Valid values:

    • Always: pulls images each time instances are created.

    • IfNotPresent: pulls images based on your business requirements. On-premises images are preferentially used. If no on-premises images are available, image pulling is performed.

    • Never: never pulls images. On-premises images are always used.

    Container.N.StdinOnce

    Boolean

    No

    false

    Specifies whether standard input streams remain connected during multiple sessions when Container.N.StdinOnce is set to true.

    If you set Container.N.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, the streams are also disconnected and remain disconnected until the container is restarted.

    Container.N.Cpu

    Float

    No

    0.25

    The number of vCPUs of container N.

    Container.N.LivenessProbe.HttpGet.Port

    Integer

    No

    8888

    The port over which you want to send the HTTP GET requests to perform liveness probes.

    Container.N.LivenessProbe.HttpGet.Path

    String

    No

    /healthyz

    The path to which you want to send the HTTP GET requests to perform liveness probes.

    Container.N.LivenessProbe.SuccessThreshold

    Integer

    No

    1

    The minimum number of consecutive successes before a failed liveness probe is considered successful. Default value: 1. Set the value to 1.

    Container.N.ReadinessProbe.PeriodSeconds

    Integer

    No

    3

    The time interval between consecutive readiness probes. Unit: seconds. Default value: 10. Minimum value: 1.

    Container.N.LivenessProbe.TimeoutSeconds

    Integer

    No

    1

    The time limit within which a liveness probe must be completed. Default value: 1. Minimum value: 1.

    Container.N.Command.N

    String

    No

    sleep

    Command N that you want to run to start container N. Maximum value of N: 20. Each command can contain up to 256 characters.

    Container.N.SecurityContext.RunAsUser

    Long

    No

    1000

    The ID of the user that runs container N.

    Container.N.ReadinessProbe.HttpGet.Path

    String

    No

    /healthz

    The path to which you want to send the HTTP GET requests to perform readiness probes.

    Container.N.LivenessProbe.Exec.Command.N

    String

    No

    cat /tmp/healthy

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

    Container.N.LifecyclePostStartHandlerHttpGetHost

    String

    No

    10.0.XX.XX

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

    Container.N.LifecyclePostStartHandlerHttpGetPort

    Integer

    No

    5050

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

    Container.N.LifecyclePostStartHandlerHttpGetPath

    String

    No

    /healthyz

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

    Container.N.LifecyclePostStartHandlerHttpGetScheme

    String

    No

    HTTPS

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

    • HTTP

    • HTTPS

    Container.N.LifecyclePostStartHandlerExec.N

    String

    No

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

    The command that you want to run by using the CLI within container N to specify the PostStart callback function.

    Container.N.LifecyclePostStartHandlerTcpSocketHost

    String

    No

    10.0.XX.XX

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

    Container.N.LifecyclePostStartHandlerTcpSocketPort

    Integer

    No

    80

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

    Container.N.LifecyclePreStopHandlerHttpGetHost

    String

    No

    10.0.XX.XX

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

    Container.N.LifecyclePreStopHandlerHttpGetPort

    Integer

    No

    80

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

    Container.N.LifecyclePreStopHandlerHttpGetPath

    String

    No

    /healthyz

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

    Container.N.LifecyclePreStopHandlerHttpGetScheme

    String

    No

    HTTP

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

    • HTTP

    • HTTPS

    Container.N.LifecyclePreStopHandlerExec.N

    String

    No

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

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

    Container.N.LifecyclePreStopHandlerTcpSocketHost

    String

    No

    10.0.XX.XX

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

    Container.N.LifecyclePreStopHandlerTcpSocketPort

    Integer

    No

    80

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

    Volume.N.Type

    String

    No

    EmptyDirVolume

    The type of volume N. Valid values:

    • EmptyDirVolume

    • NFSVolume

    • ConfigFileVolume

    • FlexVolume

    Volume.N.DiskVolume.DiskSize

    Integer

    No

    15

    The storage size of the disk volume. Unit: GiB.

    Volume.N.NFSVolume.Path

    String

    No

    /share

    The path to the Network File System (NFS) volume.

    Volume.N.FlexVolume.FsType

    String

    No

    ext4

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

    Volume.N.DiskVolume.FsType

    String

    No

    xfs

    We recommend that you specify FlexVolume.FsType.

    Volume.N.HostPathVolume.Type

    String

    No

    Directory

    The type of the host path. Examples: File, Directory, and Socket.

    Volume.N.NFSVolume.ReadOnly

    Boolean

    No

    false

    Specifies whether the NFS volume is read-only.

    • true

    • false

    Default value: false.

    Volume.N.HostPathVolume.Path

    String

    No

    /xx/xx/name

    The absolute path to the Host volume.

    Volume.N.FlexVolume.Options

    String

    No

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

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

    For example, when you use a Flex volume to mount a disk, specify the option in the {"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"} format.

    Volume.N.FlexVolume.Driver

    String

    No

    flexvolume

    The driver name of the Flex volume.

    Volume.N.ConfigFileVolumeDefaultMode

    Integer

    No

    0644

    The default permissions on the configuration file.

    Volume.N.NFSVolume.Server

    String

    No

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

    The endpoint of the NFS server.

    Volume.N.DiskVolume.DiskId

    String

    No

    d-xx

    The ID of the disk volume.

    Volume.N.Name

    String

    No

    default-volume1

    The name of the volume.

    Volume.N.EmptyDirVolume.Medium

    String

    No

    memory

    The storage medium of the EmptyDir volume. If you leave this parameter empty, the file system of the node is used as the storage medium. If you set this parameter to memory, the memory is used as the storage medium.

    Volume.N.ConfigFileVolumeConfigFileToPath.N.Path

    String

    No

    /usr/bin/

    The relative path to the configuration file.

    Volume.N.ConfigFileVolumeConfigFileToPath.N.Mode

    Integer

    No

    0644

    The permissions on the ConfigFileVolume directory.

    Volume.N.ConfigFileVolumeConfigFileToPath.N.Content

    String

    No

    bGl1bWk=

    The content of the configuration file (32 KB).

    Volume.N.EmptyDirVolume.SizeLimit

    String

    No

    256 Mi

    The storage size of the EmptyDir volume. Unit: Gi or Mi.

    InitContainer.N.InitContainerEnvironmentVar.N.Key

    String

    No

    Path

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

    InitContainer.N.InitContainerEnvironmentVar.N.Value

    String

    No

    /usr/bin/

    The value of environment variable N for init container N. The value can be up to 256 characters in length.

    InitContainer.N.SecurityContext.Capability.Add.N

    String

    No

    NET_ADMIN

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

    Note

    If you want to use NET_RAW, submit a ticket.

    InitContainer.N.Image

    String

    No

    nginx

    The image of init container N.

    InitContainer.N.InitContainerVolumeMount.N.MountPropagation

    String

    No

    None

    The mount propagation settings of volume N. Mount propagation allows you to share volumes that are mounted on a container to other containers in the same pod or to other 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. Volume mounts executed on the container are also propagated back to the underlying instance and to all containers across pods that use the same volume.

    Default value: None.

    InitContainer.N.InitContainerVolumeMount.N.MountPath

    String

    No

    /usr/share/

    The directory of init container N to which the volume is mounted.

    Important

    After you mount the volume to the directory, the data in the directory is overwritten by data on the volume. Proceed with caution.

    InitContainer.N.InitContainerVolumeMount.N.ReadOnly

    Boolean

    No

    false

    Specifies whether the mount directory is read-only.

    • true

    • false

    Default value: false.

    InitContainer.N.InitContainerVolumeMount.N.Name

    String

    No

    test-empty

    The name of volume N that you want to mount.

    InitContainer.N.InitContainerVolumeMount.N.SubPath

    String

    No

    /usr/sub/

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

    InitContainer.N.ImagePullPolicy

    String

    No

    Always

    The image pulling policy. Valid values:

    • Always: pulls images each time instances are created.

    • IfNotPresent: pulls images only if no on-premises images are available. On-premises images are preferentially used. If no on-premises images are available, image pulling is performed.

    • Never: never pulls images. On-premises images are always used.

    InitContainer.N.Cpu

    Float

    No

    0.5

    The number of vCPUs per init container N.

    InitContainer.N.WorkingDir

    String

    No

    /usr/local

    The working directory of init container N.

    InitContainer.N.Command.N

    String

    No

    sleep

    Command N that you want to run to start init container N.

    InitContainer.N.Arg.N

    String

    No

    10

    Argument N that corresponds to the command that you run to start init container N.

    InitContainer.N.SecurityContext.RunAsUser

    Long

    No

    587

    The ID of the user that runs init container N.

    InitContainer.N.Gpu

    Integer

    No

    1

    The number of GPUs of init container N.

    InitContainer.N.Memory

    Float

    No

    1.0

    The memory size of init container N. Unit: GiB.

    InitContainer.N.Name

    String

    No

    test-init

    The name of init container N.

    DnsConfigNameServer.N

    String

    No

    172.10.*.**

    The IP addresses of DNS server N.

    DnsConfigSearch.N

    String

    No

    svc.local.kubenetes

    The search domains of DNS server N.

    DnsConfigOption.N.Value

    String

    No

    value

    The value of option N.

    DnsConfigOption.N.Name

    String

    No

    name

    The key of option N.

    HostAliase.N.Ip

    String

    No

    192.0.XX.XX

    The IP address of host N.

    HostAliase.N.Hostname.N

    String

    No

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

    The name of host N.

    SecurityContextSysctl.N.Value

    String

    No

    65536

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

    SecurityContextSysctl.N.Name

    String

    No

    kernel.msgmax

    The system name of security context N in which the elastic container instance is run.

    NtpServer.N

    String

    No

    ntp.cloud.aliyuncs.com

    The endpoint of Network Time Protocol (NTP) server N.

    AcrRegistryInfo.N.Domain.N

    String

    No

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

    The domain names of Container Registry Enterprise Edition instance N. By default, all domain names of instance N are displayed. You can specify specific domain names. Separate multiple domain names with commas (,).

    AcrRegistryInfo.N.InstanceName

    String

    No

    acr-test

    The name of Container Registry Enterprise Edition instance N.

    AcrRegistryInfo.N.InstanceId

    String

    No

    cri-nwj395hgf6f3****

    The ID of Container Registry Enterprise Edition instance N.

    AcrRegistryInfo.N.RegionId

    String

    No

    cn-hangzhou

    The region ID of Container Registry Enterprise Edition instance N.

    CostOptimization

    Boolean

    No

    false

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

    • true

    • false

    Default value: false.

    InstanceFamilyLevel

    String

    No

    EnterpriseLevel

    The level of the instance family. You can specify this parameter to obtain instance types that meet the specified criteria. 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 consistent computing performance. Instance types of this level are suitable for business 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 business scenarios in which CPU utilization is low but may fluctuate in specific scenarios. For more information about burstable instance types, see Overview.

    ContainersUpdateType

    String

    No

    RenewUpdate

    The update mode of containers. Valid values:

    • RenewUpdate: the full update mode. This value takes effect based on the value of Containers in an update request. This value specifies that the previous setting of Containers is overwritten.

    • IncrementalUpdate: the incremental update mode. You can use Containers.Name to specify containers in an update request. This value specifies that only the settings of the specified request parameters are updated.

    Default value: RenewUpdate.

    InstanceType.N

    String

    No

    ecs.g6.large

    ECS instance type N. Valid values of N: 1 to 5. For more information, see Specify ECS instance types to create an elastic container instance.

    DataCacheBucket

    String

    No

    default

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

    DataCachePL

    String

    No

    PL1

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

    • 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.

    DataCacheProvisionedIops

    Integer

    No

    40000

    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}, where Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.

    Note

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

    DataCacheBurstingEnabled

    Boolean

    No

    false

    Specifies whether to enable the Performance Burst feature for the ESSD AutoPL disk that you want to use to store data caches. Valid values:

    • true

    • false

    Default value: false.

    Note

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

    GpuDriverVersion

    String

    No

    tesla=525.85.12

    The version of the GPU driver. Valid values:

    • tesla=470.82.01 (default)

    • tesla=525.85.12

    Note

    You can change the GPU driver version of GPU-accelerated elastic container instances that use specific GPU-accelerated ECS instance types. For more information, see Specify GPU-accelerated ECS instance types to create an elastic container instance.

    Response parameters

    Parameter

    Type

    Example

    Description

    RequestId

    String

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

    The request ID.

    Examples

    Sample requests

    http(s)://ess.aliyuncs.com/?Action=ModifyEciScalingConfiguration
&ScalingConfigurationId=asc-bp16har3jpj6fjbx****
&ScalingConfigurationName=test-modify
&SecurityGroupId=sg-uf66jeqopgqa9hdn****
&ContainerGroupName=nginx-test
&RestartPolicy=Always
&Cpu=1.0
&Memory=2.0
&ResourceGroupId=rg-uf66jeqopgqa9hdn****
&DnsPolicy=Default
&ImageSnapshotId=imc-2zebxkiifuyzzlhl****
&RamRoleName=RamTestRole
&TerminationGracePeriodSeconds=60
&AutoMatchImageCache=false
&Ipv6AddressCount=1
&ActiveDeadlineSeconds=1000
&SpotStrategy=SpotPriceLimit
&SpotPriceLimit=0.025
&AutoCreateEip=true
&EipBandwidth=5
&HostName=test
&IngressBandwidth=1024000
&EgressBandwidth=1024000
&CpuOptionsCore=2
&CpuOptionsThreadsPerCore=2
&EphemeralStorage=20
&LoadBalancerWeight=50
&Tag=[{"Key":"version","Value":"3"}]
&ImageRegistryCredential=[{"Password":"yourpaasword","Server":"registry-vpc.cn-shanghai.aliyuncs.com","UserName":"yourusername"}]
&Container=[{"ReadinessProbe.TimeoutSeconds":1,"ReadinessProbe.SuccessThreshold":1,"SecurityContext.Capability.Add":["NET_ADMIN"],"ReadinessProbe.TcpSocket.Port":8000,"ReadinessProbe.HttpGet.Scheme":"HTTP","LivenessProbe.PeriodSeconds":5,"Port":[{"Protocol":"TCP","Port":80}],"SecurityContext.ReadOnlyRootFilesystem":true,"EnvironmentVar":[{"Key":"PATH","Value":"/usr/local/bin"}],"LivenessProbe.TcpSocket.Port":8000,"Tty":false,"WorkingDir":"/usr/local/","LivenessProbe.HttpGet.Scheme":"HTTP","ReadinessProbe.HttpGet.Port":8080,"Arg":["100"],"Gpu":1,"ReadinessProbe.InitialDelaySeconds":3,"Stdin":false,"Memory":0.5,"Name":"nginx","Image":"registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest","LivenessProbe.InitialDelaySeconds":5,"VolumeMount":[{"MountPropagation":"None","MountPath":"/pod/data","ReadOnly":false,"Name":"default-volume1","SubPath":"data2/"}],"LivenessProbe.FailureThreshold":3,"ReadinessProbe.Exec.Command":["cat/tmp/healthy"],"ReadinessProbe.FailureThreshold":3,"ImagePullPolicy":"Always","StdinOnce":false,"Cpu":0.25,"LivenessProbe.HttpGet.Port":8888,"LivenessProbe.HttpGet.Path":"/healthyz","LivenessProbe.SuccessThreshold":1,"ReadinessProbe.PeriodSeconds":3,"LivenessProbe.TimeoutSeconds":1,"Command":["sleep"],"SecurityContext.RunAsUser":1000,"ReadinessProbe.HttpGet.Path":"/healthz","LivenessProbe.Exec.Command":["cat /tmp/healthy"],"LifecyclePostStartHandlerHttpGetHost":"10.0.XX.XX","LifecyclePostStartHandlerHttpGetPort":5050,"LifecyclePostStartHandlerHttpGetPath":"/healthyz","LifecyclePostStartHandlerHttpGetScheme":"HTTPS","LifecyclePostStartHandlerExec":["[     \"/bin/sh\",      \"-c\",      \"echo Hello from the postStart handler   /usr/share/message\" ]"],"LifecyclePostStartHandlerTcpSocketHost":"10.0.XX.XX","LifecyclePostStartHandlerTcpSocketPort":80,"LifecyclePreStopHandlerHttpGetHost":"10.0.XX.XX","LifecyclePreStopHandlerHttpGetPort":80,"LifecyclePreStopHandlerHttpGetPath":"/healthyz","LifecyclePreStopHandlerHttpGetScheme":"HTTP","LifecyclePreStopHandlerExec":["[     \"/bin/sh\",     \"-c\",     \"echo Hello from the preStop handler  /usr/share/message\" ]"],"LifecyclePreStopHandlerTcpSocketHost":"10.0.XX.XX","LifecyclePreStopHandlerTcpSocketPort":80}]
&Volume=[{"Type":"EmptyDirVolume","DiskVolume.DiskSize":15,"NFSVolume.Path":"/share","FlexVolume.FsType":"ext4","DiskVolume.FsType":"xfs","HostPathVolume.Type":"Directory","NFSVolume.ReadOnly":false,"HostPathVolume.Path":"/xx/xx/name","FlexVolume.Options":"{\"volumeId\":\"d-2zehdahrwoa7srg****\",\"performanceLevel\": \"PL2\"}","FlexVolume.Driver":"flexvolume","ConfigFileVolumeDefaultMode":644,"NFSVolume.Server":"3f9cd4a596-n****.cn-shanghai.nas.aliyuncs.com","DiskVolume.DiskId":"d-xx","Name":"default-volume1","EmptyDirVolume.Medium":"memory","ConfigFileVolumeConfigFileToPath":[{"Path":"/usr/bin/","Mode":644,"Content":"bGl1bWk="}],"EmptyDirVolume.SizeLimit":"256 Mi"}]
&InitContainer=[{"InitContainerEnvironmentVar":[{"Key":"Path","Value":"/usr/bin/"}],"SecurityContext.Capability.Add":["NET_ADMIN"],"Image":"nginx","InitContainerVolumeMount":[{"MountPropagation":"None","MountPath":"/usr/share/","ReadOnly":false,"Name":"test-empty","SubPath":"/usr/sub/"}],"ImagePullPolicy":"Always","Cpu":0.5,"WorkingDir":"/usr/local","Command":["sleep"],"Arg":["10"],"SecurityContext.RunAsUser":587,"Gpu":1,"Memory":1.0,"Name":"test-init"}]
&DnsConfigNameServer=["172.10.*.**"]
&DnsConfigSearch=["svc.local.kubenetes"]
&DnsConfigOption=[{"Value":"value","Name":"name"}]
&HostAliase=[{"Ip":"192.0.XX.XX","Hostname":["['hehe.com', 'haha.com']"]}]
&SecurityContextSysctl=[{"Value":"65536","Name":"kernel.msgmax"}]
&NtpServer=["ntp.cloud.aliyuncs.com"]
&AcrRegistryInfo=[{"Domain":["*****-****-registry.cn-beijing.cr.aliyuncs.com"],"InstanceName":"acr-test","InstanceId":"cri-nwj395hgf6f3****","RegionId":"cn-hangzhou"}]
&CostOptimization=false
&InstanceFamilyLevel=EnterpriseLevel
&ContainersUpdateType=RenewUpdate
&InstanceType=["ecs.g6.large"]
&DataCacheBucket=default
&DataCachePL=PL1
&DataCacheProvisionedIops=40000
&DataCacheBurstingEnabled=false
&GpuDriverVersion=tesla=525.85.12
&<Common request parameters>

    Sample success responses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyEciScalingConfigurationResponse>
    <RequestId>89945DD3-9072-47D0-A318-353284CF****</RequestId>
</ModifyEciScalingConfigurationResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "89945DD3-9072-47D0-A318-353284CF****"
}

    Error codes

    For a list of error codes, see Service error codes.

    HTTP status code

    Error code

    Description

    Description

    403

    Forbidden.Unauthorized

    A required authorization for the specified action is not supplied.

    You do not have the permission to call the operation.

    404

    InvalidDataDiskSnapshotId.NotFound

    Snapshot "XXX" does not exist.

    The snapshot does not exist.

    400

    InvalidDataDiskSnapshotId.SizeNotSupported

    The capacity of snapshot "XXX" exceeds the size limit of the specified disk category.

    The size of the snapshot exceeds the maximum size that is allowed for the disk.

    404

    InvalidImageId.NotFound

    The specified image does not exist.

    The image does not exist.

    400

    InvalidKeyPairName.NotFound

    The specified KeyPairName does not exist in our records.

    The key pair does not exist.

    400

    InvalidNetworkType.ForRAMRole

    RAMRole can't be used For classic instance.

    An instance uses the classic network, which does not support RamRoleName.

    400

    InvalidParamter

    The specified value of parameter is not valid.

    The value of a parameter is invalid.

    400

    InvalidScalingConfigurationName.Duplicate

    The specified value of parameter is duplicated.

    The scaling configuration name already exists.

    400

    InvalidSecurityGroupId.IncorrectNetworkType

    The network type of specified Security Group does not support this action.

    The network type of the security group is different from the network type of the scaling group.

    400

    InvalidSecurityGroupId.VPCMismatch

    The specified security group and the specified virtual switch are not in the same VPC.

    The security group and vSwitch do not reside in the same VPC.

    400

    InvalidTags.KeyValue

    The specified tags key/value cannot be empty.

    Tags is left empty.

    400

    InvalidTags.ListSize

    The specified tags list size cannot be more than "20".

    The maximum number of tags that can be specified has been reached.

    400

    InvalidUserData.Base64FormatInvalid

    The specified parameter UserData must be base64 encoded.

    The user data is not encoded in Base64.

    400

    InvalidUserData.SizeExceeded

    The specified parameter UserData exceeds the size.

    The size of the user data exceeds the upper limit.