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).

Usage

client.databases.add(
    database_cluster_uuid="9cc10173-e9ea-4176-9dbc-a4cee4c4ff30",
    body={
        "name": "alpha",
    },
)

Description

To add a new database to an existing cluster, send a POST request to /v2/databases/{database_cluster_uuid}/dbs.

Note: Database management is not supported for Caching or Valkey clusters.

The response will be a JSON object with a key called db. The value of this will be an object that contains the standard attributes associated with a database.

Parameters

database_cluster_uuid string required

A unique identifier for a database cluster.

name string required

Example: alpha

The name of the database.

Request Sample

import os
from pydo import Client

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

add_resp = client.databases.add(database_cluster_uuid="9cc10173", body={"name": "alpha"})

Response Example

{
  "db": {
    "name": "alpha"
  }
}

More Information

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