All Products
Search
Document Center

Auto Scaling:ModifyEciScalingConfiguration

Last Updated:Jul 15, 2024

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

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.

  • You can call the ModifyEciScalingConfiguration operation to verify 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 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 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 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 adds the declared container protocols and port numbers to the inbound rules of the security group.

ContainerGroupName

String

Yes

nginx-test

The name series of elastic container instances. The name must meet the following 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 instance restart policy. Valid values:

  • Always: always restarts elastic container instances.

  • Never: never restarts elastic container instances.

  • OnFailure: restarts elastic container instances upon failures.

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 instance bidding policy. Valid values:

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

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

  • SpotAsPriceGo: The 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 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 for only specific 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 ephemeral storage space. By default, a performance level 1 (PL1) enterprise SSD (ESSD) is used. Unit: GiB.

LoadBalancerWeight

Integer

No

50

The weight of each 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 registered address 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 complete. Default value: 1. Minimum value: 1.

Container.N.ReadinessProbe.SuccessThreshold

Integer

No

1

The minimum count of consecutive successes needed to consider a failed readiness probe as having recovered successfully. 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 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 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

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 during its active 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 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 settings of volume N. Mount propagation enables volumes mounted to one container to be shared among other containers within the same pod or across distinct pods residing on the same node. Valid values:

  • None: Subsequent mounts executed either on the volume itself or its subdirectories do not propagate to the already established volume mount.

  • HostToCotainer: Subsequent mounts executed either on the volume itself or its subdirectories propagate to the already established volume mount.

  • Bidirectional: This value is similar to HostToCotainer. Subsequent mounts executed either on the volume itself or its subdirectories propagate to the already established volume mount. In addition, any volume mounts executed on the container not only propagate back to the underlying instance but also to all containers across every pod that uses 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 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 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 into 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 count of consecutive failures that must occur for a liveness probe to be classified as 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 count of consecutive failures that must occur for a readiness probe to be classified as failed.

Default value: 3.

Container.N.ImagePullPolicy

String

No

Always

The image pulling policy. Valid values:

  • Always: Each time 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: On-premises images are always used. Image pulling is not performed.

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, streams are also disconnected and remain disconnected until container N 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 count of consecutive successes needed to consider a failed liveness probe as having recovered successfully. 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 time limit within which a liveness probe must be complete. 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 you want to send 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 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 use 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 in container N by using the CLI to configure 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 detected by HTTP GET requests that you want to use to configure the PreStop callback function.

Container.N.LifecyclePreStopHandlerHttpGetScheme

String

No

HTTP

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

Volume.N.DiskVolume.FsType

String

No

xfs

We recommend that you specify FlexVolume.FsType instead of DiskVolume.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 NFSVolume 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 FlexVolume to mount a disk, specify an 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 ConfigFile volume.

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 volume N.

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: Gi or Mi.

InitContainer.N.InitContainerEnvironmentVar.N.Key

String

No

Path

The name of environment variable 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. 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 enables volumes mounted to one container to be shared among other containers within the same pod or across distinct pods residing on the same node. Valid values:

  • None: Subsequent mounts executed either on the volume itself or its subdirectories do not propagate to the already established volume mount.

  • HostToCotainer: Subsequent mounts executed either on the volume itself or its subdirectories propagate to the already established volume mount.

  • Bidirectional: This value is similar to HostToCotainer. Subsequent mounts executed either on the volume itself or its subdirectories propagate to the already established volume mount. In addition, any volume mounts executed on the container not only propagate back to the underlying instance but also to all containers across every pod that uses the same volume.

Default value: None.

InitContainer.N.InitContainerVolumeMount.N.MountPath

String

No

/usr/share/

The mount directory.

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 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: On-premises images are always used. Image pulling is not performed.

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 you want to use 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 per init container N.

InitContainer.N.Memory

Float

No

1.0

The memory size per 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 DNS servers.

DnsConfigSearch.N

String

No

svc.local.kubenetes

The search domains of the DNS servers.

DnsConfigOption.N.Value

String

No

value

The option value.

DnsConfigOption.N.Name

String

No

name

The option name.

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 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 name 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 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 type). 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: 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, see Overview of burstable instances.

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 indicates 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 indicates that only the settings of the specified request parameters are updated.

Default value: RenewUpdate.

InstanceType.N

String

No

ecs.g6.large

The specified 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 you want to use to store data caches.

DataCachePL

String

No

PL1

The performance level (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 for the ESSD AutoPL disk that you want to use to store data caches. 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 store data caches. 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 maximum size of the user data has been reached.