All Products
Search
Document Center

Auto Scaling:ModifyEciScalingConfiguration

Last Updated:Feb 23, 2024

Modifies scaling configurations of the Elastic Container Instance type to meet changing business requirements.

Usage notes

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

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 do not specify this parameter, the scaling configuration ID is used.

SecurityGroupId

String

Yes

sg-uf66jeqopgqa9hdn****

The ID of the security group with which you want to associate the elastic container instance. Elastic container instances that are associated with 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 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 you do not have a default security group in the region, the system creates a default security group and then adds the declared container protocols and port numbers to the inbound rules of the security group.

ContainerGroupName

String

Yes

nginx-test

The name of the elastic container instance. Format requirements:

  • 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 restart policy of the elastic container instance. Valid values:

  • Always: always restarts the elastic container instance.

  • Never: never restarts the elastic container instance.

  • OnFailure: restarts the elastic container instance upon failures.

Default value: Always.

Cpu

Float

No

1.0

The number of vCPUs of the elastic container instance.

Memory

Float

No

2.0

The memory size of the 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 snapshot.

RamRoleName

String

No

RamTestRole

The name of the Resource Access Management (RAM) role that you want to assign to the elastic container instance. 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 for the instance. Valid values:

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

  • SpotWithPriceLimit: The instance is a preemptible instance with user-defined maximum hourly prices.

  • SpotAsPriceGo: The instance is created as a preemptible instance 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 the preemptible elastic container instance. 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 an elastic IP address (EIP) and bind the EIP to the elastic container instance.

EipBandwidth

Integer

No

5

The bandwidth of the EIP..

Default value: 5. Unit: Mbit/s.

HostName

String

No

test

The hostname of the elastic container instance.

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 for only some instance types. For more information, see Specify custom CPU options.

CpuOptionsThreadsPerCore

Integer

No

2

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

EphemeralStorage

Integer

No

20

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

LoadBalancerWeight

Integer

No

50

The weight of the elastic container instance as a backend server. Valid values: 1 to 100.

Tag.N.Key

String

No

version

The tag key.

Tag.N.Value

String

No

3

The tag value.

ImageRegistryCredential.N.Password

String

No

yourpaasword

The password of 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 timeout period for a readiness probe. Unit: seconds. 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 that is detected by TCP sockets when you use the TCP sockets 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 on which container N runs is read-only. Valid value: true.

Container.N.EnvironmentVar.N.Key

String

No

PATH

The name of the environment variable. The name can be 1 to 128 characters in length and can contain underscores (_). 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 the environment variable. The value can be up to 256 characters in length.

Container.N.LivenessProbe.TcpSocket.Port

Integer

No

8000

The port detected by TCP sockets when you use the TCP sockets to perform liveness probes.

Container.N.Tty

Boolean

No

false

Specifies whether to enable interaction. 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 to which HTTP GET requests are sent when you use the HTTP GET requests to perform readiness probes.

Container.N.Arg.N

String

No

100

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

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 startup 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 when the container is running. 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 that you want to allocate to 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 startup of container N to the start time of a liveness probe. Unit: seconds.

Container.N.VolumeMount.N.MountPropagation

String

No

None

The mount propagation setting of the volume. Mount propagation allows volumes that are mounted on one 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 mount does not receive subsequent mounts that are performed on the volume or the subdirectories of the volume.

  • HostToCotainer: The volume mount receives all subsequent mounts that are performed on the volume or the subdirectories of the volume.

  • Bidirectional: This value is similar to HostToCotainer. The volume mount receives all subsequent mounts that are performed on the volume or the subdirectories of the volume. In addition, all volume mounts that are mounted on the container are propagated back to the instance and to all containers of all pods that use the same volume.

Default value: None.

Container.N.VolumeMount.N.MountPath

String

No

/pod/data

The directory to which the container mounts the volume.

Important

After you mount the volume to the directory, the data under this directory is overwritten by data on the volume. Specify this parameter with caution.

Container.N.VolumeMount.N.ReadOnly

Boolean

No

false

Specifies whether the volume is read-only.

  • true

  • false

Default value: false.

Container.N.VolumeMount.N.Name

String

No

default-volume1

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

Container.N.VolumeMount.N.SubPath

