[ Web Proxy ]
URL:
Viewing: https://docs.digitalocean.com/reference/pydo/reference/databases/list_backups/ [Back]  [Original]
pydo.databases.list_backups() | DigitalOcean Documentation

For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

pydo.databases.list_backups()

Generated on 3 Aug 2026 from pydo version v0.40.0

Copy page as Markdown View page as Markdown

Usage 

client.databases.list_backups(
    database_cluster_uuid="9cc10173-e9ea-4176-9dbc-a4cee4c4ff30",
)
Returns JSONRaises HttpResponseError

Description

To list all of the available backups of a PostgreSQL or MySQL database cluster, send a GET request to /v2/databases/{database_cluster_uuid}/backups. Note: Backups are not supported for Caching or Valkey clusters. The result will be a JSON object with a backups key. This will be set to an array of backup objects, each of which will contain the size of the backup and the timestamp at which it was created.

Parameters

database_cluster_uuid string required

A unique identifier for a database cluster.

Request Sample

Show Request Sample
import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

get_resp = client.databases.list_backups(database_cluster_uuid="a9a8a77")

Response Example

Show Response Example
{
  "backups": [
    {
      "created_at": "2019-01-11T18:42:27Z",
      "size_gigabytes": 0.03357696,
      "incremental": false
    },
    {
      "created_at": "2019-01-12T18:42:29Z",
      "size_gigabytes": 0.03364864,
      "incremental": true
    }
  ],
  "scheduled_backup_time": {
    "backup_hour": 20,
    "backup_minute": 40,
    "backup_interval_hours": 24
  },
  "backup_progress": "36"
}

More Information

See /v2/databases/{database_cluster_uuid}/backups in the API reference for additional detail on responses, headers, parameters, and more.

In this article...

We can't find any results for your search.

Try using different keywords or simplifying your search terms.

Web Proxy Viewer  |  New URL  |  Original Page