All Products
Search
Document Center

ApsaraDB RDS:Create an ApsaraDB RDS for MariaDB instance

Last Updated:Mar 03, 2026

Create a MariaDB instance in the ApsaraDB RDS console or by calling the CreateDBInstance API operation.

Prerequisites

Before you begin, make sure that you have:

  • An Alibaba Cloud account

  • The AliyunRDSFullAccess and AliyunBSSOrderAccess permissions granted to your Resource Access Management (RAM) user. For details, see Authorize resources to a RAM user

Procedure

Go to the ApsaraDB RDS instance creation page. The price is displayed in the lower-right corner of the page and updates as you change configuration options.

Select a billing method

Select a Billing Method.

Billing methodBest forDetails
SubscriptionLong-term production workloadsLower cost than pay-as-you-go. Longer subscription durations offer greater discounts.
Pay-as-you-goShort-term testing or evaluationRelease the instance at any time to stop billing. You can convert a pay-as-you-go instance to subscription later.

Select a region

Select the Region where you want to create the instance.

Important

The region cannot be changed after purchase.

  • Same region as your ECS instance: Place the RDS instance in the same region as your Elastic Compute Service (ECS) instance to enable internal network connectivity and optimal performance.

  • No ECS instance: Select a region close to your users and connect through the public endpoint.

Select a database engine and storage type

The Edition is automatically set to High-availability Edition, which deploys a primary node and a secondary node in a classic high-availability architecture. The Product Type is set to Standard.

  1. For Database Engine, select MariaDB.

  2. Select a Storage Type. The available storage type for MariaDB is ESSD. For more information, see Storage types.

    AspectESSD
    ScalabilityUp to 32 TB. No transient connections occur during storage expansion. Supports automatic storage expansion. Upgrade, downgrade, add, or remove nodes in minutes.
    PerformanceThree performance levels: PL1 < PL2 < PL3. A PL2 ESSD delivers up to 2x the IOPS and throughput of a PL1 ESSD. A PL3 ESSD delivers up to 20x the IOPS and 11x the throughput of a PL1 ESSD.
    BackupBackups complete in minutes or seconds. The highest backup frequency is once every 15 minutes.
  3. (Optional) Select Cloud Disk Encryption for additional data protection. For more information, see Disk encryption.

Configure the network

The network type is fixed to VPC.

  1. Select a VPC. Use the same VPC as your ECS instance. Services in different VPCs cannot communicate over the internal network.

  2. Specify whether to Add to Whitelist. If you enable this option, ECS instances in the same VPC can access the RDS instance.

Note If you select No, you can manually configure a whitelist after the instance is created. For more information, see Configure a whitelist.

Configure zones and deployment method

  1. Zone: Select a zone. An ECS instance achieves slightly better performance when it accesses an RDS instance in the same zone, but the performance difference across zones within the same region is minor.

  2. vSwitch: Select an existing vSwitch or click Create vSwitch. For more information, see Create and manage a vSwitch.

  3. Deployment Method:

    Note Multi-zone Deployment is only available for subscription instances. Pay-as-you-go instances support Single-zone Deployment only.
    MethodDescription
    Multi-zone Deployment (recommended)The primary and secondary nodes are deployed in different zones within the same region. Provides cross-zone disaster recovery. Specify the Zone and Network of Primary Node and Zone and Network of Secondary Node.
    Single-zone DeploymentThe primary and secondary nodes are deployed in the same zone.

Select an instance type

  1. Select a Category.

    Note Dedicated Host is the top-tier configuration of the Dedicated category. It exclusively occupies all CPU, memory, storage, and I/O resources of a physical server.
    CategoryResourcesWhen to use
    General-purpose Instance TypesShared memory and I/O. Dedicated CPU and storage.Cost-effective choice for most workloads.
    Dedicated Instance TypesDedicated CPU, memory, storage, and I/O.Better and more stable performance for demanding workloads.
  2. Select the specifications (CPU cores and memory). For a full list, see Instance types.

Select the storage capacity

Select the Storage Capacity. The available range depends on your instance type and storage type.

Storage capacity is adjustable in increments of at least 5 GB.

Set the subscription duration (subscription only)

If you selected Subscription as the billing method, configure the Subscription Duration in the upper-right corner of the page.

Longer subscription durations offer lower prices. Hover over View Details next to the price to see a breakdown.

Configure optional parameters

The default values work for most use cases.

ParameterDescription
PortThe initial database port. Valid values: 1000 to 5999.
Resource GroupSelect the default resource group or a custom group to organize instances.
Instance NameA custom name to identify the instance.
TagsClassify and manage instances with tags. For more information, see Filter instances by tag.
Privileged AccountCreate a privileged account during instance creation. Each instance supports only one privileged account, and it cannot be deleted.
Note For pay-as-you-go instances, you can enable Release Protection after the instance is created to prevent accidental release. For more information, see Enable or disable release protection.

Set the quantity and confirm

  1. In the upper-right corner of the page, set the number of instances to purchase. The default is 1. You can purchase up to 20 instances at a time.

  2. Review the order information, quantity, and subscription duration (for subscription instances). Click Confirm Order and complete the payment. The console displays a Payment successful or Service activated message.

Note For subscription instances, select Enable Auto-renewal to avoid service disruptions from a missed renewal payment. If you purchase by month, the auto-renewal cycle is one month. If you purchase by year, the auto-renewal cycle is one year. The cycle on the buy page takes precedence. Auto-renewal can be cancelled at any time. For more information, see Renew an expired resource and Auto-renewal.

Verify the instance

Go to the Instances page. In the top navigation bar, select the region of the instance. Find the new instance by its Creation Time.

Instance creation takes about 1 to 5 minutes. Refresh the page to check the status.

Next steps

After the instance is created, complete the following setup:

  1. Configure a whitelist -- Required before any client can connect.

  2. Create a database and an account

  3. Apply for or release a public endpoint -- Only needed if you connect from outside the VPC.

  4. Connect to an ApsaraDB RDS for MariaDB instance

FAQ

How do I find the total number of RDS instances in my account?

Go to the Overview page in the ApsaraDB RDS console. This page shows the total number of RDS instances across all database engines, along with the regions and running instance counts.

I just created an instance but cannot find it. What should I check?

Possible causeWhat to do
Wrong region selectedIn the top navigation bar of the ApsaraDB RDS console, switch to the region where you created the instance.
Insufficient resourcesThe selected zone may not have enough resources. Check the Orders page for refunded fees. Try a different zone.
RAM policy blocking unencrypted instancesIf a RAM policy prevents creating unencrypted instances, select the ESSD storage type, enable Cloud Disk Encryption, configure the Key parameter, and try again. For more information, see Use RAM policies to manage the permissions of RAM users on ApsaraDB RDS instances.

References