All Products
Search
Document Center

PolarDB:Temporarily upgrade compute node specifications

Last Updated:Mar 30, 2026

When your cluster faces a predictable, short-term traffic spike—such as an e-commerce sales event or a scheduled online promotion—a temporary upgrade lets you scale up CPU and memory for a set period without committing to a permanent change. Specifications revert automatically at the time you choose, so you pay only for what you need.

Temporary upgrades are available only for Subscription clusters.

Temporary upgrade vs. permanent upgrade

Expenses and Costs > Subscription Orders > My OrdersTemporary upgrade Permanent upgrade
Best for Predictable, time-bounded traffic spikes Sustained workload increase
Duration 1 hour to 14 days Indefinite
Reverts automatically Yes, at the restore point you set No
Billing Price difference × 1.5 premium coefficient Standard subscription price
Blocked operations Manual downgrade, add/remove nodes, temporary nodes, auto scaling, unsubscribe None

Service impact

Specification changes restart compute nodes, causing brief service disruptions. The severity depends on your cluster configuration.

Connection interruption by configuration

Configuration Impact
No failover with hot standby Connection interruption of approximately 20–30 seconds
Failover with hot standby + binary logging (Binlog) enabled Connection interruption of approximately 5–10 seconds
Failover with hot standby + Binlog disabled Performance drops to zero for 1–3 seconds; connections and transactions are not interrupted
Important

Make sure your application has a reconnection mechanism before starting a specification change if your cluster does not support failover with hot standby.

Additional impacts

  • Change duration: Approximately 5 minutes per compute node. Changing two nodes takes about 10 minutes. Actual duration varies with cluster workload and the number of databases and tables.

  • Read-only node latency: Data synchronization latency on read-only nodes may be longer than normal during the change.

  • Restart order: Read-only nodes restart first, then the primary node. No primary/standby switchover occurs.

Specification changes adjust only compute resources. Existing data in the cluster is not affected.

Node specification limits

These limits ensure that read-only nodes have enough capacity to take over primary node traffic during a failover. They apply to all clusters except Multi-master Cluster (Limitless) Edition.

  • At least one read-only node must have the same specifications as the primary node.

  • Read-only nodes with hot standby enabled must have the same specifications as the primary node.

  • The memory of a read-only node cannot be less than half the memory of the primary node.

  • CPU core minimums for read-only nodes:

Primary node CPU cores Minimum CPU cores for a read-only node
2 2
4 4
8 4
16 8
32 16
64 32
88 64
120 64

Limitations

Prerequisites

Before you begin, ensure that you have:

  • A Subscription cluster in the Running state

  • No other configuration change tasks in progress (such as adding or removing nodes, or performing minor version upgrades)

  • No pending configuration change tasks

  • The AliyunServiceRoleForPolarDB service-linked role created under your Alibaba Cloud account

    Check whether the service-linked role exists

    1. Log on to the RAM console using your Alibaba Cloud account and go to Identity Management > Roles.

    2. Search for a role named AliyunServiceRoleForPolarDB.

      • If the role exists, no action is needed.

      • If the role does not exist, continue with the following steps.

      image

    3. Click Create Role. On the Create Role page, click Create Service-Linked Role in the upper-right corner.

      image

    4. Set Trusted Service to AliyunServiceRoleForPolarDB and click Create Service-Linked Role.

      image

Perform a temporary upgrade

  1. Log on to the PolarDB console. In the left navigation pane, click Clusters and select the region where the cluster is located.

  2. Open the Change Configurations (Subscription) dialog box using one of the following methods:

    • Click Change Configurations in the Actions column of the target cluster. image

    • Click the cluster ID to go to the Basic Information page. In the Database Nodes section, click Change Configurations. image

  3. Select Temporary Upgrade and click OK.

  4. On the Temporary Upgrade page, review the Current Configuration and Expiration Time, then set the following parameters:

    Important

    The Restore Point cannot be changed after it is set, and it cannot be later than one day before the cluster's expiration date. For example, if the cluster expires on January 10, the latest valid restore time is January 9. If you need to extend the upgrade duration, perform a second temporary upgrade before the original restore time is reached—the new Restore Point must be later than the first.

    Parameter Description
    Sub-series Select the target specification edition: General Specification or Dedicated Specification.
    Node Select the target specifications for each node to upgrade (primary or read-only). At least one read-only node must match the primary node specifications.
    Restore Point Set the time when the system will automatically revert the specifications to their original state. The minimum duration is 1 hour and the maximum is 14 days. For periods longer than 14 days, use a manual specification change instead.
  5. Read the terms of service, click Buy Now, and complete the payment. The upgrade task starts after payment.

Billing

The fee is based on the price difference between the new and original specifications, with a premium coefficient of 1.5:

Fee for N days = (Monthly price of new specifications − Monthly price of original specifications) ÷ 30 × 1.5 × N

More operations

Convert a temporary upgrade to a permanent upgrade

To keep the upgraded specifications permanently—or to perform operations that are blocked during a temporary upgrade, such as adding nodes or using automatic scaling—convert the temporary upgrade to a permanent one.

Two conversion methods are available:

  • Manual conversion: During the temporary upgrade period, go to the change configuration page and perform a manual specification change to the current specifications. This generates only a permanent billing order without causing a second service interruption.

  • Conversion via storage scale-out: If you manually scale out the cluster's storage space during the temporary upgrade period, the system automatically converts the compute specifications to permanent. Billing at the subscription price of the new specifications starts from the moment of the scale-out. Evaluate this carefully before scaling out storage.

View the expiration time of a temporary upgrade

Go to [Expenses and Costs](https://usercenter2-intl.console.alibabacloud.com/billing/#/account/overview) > Subscription Orders > My Orders. Search for the cluster by ID, find the Temporary Upgrade order, and click Details.

API reference

API Description
TempModifyDBNode Temporarily upgrades a PolarDB cluster

FAQ

The "Insufficient resources" error appears during a temporary upgrade.

The selected specifications are sold out in the current zone. Try selecting similar specifications that are slightly lower in capacity. To avoid this in future upgrades, change the primary zone to a zone with more available capacity.

The "`The operation is not permitted due to loss polardb service linked role.`" error appears.

The AliyunServiceRoleForPolarDB service-linked role has not been created for your account. See Prerequisites for steps to create it.

The "The expiration time of the temporary upgrade cannot be earlier than: XXX" error appears.

If you perform a second temporary upgrade to extend the duration, the Restore Point must be later than—not equal to—the restore time of the first upgrade. Extend the duration by at least one hour.