You can call the CreateDBInstance operation to create an ApsaraDB RDS instance.

Before you call this operation, make sure that you understand the billing methods and pricing of ApsaraDB RDS. For more information, see Billable items, billing methods, and pricing.

For more information about ApsaraDB RDS instance types, see Primary ApsaraDB RDS instance types.

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 for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateDBInstance

The operation that you want to perform. Set the value to CreateDBInstance.

RegionId String Yes cn-hangzhou

The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list.

Engine String Yes MySQL

The database engine that is run by the instance. Valid values:

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
EngineVersion String Yes 5.6

The database engine version that is run on the instance.

  • Valid values when you set the Engine parameter to MySQL: 5.5, 5.6, 5.7, and 8.0
  • Valid values when you set the Engine parameter to SQL Server: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha, and 2019_ent
  • Valid values when you set the Engine parameter to PostgreSQL: 10.0, 11.0, 12.0, 13.0, and 14.0
  • Valid values when you set the Engine parameter to MariaDB: 10.3
DBInstanceClass String Yes rds.mysql.s1.small

The instance type of the instance. For more information, see Primary ApsaraDB RDS instance types. You can also call the DescribeAvailableResource operation to query the available instance types in a region.

DBInstanceStorage Integer Yes 20

The storage capacity of the instance. Unit: GB. The storage capacity increases in increments of 5 GB. For more information, see Primary ApsaraDB RDS instance types. You can also call the DescribeAvailableResource operation to query the storage capacity range that is supported for a specified instance type in a region.

SystemDBCharset String No gbk

The character set that is used by the instance. This parameter has been deprecated.

DBInstanceNetType String Yes Internet

The type of the network connection to the instance. Valid values:

  • Internet: Internet
  • Intranet: internal network
DBInstanceDescription String No testdatabase

The name of the instance. The name must be 2 to 255 characters in length and can contain letters, digits, underscores (_), and hyphens (-). The name must start with a letter.

Note The name cannot start with http:// or https://.
SecurityIPList String Yes 10.10.XX.XX/24

The IP address allowlist of the instance. For more information, see Use a database client or the CLI to connect to an ApsaraDB RDS for MySQL instance. If the IP address allowlist contains more than one entry, separate the entries with commas (,). Each entry must be unique. The IP address allowlist can contain up to 1,000 entries. The entries in the IP address allowlist must be in one of the following formats:

  • IP addresses, such as 10.10.XX.XX.
  • CIDR blocks, such as 10.10.XX.XX/24. In this example, 24 indicates that the prefix of each IP address in the IP address allowlist is 24 bits in length. You can replace 24 with a value within the range of 1 to 32.
ClientToken String No ETnLKlblzczshOTUbOCz*****

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that the generated token is unique among different requests. The token can only contain ASCII characters and cannot exceed 64 characters in length.

PayType String Yes Postpaid

The billing method of the instance. Valid values:

  • Postpaid: pay-as-you-go
  • Prepaid: subscription
Note The system automatically generates a purchase order and completes the payment.
ZoneId String No cn-hangzhou-b

The ID of the zone in which the primary instance resides.

Note
  • If you specify a virtual private cloud (VPC) and a vSwitch, you must specify the ID of the zone to which the specified vSwitch belongs. Otherwise, the instance cannot be created.
  • If the instance runs RDS High-availability Edition, you must specify the ZoneIdSlave1 parameter, which specifies whether to use the single-zone deployment method or the multi-zone deployment method.
  • If the instance runs RDS Enterprise Edition, you must specify the ZoneIdSlave1 and ZoneIdSlave2 parameters, which specify whether to use the single-zone deployment method or the multi-zone deployment method.
ZoneIdSlave1 String No cn-hangzhou-c

The ID of the zone in which the secondary instance resides. If you set the ZoneIdSlave1 parameter and the ZoneId parameter to the same value, the single-zone deployment method is used. If you set the ZoneIdSlave1 parameter and the ZoneId parameter to different values, the multi-zone deployment method is used.

ZoneIdSlave2 String No cn-hangzhou-d

The ID of the zone in which the logger instance resides. If you set the ZoneIdSlave2 parameter and the ZoneId parameter to the same value, the single-zone deployment method is used. If you set the ZoneIdSlave2 parameter and the ZoneId parameter to different values, the multi-zone deployment method is used.

InstanceNetworkType String No Classic

