All Products
Search
Document Center

Auto Scaling:CreateEciScalingConfiguration

更新時間:Dec 17, 2024

Creates a scaling configuration of the Elastic Container Instance type. Auto Scaling uses the scaling configuration as a template to create elastic container instances to meet your business requirements during scale-out events.

Operation description

A scaling configuration is a template that is used to create elastic container instances during scale-out events.

You can specify CPU and Memory to determine the range of instance types. Then, Auto Scaling determines the available instance types based on factors such as I/O optimization requirements and zones. Auto Scaling preferentially creates elastic container instances by using the lowest-priced instance type. This method applies only if you set Scaling Policy to Cost Optimization Policy and no instance type is specified in the scaling configuration.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
ess:CreateEciScalingConfigurationcreate
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
ScalingGroupIdstringYes

The ID of the scaling group to which the scaling configuration belongs.

asg-bp14wlu85wrpchm0****
ScalingConfigurationNamestringYes

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 (.). It must start with a letter or a digit.

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

scalingconfig****
DescriptionstringYes
Note This parameter is unavailable for use.
desc
SecurityGroupIdstringYes

The ID of the security group to which elastic container instances belong. Elastic container instances that belong to 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 then adds the container protocols and port numbers that you specified to the inbound rules of the security group.

sg-uf66jeqopgqa9hdn****
ContainerGroupNamestringYes

The name series of elastic container instances.

If you want to use an ordered instance name, specify the value for this parameter in the following format: name_prefix[begin_number,bits]name_suffix.

nginx-test
RestartPolicystringNo

The restart policy of elastic container instances. Valid values:

  • Always: always restarts elastic container instances.
  • Never: never restarts elastic container instances.
  • OnFailure: restarts elastic container instances upon failures.

Default value: Always.

Always
CpufloatNo

The number of vCPUs per elastic container instance.

1.0
MemoryfloatNo

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

2.0
ResourceGroupIdstringNo

The ID of the resource group.

rg-uf66jeqopgqa9hdn****
DnsPolicystringNo

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.
Default
EnableSlsbooleanNo
Note This parameter is unavailable for use.
false
ImageSnapshotIdstringNo

The ID of the image cache.

imc-2zebxkiifuyzzlhl****
RamRoleNamestringNo

The name of the instance Resource Access Management (RAM) role. 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.

RamTestRole
TerminationGracePeriodSecondslongNo

The buffer time during which a program handles operations before the program stops. Unit: seconds.

60
AutoMatchImageCachebooleanNo

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

  • true
  • false

Default value: false.

false
Ipv6AddressCountintegerNo

The number of IPv6 addresses.

1
ActiveDeadlineSecondslongNo

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

1000
SpotStrategystringNo

The instance bidding policy. Valid values:

  • NoSpot: The instances are created as pay-as-you-go instances.
  • SpotWithPriceLimit: The instances are 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
SpotPriceLimitfloatNo

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.

0.025
AutoCreateEipbooleanNo

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

true
EipBandwidthintegerNo

The EIP bandwidth. Default value: 5. Unit: Mbit/s.

5
HostNamestringNo

The hostname series of elastic container instances.

test
IngressBandwidthlongNo

The maximum inbound bandwidth. Unit: bit/s.

1024000
EgressBandwidthlongNo

The maximum outbound bandwidth. Unit: bit/s.

1024000
CpuOptionsCoreintegerNo

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

2
CpuOptionsThreadsPerCoreintegerNo

The number of threads per core. You can specify this parameter for specific instance types. A value of 1 specifies that Hyper-Threading is disabled. For more information, see Specify CPU options.

2
EphemeralStorageintegerNo

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

20
LoadBalancerWeightintegerNo

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

Default value: 50.

50
Tagsarray<object>No

The tags of elastic container instances. Tags must be specified as key-value pairs. You can specify up to 20 tags for each elastic container instance. When you specify Key and Value, take note of the following items:

  • A tag key can be up to 64 characters in length. The key cannot start with acs: or aliyun or contain http:// or https://. You cannot specify an empty string as a tag key.
  • A tag value can be up to 128 characters in length. The value cannot start with acs: or aliyun or contain http:// or https://. You can specify an empty string as a tag value.
objectNo

The tag of the elastic container instance. Tags must be specified as key-value pairs. You can specify up to 20 tags for each elastic container instance. When you specify Key and Value, take note of the following items:

  • A tag key can be up to 64 characters in length. The key cannot start with acs: or aliyun or contain http:// or https://. You cannot specify an empty string as a tag key.
  • A tag value can be up to 128 characters in length. The value cannot start with acs: or aliyun or contain http:// or https://. You can specify an empty string as a tag value.
