All Products
Search
Document Center

Auto Scaling:ModifyEciScalingConfiguration

Last Updated:Oct 26, 2026

Modifies an ECI-type scaling configuration.

Operation description

Operation description

  • If you modify the name of a scaling configuration, note that scaling configurations in the same scaling group cannot have the same name.

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

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:ModifyEciScalingConfiguration

update

*ScalingGroup

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

None None

Request parameters

Parameter

Type

Required

Description

Example

ScalingConfigurationId

string

Yes

The ID of the scaling configuration to be modified.

asc-bp16har3jpj6fjbx****

ScalingConfigurationName

string

No

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

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

test-modify

SecurityGroupId

string

No

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

If you do not specify a security group, the system automatically uses the default security group in the region that you select. You must ensure that the inbound rules of the security group include the protocols and ports that the container needs to expose. If no default security group exists in the region, the system performs automatic creation of a default security group and adds the container protocols and ports that you declared to the inbound rules of the security group.

sg-uf66jeqopgqa9hdn****

ContainerGroupName

string

No

The name of the ECI instance, which is also the name of the container group. The format requirements are as follows:

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

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

nginx-test

RestartPolicy

string

No

The restart policy of the instance. Valid values:

  • Always: The instance always restarts.

  • Never: The instance never restarts.

  • OnFailure: The instance restarts on failure.

Default value: Always.

Always

Cpu

number

No

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

1.0

Memory

number

No

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

2.0

ResourceGroupId

string

No

The ID of the resource group.

rg-uf66jeqopgqa9hdn****

DnsPolicy

string

No

The DNS policy. Valid values:

  • None: Uses the DNS settings specified in the DnsConfig field.

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

Default

ImageSnapshotId

string

No

The ID of the image cache.

imc-2zebxkiifuyzzlhl****

RamRoleName

string

No

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

RamTestRole

TerminationGracePeriodSeconds

integer

No

The grace period for the program to handle operations before shutdown. Unit: seconds.

60

AutoMatchImageCache

boolean

No

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

  • true: Yes.

  • false: No.

Default value: false.

false

Ipv6AddressCount

integer

No

The number of IPv6 addresses.

1

ActiveDeadlineSeconds

integer

No

The validity period. Unit: seconds.

1000

SpotStrategy

string

No

The spot strategy of the instance. Valid values:

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

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

  • SpotAsPriceGo: The instance is a spot instance for which the system automatically bids based on the current market price.

Default value: NoSpot.

SpotPriceLimit

SpotPriceLimit

number

No

The maximum hourly price of a spot instance. The value can contain up to three decimal places.

When SpotStrategy is set to SpotWithPriceLimit, you must specify SpotPriceLimit.

0.025

AutoCreateEip

boolean

No

Specifies whether it is required to perform automatic creation of an elastic IP address and attach it to the ECI instance.

true

EipBandwidth

integer

No

The bandwidth of the elastic IP address.

Default value: 5 Mbit/s.

5

HostName

string

No

The hostname, which is also the container group name.

test

IngressBandwidth

integer

No

The inbound bandwidth limit. Unit: bytes.

1024000

EgressBandwidth

integer

No

The outbound bandwidth limit. Unit: bytes.

1024000

CpuOptionsCore

integer

No

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

2

CpuOptionsThreadsPerCore

integer

No

The number of threads per core. Only some instance types support custom settings. A value of 1 disables hyper-threading. For more information, see Customize CPU options.

2

EphemeralStorage

integer

No

The size of the ephemeral storage. By default, an ESSD PL1 cloud disk is used. Unit: GiB.

20

LoadBalancerWeight

integer

No

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

50

Tag

array<object>

No

The tag key-value pairs of the instance.

object

No

The tag key-value pairs of the instance.

Key

string

No

The tag key.

version

Value

string

No

The tag value.

3

ImageRegistryCredential

array<object>

No

The image registry information.

object

No

The image registry information.

Password

string

No

The image registry password.

yourpaasword

Server

string

No

The registration address of the image registry.

registry-vpc.cn-shanghai.aliyuncs.com

UserName

string

No

The image registry username.

yourusername

Container

array<object>

No

The list of containers included in the instance.

array<object>

No

The list of containers included in the instance.

ReadinessProbe.TimeoutSeconds

integer

No

The timeout period for the probe, in seconds. Default value: 1. Minimum value: 1.

1

ReadinessProbe.SuccessThreshold

integer

No

The minimum number of consecutive successes for the probe to be considered successful after a failure. Default value: 1. The value must be 1.