String

No

data2/

The subdirectory of the volume.

Container.N.LivenessProbe.FailureThreshold

Integer

No

3

The minimum number of consecutive failures for a successful liveness probe to be considered failed.

Default value: 3.

Container.N.ReadinessProbe.Exec.Command.N

String

No

cat/tmp/healthy

The command that you want to run by using the command line interface (CLI) to perform readiness probes.

Container.N.ReadinessProbe.FailureThreshold

Integer

No

3

The minimum number of consecutive failures for a successful readiness probe to be considered failed.

Default value: 3.

Container.N.ImagePullPolicy

String

No

Always

The image pulling policy. Valid values:

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

  • IfNotPresent: Image pulling is performed as needed. On-premises images are preferentially used. If no on-premises images are available, image pulling is performed.

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

Container.N.StdinOnce

Boolean

No

false

Specifies whether standard input streams are disconnected after a client is disconnected. If Container.N.StdinOnce is set to true, standard input streams remain connected during multiple sessions.

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 standard input 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 to which HTTP GET requests are sent when you use the HTTP GET requests to perform liveness probes.

Container.N.LivenessProbe.HttpGet.Path

String

No

/healthyz

The path to which HTTP GET requests are sent when you use the HTTP 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 interval at which readiness probes are performed. Unit: seconds. Default value: 10. Minimum value: 1.

Container.N.LivenessProbe.TimeoutSeconds

Integer

No

1

The timeout period for a liveness probe. Unit: seconds. Default value: 1. Minimum value: 1.

Container.N.Command.N

String

No

sleep

The container startup commands. You can specify up to 20 commands. 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 HTTP GET requests are sent when you use the HTTP GET requests to perform readiness probes.

Container.N.LivenessProbe.Exec.Command.N

String

No

cat /tmp/healthy

The command that you want to run by using the CLI in the container to perform liveness probes.

Container.N.LifecyclePostStartHandlerHttpGetHost

String

No

10.0.XX.XX

The IP address of the host that receives HTTP Get requests when you use the HTTP Get requests to specify the PostStart callback function.

Container.N.LifecyclePostStartHandlerHttpGetPort

Integer

No

5050

The port number detected by HTTP Get requests when you use the HTTP Get requests to specify the PostStart callback function.

Container.N.LifecyclePostStartHandlerHttpGetPath

String

No

/healthyz

The path detected by HTTP Get requests when you use the HTTP Get requests to specify the PostStart callback function.

Container.N.LifecyclePostStartHandlerHttpGetScheme

String

No

HTTPS

The protocol type of the HTTP Get request that you use to specify 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 in container N by using the CLI to specify the PostStart callback function.

Container.N.LifecyclePostStartHandlerTcpSocketHost

String

No

10.0.XX.XX

The IP address of the host detected by TCP sockets when you use the TCP sockets to specify the PostStart callback function.

Container.N.LifecyclePostStartHandlerTcpSocketPort

Integer

No

80

The port number detected by TCP sockets when you use the TCP sockets to specify the PostStart callback function.

Container.N.LifecyclePreStopHandlerHttpGetHost

String

No

10.0.XX.XX

The IP address of the host that receives HTTP Get requests when you use the HTTP Get requests to specify the PreStop callback function.

Container.N.LifecyclePreStopHandlerHttpGetPort

Integer

No

80

The port number detected by HTTP Get requests when you use the HTTP Get requests to specify the PreStop callback function.

Container.N.LifecyclePreStopHandlerHttpGetPath

String

No

/healthyz

The path detected by HTTP Get requests when you use the HTTP Get requests to specify the PreStop callback function.

Container.N.LifecyclePreStopHandlerHttpGetScheme

String

No

HTTP

The protocol type of the HTTP GET requests that you use to specify 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 in container N by using the CLI to specify the PreStop callback function.

Container.N.LifecyclePreStopHandlerTcpSocketHost

String

No

10.0.XX.XX

The IP address of the host detected by TCP sockets when you use the TCP sockets to specify the PreStop callback function.

Container.N.LifecyclePreStopHandlerTcpSocketPort

Integer

No

80

The port number detected by TCP sockets when you use the TCP sockets to specify the PreStop callback function.

Volume.N.Type