The network type of the instance. Valid values:

  • VPC.
  • Classic: classic network. This is the default value.
Note
  • If the instance runs MySQL and uses standard SSDs or enhanced SSDs (ESSDs), you must set this parameter to VPC.
  • If the instance runs PostgreSQL or MariaDB TX, you must set this parameter to VPC.
  • If the instance runs SQL Server Basic or SQL Server Web, you can set this parameter to VPC or Classic. If the instance runs other database engine, you must set this parameter to VPC.
ConnectionMode String No Standard

The connection mode of the instance. Valid values:

  • Standard: standard mode
  • Safe: database proxy mode

The system automatically assigns a connection mode to the instance.

Note SQL Server 2012, SQL Server 2016, and SQL Server 2017 support only the standard mode.
VPCId String No vpc-*****

The ID of the VPC to which the instance belongs.

Note If you set the InstanceNetworkType parameter to VPC, you must specify the VPCId parameter.
VSwitchId String No vsw-*****

The ID of the vSwitch that is associated with the specified VPC. The vSwitch must belong to the zone that is specified by the ZoneId parameter.

Note If you set the InstanceNetworkType parameter to VPC, you must specify the VSwitchId parameter.
PrivateIpAddress String No 172.16.XX.XX

The private IP address of the instance. The private IP address must be within the CIDR block that is supported by the specified vSwitch. ApsaraDB RDS automatically assigns a private IP address to the instance based on the values of the VPCId and vSwitchId parameters.

UsedTime String No 2

The subscription duration of the instance. Valid values:

  • If you set the Period parameter to Year, the value of the UsedTime parameter ranges from 1 to 5.
  • If you set the Period parameter to Month, the value of the UsedTime parameter ranges from 1 to 11.
Note If you set the PayType parameter to Prepaid, you must specify the UsedTime parameter.
Period String No Year

Specifies whether to use yearly subscription or monthly subscription for the instance. Valid values:

  • Year
  • Month
Note If you set the PayType parameter to Prepaid, you must specify the Period parameter.
ResourceGroupId String No rg-acfmy*****

The ID of the resource group.

DBInstanceStorageType String Yes cloud_essd

The storage type of the instance. Valid values:

  • local_ssd: local SSD. This is the recommended storage type.
  • cloud_ssd: standard SSD. This storage type is not recommended. Standard SSDs are no longer available for purchase in some Alibaba Cloud regions.
  • cloud_essd: ESSDs of performance level 1 (PL1).
  • cloud_essd2: ESSDs of PL2.
  • cloud_essd3: ESSDs of PL3.
Note The default value of this parameter is determined by the instance type specified by the DBInstanceClass parameter.
  • If the instance type specifies the local SSD storage type, the default value of this parameter is local_ssd.
  • If the instance type specifies the standard SSD or ESSD storage type, the default value of this parameter is cloud_essd.
BusinessInfo String No 121436975448952

The additional business information about the instance.

EncryptionKey String No 0d24*****-da7b-4786-b981-9a164dxxxxxx

The ID of the key that is used for disk encryption in the region where the instance resides. You can obtain the ID of the key from the Key Management Service (KMS) console. You can also create a key. For more information, see Create a CMK.

Note If you specify the EncryptionKey parameter, disk encryption is automatically enabled. In this case, you must also specify the RoleARN parameter. Disk encryption cannot be disabled after it is enabled.
RoleARN String No acs:ram::1406xxxxxx:role/aliyunrdsinstanceencryptiondefaultrole

The Alibaba Cloud Resource Name (ARN) that is provided by your Alibaba Cloud account for RAM users. RAM users can use the ARN to connect ApsaraDB RDS to KMS. You can copy the ARN from the RAM console.

Note For more information about how to grant permissions to RAM users in the RAM console, see Authorize an ApsaraDB RDS for MySQL instance to access KMS.
AutoRenew String No true

Specifies whether to enable auto-renewal for the instance. You must specify this parameter only when the instance uses the subscription billing method. Valid values:

  • true
  • false
    Note
    • If you set the Period parameter to Month, the auto-renewal cycle is one month.
    • If you set the Period parameter to Year, the auto-renewal cycle is one year.
Category String No HighAvailability

The RDS edition of the instance. Valid values:

  • Basic: RDS Basic Edition
  • HighAvailability: High-availability Edition
  • AlwaysOn: Cluster Edition
  • Finance: Enterprise Edition