KeystringNo

The tag key of the elastic container instance.

The tag key cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with acs: or aliyun or contain http:// or https://.

version
ValuestringNo

The tag value of the elastic container instance.

The tag value can be an empty string. The tag value can be up to 128 characters in length. It cannot start with acs: and cannot contain http:// or https://.

3
ImageRegistryCredentialsarray<object>No

The image repositories.

objectNo

The image repository.

PasswordstringNo

The password of the image repository.

yourpaasword
ServerstringNo

The endpoint of the image repository.

registry-vpc.cn-shanghai.aliyuncs.com
UserNamestringNo

The username of the image repository.

yourusername
Containersarray<object>No

The containers on the elastic container instance.

objectNo

The container on the elastic container instance.

ReadinessProbe.TimeoutSecondsintegerNo

The timeout limit for a readiness probe to be complete. Unit: seconds. Default value: 1. Minimum value: 1.

5
ReadinessProbe.SuccessThresholdintegerNo

The minimum number of consecutive successes that must occur for a failed readiness probe to be considered successful. Default value: 1. Set the value to 1.

1
SecurityContext.Capability.AddarrayNo

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, submit a ticket.
stringNo

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, submit a ticket.
NET_ADMIN
ReadinessProbe.TcpSocket.PortintegerNo

The port detected by the TCP socket that you use to perform a readiness probe.

8000
ReadinessProbe.HttpGet.SchemestringNo

The protocol type of the HTTP GET request that you send to perform a readiness probe. Valid values:

  • HTTP
  • HTTPS
HTTP
LivenessProbe.PeriodSecondsintegerNo

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

5
Portsarray<object>No

The ports.

objectNo

The port.

ProtocolstringNo

The protocol type. Valid values:

  • TCP
  • UDP
TCP
PortintegerNo

The port number. Valid values: 1 to 65535.

80
SecurityContext.ReadOnlyRootFilesystembooleanNo

Specifies whether the root file system on which the container runs is read-only. Set the value to true.

true
EnvironmentVarsarray<object>No

The environment variables.

objectNo

The environment variable.

KeystringNo

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

PATH
ValuestringNo

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

/usr/local/bin
FieldRefFieldPathstringNo
Note This parameter is unavailable for use.
fieldPath
LivenessProbe.TcpSocket.PortintegerNo

The port detected by the TCP socket that you use to perform a liveness probe.

8000
TtybooleanNo

Specifies whether to enable the Interaction feature. Valid values:

  • true
  • false

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

Default value: false.

false
WorkingDirstringNo

The working directory of the container.

/usr/local/
LivenessProbe.HttpGet.SchemestringNo

The protocol type of the HTTP GET request that you send to perform a liveness probe. Valid values:

  • HTTP
  • HTTPS
HTTP
ReadinessProbe.HttpGet.PortintegerNo

The port over which you send an HTTP GET request to perform a readiness probe.

8080
ArgsarrayNo

The startup arguments of the containers. You can specify up to 10 arguments.

stringNo

The startup argument of the container. You can specify up to 10 arguments.

100
GpuintegerNo

The number of GPUs per container.

1
ReadinessProbe.InitialDelaySecondsintegerNo

The number of seconds that elapse from the startup of the container to the start time of a readiness probe.

3
StdinbooleanNo

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
MemoryfloatNo

The memory size per container. Unit: GiB.

0.5
NamestringNo

The name of the container image.

nginx
ImagestringNo

The container image.

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

The number of seconds that elapse from the startup of the container to the start time of a liveness probe.

5
VolumeMountsarray<object>No

The volume mounts of the container.

objectNo

The volume mount of the container.

MountPropagationstringNo

The mount propagation settings of the volume. Mount propagation enables volume sharing from one container to other containers within the same pod or to containers across separate pods on the same node. Valid values:

  • None: Subsequent mounts executed on the volume or its subdirectories do not propagate to the volume.
  • HostToCotainer: Subsequent mounts executed on the volume or its subdirectories propagate to the volume.
  • Bidirectional: This value is similar to HostToCotainer. Subsequent mounts executed on the volume or its subdirectories propagate to the volume. All volume mounts executed on the container not only propagate back to the underlying host but also to all containers across every pod that uses the same volume.

Default value: None.

None
MountPathstringNo

The directory to which the container mounts the volume.

Note Data in this directory is overwritten by data on the volume. Specify this parameter with caution.
/pod/data
ReadOnlybooleanNo

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

  • true
  • false

Default value: false.

false
NamestringNo

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

default-volume1
SubPathstringNo

The subdirectory of the volume.