String

No

EmptyDirVolume

The volume type. 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 FlexVolume.

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

Volume.N.FlexVolume.Options

String

No

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

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

For example, when you use FlexVolume to mount a disk, the option is 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 ConfigFile volume.

Volume.N.NFSVolume.Server

String

No

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

The address 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 volume name.

Volume.N.EmptyDirVolume.Medium

String

No

memory

The storage medium of the EmptyDir volume. If you leave this parameter empty, the file system that backs 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 directory of the ConfigFile volume.

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: GiB or MiB.

InitContainer.N.InitContainerEnvironmentVar.N.Key

String

No

Path

The name of the environment variable. 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.

InitContainer.N.InitContainerEnvironmentVar.N.Value

String

No

/usr/bin/

The value of the environment variable. 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 setting of the volume. Mount propagation allows volumes that are mounted on one 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 mount does not receive subsequent mounts that are performed on the volume or the subdirectories of the volume.

  • HostToCotainer: The volume mount receives all subsequent mounts that are performed on the volume or the subdirectories of the volume.

  • Bidirectional: This value is similar to HostToCotainer. The volume mount receives all subsequent mounts that are performed on the volume or the subdirectories of the volume. In addition, all volume mounts that are mounted on init container N are propagated back to the instance and to all containers of all pods that use the same volume.

Default value: None.

InitContainer.N.InitContainerVolumeMount.N.MountPath

String

No

/usr/share/

The directory to which the volume is mounted.

Important

After you mount the volume to the directory, the data under this directory is overwritten by data on the volume. Specify this parameter 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 the volume that you want to mount.

InitContainer.N.InitContainerVolumeMount.N.SubPath

String

No

/usr/sub/

The subdirectory of the volume. 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: Each time instances are created, image pulling is performed.

  • IfNotPresent: Image pulling is performed as needed. On-premises images are preferentially used. If no on-premises images are available, image pulling is performed.

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

InitContainer.N.Cpu

Float

No

0.5

The number of vCPUs that you want to allocate to init container N.

InitContainer.N.WorkingDir

String

No

/usr/local

The working directory of init container N.

InitContainer.N.Command.N

String

No

sleep

The container startup commands.

InitContainer.N.Arg.N

String

No

10

The container startup arguments.

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 that you want to allocate to init container N.

InitContainer.N.Memory

Float

No

1.0

The memory size that you want to allocate to 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 the Domain Name Service (DNS) servers.

DnsConfigSearch.N

String

No

svc.local.kubenetes

The search domains of the DNS servers.

DnsConfigOption.N.Value

String

No

value

The value of option N.

DnsConfigOption.N.Name

String

No

name

The name of option N.

HostAliase.N.Ip

String

No

192.0.XX.XX

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

HostAliase.N.Hostname.N

String

No

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

The name of the host that you want to add.

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 name of security context N in which the elastic container instance runs.

NtpServer.N

String

No

ntp.cloud.aliyuncs.com

The domain name 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 Container Registry Enterprise Edition 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 use this parameter to filter 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 provide stable computing performance in a consistent manner. 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: This value is valid only for burstable instances. 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, see Overview of burstable instances.

ContainersUpdateType

String

No

RenewUpdate

The update mode of containers. Valid values:

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

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

Default value: RenewUpdate.

InstanceType.N

String

No

ecs.g6.large

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

DataCacheBucket

String

No

default

The bucket that caches data.

DataCachePL

String

No

PL1

The PL of the disk that you want to use to caches data. 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 IOPS provisioned for the ESSD AutoPL disk that you want to use to cache data. Valid values: 0 to min{50000, 1000 × Capacity - Baseline IOPS}, where Baseline IOPS = min{1800 + 50 × Capacity - 50000}.

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 cache data. Valid values:

  • true

  • false

Default value: false.

Note

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

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-naw76.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
&<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

Error message

Description

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

You are not authorized 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 specified image is not found.

400

InvalidKeyPairName.NotFound

The specified KeyPairName does not exist in our records.

The name of the specified key pair does not exist.

400

InvalidNetworkType.ForRAMRole

RAMRole can't be used For classic instance.

The network type of an instance is classic network. The classic network 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 user data size exceeds the upper limit.