DedicatedHostGroupId String No dhg-4n*****

The ID of the dedicated cluster to which the instance belongs.

If you create the instance in a dedicated cluster, you must specify this parameter.

Note
TargetDedicatedHostIdForMaster String No i-bp*****1

The ID of the host to which the instance belongs in the specified dedicated cluster.

If you create the instance in a dedicated cluster, you must specify this parameter. If you do not specify this parameter, the system automatically assigns a host.

Note
TargetDedicatedHostIdForSlave String No i-bp*****2

The ID of the host to which the secondary instance belongs in the specified dedicated cluster.

If the instance runs RDS High-availability Edition or RDS Enterprise Edition and you create the instance in a dedicated cluster, you must specify this parameter. If you do not specify this parameter, the system automatically assigns a host.

Note
TargetDedicatedHostIdForLog String No i-bp*****3

The ID of the host to which the logger instance belongs in the specified dedicated cluster.

If the instance runs RDS Enterprise Edition and you create the instance in a dedicated cluster, you must specify this parameter. If you do not specify this parameter, the system automatically assigns a host.

Note
DBParamGroupId String No rpg-sys-*****

The ID of the parameter template. You can call the DescribeParameterGroups operation to query ID of the parameter template.

Note
  • If you want to create an instance that runs RDS Basic Edition and uses the X-Engine storage engine, you must call the preceding operation, locate the mysql_xengine_8.0_basic_normal_safe field in the response, find the ID of the corresponding system parameter template, and then use the ID as the value for this parameter.
  • If you want to create an instance that runs RDS High-availability Edition and uses the X-Engine storage engine, you must call the preceding operation, locate the mysql_xengine_8.0_standard_normal_safe field in the response, find the ID of the corresponding system parameter template, and then use the ID as the value for this parameter.
DBTimeZone String No +08:00

The time zone of the instance. This parameter takes effect only when you set the Engine parameter to MySQL or PostgreSQL.

  • If you set the Engine parameter to MySQL:
    • The time zone of the instance is in UTC. Valid values: -12:59 to +13:00.
    • If the instance uses local SSDs, you can specify the name of the time zone. For example, you can specify the Asia/Hong_Kong time zone. For more information, see Time zones.
  • If you set the Engine parameter to PostgreSQL:
    • The time zone of the instance is not in UTC. For more information, see Time zones.
    • You can specify this parameter only when the instance runs PostgreSQL with standard SSDs or ESSDs.
Note
  • If the instance is a primary instance, you can specify this parameter. If the instance is a read-only instance, you cannot specify this parameter. A read-only instance inherits the time zone of its primary instance.
  • If you do not specify this parameter, the system automatically assigns the default time zone of the region in which the instance resides.
DBIsIgnoreCase String No true

Specifies whether table names are case-sensitive. Valid values:

  • true: Table names are not case-sensitive. This is the default value.
  • false: Table names are case-sensitive.
TargetMinorVersion String No rds_20200229

The minor engine version that is run by the instance. You must specify this parameter only when the instance runs MySQL. Format: RDS edition_Minor engine version. Examples: rds_20200229, xcluster_20200229, and xcluster80_20200229. The following codes are used to represent RDS editions and database engine versions:

  • rds: The instance runs RDS Basic Edition or RDS High-availability Edition.
  • xcluster: The instance runs MySQL 5.7 on RDS Enterprise Edition.
  • xcluster80: The instance runs MySQL 8.0 on RDS Enterprise Edition.
Note For more information about minor engine versions, see Release notes for AliSQL.
StorageAutoScale String No Disable

Specifies whether to enable automatic storage expansion for the instance. Valid values:

  • Enable.
  • Disable. This is the default value.
Note After the instance is created, you can call the ModifyDasInstanceConfig operation to modify the settings of the automatic storage expansion feature for the instance. For more information, see Configure automatic storage expansion for an ApsaraDB RDS for MySQL instance.
StorageThreshold Integer No 50

The threshold based on which automatic storage expansion is triggered. The threshold is a percentage. Valid values:

  • 10
  • 20
  • 30
  • 40
  • 50
Note If you set the StorageAutoScale parameter to Enable, you must specify the StorageThreshold parameter.
StorageUpperBound Integer No 2000