1

SecurityContext.Capability.Add

array

No

Grants specific privileges to the processes in the container. Only NET_ADMIN and NET_RAW are supported.

Note

NET_RAW is not supported by default. To use NET_RAW, submit a ticket.

string

No

Grants specific privileges to the processes in the container. Only NET_ADMIN and NET_RAW are supported.

Note

NET_RAW is not supported by default. To use NET_RAW, submit a ticket.

NET_ADMIN

ReadinessProbe.TcpSocket.Port

integer

No

The port number to probe when a TCP socket is used for health checks.

8000

ReadinessProbe.HttpGet.Scheme

string

No

The protocol type for the HTTP GET request when HTTP is used for health checks. Valid values:

  • HTTP

  • HTTPS

HTTP

LivenessProbe.PeriodSeconds

integer

No

The interval between checks, in seconds. Default value: 10. Minimum value: 1.

5

Port

array<object>

No

The exposed ports and protocols.

object

No

The exposed ports and protocols.

Protocol

string

No

The protocol type. Valid values:

  • TCP

  • UDP

TCP

Port

integer

No

The port number. Valid values: 1 to 65535.

80

SecurityContext.ReadOnlyRootFilesystem

boolean

No

Specifies whether the root file system on which the container runs is read-only. Only true is supported.

true

EnvironmentVar

array<object>

No

The environment variable information.

object

No

The environment variable information.

Key

string

No

The name of the environment variable. The name must be 1 to 128 characters in length and can contain letters, digits, and underscores (_). It cannot start with a digit.

PATH

Value

string

No

The value of the environment variable. The value must be 0 to 256 characters in length.

/usr/local/bin

LivenessProbe.TcpSocket.Port

integer

No

The port number to probe when a TCP socket is used for health checks.

8000

Tty

boolean

No

Specifies whether to allocate a TTY. Default value: false.

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

false

WorkingDir

string

No

The working directory of the container.

/usr/local/

LivenessProbe.HttpGet.Scheme

string

No

The protocol type for the HTTP GET request when HTTP is used for health checks. Valid values:

  • HTTP

  • HTTPS

HTTP

ReadinessProbe.HttpGet.Port

integer

No

The port number to probe for HTTP GET requests when HTTP is used for health checks.

8080

Arg

array

No

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

string

No

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

100

Gpu

integer

No

The number of GPUs allocated to the container.

1

ReadinessProbe.InitialDelaySeconds

integer

No

The number of seconds after the container has started before the probe is initiated.

3

Stdin

boolean

No

Specifies whether to allocate a buffer for standard input in the container runtime. If this parameter is not set, a read from the standard input of the container results in EOF.

Default value: false.

false

Memory

number

No

The memory size of the container. Unit: GiB.

0.5

Name

string

No

The container image name.

nginx

Image

string

No

The container image.

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

LivenessProbe.InitialDelaySeconds

integer

No

The number of seconds after the container has started before the probe is initiated.

5

VolumeMount

array<object>

No

The volume mount information.

object

No

The volume mount information.

MountPropagation

string

No

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

  • None: The volume does not receive any subsequent mounts that are executed on the volume or its subdirectories.

  • HostToCotainer: The volume receives all subsequent mounts that are executed on the volume or its subdirectories.

  • Bidirectional: Similar to HostToCotainer, the volume receives all subsequent mounts. Additionally, the volume is propagated back to the host and to all containers of all pods that use the same volume.

Default value: None.

None

MountPath

string

No

The directory where the volume is mounted in the container.

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

/pod/data

ReadOnly

boolean

No

Specifies whether the volume is read-only. Valid values:

  • true: Read-only.

  • false: Readable and writable.

Default value: false.

false

Name

string

No

The name of the volume. The value must be the same as the Name in Volume.

default-volume1

SubPath

string

No

The subpath of the volume.

data2/

LivenessProbe.FailureThreshold

integer

No

The minimum number of consecutive failures for the probe to be considered failed after having succeeded.

Default value: 3.

3

ReadinessProbe.Exec.Command

array

No

The command to execute in the container when the command line is used for health checks.

string

No

The command to execute in the container when the command line is used for health checks.

cat/tmp/healthy

ReadinessProbe.FailureThreshold

integer

No

The minimum number of consecutive failures for the probe to be considered failed after having succeeded.

Default value: 3.

3

ImagePullPolicy

string

No

