All Products
Search

This Product

    ApsaraDB RDS:CreateDBInstance

    Document Center

    ApsaraDB RDS:CreateDBInstance

    Last Updated:Aug 17, 2026

    Creates an ApsaraDB RDS instance.

    Operation description

    Supported engines

    • RDS MySQL

    • RDS PostgreSQL

    • RDS SQL Server

    • RDS MariaDB

    Related documentation

    Warning This API operation incurs fees. Read the related documentation carefully before you perform this operation. If an error message is returned when you call this API operation, search for the error message to find the cause.

    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

    rds:CreateDBInstance

    create

    *All Resource

    *
    • rds:ResourceTag
    • rds:Engine
    • rds:EngineVersion
    • rds:DBInstanceClass
    • rds:DBInstanceStorage
    		 None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    The region ID. You can call DescribeRegions to query available regions.

    cn-hangzhou
    Engine

    string

    Yes

    The database engine. Valid values:

    • MySQL

    • SQLServer

    • PostgreSQL

    • MariaDB

    MySQL
    EngineVersion

    string

    Yes

    The database engine version. Valid values:

    • Regular instances

      • MySQL: 5.5, 5.6, 5.7, 8.0

      • SQL Server: 08r2_ent_ha (cloud disk edition, discontinued), 2008r2 (instance with Premium Local SSDs, discontinued), 2012 (Enterprise Edition standalone), 2012_ent_ha, 2012_std_ha, 2012_web, 2014_ent_ha, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent, 2017_std_ha, 2017_web, 2019_ent, 2019_std_ha, 2019_web, 2022_ent, 2022_std_ha, 2022_web, 2025_ent, 2025_std

      • PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0

      • MariaDB: 10.3, 10.6

    • Serverless instances

      • MySQL: 5.7, 8.0

      • SQL Server: 2016_std_sl, 2017_std_sl, 2019_std_sl

      • PostgreSQL: 14.0, 15.0, 16.0, 17.0, 18.0

    Note

    • MariaDB does not support the creation of serverless instances.

    • In SQL Server instance versions, _ent indicates Enterprise Cluster Edition, _ent_ha indicates Enterprise Edition, _std_ha indicates Standard Edition, and _web indicates Web Edition.

    • SQL Server 2014 instances are not available for purchase on the China site (Chinese mainland).

    • Babelfish for RDS PostgreSQL instances support only major version 15.0.

    8.0
    DBInstanceClass

    string

    Yes

    The instance type. You can specify a standard or YiTian instance type. For more information, see Primary instance types.

    To create a serverless instance, specify one of the following values:

    • MySQL Basic Edition: mysql.n2.serverless.1c

    • MySQL High-availability Edition: mysql.n2.serverless.2c

    • SQL Server: mssql.mem2.serverless.s2

    • PostgreSQL Basic Edition: pg.n2.serverless.1c

    • PostgreSQL High-availability Edition: pg.n2.serverless.2c

    mysql.n2.medium.2c
    DBInstanceStorage

    integer

    Yes

    The instance storage space. Unit: GB. The value increases in increments of 5 GB. For the value range, see Instance types.

    100
    SystemDBCharset

    string

    No

    Deprecated parameter. You do not need to configure this parameter.

    gbk
    DBInstanceNetType

    string

    Yes

    The network connectivity type of the instance. Set the value to Intranet, which indicates an internal network connection.

    Intranet
    DBInstanceDescription

    string

    No

    The instance name. The name must be 2 to 255 characters in length. The name must start with a letter or a Chinese character and can contain digits, Chinese characters, letters, and hyphens (-).

    Note

    The name cannot start with http:// or https://.

    testInstance
    SecurityIPList

    string

    Yes

    The IP whitelist of the instance. Separate multiple entries with commas (,). Entries cannot be duplicated. You can add up to 1,000 IP addresses or CIDR blocks per instance. The following two formats are supported:

    • IP address format, such as 10.10.XX.XX.

    • CIDR format, such as 10.10.XX.XX/24 (Classless Inter-Domain Routing, where 24 indicates the prefix length, which ranges from 1 to 32).

    10.10.XX.XX/24
    ClientToken

    string

    No

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

    ETnLKlblzczshOTUbOCz****
    PayType

    string

    Yes

    The billing method of the instance. Valid values:

    Note

    The system automatically generates and completes the payment for the order. You do not need to manually confirm the payment.

    Postpaid
    ZoneId

    string

    No

    The zone ID of the primary node.

    • If you specify a VPC and a vSwitch, you must set this parameter to the zone ID of the specified vSwitch. Otherwise, the instance cannot be created.

    • For high-availability series instances, you must also specify ZoneIdSlave1 to determine whether the instance is deployed in a single zone or across multiple zones.

    • For RDS Enterprise Edition instances, you must also specify ZoneIdSlave1 and ZoneIdSlave2 to determine whether the instance is deployed in a single zone or across multiple zones.

    • For RDS Cluster Edition instances, you must also specify ZoneIdSlave1 for two-node clusters, or ZoneIdSlave1 and ZoneIdSlave2 for three-node clusters.

    cn-hangzhou-b
    ZoneIdSlave1

    string

    No

    The zone ID of the secondary node.

    • If you set this parameter to Auto, the system uses multi-zone deployment and automatically selects a zone for the secondary node.

    • If you set this parameter to the same value as ZoneId, single-zone deployment is used.

    • If you set this parameter to a value different from ZoneId, multi-zone deployment is used.

    cn-hangzhou-c
    ZoneIdSlave2

    string

    No

    ApsaraDB RDS for MySQL instances of the Cluster Edition support creating one or two secondary nodes when you create an instance. You can use this parameter to specify the zone ID of the second secondary node.

    cn-hangzhou-d
    InstanceNetworkType

    string

    No

    The network type of the instance. Valid values:

    • VPC: virtual private cloud (VPC).

    • Classic: classic network.

    Note

    • ApsaraDB RDS for MySQL instances with cloud disks support only VPC. Set this parameter to VPC.

    • ApsaraDB RDS for PostgreSQL and MariaDB instances support only VPC. Set this parameter to VPC.

    • ApsaraDB RDS for SQL Server Basic Edition and Web Edition instances support both the classic network and VPC. Other instances support only VPC. Set this parameter to VPC.

    VPC
    ConnectionMode

    string

    No

    The access mode of the instance. Valid values:

    Standard
    VPCId

    string

    No

    The virtual private cloud (VPC) ID.

    vpc-****
    VSwitchId

    string

    No

    The vSwitch ID.

    vsw-****
    PrivateIpAddress

    string

    No

    The internal IP address of the instance. The IP address must be within the IP address range of the specified vSwitch. The system automatically assigns an internal IP address based on the values of VPCId and vSwitchId by default.

    172.16.XX.XX
    UsedTime

    string

    No

    The subscription duration. Valid values:

    2
    Period

    string

    No

    Specifies the subscription duration unit for a subscription instance. Valid values:

    • Year: yearly subscription.

    • Month: monthly subscription.

    Note

    This parameter is required if the billing method is set to Prepaid.

    Year
    ResourceGroupId

    string

    No

    The resource group ID.

    rg-acfmy****
    DBInstanceStorageType

    string

    No

    The storage type of the instance. Valid values:

    • local_ssd: Premium Local SSD (recommended).

    • general_essd: Premium ESSD (recommended).

    • cloud_essd: ESSD PL1.

    • cloud_essd2: ESSD PL2.

    • cloud_essd3: ESSD PL3.

    • cloud_ssd: standard SSD (not recommended because this storage type is no longer available for purchase in some regions).

    The default value of this parameter is automatically determined based on the instance type specified by the DBInstanceClass parameter:

    • If the instance type is a Premium Local SSD instance type, the default value is local_ssd.

    • If the instance type is a cloud disk instance type, the default value is cloud_essd.

    Note

    Serverless instances support only ESSD PL1 and Premium ESSD.

    general_essd
    BusinessInfo

    string

    No

    The business extension parameter.

    121436975448952
    EncryptionKey

    string

    No

    The ID of the encryption key that is used for cloud disk encryption in the same region. If you specify this parameter, cloud disk encryption is enabled and cannot be disabled. You must also specify RoleARN.

    0d24*****-da7b-4786-b981-9a164dxxxxxx
    RoleARN

    string

    No

    The Alibaba Cloud Resource Name (ARN) that is used for authorization of the RDS service account to access Key Management Service (KMS). You can call the CheckCloudResourceAuthorized operation to query the ARN.

    acs:ram::1406****:role/aliyunrdsinstanceencryptiondefaultrole
    AutoRenew

    string

    No

    Specifies whether to enable auto-renewal for the instance. This parameter takes effect only when you create a subscription instance. Valid values:

    • true

    • false

    Note

    • If you purchase the instance on a monthly basis, the auto-renewal cycle is one month.

    • If you purchase the instance on a yearly basis, the auto-renewal cycle is one year.

    true
    Category

    string

    No

    The instance edition. Valid values:

    • Regular instances

      • Basic: Basic Edition.

      • HighAvailability: High-availability Edition.

      • cluster: MySQL or PostgreSQL Cluster Edition.

      • AlwaysOn: SQL Server Cluster Edition.

      • Finance: RDS Enterprise Edition.

      Note

      This parameter is required when you create an SQL Server Enterprise Cluster Edition instance, or a Basic Edition Enterprise instance. For example, when you create a Basic Edition 2022 Enterprise Cluster Edition (2022_ent) instance, you must set this parameter to Basic.

    • Serverless instances

      • serverless_basic: Serverless Basic Edition. (Applicable only to MySQL and PostgreSQL)

      • serverless_standard: Serverless High-availability Edition. (Applicable only to MySQL and PostgreSQL)

      • serverless_ha: SQL Server Serverless High-availability Edition.

      Note

      This parameter is required when PayType is set to Serverless.

    HighAvailability
    DedicatedHostGroupId

    string

    No

    The dedicated cluster host group ID.

    dhg-4n****
    TargetDedicatedHostIdForMaster

    string

    No

    The host ID of the primary instance in the dedicated cluster.

    i-bp****
    TargetDedicatedHostIdForSlave

    string

    No

    The host ID of the secondary instance in the dedicated cluster.

    i-bp****
    TargetDedicatedHostIdForLog

    string

    No

    The host ID of the logger instance in the dedicated cluster.

    i-bp****
    DBParamGroupId

    string

    No

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

    Note

    Only MySQL and PostgreSQL support this parameter. If you do not specify this parameter, the system default parameter template is used. You can also create a custom parameter template and specify it here.

    rpg-sys-****
    DBTimeZone

    string

    No

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

    • If Engine is set to MySQL:

      • This parameter specifies a UTC time zone. Valid values: -12:59 to +13:00.

      • Instances with Premium Local SSDs can use named time zones, such as Asia/Hong_Kong. For more information about named time zones, see Named time zone reference.

    • If Engine is set to PostgreSQL:

      • This parameter specifies a named time zone. UTC time zones are not supported. For more information about named time zones, see Named time zone reference.

      • This parameter can be configured only for PostgreSQL instances with cloud disks.

    Note

    • You can set the time zone when you purchase a primary instance. Read-only instances do not support time zone settings and inherit the time zone of the primary instance.

    • If you do not configure this parameter, the system selects the default time zone based on the region where you purchase the instance.

    +08:00
    DBIsIgnoreCase

    string

    No

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

    • true: Case-insensitive. This is the default value.

    • false: Case-sensitive.

    true
    TargetMinorVersion

    string

    No

    The minor engine version of the RDS instance to create. This parameter is required only when you create a MySQL or PostgreSQL instance. Format:

    • MySQL: <Instance version>_<Numeric version number>. Examples: rds_20200229, xcluster_20200229, or xcluster80_20200229. Description:

      • rds: High-availability Edition or Basic Edition.

      • xcluster: MySQL 5.7 RDS Enterprise Edition.

      • xcluster80: MySQL 8.0 RDS Enterprise Edition.

      Note

      You can call the DescribeDBMiniEngineVersions operation to query the numeric version number. For more information about the differences between versions, see AliSQL Release Notes.

    • PostgreSQL: rds_postgres_<Major version>00_<Minor version number>. Example: rds_postgres_1400_20220830. Description:

      • 1400: The major PostgreSQL version is 14.

      • 20220830: The AliPG minor engine version. You can call the DescribeDBMiniEngineVersions operation to query this value. For more information about the differences between versions, see PostgreSQL Minor Version Release Notes.

      Note

      If Babelfish is enabled in BabelfishConfig, the minor engine version format for the RDS PostgreSQL instance is: rds_postgres_<Major version>00_<AliPG minor engine version>_babelfish.

    rds_20200229
    StorageAutoScale

    string

    No

    Specifies whether to enable automatic storage expansion. This parameter is supported only for MySQL and PostgreSQL. Valid values:

    Disable
    StorageThreshold

    integer

    No

    The threshold (in percentage) that triggers automatic storage expansion. Valid values:

    50
    StorageUpperBound

    integer

    No

    The maximum total storage capacity for automatic storage expansion. Automatic expansion does not cause the total storage capacity of the instance to exceed this value. Unit: GB.

    Note

    • The value must be greater than or equal to 0.

    • This parameter is required when StorageAutoScale is set to Enable.

    2000
    DryRun

    boolean

    No

    Specifies whether to perform a dry run for this request. Valid values:

    false
    UserBackupId

    string

    No

    The user backup ID. You can call the ListUserBackupFiles operation to query user backup IDs. If you specify this parameter, an instance is created based on the user backup.

    If you specify this parameter, the following limits apply:

    • PayType must be set to Postpaid.

    • Engine must be set to MySQL.

    • EngineVersion must be set to 5.7.

    • Category must be set to Basic.

    67798****
    Amount

    integer

    No

    The number of ApsaraDB RDS for MySQL instances to create. This parameter is used only for batch creation of ApsaraDB RDS for MySQL instances.

    2
    CreateStrategy

    string

    No

    The strategy for batch instance creation. This parameter takes effect only when the value of Amount is greater than 1. Valid values:

    • Atomicity (default): atomic. All instances in the same batch are either created successfully or fail together. If one instance fails to be created, all instances fail.

    • Partial: non-atomic. The creation of an instance is not affected by other instances in the same batch.

    Atomicity
    Tag

    array<object>

    No

    The tags.

    object

    No

    The details of the tags.

    Key

    string

    No

    The tag key. Specify this parameter to bind a tag to the instance.

    • If the specified tag key already exists, the tag key is directly bound to the instance. Call ListTagResources to query existing tags.

    • If the specified tag key does not exist, the tag key is created and then bound to the instance.

    • Empty strings are not allowed.

    • This parameter must be used together with the Tag.Value parameter. Neither parameter can be used alone.

    testkey1
    Value

    string

    No

    The tag value that corresponds to the tag key. Specify this parameter to bind a tag to the instance.

    testvalue1
    DeletionProtection

    boolean

    No

    Specifies whether to enable the release protection feature for the ApsaraDB RDS instance. This feature is supported only for pay-as-you-go instances. Valid values:

    • true: Enabled.

    • false: Disabled (default).

    true
    BabelfishConfig

    string

    No

    The Babelfish for RDS PostgreSQL configuration information.

    {"babelfishEnabled":"true","migrationMode":"single-db","masterUsername":"babelfish_user","masterUserPassword":"Babelfish123!"}
    ServerlessConfig

    object

    No

    The settings of the serverless ApsaraDB RDS instance. This parameter is required when you create a serverless instance.

    Note

    MariaDB does not support the creation of serverless instances.

    MaxCapacity

    number

    No

    The maximum number of RDS Capacity Units (RCUs) for automatic scaling. Valid values:

    8
    MinCapacity

    number

    No

    The minimum number of RCUs for automatic scaling. Valid values:

    0.5
    AutoPause

    boolean

    No

    Specifies whether to enable the intelligent suspension and startup feature for the serverless instance. Valid values:

    true
    SwitchForce

    boolean

    No

    Specifies whether to enable forced scaling for the serverless instance. Valid values:

    • true: Enabled.

    • false: Disabled (default).

    Note

    • This parameter is required only for MySQL and PostgreSQL serverless instances. After you enable this parameter, the instance may be unavailable for 30 to 120 seconds during forced scaling. Use this parameter with caution as needed.

    • Elastic scaling of instance RCUs usually takes effect immediately. However, in certain special cases, such as when a large transaction is being executed, scaling cannot be completed immediately. In this case, you can enable this parameter to perform forced scaling.

    false
    ConnectionString

    string

    No

    The internal endpoint of the database.

    rm-uf6wjk5****.mysql.rds.aliyuncs.com
    Port

    string

    No

    Specifies the port number to initialize when the RDS instance is created. Valid values:

    • MySQL: 1000 to 65534

    • PostgreSQL, SQL Server, and MariaDB: 1000 to 5999

    3306
    BurstingEnabled

    boolean

    No

    Deprecated parameter. You do not need to configure this parameter.

    0
    AutoPay

    boolean

    No

    Specifies whether to enable the I/O performance burst feature for premium performance disks. Valid values:

    false
    IoAccelerationEnabled

    string

    No

    Specifies whether to enable automatic payment. Valid values:

    • true: Automatic payment is enabled. Make sure that your account balance is sufficient.

    • false: Only an order is generated, and no payment is made.

    Note

    Default value: true. If your payment method has an insufficient balance, set AutoPay to false. An unpaid order is then generated. You can log on to the ApsaraDB RDS console to complete the payment.

    true
    ColdDataEnabled

    boolean

    No

    Specifies whether to enable the Buffer Pool Extension (BPE) feature for Premium ESSDs. Valid values:

    • 1: Enabled.

    • 0: Not enabled.

    0
    WhitelistTemplateList

    string

    No

    Specifies whether to enable the cold data archiving feature for Premium ESSDs. Valid values:

    • true: Enabled.

    • false: Disabled.

    false
    AutoCreateProxy

    boolean

    No

    The whitelist template list.

    192.168.0.1,172.16.213.9
    AutoUseCoupon

    boolean

    No

    Specifies whether to automatically create a proxy. Valid values:

    • true: Enables automatic creation. The proxy is a general-purpose database proxy by default.

    • false: Disables automatic creation.

    false
    PromotionCode

    string

    No

    Specifies whether to use coupons. Valid values:

    • true: Uses coupons.

    • false (default): Does not use coupons.

    Note

    After coupons are used, if you perform a specification downgrade, the amount offset by coupons will not be refunded.

    true
    OptimizedWrites

    string

    No

    The coupon code.

    aliwood-1688-mobile-promotion
    ExternalReplication

    boolean

    No

    Specifies whether to enable the 16KB atomic write feature. Valid values:

    • optimized: enabled.

    • none (default): disabled.

    optimized
    CustomExtraInfo

    string

    No

    Enables or disables native replication for ApsaraDB RDS for MySQL. Valid values:

    • ON: Enabled.

    • OFF: Disabled.

    ON

    No

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    DryRunResult

    boolean

    Indicates whether the dry run was successful. Valid values:

    • true: The dry run was successful.

    • false: The dry run failed.

    Note

    • This parameter is not returned if the dry run is not performed.

    • If the dry run fails, the corresponding error is returned.

    true
    TagResult

    boolean

    Indicates whether the tag is successfully bound to the instance. Valid values:

    • true: Successful.

    • false: Failed.

    Note

    If no tag is bound to the instance, this parameter is not returned.

    true
    RequestId

    string

    The request ID.

    1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC
    ConnectionString

    string

    The internal endpoint of the instance.

    rm-uf6wjk5****.mysql.rds.aliyuncs.com
    Message

    string

    The prompt information of the batch creation task.

    Batch Create DBInstance Task Is In Process.
    DBInstanceId

    string

    The instance ID. If you set the Amount parameter to a value greater than 1, the number of instance IDs corresponding to that value is returned, separated by commas.

    rm-uf6wjk5****
    Port

    string

    The port number corresponding to the internal endpoint of the instance.

    3306
    TaskId

    string

    The task ID of the batch creation task.

    • Returned only when the Amount parameter is greater than 1.

    • Querying tasks by TaskId value is not supported.

    s2365879-a9d0-55af-fgae-f2****
    DryRun

    boolean

    Indicates that the current request performs a dry run before creating the instance.

    • The value is always true.

    • This parameter is not returned if no dry run is performed.

    true
    OrderId

    string

    The order ID.

    1007893702****
    Note

    When you call this operation by using the latest SDK, the default client timeout period may be inconsistent with the server timeout period, which may cause a request timeout error even though the operation is actually called. To avoid this issue, set the ReadTimeout parameter to 20000 before calling this operation.

    Examples

    Success response

    JSON format

    {
  "DryRunResult": true,
  "TagResult": true,
  "RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
  "ConnectionString": "rm-uf6wjk5****.mysql.rds.aliyuncs.com",
  "Message": "Batch Create DBInstance Task Is In Process.",
  "DBInstanceId": "rm-uf6wjk5****",
  "Port": "3306",
  "TaskId": "s2365879-a9d0-55af-fgae-f2****",
  "DryRun": true,
  "OrderId": "1007893702****"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 Invalid.ParamGroupDBVersion %s.%s
    400 InvalidInstanceLevel.DiskType Specified instance level not support request disk type The current 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. A security risk was detected in the default payment method. Please verify your payment method before placing your order. A verification link will be sent to you via email and internal message.
    400 InvalidZoneId.NotSupported The Specified vpc Zone not supported. VPC-hosted RDS instances cannot be created in the zone. Specify a different zone.
    400 InvalidZone.NotSupportedForStorageType The specified zone is closed or invalid for Specified DBInstanceStorageType. The specified region is closed or invalid for the specified DBInstanceStorageType.
    400 InvalidNetworkTypeClassicWhenCloudStorage The Specified InstanceNetworkType value Classic is not valid when choose cloud storage type. When selecting a cloud storage type, specifying a InstanceNetworkType value of Classic is not valid.
    400 InvalidZone.NotSupported The Specified Zone not supported. The zone is invalid.
    400 InvalidEssdStorageSize invalid cloud essd storage size. The storage size of cloud disks is invalid. Check the storage size.
    400 InvalidParameter Some Reuquest Parameters Is Invalid. Check or Try It Again Later.
    400 Pay.AmountLimitExceeded Pay amount limit exceeded.
    400 IncompleteAccountInfo Your information is incomplete. Complete your information before the operation. The operation failed. Items that are marked with an asterisk (*) in the account information must be specified. Make sure that you specify these items on the Basic Information page in Account Center.
    400 IncompleteTaxInfo Your tax information is incomplete. Complete your information before the operation. The operation failed. Your tax information is incomplete. Complete your tax information.
    400 InvalidPaymentMethod.Incomplete No payment method is specified for your account. We recommend that you add a payment method. No valid payment method is specified for your Alibaba Cloud account. Add a valid payment method.
    400 InvalidPaymentMethod.Missing No payment method is specified for your account. We recommend that you add a payment method. No valid payment method is specified for your Alibaba Cloud account. Add a valid payment method.
    400 InsuffcientBalanceOrBankAccount Add a payment method or add funds to the prepayment balance. Get started by creating an instance. No valid payment method is specified within your Alibaba Cloud account. Add a valid payment method or add funds to your Alibaba Cloud account.
    400 InvalidPaymentMethod.NoAccess No payment method is specified for your account. We recommend that you add a payment method.
    400 InvalidPaymentMethod.InsufficientBalance No payment method is specified for your account. We recommend that you add a payment method or add funds to the prepayment balance.
    400 Pay.LowFunds The balance of the advance payment is insufficient or there is no balance of the advance payment.
    400 Pay.ChargeChannelNotFound Failure to obtain the first external payment channel if the advance balance is insufficient.
    400 VswitchIpExhausted Vswitch IP exhausted. The operation failed. No vSwitch IP addresses are available.
    400 InvalidPrivateIpAddress.AlreadyUsed The specified IP is already used. The IP address has been used.
    400 InvalidEcsImage.NotFound Sepcified ecs image does not exist
    400 InvalidMinorVersion.NotFound Sepcified minor version does not exists.
    400 InvalidConcurrentOperate Concurrent operation is detected. Concurrent operations exist. Wait until the previous operation is complete and try again.
    400 ZoneId.NotMatchWithCategory The number of ZoneId specified does not match with category. The number of zones is not supported for the database engine or the RDS edition of the RDS instance. Modify the zone settings.
    400 InvalidSecurityIPList.Format The specified parameter securityIPList is not valid. The format of the IP address whitelist does not meet the requirements. Check the IP address whitelist.
    400 InvalidDBParamGroupId.Format The specified parameter dbParamGroupId is not valid.
    400 InvalidTargetMinorVersion.Format The specified parameter targetMinorVersion is not valid.
    400 InvalidDedicatedHostGroupId.Format The specified parameter dedicatedHostGroupId is not valid.
    400 InvalidDBInstanceClass.Malformed The specified parameter DBInstanceClass is not valid.
    400 InvalidEngineVersion.Malformed The specified parameter EngineVersion is not valid. The 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 quota runs out. Contact your customer service representatives to increase the quota.
    400 InvalidTagKey.Malformed The Tag.N.Key parameter is empty. The Tag.N.Key parameter is left unspecified.
    400 InvalidTagValue.Malformed The Tag.N.Value parameter is empty. The Tag.N.Value parameter is left unspecified.
    400 Duplicate.TagKey The Tag.N.Key contains duplicate keys. The values of two Tag.N.Key parameters are duplicate.
    400 NumberExceed.Tags The maximum number of Tags is exceeded. The maximum is 20. The number of tags exceeds 20.
    400 MissingParameter.ResourceIds The parameter ResourceIds.N must not be null. The ResourceIds.N parameter cannot be empty.
    400 InvalidParameter.TagKey The Tag.N.Key parameter is invalid. The value of the Tag.N.Key parameter is invalid.
    400 InvalidParameter.TagValue The Tag.N.Value parameter is invalid. The Tag.N.Value parameter is invalid.
    400 NoPermission.SystemTag You have no permission to use system tags. You have no permission to use the system tag.
    400 InvalidParam.Amount Amount is allowed from 1 to 20. Amount is allowed from 1 to 20.
    400 InvalidParam.CreateStrategy Only Atomicity and Partial are allowed. Only the Atomicity and Partial parameters are supported.
    400 InvalidParam.Engine Only MySQL is allowed when Amount > 1.
    400 InvalidMultiZoneInfoList The Specified Zone Info List is Invaild.
    400 InvalidKmsConfigStatus The Kms Service Config is Invalid.
    400 InvalidConnectionString.Duplicate Specified connection string already exists in the Aliyun RDS.
    400 InvalidPort.Malformed Specified port is not valid. The port number is invalid.
    400 InvalidUsedTime UsedTime can not Less than or equal to zero. The value of the UsedTime parameter must be greater than 0.
    400 Kms.Unauthorized KMS has not been authorized. KMS is not authorized.
    400 InvalidDBInstanceClass.Offline The specified instance type is no longer provided. Please specify another instance type. The instance type that you select is no longer available. Select another instance type.
    400 SystemParamGroupCode.Format Specific DBParamGroupId is not valid. The DBParamGroupId parameter specified for creation is invalid.
    400 InvalidDBInstanceName.Duplicate Specified DB instance name already exists in the Aliyun RDS. The operation failed. The instance name already exists. Specify a different name and try again.
    400 ServiceLinkedRole.NotExist Service linked role for RDS PostgreSQL not exist. Create the AliyunServiceRoleForRdsPgsqlOnEcs role for ApsaraDB RDS for PostgreSQL.
    400 CommodityServiceCalling.Exception Failed to call commodity service. Failed to call commodity service return.
    400 Commodity.InvalidComponent The module you purchased is not legal, please buy it again. The module you purchased is not legal, please buy it again.
    400 Pay.InsufficientBalance Insufficient available balance. Insufficient available balance.
    400 Price.CommoditySys Commodity system call exception. Commodity system call exception.
    400 RegionEndTimeDissolvedAustralia Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. Hello customer, this area has been abolished.
    400 RegionEndTimeDissolvedIndia Cloud services in the India (Mumbai) region will be discontinued. Set the validity date to July 15, 2024 or earlier than July 15, 2024. Hello customer, this area has been abolished.
    400 InvalidPrivateIpAddress.Format The specified private IP address format is incorrect. The specified IP address is not in the correct format.
    400 InvalidPrivateIpAddress.Mismatch Specified private IP address is not in the CIDR block of virtual switch. The VPC endpoint is invalid.
    400 TooManyWhitelistTemplateIds create dbinstance can support attach to up to 10 whitelist templates. Excessive number of incoming whitelist templates! You can associate up to 10 whitelist templates.
    400 UnsupportExtendDisk.NotSupport Specified DB instance is unsupport extend disk. Disk expansion is not supported on the specified instance.
    400 InvalidWhitelistTemplateId the template id list is invalid. The ID of the specified whitelist template is incorrect. Check the setting.
    400 InvalidRequestId The request is copy, check your token. The request is copy, check your token.
    400 InvalidParameter.MinCapacity The specified parameter 'MinCapacity' is not valid. The specified parameter 'MinCapacity' is not valid.
    400 UnsupportedClassCode The specified DB instance class stops selling. The specified DB instance class stops selling.
    400 InvalidParameter.NotSupportDBInstanceStorageType Parameter DBInstanceStorageType is invalid. Invalid DBInstanceStorageType parameter
    400 InvalidParam.InstanceNetworkType Creation of classic network instances is not supported. Classic network offline, does not support the creation of classic network instances!
    400 InvalidOrder.NotFound Specified order does not exist in RDS. The specified order does not exist in RDS.
    400 InvalidVSwitchId.Format The specified vswitch Id format is incorrect. The specified vSwitch ID is in an incorrect format.
    400 Order.ComboInstanceNotAllowOperate A package instance is not allowed to operate independently. A package instance is not allowed to operate independently.
    400 Price.PricingPlanResultNotFound Pricing plan price result not found. Pricing plan price result not found.
    400 Order.NoRealNameAuthentication You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the cost and cost for real-name authentication.
    400 InsufficientAvailableQuota Your account quota limit is less than 0, please recharge before trying to purchase. Your account available limit is less than 0, please recharge before trying to purchase.
    400 RegionDissolvedEOM Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. Hello, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will stop operating. In order to ensure your business continuity and smooth transition of data migration, you are currently unable to operate new purchase orders. Thank you for your understanding and support.
    400 Order.PeriodInvalid There is a problem with the period you selected, please choose again. There is a problem with the period you selected, please choose again.
    400 pay.noCreditCard Account not bound to credit card. No credit card is available.
    400 Order.InstHasUnpaidOrder There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. There is an unpaid order for the service you have purchased. Please pay or void it before placing the order.
    400 BasicInfoUncompleted Your information is incomplete. Complete your information before the operation. Your basic information is not complete, please complete your basic information before operation.
    400 Risk.RiskControlRejection Your account is abnormal, please contact customer service for details. Your account is abnormal, please contact customer service for details.
    400 Api.NotSupport Specified api is not supported. The current interface does not support.
    400 ContainForbiddenLabelError There is a label that prohibits placing orders. Please contact your distributor for assistance. You cannot place the order because a tag indicates that order placement is prohibited. Contact your distributor.
    400 InvalidDBInstanceId.NotFound The DBInstanceId provided does not exist in records. The DBInstanceId provided does not exist.
    400 InvalidParam Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. The specified wal_level parameter is invalid. There is still a copy slot in the instance, so it cannot be set to replica.
    400 System.SaleValidateFailed Sales expression validation system error. A system error occurs when the sales expression is verified.
    400 Abs.InvalidAccount.NotFound account is not found. The account does not exist.
    400 SqlExecuteFailedOrTimeout sql command execution failed or timed out:%s. SQL command execution failed or timed out
    400 ColdData.EngineVersionNotSupport The current instance engine version not support coldDataEnabled. The current instance engine version not support coldDataEnabled.
    400 ColdData.MinorVersionNotSupport The current instance minor version not support coldDataEnabled. The current instance minor version not support coldDataEnabled.
    400 IncorrectTargetClasscode The current instance type does not support this operation. This operation is not supported by the instance type.
    400 RequiredParam.NotFound Required input param is not found. Required parameters are missing.
    400 Parameters.Invalid Parameter error, please check the parameters. Parameter error, please check the parameters.
    400 BackupPolicyNotSupport Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy.
    400 InvalideStatus.Format The instance status does not support this operation. The instance status does not support this operation.
    400 InvalidReleasedKeepPolicy.Format Specified Released Keep Policy is not valid. Specified Released Keep Policy is not valid.
    400 InvalidDBInstanceEngineType.Format the DB instance engine type does not support this operation. This operation is not supported for the database engine of the instance.
    400 Pay.NoCreditCard No credit cards. No credit cards.
    400 VpcNetworkTypeNotSupport The vpc network type instance does not support this operation. The vpc network type instance does not support this operation.
    400 MirrorInsExists Specified DB instance mirror ins already existed. Specified DB instance mirror ins already existed.
    400 InvalidBackupSet The specified database does not exist in the backup set. The specified database does not exist in the backup set.
    400 OrdTCommodityQueryError Failed to query for product. Failed to query product.
    400 ProductInstanceReleased The instance has been released. Please check before placing the order. The instance has been released, please verify and place an order.
    400 IncorrectTargetCategory Current target category does not support this operation. Current target category does not support this operation.
    400 PurchaseDurationInsufficient The purchase duration does not meet the requirements, please choose again. The purchase duration does not meet the requirements, please select again.
    400 NotFound.ParamGroupId Current ParamGroupId not found. The parameter template does not exist.
    400 InvalidParamForXfs Xfs instance must be single tenant standard instance. Xfs instance must be single tenant standard instance.
    400 UnsupportedColdData Current coldDataEnabled parameter can not support. The specified region does not support cold storage.
    400 AtLeastThreeVSwitchAvailableIp The primary vswitch requires at least three available IP addresses. The master switch requires at least 3 available IPs.
    400 AtLeastTwoVSwitchAvailableIp The primary vswitch requires at least two available IP addresses. The master switch requires at least 2 available IPs.
    400 DuckDBOperationConflictBetweenPrimaryAndReadOnlyInstance Current instance is already attached to another duckdb instance, operation is conflict. The current instance is already associated with another DUCKDB instance, which conflicts with the current DUCKDB operation.
    400 AtLeastTwoVSwitchParamExists The specified params(Vswitchs) at least two. At least two Vswitchs parameters must be specified. Each Vswitchs parameter specifies a vSwitch in a zone.
    400 InvalidVPCId.NotFound Specified virtual vpc is not found. The VPC ID cannot be found. Check the VPC ID.
    400 InvalidDefaultVSwitch.NotFound InvalidDefaultVSwitch.NotFound The operation failed. The vSwitch cannot be found in the VPC.
    400 InvalidVSwitchId.Mismatch Specified instance and virtual switch are not in the same zone. The RDS instance and the vSwitch are not in the same zone.
    400 InvalidVpcIdOrVswitchId.NotSupported The specified vpcId or vSwitchId is not supported. The VPC that is specified by the vpcId parameter or the vSwitch that is specified by the vSwitchId parameter is not supported. Check the values of these parameters.
    401 CannotDecreaseEssdPerfLevel cannot decrease cloud essd performance level.
    500 ExternalFailure The request processing has failed due to external service failure. The request processing has failed due to external service failure.
    500 RequestMetaDataFailed The service request failed. Please try again later or contact service personnel. The service request failed. Please try again later or contact service personnel.
    500 InvokeProxyFailure The request processing has failed due to service failure of rds api. The request failed to be processed due to an RDS API failure.
    403 ByokRoleArnNotFound The roleArn can not be null. The roleArn can not be null.
    403 RISK.RISK_CONTROL_REJECTION Risk control rejection.
    403 AliCroup2CloudUserCannotBuyNotInnerCommodity There is no group cloud commodity label, and users within the group are not allowed to purchase. The product does not have the group cloud migration tag. Internal group users are not allowed to purchase this product.
    403 GroupReplicationNotSupport.InvalidEngineVersion Group Replication requires the instance engine version to be 8.0. The instance database version is not MySQL 8.0. MySQL Group Replication is not supported.
    403 GroupReplicationNotSupport.InvalidNodeClassCode Group Replication requires the ClassCode of each node to be consistent. The specifications of the instance nodes are inconsistent. MySQL Group Replication is not supported.
    403 GroupReplicationNotSupport.InvalidNodeNum Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3. The number of instance nodes is not an odd number greater than or equal to 3. MySQL Group Replication is not supported.
    403 GroupReplicationNotSupport.InvalidXengine Group Replication is not supported because the instance has xengine tables. The instance contains tables that use the X-Engine storage engine. MySQL Group Replication is not supported.
    403 GroupReplicationNotSupport.MemoryTooSmall Group Replication is not supported because the memory is too small. The instance specification has insufficient memory. MySQL Group Replication is not supported.
    403 IncorrectMinorVersion Current engine minor version does not support operations. This operation is not supported for the current minor engine version.
    403 CloudDiskEncryptionNotSupport The encryption key is not allowed for general-purpose instance. Universal instances do not support cloud disk encryption.
    403 CloudSSDNotSupport Cloud ssd does not support this operation, please upgrade to essd. SSD disks do not support this operation. Upgrade to ESSD.
    403 InvalidVswitchId Specified conn vswitch id is not valid. The specified VSwitchId is in an incorrect format or is empty.
    403 BasicCategoryNotSupport The Basic category is not supported. Basic series not supported
    403 OrderStatus.UnPaid The specified db instance has unpaid order. The instance has an unpaid order. Please pay first and try again.
    403 InvalidReduceDiskSize The storage capacity after the scale-down must be larger than the used amount. The scale-in target capacity cannot be less than the current storage space usage
    403 InvalidUserOperatorPermission The user permission does not support this operation. The user is not authorized to perform this operation.
    403 OperationDenied.ZoneResource There is no available zone for inventory. There is no available zone for inventory.
    403 NotInFlowController Sorry,no permission. Sorry,no permission.
    403 InvalidKmsKey Kms key is disabled. The KMS key is disabled.
    403 InvalidInstanceLevel.Malformed Current DB instance level does not support this operation. The specified database instance type does not support this operation.
    403 IncorrectCharacterType Current DB instance character type does not support this operation. This operation is not supported for the character type of the instance.
    403 GuardDBInstanceExists Current DB instance had guard instance. The current database instance already has a disaster recovery instance.
    404 InsufficientResourceCapacity The target availability zone does not have sufficient resources. The target Availability Zone does not have enough resources.
    404 InvalidClusterKms The current instance does not authorized to access the Key Management Service. The instance does not have permissions to access Key Management Service (KMS).
    404 Request.NotFound The requested resource is not available. The requested resources are unavailable.
    404 HostInfo.NotFound The specified host info is not found. The specified host information does not exist.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.