The maximum storage capacity that is allowed for automatic storage expansion. The storage capacity of the instance cannot exceed the maximum storage capacity. Unit: GB. Valid values: an integer greater than or equal to 0.

Note If you set the StorageAutoScale parameter to Enable, you must specify the StorageUpperBound parameter.
DryRun Boolean No false

Specifies whether to conduct a precheck before the system creates the instance. Valid values:

  • true: The system prechecks the request and does not create the instance. The system prechecks items such as the request parameters, request format, service limits, and available resources.
  • false: The system sends the request without a precheck. If the request passes verification, the system creates the instance. This is the default value.
UserBackupId String No 67798*****

The ID of the backup file that is used to create the instance. You can call the ListUserBackupFiles operation to query backup files. If you create the instance by using the data of a backup file, you must specify this parameter.

Note This parameter is supported only when the following requirements are met:
  • The PayType parameter is set to Postpaid.
  • The Engine parameter is set to MySQL.
  • The EngineVersion parameter is set to 5.7.
  • The Category parameter is set to Basic.
Amount Integer No 2

The number of ApsaraDB RDS for MySQL instances that you want to create. The parameter takes effect only when you create multiple ApsaraDB RDS for MySQL instances at a time by using a single request.

Valid values: 1 to 20. Default value: 1.

Note
  • If you want to create multiple ApsaraDB RDS for MySQL instances at a time by using a single request, you can add tags to all the instances by using the Tag.N.Key parameter and the Tag.N.Value parameter. After the instances are created, you can manage the instances based on the tags.
  • After you submit a request to create multiple ApsaraDB RDS for MySQL instances, this operation returns the TaskId, RequestId, and Message parameters. You can call the DescribeDBInstanceAttribute operation to query the details about an instance.
  • If the value of the Engine parameter is not MySQL and the value of the Amount parameter is greater than 1, this operation fails and returns the InvalidParam.Engine error message.
CreateStrategy String No Atomicity

The policy based on which multiple instances are created. The parameter takes effect only when the value of the Amount parameter is greater than 1.

  • Atomicity: atomicity. The instances are all created. If one instance cannot be created, none of the instances is created.
  • Partial: non-atomicity. Each instance is independently created. The failure in creating one instance does not affect the creation of the other instances.

Default value: Atomicity.

Tag.N.Key String No testkey1

The key of the tag that you want to add to the instance. You can use this parameter to add tags to the instance. The value of the N variable in the Tag.N.Key parameter ranges from 1 to 20. You can specify this parameter multiple times to create and add multiple tags to the instance.

For example, if you want to create and add two tags to the instance, you must specify the Tag.1.Key and Tag.2.Key parameters.

Note
  • If the specified tag key is an existing key, the system directly adds the tag key to the instance. You can call the ListTagResources operation to query the details about the existing tags.
  • If the specified tag key is not an existing key, the system creates the tag key and adds the tag key to the instance.
  • The value of this parameter cannot be an empty string.
  • This parameter must be used together with the Tag.N.Value parameter.
Tag.N.Value String No testvalue1

The tag value that is associated with the specified tag key. You can use this parameter to add tags to the instance. The value of the N variable in the Tag.N.Value parameter ranges from 1 to 20. You can specify multiple values for this parameter to create and add multiple tags to the instance.

This parameter must be used together with the Tag.N.Key parameter. For example, if you specify the Tag.1.Key and Tag.2.Key parameters, you must also specify the Tag.1.Value and Tag.2.Value parameters.

Note
  • If the specified tag value is found in the specified tag key, the system directly adds the tag value to the instance. You can call the ListTagResources operation to query the details about the existing tags.
  • If the specified tag value is not found in the specified tag key, the system creates the tag value and adds the tag value to the instance.
  • This parameter must be used together with the Tag.N.Key parameter.
DeletionProtection Boolean No true

Specifies whether to enable the release protection feature for the instance.

  • true: The release protection is enabled.
  • false: The release protection is disabled. This is the default value.
BabelfishConfig String No {"babelfishEnabled":"true","migrationMode":"single-db","masterUsername":"babelfish_user","masterUserPassword":"Babelfish123!"}

The configuration of an ApsaraDB RDS for PostgreSQL instance for which Babelfish is enabled.

Format:{"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"}