The image pull policy for the container. Valid values:

  • Alway: Always pulls the image.

  • IfNotPresent: Pulls the image on demand. Uses the local image first, and pulls the image only when no local image is available.

  • Never: Never pulls the image. Uses the local image and does not pull the image.

Always

StdinOnce

boolean

No

Specifies whether the standard input stream maintains the enabling status across multiple attached sessions when standard input is set to true.

If StdinOnce is set to true, the standard input is opened when the container starts, remains empty until the first client attaches to the standard input, and then stays open to accept data until the client disconnects. After the client disconnects, the standard input enters the shutdown state and remains in the shutdown state until the container is restarted.

false

Cpu

number

No

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

0.25

LivenessProbe.HttpGet.Port

integer

No

The port number to probe for HTTP GET requests when HTTP is used for health checks.

8888

LivenessProbe.HttpGet.Path

string

No

The path to probe for HTTP GET requests when HTTP is used for health checks.

/healthyz

LivenessProbe.SuccessThreshold

integer

No

The minimum number of consecutive successes for the probe to be considered successful after a failure. Default value: 1. The value must be 1.

1

ReadinessProbe.PeriodSeconds

integer

No

The interval between checks, in seconds. Default value: 10. Minimum value: 1.

3

LivenessProbe.TimeoutSeconds

integer

No

The timeout period for the probe, in seconds. Default value: 1. Minimum value: 1.

1

Command

array

No

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

string

No

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

sleep

SecurityContext.RunAsUser

integer

No

The user ID used to run the container.

1000

ReadinessProbe.HttpGet.Path

string

No

The path to probe for HTTP GET requests when HTTP is used for health checks.

/healthz

LivenessProbe.Exec.Command

array

No

The command to execute in the container when the command line is used for health checks.

string

No

The command to execute in the container when the command line is used for health checks.

cat /tmp/healthy

LifecyclePostStartHandlerHttpGetHost

string

No

The host address that receives HTTP GET requests when HTTP is used to configure the PostStart callback function.

10.0.XX.XX

LifecyclePostStartHandlerHttpGetPort

integer

No

The port number to probe for HTTP GET requests when HTTP is used to configure the PostStart callback function.

5050

LifecyclePostStartHandlerHttpGetPath

string

No

The path to probe for HTTP GET requests when HTTP is used to configure the PostStart callback function.

/healthyz

LifecyclePostStartHandlerHttpGetScheme

string

No

The protocol type for the HTTP GET request when HTTP is used for the Settings of the PostStart callback function. Valid values:

  • HTTP

  • HTTPS

HTTPS

LifecyclePostStartHandlerExec

array

No

The command to execute in the container when the command line is used to configure the PostStart callback function.

string

No

The command to execute in the container when the command line is used to configure the PostStart callback function.

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

LifecyclePostStartHandlerTcpSocketHost

string

No

The host address to probe when a TCP socket is used to configure the PostStart callback function.

10.0.XX.XX

LifecyclePostStartHandlerTcpSocketPort

integer

No

The port number to probe when a TCP socket is used to configure the PostStart callback function.

80

LifecyclePreStopHandlerHttpGetHost

string

No

The host address that receives HTTP GET requests when HTTP is used to configure the PreStop callback function.

10.0.XX.XX

LifecyclePreStopHandlerHttpGetPort

integer

No

The port number to probe for HTTP GET requests when HTTP is used to configure the PreStop callback function.

80

LifecyclePreStopHandlerHttpGetPath

string

No

The path to probe for HTTP GET requests when HTTP is used to configure the PreStop callback function.

/healthyz

LifecyclePreStopHandlerHttpGetScheme

string

No

The protocol type for the HTTP GET request when HTTP is used for the Settings of the PreStop callback function. Valid values:

  • HTTP

  • HTTPS

HTTP

LifecyclePreStopHandlerExec

array

No

The command to execute in the container when the command line is used to configure the PreStop callback function.

string

No

The command to execute in the container when the command line is used to configure the PreStop callback function.

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

LifecyclePreStopHandlerTcpSocketHost

string

No

The host address to probe when a TCP socket is used to configure the PreStop callback function.

10.0.XX.XX

LifecyclePreStopHandlerTcpSocketPort

integer

No

The port number to probe when a TCP socket is used to configure the PreStop callback function.

80

Volume

array<object>

No

The volume information.

array<object>

No

The volume information.

Type

string

No

The volume type. Valid values:

  • EmptyDirVolume

  • NFSVolume

  • ConfigFileVolume

  • FlexVolume

EmptyDirVolume