data2/
LivenessProbe.FailureThresholdintegerNo

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

Default value: 3.

3
ReadinessProbe.Exec.CommandsarrayNo

The commands executed in the container when using the command line to perform the health check.

stringNo

The command.

cat /tmp/healthy
ReadinessProbe.FailureThresholdintegerNo

The minimum number of consecutive failures that must occur for a successful readiness probe to be considered failed. Default value: 3.

3
ImagePullPolicystringNo

The image pulling policy. Valid values:

  • Always: Each time instances are created, image pulling is performed.
  • IfNotPresent: Image pulling is performed as needed. On-premises images are preferentially used. If no on-premises images are available, image pulling is performed.
  • Never: On-premises images are always used. Image pulling is not performed.
Always
StdinOncebooleanNo

Specifies whether standard input streams remain connected during multiple sessions if Stdin is set to true.

If you set 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 the container is restarted.

false
CpufloatNo

The number of vCPUs per container.

0.25
LivenessProbe.HttpGet.PortintegerNo

The port over which you send an HTTP GET request to perform a liveness probe.

8888
LivenessProbe.HttpGet.PathstringNo

The path to which you send an HTTP GET request to perform a liveness probe.

/healthyz
LivenessProbe.SuccessThresholdintegerNo

The minimum number of consecutive successes that must occur for a failed liveness probe to be considered successful. Default value: 1. Set the value to 1.

1
ReadinessProbe.PeriodSecondsintegerNo

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

3
LivenessProbe.TimeoutSecondsintegerNo

The timeout limit for a liveness probe to be complete. Unit: seconds. Default value: 1. Minimum value: 1.

1
CommandsarrayNo

The commands that you can run by using a CLI to perform liveness probes within the container.

stringNo

The command that you can run by using a CLI to perform a liveness probe within the container.

sleep
SecurityContext.RunAsUserlongNo

The ID of the user that runs the container.

1000
ReadinessProbe.HttpGet.PathstringNo

The path to which you send an HTTP GET request to perform a readiness probe.

/healthz
LivenessProbe.Exec.CommandsarrayNo

The commands executed in the container when using the command line to perform the health check.

stringNo

The command.

cat /tmp/healthy
LifecyclePostStartHandlerHttpGetHoststringNo

The IP address of the host to which you send an HTTP GET request to configure the postStart callback function.

10.0.XX.XX
LifecyclePostStartHandlerHttpGetPortintegerNo

The port over which you send an HTTP GET request to configure the postStart callback function.

5050
LifecyclePostStartHandlerHttpGetPathstringNo

The path to which you send an HTTP GET request to configure the postStart callback function.

/healthyz
LifecyclePostStartHandlerHttpGetSchemestringNo

The protocol type of the HTTP GET request that you send to configure the postStart callback function. Valid values:

  • HTTP
  • HTTPS
HTTPS
LifecyclePostStartHandlerExecsarrayNo

The commands that you can run by using a CLI to configure the postStart callback function within the container.

stringNo

The command that you can run by using a CLI to configure the postStart callback function within the container.

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

The IP address of the host detected by the TCP socket that you use to configure the postStart callback function.

10.0.XX.XX
LifecyclePostStartHandlerTcpSocketPortintegerNo

The port detected by the TCP socket that you use to configure the postStart callback function.

80
LifecyclePreStopHandlerHttpGetHoststringNo

The IP address of the host to which you send an HTTP GET request to configure the preStop callback function.

10.0.XX.XX
LifecyclePreStopHandlerHttpGetPortintegerNo

The port over which you send an HTTP GET request to configure the preStop callback function.

88
LifecyclePreStopHandlerHttpGetPathstringNo

The path to which you send an HTTP GET request to configure the preStop callback function.

/healthyz
LifecyclePreStopHandlerHttpGetSchemestringNo

The protocol type of the HTTP GET request that you send to configure the preStop callback function. Valid values:

  • HTTP
  • HTTPS
HTTP
LifecyclePreStopHandlerExecsarrayNo

The commands that you can run by using a CLI to configure the preStop callback function within the container.

stringNo

The command that you can run by using a CLI to configure the preStop callback function within the container.

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

The IP address of the host detected by the TCP socket that you use to configure the preStop callback function.

10.0.XX.XX
LifecyclePreStopHandlerTcpSocketPortintegerNo

The port detected by the TCP socket that you use to configure the preStop callback function.

90
Volumesarray<object>No

The volumes.

objectNo

The volume.

TypestringNo

The type of the Host directory. Examples: File, Directory, and Socket.

ConfigFileVolume
DiskVolume.DiskSizeintegerNo

The size of the volume. Unit: GiB.