The following list describes the fields in the format:

  • babelfishEnabled: specifies whether to enable Babelfish for the instance. If you set this parameter to true, you enable Babelfish for the instance. If you leave this parameter empty, you disable Babelfish for the instance.
  • migrationMode: The migration mode of the instance. Valid values: single-db and multi-db.
  • masterUsername: The name of the administrator account. The name can contain lowercase letters, digits, and underscores (_). It must start with a letter and end with a letter or digit. It can be up to 63 characters in length and cannot start with pg.
  • masterUserPassword: The password of the administrator account. The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. It must be 8 to 32 characters in length. The password can contain any of the following characters:! @ # $ % ^ & * () _ + - =.
Note This parameter takes effect only when you create an ApsaraDB RDS for PostgreSQL instance. For more information, see Introduction to Babelfish.
MaxCapacity double No 8

The maximum value of Rds Capacity Unit (RCU).

MinCapacity double No 0.5

The minimum value of RCU.

Response parameters

Parameter Type Example Description
DryRunResult Boolean true

Indicates whether the request passed the precheck. Valid values:

  • true: The request passed the precheck.
  • false: The request failed the precheck.
    Note
    • If the system does not perform a precheck, this parameter is not returned.
    • If the request failed the precheck, an error is returned.
TagResult Boolean true

Indicates whether the specified tag is added to the instance. Valid values:

  • true: The specified tag is added to the instance.
  • false: The specified tag cannot be added to the instance.
Note If you do not add a tag to the instance, this parameter is not returned.
RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

The ID of the request.

ConnectionString String rm-uf6wjk5*****.mysql.rds.aliyuncs.com

The endpoint that is used to connect to the instance.

Note The DBInstanceNetType parameter specifies whether the endpoint is an internal endpoint or a public endpoint.
Message String Batch Create DBInstance Task Is In Process.

The message that indicates whether multiple instances are created. The parameter is returned only when the value of the Amount parameter is greater than 1.

DBInstanceId String rm-uf6wjk5*****

The ID of the instance. If the value of the Amount parameter is greater than 1, more than one instance ID is returned. The number of instance IDs that are returned is the same as the value of the Amount parameter. The returned instance IDs are separated by commas (,).

For example, if the value of the Amount parameter is 3, three instance IDs are returned. Example:

rm-uf6wjk5*****1,rm-uf6wjk5*****2,rm-uf6wjk5*****3
Port String 3306

The port that is used to connect to the instance.

Note The DBInstanceNetType parameter specifies whether the port is an internal port or a public port.
TaskId String s2365879-a9d0-55af-fgae-f2*****

The ID of the task that is run to create multiple instances. The parameter is returned only when the value of the Amount parameter is greater than 1.

Note The TaskID parameter cannot be used to query a task.
DryRun Boolean true

Indicates that the system prechecks the request before the system creates the instance. The return value is fixed as true.

Note If the system does not perform a precheck, this parameter is not returned.
OrderId String 1007893702*****

The ID of the order.

Note In the latest version of SDK, the default timeout period on the client side is different from the default timeout period on the instance. If you use the latest version of SDK to call this operation, a timeout may be reported even if this operation is successfully called. To prevent this issue, you can set the ReadTimeout parameter to 20000 before you call this operation.
Set the ReadTimeout parameter

Examples

Sample requests

http(s)://rds.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&DBInstanceNetType=Internet
&PayType=Postpaid
&SecurityIPList=10.23.XX.XX/24
&<Common request parameters>

Sample responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDBInstanceResponse>
    <OrderId>1007893702*****</OrderId>
    <ConnectionString>rm-uf6wjk5*****.mysql.rds.aliyuncs.com</ConnectionString>
    <DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
    <Port>3306</Port>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
</CreateDBInstanceResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "OrderId" : "1007893702*****",
  "ConnectionString" : "rm-uf6wjk5*****.mysql.rds.aliyuncs.com",
  "DBInstanceId" : "rm-uf6wjk5*****",
  "Port" : 3306,
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

Error codes

