From b5828b4db3c4f14960786aeced5bc22690d092a8 Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 3 Jun 2026 14:51:33 +0800 Subject: [PATCH 1/6] add info about the Recycle Bin support for Essential --- tidb-cloud/backup-and-restore-serverless.md | 22 +++++++++++++++++++++ tidb-cloud/delete-tidb-cluster.md | 14 +++++++++---- tidb-cloud/features.md | 2 +- tidb-cloud/tidb-cloud-glossary.md | 6 +++++- 4 files changed, 38 insertions(+), 6 deletions(-) diff --git a/tidb-cloud/backup-and-restore-serverless.md b/tidb-cloud/backup-and-restore-serverless.md index beac905220604..7b4702858572b 100644 --- a/tidb-cloud/backup-and-restore-serverless.md +++ b/tidb-cloud/backup-and-restore-serverless.md @@ -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 5c119f8fb2a3a..3a2187915efad 100644 --- a/tidb-cloud/delete-tidb-cluster.md +++ b/tidb-cloud/delete-tidb-cluster.md @@ -26,15 +26,18 @@ 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 it. 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 +46,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 the 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). \ No newline at end of file diff --git a/tidb-cloud/features.md b/tidb-cloud/features.md index a69902cfd6263..a8cf2e6577086 100644 --- a/tidb-cloud/features.md +++ b/tidb-cloud/features.md @@ -116,7 +116,7 @@ This document lists the feature support status for different TiDB Cloud plans, i Backup file recycle bin ❌ - ❌ + ✅ ✅ ✅ diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index c519a45b4c85f..433295a02dbfb 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -140,7 +140,11 @@ The place where the data of deleted [TiDB Cloud resources](#tidb-cloud-resource) 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 {{{ .premium }}} instances and {{{ .dedicated }}} clusters support the Recycle Bin feature. +Currently, only the following types of TiDB Cloud resources support the Recycle Bin feature: + +- {{{ .essential }}} instances +- {{{ .premium }}} instances +- {{{ .dedicated }}} clusters ### region From 37201137161d7db2223bd6bf2df8d7eb93f3bbef Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 5 Jun 2026 09:19:37 +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/delete-tidb-cluster.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tidb-cloud/delete-tidb-cluster.md b/tidb-cloud/delete-tidb-cluster.md index 3a2187915efad..36edc3a1e13af 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 in the future, make sure that you have a backup of it. Otherwise, you cannot restore it. - 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). @@ -37,7 +37,7 @@ You can delete a TiDB Cloud resource at any time by performing the following ste 5. Click **I understand, delete it**. - 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. + Once a backed-up {{{ .essential }}} instance or TiDB Cloud Dedicated cluster is deleted, its existing backup files 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. From b7970132e68477f4d9ea416404575af9a244fb60 Mon Sep 17 00:00:00 2001 From: qiancai Date: Fri, 5 Jun 2026 10:25:27 +0800 Subject: [PATCH 3/6] add the release note for Essential's Recycle Bin support Co-Authored-By: Grace Cai --- tidb-cloud/backup-and-restore-serverless.md | 4 ++++ tidb-cloud/releases/tidb-cloud-release-notes.md | 6 ++++++ 2 files changed, 10 insertions(+) diff --git a/tidb-cloud/backup-and-restore-serverless.md b/tidb-cloud/backup-and-restore-serverless.md index 7b4702858572b..f94f7d137971b 100644 --- a/tidb-cloud/backup-and-restore-serverless.md +++ b/tidb-cloud/backup-and-restore-serverless.md @@ -146,6 +146,10 @@ To restore a deleted {{{ .essential }}} instance from the Recycle Bin, take the 3. Locate the {{{ .essential }}} instance you want to restore, and then click the **>** button to expand the available backups of the instance. + >**Note:** + > + > If a {{{ .essential }}} instance **has no backup**, the deleted instance is not displayed in the Recycle Bin. + 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. diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index 7d92279c90f82..b2a70fa88cdda 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -89,6 +89,12 @@ This page lists the release notes of [TiDB Cloud](https://www.pingcap.com/tidb-c - **TiDB Cloud Essential** + - Recycle Bin is now available for [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential). It stores data from deleted TiDB Cloud resources that have valid backups. + + When a [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) instance with existing backups is deleted, its backup files are moved to the Recycle Bin. Backup files created by automatic backups are retained in the Recycle Bin for a specified period. To avoid data loss, restore the data to a new TiDB Cloud Essential instance before the retention period expires. Note that if a TiDB Cloud Essential instance **has no backup**, the deleted instance is not displayed in the Recycle Bin. + + For more information, see [Backup and Restore](/tidb-cloud/backup-and-restore-serverless.md#restore-from-recycle-bin). + - Top RU is now available in public preview for [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) in the following region: - Alibaba Cloud: `Mexico (na-south-1)` From 9c2a69ab95376bba7e05fbfa4d93c11d578cb992 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 5 Jun 2026 10:37:25 +0800 Subject: [PATCH 4/6] Update tidb-cloud/features.md --- tidb-cloud/features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/features.md b/tidb-cloud/features.md index a8cf2e6577086..31a18f064f94c 100644 --- a/tidb-cloud/features.md +++ b/tidb-cloud/features.md @@ -116,7 +116,7 @@ This document lists the feature support status for different TiDB Cloud plans, i Backup file recycle bin ❌ - ✅ + ✅ ✅ ✅ From 5d34a37330279948e62464c5492fa1055b23b6c9 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Fri, 5 Jun 2026 10:39:07 +0800 Subject: [PATCH 5/6] Update tidb-cloud/releases/tidb-cloud-release-notes.md --- tidb-cloud/releases/tidb-cloud-release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index b2a70fa88cdda..0e402a96f7a85 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -91,7 +91,7 @@ This page lists the release notes of [TiDB Cloud](https://www.pingcap.com/tidb-c - Recycle Bin is now available for [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential). It stores data from deleted TiDB Cloud resources that have valid backups. - When a [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) instance with existing backups is deleted, its backup files are moved to the Recycle Bin. Backup files created by automatic backups are retained in the Recycle Bin for a specified period. To avoid data loss, restore the data to a new TiDB Cloud Essential instance before the retention period expires. Note that if a TiDB Cloud Essential instance **has no backup**, the deleted instance is not displayed in the Recycle Bin. + When a TiDB Cloud Essential instance with existing backups is deleted, its backup files are moved to the Recycle Bin. Backup files created by automatic backups are retained in the Recycle Bin for a specified period. To avoid data loss, restore the data to a new TiDB Cloud Essential instance before the retention period expires. Note that if a TiDB Cloud Essential instance **has no backup**, the deleted instance is not displayed in the Recycle Bin. For more information, see [Backup and Restore](/tidb-cloud/backup-and-restore-serverless.md#restore-from-recycle-bin). From 8023518ec6379d9c0456bac3b4d6015be7234b8c Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 8 Jun 2026 11:34:17 +0800 Subject: [PATCH 6/6] Update tidb-cloud/releases/tidb-cloud-release-notes.md --- tidb-cloud/releases/tidb-cloud-release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index 0e402a96f7a85..656f9af020e01 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -89,7 +89,7 @@ This page lists the release notes of [TiDB Cloud](https://www.pingcap.com/tidb-c - **TiDB Cloud Essential** - - Recycle Bin is now available for [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential). It stores data from deleted TiDB Cloud resources that have valid backups. + - Recycle Bin is now available for [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential). It stores data of deleted TiDB Cloud resources that have valid backups. When a TiDB Cloud Essential instance with existing backups is deleted, its backup files are moved to the Recycle Bin. Backup files created by automatic backups are retained in the Recycle Bin for a specified period. To avoid data loss, restore the data to a new TiDB Cloud Essential instance before the retention period expires. Note that if a TiDB Cloud Essential instance **has no backup**, the deleted instance is not displayed in the Recycle Bin.