15
NFSVolume.PathstringNo

The path to the NFS volume.

/share
FlexVolume.FsTypestringNo

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

ext4
DiskVolume.FsTypestringNo

The type of the disk volume. We recommend that you specify FlexVolume.FsType instead of DiskVolume.FsType.

xfs
HostPathVolume.TypestringNo

The type of host directory. For example: File, Directory, Socket, etc.

Directory
NFSVolume.ReadOnlybooleanNo

Specifies whether the permissions on the NFS volume are read-only. Valid values:

  • true
  • false

Default value: false.

false
HostPathVolume.PathstringNo

The absolute path on the host.

/xx/xx/path
FlexVolume.OptionsstringNo

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

For example, if you use FlexVolume to mount a disk, specify the value in the {"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"} format.

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

The name of the FlexVolume driver.

flexvolume
ConfigFileVolumeDefaultModeintegerNo

The default permissions on the ConfigFile volume.

0644
NFSVolume.ServerstringNo

The endpoint of the NFS server.

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

The ID of the disk volume.

d-xx
NamestringNo

The name of the volume.

default-volume1
EmptyDirVolume.MediumstringNo

The storage medium of the emptyDir volume. By default, this parameter is left empty. In this case, the emptyDir volume uses the file system of the node as the storage medium. A value of memory specifies that the emptyDir volume uses the memory as the storage medium.

memory
ConfigFileVolumeConfigFileToPathsarray<object>No

The paths to the configuration files.

objectNo

The path to the configuration file.

PathstringNo

The name of the environment variable.

PATH
ModeintegerNo

The permissions on the configuration file.

0644
ContentstringNo

The content of the configuration file (32 KB).

bGl1bWk=
EmptyDirVolume.SizeLimitstringNo

The size of the emptyDir volume. The value contains a unit. We recommend that you use Gi or Mi as the unit.

256Mi
InitContainersarray<object>No

The init containers.

objectNo

The init container.

InitContainerEnvironmentVarsarray<object>No

The environment variables of the init container.

objectNo

The environment variable of the init container.

KeystringNo

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 [0-9a-zA-Z] format.

Path
ValuestringNo

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

/usr/bin/
FieldRefFieldPathstringNo
Note This parameter is unavailable for use.
path
SecurityContext.Capability.AddsarrayNo

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

Note To use NET_RAW, submit a ticket.
stringNo

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

Note To use NET_RAW, submit a ticket.
NET_ADMIN
ImagestringNo

The image of the init container.

nginx
InitContainerPortsarray<object>No

The ports of init containers.

objectNo

The port of the init container.

ProtocolstringNo

The protocol type. Valid values:

  • TCP
  • UDP
TCP
PortintegerNo

The port number. Valid values: 1 to 65535.

1
InitContainerVolumeMountsarray<object>No

The volume mounts of the init container.

objectNo

The volume mount of the init container.

MountPropagationstringNo

The mount propagation settings of the volume. Mount propagation enables volume sharing from one container to other containers within the same pod or to containers across separate pods on the same node. Valid values:

  • None: Subsequent mounts executed on the volume or its subdirectories do not propagate to the volume.
  • HostToCotainer: Subsequent mounts executed on the volume or its subdirectories propagate to the volume.
  • Bidirectional: This value is similar to HostToCotainer. Subsequent mounts executed on the volume or its subdirectories propagate to the volume. All volume mounts executed on the container not only propagate back to the underlying host but also to all containers across every pod that uses the same volume.
None
MountPathstringNo

The directory to which the init container mounts the volume. The data stored in this directory is overwritten by the data on the volume. Specify this parameter with caution.

/usr/share/
ReadOnlybooleanNo

Specifies whether the mount path is read-only.

Default value: false.

false
NamestringNo

The name of the volume.

test-empty
SubPathstringNo

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

/usr/sub/
SecurityContext.ReadOnlyRootFilesystembooleanNo

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

true
ImagePullPolicystringNo

The image pulling policy.

Always
CpufloatNo

The number of vCPUs per init container.

0.5
WorkingDirstringNo

The working directory of the init container.

/usr/local
CommandsarrayNo

The startup commands of the init container.

stringNo

The startup command of the init container.

sleep
ArgsarrayNo

The startup arguments of the init container. You can specify up to 10 arguments.

stringNo

The startup argument of the init container. You can specify up to 10 arguments.

100
SecurityContext.RunAsUserlongNo

The ID of the user that runs the init container.

587
GpuintegerNo

The number of GPUs per init container.

1
MemoryfloatNo

The memory size per init container. Unit: GiB.

1.0
NamestringNo

The name of the init container.