HTTP status code Error code Error message Description
400 InvalidInstanceLevel.DiskType Specified instance level not support request disk type The error message returned because the specified instance type does not support the specified storage type.
400 RR309 We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification. The error message returned because security risks are detected in your payment method. Click the link in the email that is sent to you or in the ApsaraDB RDS console to continue with the verification. After you complete the verification, submit the order again.
400 InvalidZoneId.NotSupported The Specified vpc Zone not supported. The error message returned because the specified zone does not allow you to create an instance in a VPC. Specify a different zone and try again.
400 InvalidZone.NotSupported The Specified Zone not supported. The error message returned because the specified region ID is invalid.
400 InvalidEssdStorageSize invalid cloud essd storage size. The error message returned because the specified storage capacity is invalid. You must select a valid storage capacity and try again.
400 IncompleteAccountInfo Your information is incomplete. Complete your information before the operation. The error message returned because your account information is incomplete. Log on to the Account Center console and specify all account information items that are labeled with an asterisk (*). Check the information items in the Basic Information page.
400 IncompleteTaxInfo Your tax information is incomplete. Complete your information before the operation. The error message returned because your tax information is incomplete. Specify all required tax information.
400 InvalidPaymentMethod.Incomplete No payment method is specified for your account. We recommend that you add a payment method. The error message returned because no valid payment method is provided within your Alibaba Cloud account. Add a valid payment method and try again.
400 InvalidPaymentMethod.Missing No payment method is specified for your account. We recommend that you add a payment method. The error message returned because no valid payment method is provided within your Alibaba Cloud account. Add a valid payment method and try again.
400 InsuffcientBalanceOrBankAccount Add a payment method or add funds to the prepayment balance. Get started by creating an instance. The error message returned because no valid payment method is provided within the current Alibaba Cloud account. Add a valid payment method or add funds to the current Alibaba Cloud account.
400 VswitchIpExhausted Vswitch IP exhausted. The error message returned because vSwitch IP addresses are depleted.
400 InvalidPrivateIpAddress.AlreadyUsed The specified IP is already used. The error message returned because the specified IP address is in use.
400 SYSTEM.CONCURRENT_OPERATE Concurrent operation is detected. The error message returned because concurrent operations are running in the system.
400 ZoneId.NotMatchWithCategory The number of ZoneId specified does not match with category. The error message returned because the number of zones that you specify is not supported for the specified database engine or RDS edition. Specify a valid number of zones and try again.
400 InvalidSecurityIPList.Format The specified parameter securityIPList is not valid. The error message returned because the specified IP address allowlist is in an invalid format. Modify the IP address allowlist and try again.
400 InvalidEngineVersion.Malformed The specified parameter EngineVersion is not valid. The error message returned because the specified database engine version is invalid. Check the database engine version and try again.
400 CreditPayInsufficientBalance Insufficient credit pay limit. Please contact your channel partner to increase the limit. The error message returned because your Alibaba Cloud account does not have a sufficient balance. Make sure that the balance of your Alibaba Cloud account is sufficient.
400 InvalidTagKey.Malformed The Tag.N.Key parameter is empty. The error message returned because the Tag.N.Key parameter is empty.
400 InvalidTagValue.Malformed The Tag.N.Value parameter is empty. The error message returned because the Tag.N.Value parameter is empty.
400 Duplicate.TagKey The Tag.N.Key contains duplicate keys. The error message returned because the Tag.N.Key parameter specifies a duplicate key.
400 NumberExceed.Tags The maximum number of Tags is exceeded. The maximum is 20. The error message returned because the number of tags that you specify exceeds the maximum number of tags that are allowed. A maximum of 20 tags are allowed.
400 MissingParameter.ResourceIds The parameter ResourceIds.N must not be null. The error message returned because the ResourceIds.N parameter is empty.
400 InvalidParameter.TagKey The Tag.N.Key parameter is invalid. The error message returned because the value of the Tag.N.Key parameter is invalid.
400 InvalidParameter.TagValue The Tag.N.Value parameter is invalid. The error message returned because the value of the Tag.N.Value parameter is invalid.
400 NoPermission.SystemTag You have no permission to use system tags. The error message returned because the tags that you specify are system tags.
400 InvalidParam.Amount Amount is allowed from 1 to 20. The error message returned because the value of the Amount parameter is not within the range of 1 to 20.
400 InvalidParam.CreateStrategy Only Atomicity and Partial are allowed. The error message returned because the value of the CreateStrategy parameter is not Atomicity or Partial.
401 CannotDecreaseEssdPerfLevel cannot decrease cloud essd performance level. The error message returned because the change of the storage type is not allowed. The storage type of an instance that runs SQL Server with standard SSDs can be changed only to ESSDs. The storage type of an instance that runs SQL Server with local SSDs can be changed to standard SSDs or ESSDs.

For a list of error codes, visit the API Error Center.