From e0d5f0635c5d8c2dfa008748c885fca8153081ff Mon Sep 17 00:00:00 2001 From: qiancai Date: Mon, 23 Mar 2026 14:23:43 +0800 Subject: [PATCH 1/6] update steps to access Recycle Bin --- tidb-cloud/backup-and-restore.md | 13 +++++++++---- tidb-cloud/premium/backup-and-restore-premium.md | 15 ++++++++++----- 2 files changed, 19 insertions(+), 9 deletions(-) diff --git a/tidb-cloud/backup-and-restore.md b/tidb-cloud/backup-and-restore.md index a65704111066a..d448dc089b189 100644 --- a/tidb-cloud/backup-and-restore.md +++ b/tidb-cloud/backup-and-restore.md @@ -325,10 +325,15 @@ To restore your TiDB Cloud Dedicated cluster data from a backup to a new cluster To restore a deleted cluster from recycle bin, take the following steps: -1. In the [TiDB Cloud console](https://tidbcloud.com), switch to your target project using the combo box in the upper-left corner. -2. In the left navigation pane, click **Project Settings** > **Recycle Bin**. -3. On the **Recycle Bin** page, locate the cluster you want to restore, click **...** in the **Action** column, and then click **Backups**. -4. On the **Backups** page, locate your desired backup time, click **...** in the **Action** column, and then click **Restore**. +1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page of your organization, click **...** in the upper-right corner, and then click **Recycle Bin**. + + >**Tip:** + > + > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organizations first. + +2. On the **Recycle Bin** page, click the **Dedicated** tab to go to the recycle bin of TiDB Cloud Dedicated clusters. +3. Locate the cluster you want to restore, and then click the **>** button to expand the available backups of the cluster. +4. In the row of your desired backup, click **...**, and then select **Restore**. 5. On the **Restore** page, specify a name for the new cluster, and then make the following changes if necessary: - Update the port number of the cluster. diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index 99f2f8f2e7f34..9c76b7bed2431 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -130,14 +130,19 @@ To restore your data to a new instance, take the following steps: To restore a deleted instance from the Recycle Bin, take the following steps: -1. Log in to the [TiDB Cloud console](https://tidbcloud.com), and then navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page. In the top-right corner, click **Recycle Bin**. +1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page of your organization, click **...** in the upper-right corner, and then click **Recycle Bin**. -2. On the **Recycle Bin** page, locate the {{{ .premium }}} instance you want to restore: + >**Tip:** + > + > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organizations first. - - Click the **>** button to expand instance details. - - Find the desired backup, click **...** in the **Action** column, and then select **Restore**. +2. On the **Recycle Bin** page, click the **Premium** tab to go to the recycle bin of {{{ .premium }}} instances. -3. On the **Restore** page, follow the same steps as [Restore to a new instance](#restore-to-a-new-instance) to restore the backup to a new instance. +3. Locate the {{{ .premium }}} instance you want to restore, and then click the **>** button to expand the available backups of the instance. + +4. In the row of your desired backup, click **...**, and then select **Restore**. + +5. On the **Restore** page, follow the same steps as [Restore to a new instance](#restore-to-a-new-instance) to restore the backup to a new instance. ### Restore backups from a different plan type From 85d07148d5d5e9f43397a04bfea3fbda1d51fd45 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 23 Mar 2026 14:35:03 +0800 Subject: [PATCH 2/6] Apply suggestions from code review Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- tidb-cloud/backup-and-restore.md | 4 ++-- tidb-cloud/premium/backup-and-restore-premium.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/tidb-cloud/backup-and-restore.md b/tidb-cloud/backup-and-restore.md index d448dc089b189..80a48e1ffe936 100644 --- a/tidb-cloud/backup-and-restore.md +++ b/tidb-cloud/backup-and-restore.md @@ -323,13 +323,13 @@ To restore your TiDB Cloud Dedicated cluster data from a backup to a new cluster > > You cannot restore a deleted cluster to any point in time. You can only select an automatic or manual backup to restore. -To restore a deleted cluster from recycle bin, take the following steps: +To restore a deleted cluster from the Recycle Bin, take the following steps: 1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page of your organization, click **...** in the upper-right corner, and then click **Recycle Bin**. >**Tip:** > - > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organizations first. + > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organization first. 2. On the **Recycle Bin** page, click the **Dedicated** tab to go to the recycle bin of TiDB Cloud Dedicated clusters. 3. Locate the cluster you want to restore, and then click the **>** button to expand the available backups of the cluster. diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index 9c76b7bed2431..17cfedb215139 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -134,7 +134,7 @@ To restore a deleted instance from the Recycle Bin, take the following steps: >**Tip:** > - > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organizations first. + > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organization first. 2. On the **Recycle Bin** page, click the **Premium** tab to go to the recycle bin of {{{ .premium }}} instances. From 24bcd694f4a9a504b7857f92a0a05b74f2048b7e Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 25 Mar 2026 11:18:14 +0800 Subject: [PATCH 3/6] essential: support recycle bin --- tidb-cloud/backup-and-restore-serverless.md | 24 ++++++++++++++++++- tidb-cloud/delete-tidb-cluster.md | 15 ++++++++---- tidb-cloud/features.md | 2 +- .../premium/backup-and-restore-premium.md | 2 +- tidb-cloud/tidb-cloud-glossary.md | 14 +++++++++-- 5 files changed, 48 insertions(+), 9 deletions(-) diff --git a/tidb-cloud/backup-and-restore-serverless.md b/tidb-cloud/backup-and-restore-serverless.md index 1233f4841011a..895fcbf0eabf5 100644 --- a/tidb-cloud/backup-and-restore-serverless.md +++ b/tidb-cloud/backup-and-restore-serverless.md @@ -85,7 +85,7 @@ The restore process typically completes within a few minutes. If the restore tak If the data is corrupted after a canceled restore and cannot be recovered, contact [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md) for assistance. -### Perform the restore +### Restore to a new instance > **Note:** > @@ -128,6 +128,28 @@ To restore your data to a new {{{ .starter }}} or Essential instance, take the f Once the restore process begins, the {{{ .starter }}} or Essential instance status changes to **Restoring**. The {{{ .starter }}} or Essential instance will remain unavailable until the restore is complete and the status changes to **Available**. +### Restore from Recycle Bin + +> **Note:** +> +> {{{ .starter }}} does not support restoring from Recycle Bin. + +To restore a deleted {{{ .essential }}} instance from the Recycle Bin, take the following steps: + +1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page of your organization, click **...** in the upper-right corner, and then click **Recycle Bin**. + + >**Tip:** + > + > If you are in multiple organizations, use the combo box in the upper-left corner to switch to your target organization first. + +2. On the **Recycle Bin** page, click the **Essential** tab to go to the recycle bin of {{{ .essential }}} instances. + +3. Locate the {{{ .essential }}} instance you want to restore, and then click the **>** button to expand the available backups of the instance. + +4. In the row of your desired backup, click **...**, and then select **Restore**. + +5. On the **Restore** page, follow the same steps as [Restore to a new instance](#restore-to-a-new-instance) to restore the backup to a new instance. + ## Limitations - If a TiFlash replica is enabled, it will be unavailable for a period after the restore, because the data needs to be rebuilt in TiFlash. diff --git a/tidb-cloud/delete-tidb-cluster.md b/tidb-cloud/delete-tidb-cluster.md index e7de90498d8f0..da9bb4b9c1122 100644 --- a/tidb-cloud/delete-tidb-cluster.md +++ b/tidb-cloud/delete-tidb-cluster.md @@ -26,15 +26,19 @@ You can delete a TiDB Cloud resource at any time by performing the following ste - If you have at least one manual or automatic backup, you can see the number of backups and the charging policy for backups. Click **Continue** and enter `//`. - If you do not have any backups, just enter `//`. - If you want to restore a deleted {{{ .dedicated }}} cluster sometime in the future, make sure that you have a backup of the cluster. Otherwise, you cannot restore it anymore. For more information about how to back up TiDB Cloud Dedicated clusters, see [Back Up and Restore TiDB Cloud Dedicated Data](/tidb-cloud/backup-and-restore.md). + If you want to restore a deleted {{{ .essential}}} instance or {{{ .dedicated }}} cluster sometime in the future, make sure that you have a backup of it. Otherwise, you cannot restore it anymore. + + - For more information about how to back up {{{ .essential }}} instances, see [Back Up and Restore {{{ .essential }}} Data](/tidb-cloud/backup-and-restore-serverless.md). + - For more information about how to back up TiDB Cloud Dedicated clusters, see [Back Up and Restore TiDB Cloud Dedicated Data](/tidb-cloud/backup-and-restore.md). + > **Note:** > - > [{{{ .starter }}}](/tidb-cloud/select-cluster-tier.md#starter) and [{{{ .essential }}}](/tidb-cloud/select-cluster-tier.md#essential) instances do not support restoring data after the deletion. If you want to delete a {{{ .starter }}} or {{{ .essential }}} instance and restore its data in the future, see [Export Data from {{{ .starter }}} or Essential](/tidb-cloud/serverless-export.md) to export your data as a backup. + > [{{{ .starter }}}](/tidb-cloud/select-cluster-tier.md#starter) instances do not support restoring data after the deletion. If you want to delete a {{{ .starter }}} instance and restore its data in the future, see [Export Data from {{{ .starter }}}](/tidb-cloud/serverless-export.md) to export your data as a backup. 5. Click **I understand, delete it**. - Once a backed up TiDB Cloud Dedicated cluster is deleted, the existing backup files of the cluster are moved to the recycle bin. + Once a backed up {{{ .essential }}} instance or TiDB Cloud Dedicated cluster is deleted, the existing backup files of it are moved to the Recycle Bin. - Automatic backups will expire and be automatically deleted once the retention period ends, except for the latest one. The default retention period is 7 days if you don't modify it. The latest automatic backup will not be deleted unless you explicitly delete it. - Manual backups will be kept in the Recycle Bin until manually deleted. @@ -43,4 +47,7 @@ You can delete a TiDB Cloud resource at any time by performing the following ste > > Please be aware that backups will continue to incur charges until deleted. - If you want to restore a TiDB Cloud Dedicated cluster from recycle bin, see [Restore a deleted cluster](/tidb-cloud/backup-and-restore.md#restore-a-deleted-cluster). + If you want to restore data from Recycle Bin, see the following documents: + + - [Restore a deleted {{{ .essential }}} instance](/tidb-cloud/backup-and-restore-serverless.md#restore-from-recycle-bin). + - [Restore a deleted TiDB Cloud Dedicated cluster](/tidb-cloud/backup-and-restore.md#restore-a-deleted-cluster). diff --git a/tidb-cloud/features.md b/tidb-cloud/features.md index 7a3e08ad202a4..eee350ed8edbd 100644 --- a/tidb-cloud/features.md +++ b/tidb-cloud/features.md @@ -103,7 +103,7 @@ This document lists the feature support status for different TiDB Cloud plans, i Backup file recycle bin ❌ - ❌ + ✅ ✅ diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index 17cfedb215139..518d63dea3eaf 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -128,7 +128,7 @@ To restore your data to a new instance, take the following steps: ### Restore from Recycle Bin -To restore a deleted instance from the Recycle Bin, take the following steps: +To restore a deleted {{{ .premium }}} instance from the Recycle Bin, take the following steps: 1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page of your organization, click **...** in the upper-right corner, and then click **Recycle Bin**. diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index 59aca5601b1a0..283491974fb53 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -119,9 +119,19 @@ Project members are users who are invited to join one or more projects of the or ### Recycle Bin -The place where the data of deleted {{{ .dedicated }}} clusters and {{{ .premium }}} instances with valid backups is stored. +The place where the data of deleted TiDB Cloud resources with valid backups is stored. -Once a backed-up {{{ .dedicated }}} cluster or {{{ .premium }}} instance is deleted, the existing backup files of the cluster or instance are moved to the recycle bin. For backup files from automatic backups, the recycle bin will retain them for a specified period. You can configure the backup retention in **Backup Setting**, and the default is 7 days. For backup files from manual backups, there is no expiration date. To avoid data loss, remember to restore the data to a new {{{ .dedicated }}} cluster or {{{ .premium }}} instance in time. Note that if a {{{ .dedicated }}} cluster or {{{ .premium }}} instance **has no backup**, the deleted cluster or instance will not be displayed here. +Once a backed-up TiDB Cloud resource is deleted, the existing backup files of it are moved to the Recycle Bin. For backup files from automatic backups, the Recycle Bin will retain them for a specified period. You can configure the backup retention in **Backup Setting**, and the default is 7 days. For backup files from manual backups, there is no expiration date. To avoid data loss, remember to restore the data to a new TiDB Cloud resource in time. Note that if a TiDB Cloud resource **has no backup**, the deleted resource will not be displayed in the Recycle Bin. + +Currently, only the following types of TiDB Cloud resources support the Recycle Bin feature: + +- {{{ .essential }}} instances + + +- {{{ .premium }}} instances + + +- {{{ .dedicated }}} clusters ### region From 5a33c29aa9a6982fd0b14fb5a1a4475a36e2213c Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 25 Mar 2026 11:20:00 +0800 Subject: [PATCH 4/6] Update tidb-cloud/backup-and-restore.md --- tidb-cloud/backup-and-restore.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/backup-and-restore.md b/tidb-cloud/backup-and-restore.md index 80a48e1ffe936..f7143939cfe65 100644 --- a/tidb-cloud/backup-and-restore.md +++ b/tidb-cloud/backup-and-restore.md @@ -323,7 +323,7 @@ To restore your TiDB Cloud Dedicated cluster data from a backup to a new cluster > > You cannot restore a deleted cluster to any point in time. You can only select an automatic or manual backup to restore. -To restore a deleted cluster from the Recycle Bin, take the following steps: +To restore a deleted TiDB Cloud Dedicated cluster from the Recycle Bin, take the following steps: 1. In the [TiDB Cloud console](https://tidbcloud.com), navigate to the [**My TiDB**](https://tidbcloud.com/tidbs) page of your organization, click **...** in the upper-right corner, and then click **Recycle Bin**. From 5e642ed34a9a4bbde748f0b315850d5f77d00052 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 25 Mar 2026 11:22:58 +0800 Subject: [PATCH 5/6] Apply suggestions from code review Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- tidb-cloud/delete-tidb-cluster.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/delete-tidb-cluster.md b/tidb-cloud/delete-tidb-cluster.md index da9bb4b9c1122..0f448431d7457 100644 --- a/tidb-cloud/delete-tidb-cluster.md +++ b/tidb-cloud/delete-tidb-cluster.md @@ -26,7 +26,7 @@ You can delete a TiDB Cloud resource at any time by performing the following ste - If you have at least one manual or automatic backup, you can see the number of backups and the charging policy for backups. Click **Continue** and enter `//`. - If you do not have any backups, just enter `//`. - If you want to restore a deleted {{{ .essential}}} instance or {{{ .dedicated }}} cluster sometime in the future, make sure that you have a backup of it. Otherwise, you cannot restore it anymore. + If you want to restore a deleted {{{ .essential }}} instance or {{{ .dedicated }}} cluster sometime in the future, make sure that you have a backup of it. Otherwise, you cannot restore it anymore. - For more information about how to back up {{{ .essential }}} instances, see [Back Up and Restore {{{ .essential }}} Data](/tidb-cloud/backup-and-restore-serverless.md). - For more information about how to back up TiDB Cloud Dedicated clusters, see [Back Up and Restore TiDB Cloud Dedicated Data](/tidb-cloud/backup-and-restore.md). From 6c87cde3c07ce59075d40db620a37703962fb6c5 Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 25 Mar 2026 11:23:49 +0800 Subject: [PATCH 6/6] fix a broken link --- tidb-cloud/releases/release-notes-2025.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/releases/release-notes-2025.md b/tidb-cloud/releases/release-notes-2025.md index 2e7ec50ebb765..b9218469e670b 100644 --- a/tidb-cloud/releases/release-notes-2025.md +++ b/tidb-cloud/releases/release-notes-2025.md @@ -198,7 +198,7 @@ This page lists the release notes of [TiDB Cloud](https://www.pingcap.com/tidb-c - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) removes the in-place restore feature, which means you can no longer restore a backup directly to the same cluster. This change helps prevent accidental overwrites of active production data and potential data loss. - To restore your data, you can [restore the backup to a new cluster](/tidb-cloud/backup-and-restore-serverless.md#perform-the-restore). After validating the restored data, switch your application to the new cluster. Previously restored data in existing clusters remains intact, and no action is required unless you perform a new restore. + To restore your data, you can [restore the backup to a new cluster](/tidb-cloud/backup-and-restore-serverless.md#restore-to-a-new-instance). After validating the restored data, switch your application to the new cluster. Previously restored data in existing clusters remains intact, and no action is required unless you perform a new restore. For safer restore and migration workflows with more control and flexibility, consider using [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential).