Skip to content

chore: add admin UI instructions for database restore #6700

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mnaqvi08 merged 5 commits into from
Jan 7, 2026
Merged

chore: add admin UI instructions for database restore #6700

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
30c0aec
chore: update docs to reflect DB undelete addition
mnaqvi08 Jan 6, 2026
aedb2df
Merge branch 'master' into chore/update-db-delete
jstirnaman Jan 6, 2026
b4debb4
chore: consolidate points
mnaqvi08 Jan 6, 2026
b1ca174
chore: address comments
mnaqvi08 Jan 6, 2026
3898947
Merge branch 'master' into chore/update-db-delete
jstirnaman Jan 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions content/influxdb3/cloud-dedicated/admin/databases/delete.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ list_code_example: |
--header "Authorization: Bearer MANAGEMENT_TOKEN"
```
related:
- /influxdb3/cloud-dedicated/admin/databases/undelete/
- /influxdb3/cloud-dedicated/reference/cli/influxctl/database/delete/
- /influxdb3/cloud-dedicated/reference/api/
---
Expand All @@ -47,6 +48,13 @@ to delete a database from your {{< product-name omit=" Clustered" >}} cluster.
> that granted access to the deleted database will also grant access to the new
> database.

> [!Note]
> #### Deleted databases can be restored
>
> Deleted databases can be [restored](/influxdb3/cloud-dedicated/admin/databases/undelete/)
Copy link
Contributor

@wdoconnell wdoconnell Jan 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I realize this may be a nit, but can we characterize this as "Deleted databases may be able to be restored"? Based on the current configuration DBs will be restorable for at least 7 days (depending on when the cleanup job runs), but I would rather hedge here with more permissive language than "can" to avoid suggesting that the customer can always wait til the last moment to restore.

> within approximately 7 days of deletion. After this grace period, the database
> and its data are permanently removed.

{{< tabs-wrapper >}}
{{% tabs %}}
[Admin UI](#)
Expand Down
41 changes: 38 additions & 3 deletions content/influxdb3/cloud-dedicated/admin/databases/undelete.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Undelete a database
description: >
Use the [`influxctl database undelete` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/database/undelete/)
Use the Admin UI or the [`influxctl database undelete` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/database/undelete/)
to restore a previously deleted database in your {{< product-name omit=" Cluster" >}} cluster.
menu:
influxdb3_cloud_dedicated:
Expand All @@ -17,7 +17,7 @@ related:
- /influxdb3/cloud-dedicated/admin/tokens/database/create/
---

Use the [`influxctl database undelete` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/database/undelete/)
Use the Admin UI or the [`influxctl` CLI](/influxdb3/cloud-dedicated/reference/cli/influxctl/)
to restore a previously deleted database in your {{< product-name omit=" Cluster" >}} cluster.

> [!Important]
Expand All @@ -37,7 +37,40 @@ table limits, and column limits as when it was deleted.
> After this grace period, all Parquet files associated with the deleted database
> are permanently removed and the database cannot be undeleted.

## Undelete a database using the influxctl CLI
{{< tabs-wrapper >}}
{{% tabs %}}
[Admin UI](#admin-ui)
[influxctl](#influxctl)
{{% /tabs %}}
{{% tab-content %}}
<!------------------------------BEGIN ADMIN UI -------------------------------->
The InfluxDB Cloud Dedicated administrative UI includes a portal for
managing databases, including restoring deleted databases.

1. To access the {{< product-name >}} Admin UI, visit the following URL in your browser:
Copy link
Contributor

@wdoconnell wdoconnell Jan 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See #6528 and #6562 - I think we have a template we can reference here so that we don't need to rewrite this text.

There is one instance where we did need to hardcode it in the above PRs for formatting reasons, so double check with hugo serve locally to make sure the template works


<pre>
<a href="https://console.influxdata.com">https://console.influxdata.com</a>
</pre>

2. Use the credentials provided by InfluxData to log into the Admin UI.
If you don't have login credentials, [contact InfluxData support](https://support.influxdata.com).
3. In the database list, find the deleted database you want to restore.
Deleted databases are shown with a "Deleted" status indicator.
You can sort on column headers or use the **Search** field to find a specific database.
4. Click the options button (three vertical dots) to the right of the deleted database you want to restore.
The options menu displays.
5. In the options menu, click **Restore Database**. The **Restore Database** dialog displays.
Copy link
Contributor

@jstirnaman jstirnaman Jan 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. Click the options button (three vertical dots) to the right of the deleted database you want to restore.
The options menu displays.
5. In the options menu, click **Restore Database**. The **Restore Database** dialog displays.
4. In the options menu (three vertical dots to the right of the database), click **Restore Database**. The **Restore Database** dialog displays.

6. In the **Restore Database** dialog, review the database name and deletion date.
7. Click the **Restore Database** button to restore the database.
Copy link
Contributor

@jstirnaman jstirnaman Jan 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
6. In the **Restore Database** dialog, review the database name and deletion date.
7. Click the **Restore Database** button to restore the database.
5. In the **Restore Database** dialog, review the database name and deletion date.
6. Click the **Restore Database** button to restore the database.

{{% /tab-content %}}
{{% tab-content %}}

1. If you haven't already, [download and install the `influxctl` CLI](/influxdb3/cloud-dedicated/reference/cli/influxctl/#download-and-install-influxctl).
2. Use the [`influxctl database undelete` command](/influxdb3/cloud-dedicated/reference/cli/influxctl/database/undelete/)
to restore a deleted database. Provide the following:

- The name of the deleted database to restore

{{% code-placeholders "DATABASE_NAME" %}}
```sh
Expand All @@ -49,6 +82,8 @@ Replace the following:

- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
Name of the deleted database to restore
{{% /tab-content %}}
{{< /tabs-wrapper >}}

## Recreate tokens for the database

Expand Down
Loading