test-init
DnsConfigNameServersarrayNo

The IP addresses of the DNS servers.

stringNo

The IP address of the DNS server.

172.10.*.**
DnsConfigSearchsarrayNo

The search domains of the DNS servers.

stringNo

The search domain of the DNS server.

svc.local.kubenetes
DnsConfigOptionsarray<object>No

The options. Each option is a name-value pair. The value in the name-value pair is optional.

objectNo

The option. Each option is a name-value pair. The value in the name-value pair is optional.

ValuestringNo

The variable value of the option.

value
NamestringNo

The variable name of the option.

name
HostAliasesarray<object>No

The custom hostnames of the containers.

objectNo

The custom hostname of the container.

IpstringNo

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

1.1.1.1
HostnamesarrayNo

The hostnames of the containers that you want to add.

stringNo

The hostname of the container that you want to add.

hehe.com
SecurityContextSysctlsarray<object>No

The system information of the security context in which the elastic container instance runs.

objectNo

The system information of the security context in which the elastic container instance runs.

ValuestringNo

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

65536
NamestringNo

The variable name of the security context in which the container group runs.

kernel.msgmax
NtpServersarrayNo

The endpoints of the Network Time Protocol (NTP) servers.

stringNo

The endpoint of the NTP server.

ntp.cloud.aliyuncs.com
AcrRegistryInfosarray<object>No

The Container Registry Enterprise Edition instances.

objectNo

The Container Registry Enterprise Edition instance.

DomainsarrayNo

The domain names of the Container Registry Enterprise Edition instances. By default, all domain names are displayed. Separate multiple domain names with commas (,).

stringNo

The domain name of the Container Registry Enterprise Edition instance. By default, all domain names are displayed. Separate multiple domain names with commas (,).

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

The name of the Container Registry Enterprise Edition instance.

acr-test
InstanceIdstringNo

The ID of the Container Registry Enterprise Edition instance.

cri-nwj395hgf6f3****
RegionIdstringNo

The region ID of the Container Registry Enterprise Edition instance.

cn-beijing
CostOptimizationbooleanNo

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

  • true
  • false
false
InstanceFamilyLevelstringNo

The level of the instance family. You can specify this parameter to match the available instance types. This parameter takes effect only if you set CostOptimization to true. Valid values:

  • EntryLevel: entry level (shared instance types). Instance types of this level are the most cost-effective, but may not ensure stable computing performance. Instance types of this level are suitable for 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 scenarios in which the CPU utilization is low but may fluctuate in specific cases. For more information, see Overview of burstable instances.
EnterpriseLevel
InstanceTypesarrayNo

The ECS instance types that you want to use to create elastic container instances. You can specify up to five ECS instance types.

stringNo

The ECS instance type that you want to use to create elastic container instances. You can specify up to five ECS instance types. For more information, see Specify ECS instance types to create an elastic container instance.

ecs.g6.large
DataCacheBucketstringNo

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

default
DataCachePLstringNo

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

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

The provisioned IOPS of the ESSD AutoPL disk that you want to use to store data caches. Valid values: 0 to min{50,000, 1,000 × *Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × *Capacity, 50,000}.

Note For more information about ESSD AutoPL disks, see ESSD AutoPL disks.
40000
DataCacheBurstingEnabledbooleanNo

Specifies whether to enable the performance burst feature when ESSD AutoPL disks are used to store data caches. Valid values:

  • true
  • false

Default value: false.

Note For more information about ESSD AutoPL disks, see ESSD AutoPL disks.
false
GpuDriverVersionstringNo

The version of the GPU driver. Valid values:

  • tesla=470.82.01 (default)
  • tesla=525.85.12
Note You can switch the GPU driver version only for a few Elastic Compute Service (ECS) instance types. For more information, see Specify GPU-accelerated ECS instance types to create an elastic container instance.
tesla=525.85.12

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

ScalingConfigurationIdstring

The ID of the elastic container instance (container group).

eci-uf6fonnghi50u374****
RequestIdstring

The request ID.

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

Examples

Sample success responses

JSONformat

{
  "ScalingConfigurationId": "eci-uf6fonnghi50u374****",
  "RequestId": "89945DD3-9072-47D0-A318-353284CF****"
}

Error codes

HTTP status codeError codeError message
403Forbidden.RiskControlForbidden.RiskControl

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-12-03The Error code has changed. The request parameters of the API has changedView Change Details
2024-01-23The Error code has changedView Change Details
2023-11-14The Error code has changed. The request parameters of the API has changedView Change Details
2023-10-11The Error code has changed. The request parameters of the API has changedView Change Details
2023-07-12The Error code has changedView Change Details