DiskVolume.DiskSize

integer

No

The size of the disk volume. Unit: GiB.

15

NFSVolume.Path

string

No

The path of the NFS volume.

/share

FlexVolume.FsType

string

No

The type of the file system to be mounted. The default value depends on the script of the FlexVolume.

ext4

DiskVolume.FsType

string

No

This file system type is not recommended. Use the FlexVolume.FsType parameter instead.

xfs

HostPathVolume.Type

string

No

The type of the host directory, such as File, Directory, or Socket.

Directory

NFSVolume.ReadOnly

boolean

No

Specifies whether the NFS volume is read-only. Valid values:

  • true: Read-only.

  • false: Readable and writable.

Default value: false.

false

HostPathVolume.Path

string

No

The absolute path on the host.

/xx/xx/name

FlexVolume.Options

string

No

The list of options for the FlexVolume object. The options are in key-value pair format and passed in JSON.

For example, when you mount a cloud disk by using FlexVolume, the format of Options is {"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"}.

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

FlexVolume.Driver

string

No

The name of the driver used for the FlexVolume.

flexvolume

ConfigFileVolumeDefaultMode

integer

No

The default permissions for the ConfigFileVolume.

0644

NFSVolume.Server

string

No

The address of the NFS server.

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

DiskVolume.DiskId

string

No

The ID of the disk volume.

d-xx

Name

string

No

The name of the volume.

default-volume1

EmptyDirVolume.Medium

string

No

The storage medium of the EmptyDirVolume. The default value is empty, which indicates that the node file system is used. The value can be set to memory, which indicates that the memory is used.

memory

ConfigFileVolumeConfigFileToPath

array<object>

No

The list of configuration file paths.

object

No

The list of configuration file paths.

Path

string

No

The relative file path.

/usr/bin/

Mode

integer

No

The directory permissions for the ConfigFileVolume.

0644

Content

string

No

The content of the configuration file (32 KB).

bGl1bWk=

EmptyDirVolume.SizeLimit

string

No

The size of the EmptyDir volume. Include a unit when you specify the value. Gi or Mi is recommended.

256 Mi

InitContainer

array<object>

No

The list of init containers.

array<object>

No

The list of init containers.

InitContainerEnvironmentVar

array<object>

No

The environment variable information.

object

No

The environment variable information.

Key

string

No

The name of the environment variable. The name must be 1 to 128 characters in length and can contain letters, digits, and underscores (_). It cannot start with a digit.

Path

Value

string

No

The value of the environment variable. The value must be 0 to 256 characters in length.

/usr/bin/

SecurityContext.Capability.Add

array

No

Grants specific permissions to processes in the container. Only NET_ADMIN and NET_RAW are supported.

Note

NET_RAW is not supported by default. Submit a ticket to apply for this permission.

string

No

Grants specific permissions to processes in the container. Only NET_ADMIN and NET_RAW are supported.

Note

NET_RAW is not supported by default. Submit a ticket to apply for this permission.

NET_ADMIN

Image

string

No

The image used by the container.

nginx

InitContainerVolumeMount

array<object>

No

The volume mount information.

object

No

The volume mount information.

MountPropagation

string

No

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

  • None: The volume does not receive any subsequent mounts that are executed on the volume or its subdirectories.

  • HostToCotainer: The volume receives all subsequent mounts that are executed on the volume or its subdirectories.

  • Bidirectional: Similar to HostToCotainer, the volume receives all subsequent mounts. Additionally, the volume is propagated back to the host and to all containers of all pods that use the same volume.

Default value: None.

None

MountPath

string

No

The mount directory.

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

/usr/share/

ReadOnly

boolean

No

Specifies whether the mount path is read-only. Valid values:

  • true: Read-only.

  • false: Readable and writable.

Default value: false.

false

Name

string

No

The name of the mounted volume.

test-empty

SubPath

string

No

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

/usr/sub/

ImagePullPolicy

string

No

The image pull policy. Valid values:

  • Always: Always pulls the image.

  • IfNotPresent: Pulls the image on demand. Uses the local image first. If no local image is available, pulls the image.

  • Never: Never pulls the image. Uses the local image.

Always

Cpu

number

No

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

0.5

WorkingDir

string

No

The working directory.

/usr/local

Command

array

No

The startup command of the container.

string

No

The startup command of the container.

sleep

Arg

array

No

The startup arguments of the container.

string

No

The startup arguments of the container.

10

SecurityContext.RunAsUser

integer

No

The user ID used to run the container.

