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.
Operation description
- 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
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ScalingConfigurationId | string | Yes | The ID of the scaling configuration that you want to modify. | asc-bp16har3jpj6fjbx**** |
ScalingConfigurationName | string | Yes | 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 within a scaling group in a region. If you do not specify this parameter, the value of the ScalingConfigurationId parameter is used. | test-modify |
Description | string | Yes | Note
This parameter is unavailable.
| desc |
SecurityGroupId | string | Yes | 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. | sg-uf66jeqopgqa9hdn**** |
ContainerGroupName | string | Yes | The name of the elastic container instance. The name must meet the following requirements:
| nginx-test |
RestartPolicy | string | No | The instance restart policy. Valid values:
Default value: Always. | Always |
Cpu | float | No | The number of vCPUs of the elastic container instance. | 1.0 |
Memory | float | No | The memory size of the elastic container instance. Unit: GiB. | 2.0 |
ResourceGroupId | string | No | The ID of the resource group. | rg-uf66jeqopgqa9hdn**** |
DnsPolicy | string | No | The Domain Name System (DNS) policy. Valid values:
| Default |
EnableSls | boolean | No | Note
This parameter is unavailable.
| false |
ImageSnapshotId | string | No | The ID of the image cache. | imc-2zebxkiifuyzzlhl**** |
RamRoleName | string | No | The name of the RAM role for the instance. You can use an instance RAM role to access both elastic container instances and Elastic Compute Service (ECS) instances. For more information, see Use an instance RAM role by calling API operations. | RamTestRole |
TerminationGracePeriodSeconds | long | No | The buffer time in which the program handles operations before the program is stopped. Unit: seconds. | 60 |
AutoMatchImageCache | boolean | No | Specifies whether to automatically match the image cache. Default value: false. | false |
Ipv6AddressCount | integer | No | The number of IPv6 addresses. | 1 |
ActiveDeadlineSeconds | long | No | The validity period. Unit: seconds. | 1000 |
SpotStrategy | string | No | The bidding policy for the elastic container instance. Valid values:
Default value: NoSpot. | SpotPriceLimit |
SpotPriceLimit | float | No | The maximum hourly price of the preemptible elastic container instance. The value can be accurate to three decimal places. If you set the SpotStrategy parameter to SpotWithPriceLimit, you must also specify the SpotPriceLimit parameter. | 0.025 |
AutoCreateEip | boolean | No | Specifies whether to automatically create an elastic IP address (EIP) and bind the EIP to the elastic container instance. | true |
EipBandwidth | integer | No | The bandwidth of the EIP. Default value: 5. Unit: Mbit/s. | 5 |
HostName | string | No | The name of the elastic container instance. | test |
IngressBandwidth | long | No | The maximum inbound bandwidth. Unit: bit/s. | 1024000 |
EgressBandwidth | long | No | The maximum outbound bandwidth. Unit: bit/s. | 1024000 |
CpuOptionsCore | integer | No | The number of physical CPU cores. This parameter is not available for all instance types. For more information, see Specify custom CPU options. | 2 |
CpuOptionsThreadsPerCore | integer | No | The number of threads per core. This parameter is not available for all instance types. A value of 1 indicates that Hyper-Threading is disabled. For more information, see Specify custom CPU options. | 2 |
EphemeralStorage | integer | No | The size of the temporary storage space. By default, an enhanced SSD (ESSD) of the PL1 level is used. Unit: GiB. | 20 |
LoadBalancerWeight | integer | No | The weight of the elastic container instance as a backend server. Valid values: 1 to 100. | 50 |
Tags | array<object> | No | Information about the tags. | |
object | No | Information about the tags. | ||
Key | string | No | The key of the tag. | version |
Value | string | No | The value of the tag. | 3 |
ImageRegistryCredentials | array<object> | No | Information about the image repository. | |
object | No | Information about the image repository. | ||
Password | string | No | The password that is used to access the image repository. | yourpaasword |
Server | string | No | The domain name of the image repository. | registry-vpc.cn-shanghai.aliyuncs.com |
UserName | string | No | The username that is used to access the image repository. | yourusername |
Containers | array<object> | No | The containers. | |
object | No | The containers. | ||
ReadinessProbe.TimeoutSeconds | integer | No | The timeout limit for a readiness probe to be complete. Unit: seconds. Default value: 1. Minimum value: 1. | 1 |
ReadinessProbe.SuccessThreshold | integer | No | 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. | 1 |
SecurityContext.Capability.Adds | array | No | The permissions that you want to grant to the processes in the container. Valid values: NET_ADMIN and NET_RAW. Note
To use NET_RAW, you must submit a ticket.
| |
string | No | The permissions that you want to grant to the process in the container. Valid values: NET_ADMIN and NET_RAW. Note
To use NET_RAW, you must submit a ticket.
| NET_RAW | |
ReadinessProbe.TcpSocket.Port | integer | No | The port detected by the TCP sockets for readiness probing. | 8000 |
ReadinessProbe.HttpGet.Scheme | string | No | The protocol type of the HTTP GET requests for readiness probing. Valid values:
| HTTP |
LivenessProbe.PeriodSeconds | integer | No | The interval between consecutive liveness probes. Unit: seconds. Default value: 10. Minimum value: 1. | 5 |
Ports | array<object> | No | The ports. | |
object | No | Information about the ports. | ||
Protocol | string | No | The protocol type. Valid values:
| TCP |
Port | integer | No | The port number. Valid values: 1 to 65535. | 80 |
SecurityContext.ReadOnlyRootFilesystem | boolean | No | Specifies whether the root file system on which the container runs is read-only. Set the value to true. | true |
EnvironmentVars | array<object> | No | The environment variables. | |
object | No | Information about the environment variables. | ||
Key | string | No | The name of the environment variable. The name can be 1 to 128 characters in length and can contain letters, underscores (_), and digits. It cannot start with a digit. Specify the value in the | PATH |
Value | string | No | The value of the environment variable. The value can be up to 256 characters in length. | /usr/local/bin |
FieldRef.FieldPath | string | No | Note
This parameter is not available for use.
| path |
LivenessProbe.TcpSocket.Port | integer | No | The port detected by the TCP sockets for liveness probing. | 1 |
Tty | boolean | No | Specifies whether to enable the Interaction feature. Default value: false. If the command is a /bin/bash command, set this parameter to true. | false |
WorkingDir | string | No | The working directory of the container. | /usr/local/ |
LivenessProbe.HttpGet.Scheme | string | No | The protocol type of the HTTP GET requests for liveness probing. Valid values:
| HTTP |
ReadinessProbe.HttpGet.Port | integer | No | The port over which you want to send the HTTP GET requests for readiness probing. | 8080 |
Args | array | No | The container startup arguments. You can specify up to 10 arguments. | |
string | No | The container startup argument. You can specify up to 10 arguments. | 100 | |
Gpu | integer | No | The number of GPUs that you want to allocate to the container. | 1 |
ReadinessProbe.InitialDelaySeconds | integer | No | The interval between the launch of the container and the onset of a readiness probe. Unit: seconds. | 3 |
Stdin | boolean | No | Specifies whether the container allocates buffer resources to standard input streams during its active runtime. If you do not specify this parameter, an end-of-file (EOF) error occurs when standard input streams in the container are read. Default value: false. | false |
Memory | float | No | The memory size that you want to allocate to the container. Unit: GiB. | 0.5 |
Name | string | No | The name of the container image. | nginx |
Image | string | No | The image of the container. | registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest |
LivenessProbe.InitialDelaySeconds | integer | No | The interval between the launch of the container and the onset of a liveness probe. Unit: seconds. | 5 |
VolumeMounts | array<object> | No | The volume mounts of the container. | |
object | No | Information about the volume mount of the container. | ||
MountPropagation | string | No | The mount propagation setting of the volume. Mount propagation enables volumes mounted on one container to be shared among other containers within the same pod or across distinct pods residing on the same node. Valid values:
| None |
MountPath | string | No | The directory within the container onto which you want to mount the volume. Note
The information stored within this directory will be overridden by the data present on the mounted volume. Specify this parameter with caution.
| /pod/data |
ReadOnly | boolean | No | Specifies whether the volume is read-only. Default value: false. | false |
Name | string | No | The volume name. The value of this parameter is the same as the value of Volume.N.Name. | default-volume1 |
SubPath | string | No | The subdirectory of the volume. | data2/ |
LivenessProbe.FailureThreshold | integer | No | The minimum count of consecutive failures that must occur for a liveness probe to be classified as failed. Default value: 3. | 3 |
ReadinessProbe.Exec.Commands | array | No | The commands executed in the container when using the command line to perform the health check. | |
string | No | The command. | cat /tmp/healthy | |
ReadinessProbe.FailureThreshold | integer | No | The minimum count of consecutive failures that must occur for a readiness probe to be classified as failed. Default value: 3. | 3 |
ImagePullPolicy | string | No | The image pulling policy. Valid values:
| Always |
StdinOnce | boolean | No | Specifies whether standard input streams remain connected during multiple sessions when StdinOnce is set to true. If StdinOnce is set to true, standard input streams are connected after the container is started, and remain idle until a client is connected to receive data. After the client is disconnected, streams are also disconnected, and remain disconnected until the container is restarted. | false |
Cpu | float | No | The number of vCPUs that you want to allocate to the container. | 0.25 |
LivenessProbe.HttpGet.Port | integer | No | The port over which you want to send the HTTP GET requests for liveness probing. | 8888 |
LivenessProbe.HttpGet.Path | string | No | The path to which you want to send the HTTP GET requests for liveness probing. | /healthyz |
LivenessProbe.SuccessThreshold | integer | No | 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. | 1 |
ReadinessProbe.PeriodSeconds | integer | No | The interval between consecutive readiness probes. Unit: seconds. Default value: 10. Minimum value: 1. | 3 |
LivenessProbe.TimeoutSeconds | integer | No | The timeout limit for a liveness probe to be complete. Unit: seconds. Default value: 1. Minimum value: 1. | 1 |
Commands | array | No | The command that you want to run by using the CLI for liveness probing within the container. | |
string | No | The command that you want to run by using the CLI for liveness probing within the container. | sleep | |
SecurityContext.RunAsUser | long | No | The ID of the user that runs the container. | 1000 |
ReadinessProbe.HttpGet.Path | string | No | The path to which you want to send the HTTP GET requests for readiness probing. | /healthz |
LivenessProbe.Exec.Commands | array | No | The command executed in the container when using the command line to perform the health check. | |
string | No | The command. | cat /tmp/healthy | |
LifecyclePostStartHandlerHttpGetHost | string | No | The IP address of the host to which you want to send the HTTP GET requests for configuring the postStart callback function. | 10.0.XX.XX |
LifecyclePostStartHandlerHttpGetPort | integer | No | The port over which you want to send the HTTP GET requests for configuring the postStart callback function. | 5050 |
LifecyclePostStartHandlerHttpGetPath | string | No | The path to which you want to send the HTTP GET requests for configuring the postStart callback function. | /healthyz |
LifecyclePostStartHandlerHttpGetScheme | string | No | The protocol type of the HTTP GET requests that you want to send for configuring the postStart callback function. Valid values:
| HTTPS |
LifecyclePostStartHandlerExecs | array | No | The commands that you want to run by using the CLI for configuring the postStart callback function within the container. | |
string | No | The command that you want to run by using the CLI for configuring the postStart callback function within the container. | ["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"] | |
LifecyclePostStartHandlerTcpSocketHost | string | No | The IP address of the host detected by the TCP sockets that you want to use for configuring the postStart callback function. | 10.0.XX.XX |
LifecyclePostStartHandlerTcpSocketPort | integer | No | The port detected by the TCP sockets that you want to use for configuring the postStart callback function. | 80 |
LifecyclePreStopHandlerHttpGetHost | string | No | The IP address of the host to which you want to send the HTTP GET requests for configuring the preStop callback function. | 10.0.XX.XX |
LifecyclePreStopHandlerHttpGetPort | integer | No | The port over which you want to send the HTTP GET requests for configuring the preStop callback function. | 80 |
LifecyclePreStopHandlerHttpGetPath | string | No | The path to which you want to send the HTTP GET requests for configuring the preStop callback function. | /healthyz |
LifecyclePreStopHandlerHttpGetScheme | string | No | The protocol type of the HTTP GET requests that you want to send for configuring the preStop callback function. Valid values:
| HTTP |
LifecyclePreStopHandlerExecs | array | No | The commands that you want to run by using the CLI for configuring the preStop callback function within the container. | |
string | No | The command that you want to run by using the CLI for configuring the preStop callback function within the container. | ["/bin/sh", "-c","echo Hello from the preStop handler > /usr/share/message"] | |
LifecyclePreStopHandlerTcpSocketHost | string | No | The IP address of the host detected by the TCP sockets that you want to use for configuring the preStop callback function. | 10.0.XX.XX |
LifecyclePreStopHandlerTcpSocketPort | integer | No | The port detected by the TCP sockets that you want to use for configuring the preStop callback function. | 80 |
Volumes | array<object> | No | The volumes. | |
object | No | The volume. | ||
Type | string | No | The type of the Host directory. Examples: File, Directory, and Socket. | EmptyDirVolume |
DiskVolume.DiskSize | integer | No | The volume size. Unit: GiB. | 15 |
NFSVolume.Path | string | No | The path to the Network File System (NFS) volume. | /share |
FlexVolume.FsType | string | No | The type of the mounted file system. The default value is determined by the script of FlexVolume. | ext4 |
DiskVolume.FsType | string | No | We recommend that you specify | xfs |
HostPathVolume.Type | string | No | The type of host directory. For example: File, Directory, Socket, etc. | Directory |
NFSVolume.ReadOnly | boolean | No | Specifies whether the permissions on the NFS volume are read-only. Default value: false. | false |
HostPathVolume.Path | string | No | The absolute path on the host. | /xx/xx/name |
FlexVolume.Options | string | No | The FlexVolume options. Each option is a key-value pair in a JSON string. For example, if you use FlexVolume to mount a disk, the format of Options is | {"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"} |
FlexVolume.Driver | string | No | The name of the FlexVolume driver. | flexvolume |
ConfigFileVolumeDefaultMode | integer | No | The default permissions on the ConfigFile volume. | 0644 |
NFSVolume.Server | string | No | The endpoint of the NFS server. | 3f9cd4a596-naw76.cn-shanghai.nas.aliyuncs.com |
DiskVolume.DiskId | string | No | The ID of the disk volume. | d-xx |
Name | string | No | The volume name. | default-volume1 |
EmptyDirVolume.Medium | string | No | The storage medium of the emptyDir volume. If you do not specify a storage medium for the emptyDir volume, the emptyDir volume stores data in the file system of a node by default. A value of memory indicates that the emptyDir volume stores data in the memory. | memory |
ConfigFileVolumeConfigFileToPath | array<object> | No | The paths to configuration files. | |
object | No | The path to the configuration file. | ||
Path | string | No | The relative path to the configuration file. | /usr/bin/ |
Mode | integer | No | The permissions on the ConfigFile volume. | 0644 |
Content | string | No | The content of the configuration file (32 KB). | bGl1bWk= |
EmptyDirVolume.SizeLimit | string | No | The size of the emptyDir volume. The value contains a unit. We recommend that you use Gi or Mi as the unit. | 256Mi |
InitContainers | array<object> | No | The init containers. | |
object | No | The init containers. | ||
InitContainerEnvironmentVars | array<object> | No | The environment variables of the init container. | |
object | No | The environment variables of the init container. | ||
Key | string | No | The key of the environment variable. The key must be 1 to 128 characters in length. Specify the name in the | Path |
Value | string | No | The value of the environment variable. The value must be 0 to 256 characters in length. | /usr/bin/ |
FieldRef.FieldPath | string | No | Note
This parameter is unavailable.
| path |
SecurityContext.Capability.Adds | array | No | The permissions granted to processes in the container. | |
string | No | The permission granted to processes in the container. Valid values: NET_ADMIN and NET_RAW. Note
To use NET_RAW, you must submit a ticket.
| NET_RAW | |
Image | string | No | The container image. | nginx |
InitContainerPorts | array<object> | No | The ports of the init container. | |
object | No | The ports of the init container. | ||
Protocol | string | No | The type of the protocol. Valid values:
| TCP |
Port | integer | No | The port number. Valid values: 1 to 65535. | 1 |
InitContainerVolumeMounts | array<object> | No | Information about the volume mounts of the init container. | |
object | No | Information about the volume mounts of the init container. | ||
MountPropagation | string | No | The mount propagation setting of the volume. Mount propagation allows the sharing of volumes that are mounted on one container with other containers in the same pod, or even with other pods on the same node. Valid values:
Default value: None. | None |
MountPath | string | No | The path where the container mounts the volume. Note
Data stored in the path of the container is overwritten by the content of the volume.
| /usr/share/ |
ReadOnly | boolean | No | Specifies whether the mount path is read-only. Default value: false. | false |
Name | string | No | The name of the volume. | test-empty |
SubPath | string | No | The subdirectory of the volume. The elastic container instance can mount different directories of the same volume to different subdirectories of containers. | Always |
SecurityContext.ReadOnlyRootFilesystem | boolean | No | Note
This parameter is unavailable.
| false |
ImagePullPolicy | string | No | The image pulling policy. Valid values:
| Always |
Cpu | float | No | The number of vCPUs that you want to allocate to the container. | 0.5 |
WorkingDir | string | No | The working directory. | /usr/local |
Commands | array | No | The commands that you want to run to start the container. | |
string | No | The commands that you want to run to start the container. | sleep | |
Args | array | No | The startup parameter of the container. | |
string | No | The arguments that are passed to the container startup command. | 10 | |
SecurityContext.RunAsUser | long | No | The ID of the user that runs the container. | 587 |
Gpu | integer | No | The number of GPUs that you want to allocate to the container. | 1 |
Memory | float | No | The size of the memory. Unit: GiB. | 1.0 |
Name | string | No | The name of the container. | test-init |
DnsConfigNameServers | array | No | The IP addresses of the DNS servers. | |
string | No | The IP addresses of the DNS servers. | 172.10.*.** | |
DnsConfigSearchs | array | No | The DNS lookup domains. | |
string | No | The DNS lookup domains. | svc.local.kubenetes | |
DnsConfigOptions | array<object> | No | The options. Each option is a name-value pair. The value in the name-value pair is optional. | |
object | No | The objects. Each object is a name-value pair. The value is optional. | ||
Value | string | No | The variable value of the option. | value |
Name | string | No | The variable name of the option. | name |
HostAliases | array<object> | No | Information about the hosts. | |
object | No | Information about the hosts. | ||
Ip | string | No | The IP address that you want to add. | 192.0.XX.XX |
Hostnames | array | No | The hostnames that you want to add. | |
string | No | The hostnames that you want to add. | ['hehe.com', 'haha.com'] | |
SecurityContextSysCtls | array<object> | No | The system information of the security context in which the elastic container instance runs. | |
object | No | The system information of the security context in which the elastic container instance runs. | ||
Value | string | No | The variable value of the security context in which the elastic container instance runs. | 65536 |
Name | string | No | The name of the security context in which the elastic container instance runs. | kernel.msgmax |
NtpServers | array | No | The domain names of the NTP server. | |
string | No | The domain names of the NTP server. | ntp.cloud.aliyuncs.com | |
AcrRegistryInfos | array<object> | No | Information about the Container Registry Enterprise Edition instance. | |
object | No | Information about the Container Registry Enterprise Edition instance. | ||
Domains | array | No | The domain names of the Container Registry Enterprise Edition instances. By default, all domain names of the Container Registry Enterprise Edition instances are displayed. You can specify one or more domain names. Separate multiple domain names with commas (,). | |
string | No | The domain names of the Container Registry Enterprise Edition instances. By default, all domain names of the Container Registry Enterprise Edition instances are displayed. You can specify one or more domain names. Separate multiple domain names with commas (,). | *****-****-registry.cn-beijing.cr.aliyuncs.com | |
InstanceName | string | No | The name of the Container Registry Enterprise Edition instance. | acr-test |
InstanceId | string | No | The ID of the Container Registry Enterprise Edition instance. | cri-nwj395hgf6f3**** |
RegionId | string | No | The region ID of the Container Registry Enterprise Edition instance. | cn-hangzhou |
CostOptimization | boolean | No | Specifies whether to enable the cost optimization feature. Valid values:
Default value: false. | false |
InstanceFamilyLevel | string | No | The level of the instance type, which is used to filter the instance types that meet the specified criteria. This parameter takes effect only if you set the
| EnterpriseLevel |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "89945DD3-9072-47D0-A318-353284CF****"
}
Error codes
HTTP status code | Error code | Error message |
---|---|---|
403 | Forbidden.RiskControl | Forbidden.RiskControl |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-01-23 | The Error code has changed | View Change Details |
2023-11-14 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2023-10-11 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2023-07-12 | The Error code has changed | View Change Details |