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.update_do_settings(
    database_cluster_uuid="9cc10173-e9ea-4176-9dbc-a4cee4c4ff30",
    body={
        "do_settings": {...},
    },
)

Description

To update the DigitalOcean-specific settings for a database cluster, send a PUT request to /v2/databases/{database_cluster_uuid}/do_settings. Currently, the only supported setting is service_cnames, which allows you to specify custom DNS names (CNAMEs) to be included in the TLS certificate Subject Alternative Names (SANs) for the database cluster nodes. This enables TLS verification when connecting via a custom hostname. After updating, the database nodes will be replaced to apply the new certificate. This process is performed as a rolling replacement and does not cause downtime. To clear all custom CNAMEs, send an empty array or omit the field.

Parameters

database_cluster_uuid string required

A unique identifier for a database cluster.

do_settings object required

DigitalOcean-specific settings for the database cluster.

Show child properties

service_cnames array of strings optional

Example: ['db.example.com', 'database.myapp.io']

An array of custom CNAMEs for the database cluster. Each CNAME must be a valid RFC 1123 hostname (e.g., "db.example.com"). Maximum of 16 CNAMEs allowed, each up to 253 characters.

Request Sample

import os
from pydo import Client

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

req = {
    "do_settings": {
        "service_cnames": ["db.example.com", "db-replica.example.com"]
    }
}

resp = client.databases.update_do_settings(
    database_cluster_uuid="9cc10173-e9ea-4176-9dbc-a4cee4c4ff30",
    body=req
)

More Information

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