587

Gpu

integer

No

The number of GPUs allocated to the container.

1

Memory

number

No

The memory size. Unit: GiB.

1.0

Name

string

No

The name of the container.

test-init

DnsConfigNameServer

array

No

The list of IP addresses of DNS servers.

string

No

The list of IP addresses of DNS servers.

172.10.*.**

DnsConfigSearch

array

No

The list of DNS search domains.

string

No

The list of DNS search domains.

svc.local.kubenetes

DnsConfigOption

array<object>

No

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

object

No

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

Value

string

No

The value of the object variable.

value

Name

string

No

The name of the object variable.

name

HostAliase

array<object>

No

The custom hostname mapping for a container in the instance.

object

No

The custom hostname mapping for a container in the instance.

Ip

string

No

The IP address to be added.

192.0.XX.XX

Hostname

array

No

The hostname to be added.

string

No

The hostname to be added.

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

SecurityContextSysctl

array<object>

No

The security context for the pod runtime.

object

No

The security context for the pod runtime.

Value

string

No

The variable value of the contextual security for the instance runtime.

65536

Name

string

No

The system name of the security context for the instance runtime.

kernel.msgmax

NtpServer

array

No

The NTP server.

string

No

The NTP server.

ntp.cloud.aliyuncs.com

AcrRegistryInfo

array<object>

No

The information about the ACR Enterprise instance.

object

No

The information about the ACR Enterprise instance.

Domain

array

No

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

string

No

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

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

InstanceName

string

No

The name of the ACR Enterprise instance.

acr-test

InstanceId

string

No

The instance ID of the ACR Enterprise instance.

cri-nwj395hgf6f3****

RegionId

string

No

The region ID of the ACR Enterprise instance.

cn-hangzhou

CostOptimization

boolean

No

Specifies whether to enable cost optimization. Valid values:

  • true: Enabled.

  • false: Disabled.

Default value: false.

false

InstanceFamilyLevel

string

No

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

  • EntryLevel: Entry-level, which refers to shared instance types. This level provides lower costs but cannot guarantee stable computing performance. It is suitable for scenarios with low CPU utilization. For more information, see Shared instance families.

  • EnterpriseLevel: Enterprise-level. This level provides stable performance and dedicated resources, and is suitable for scenarios that require high stability. For more information, see Instance families.

  • CreditEntryLevel: Credit-based entry-level, which refers to burstable instances. This level ensures computing performance by using CPU credits and is suitable for scenarios with low CPU utilization but occasional CPU bursts. For more information, see Overview of burstable instances.

EnterpriseLevel

ContainersUpdateType

string

No

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

  • RenewUpdate: Full update. The Containers parameter in the request parameters prevails and overwrites the original Containers parameter configurations.

  • IncrementalUpdate: Incremental update. Containers are matched based on Containers.Name. Only the parameters specified in the request parameters are updated. Unspecified parameters are not updated.

Default value: RenewUpdate.

RenewUpdate

InstanceType

array

No

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

string

No

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

ecs.g6.large

DataCacheBucket

string

No

The data cache bucket.

default

DataCachePL

string

No

The performance level of the cloud disk used for data caching. We recommend ESSDs. Valid values for ESSDs:

  • PL0: Up to 10,000 random read/write IOPS per disk.

  • PL1: Up to 50,000 random read/write IOPS per disk.

  • PL2: Up to 100,000 random read/write IOPS per disk.

  • PL3: Up to 1,000,000 random read/write IOPS per disk.

Default value: PL1.

Note

For more information about ESSDs, see ESSDs.

PL1

DataCacheProvisionedIops

integer

No

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

Note

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

40000

DataCacheBurstingEnabled

boolean

No

Specifies whether to enable the burstable performance feature when an ESSD AutoPL cloud disk is used for data caching. Valid values:

  • true: Enabled.

  • false: Disabled.

Default value: false.

Note

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

false

GpuDriverVersion

string

No

The GPU driver version. Valid values:

  • tesla=470.82.01 (default)

  • tesla=525.85.12

Note

Only specific instance types support switching the GPU driver version. For more information, see Create an instance by specifying a GPU instance type.

tesla=525.85.12

Override

boolean

No

Specifies whether to overwrite. Valid values:

  • true: Overwrite.

  • false: Do not overwrite.

false

Response elements

Element

Type

Description

Example

object

RequestId

string

The unique ID of the request.

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

Examples

Success response

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

403 Forbidden.RiskControl Forbidden.RiskControl

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.