---
title: pydo.databases.update_do_settings()
description: Update DO Settings for a Database Cluster
product: Reference
url: https://docs.digitalocean.com/reference/pydo/reference/databases/update_do_settings/
last_updated: "2026-08-03"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](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.update_do_settings()

Generated on 3 Aug 2026 from `pydo` version [`v0.40.0`](https://github.com/digitalocean/pydo/releases/tag/v0.40.0v0.40.0)

## Usage

```python
client.databases.update_do_settings(
    database_cluster_uuid="9cc10173-e9ea-4176-9dbc-a4cee4c4ff30",
    body={
        "do_settings": {...},
    },
)
```

Returns `None`Raises `HttpResponseError`

## Description

To update the DigitalOcean-specific settings for a database cluster, send a PUT request to [`/v2/databases/{database_cluster_uuid}/do_settings`](https://docs.digitalocean.com/reference/api/reference/databases/index.html.md#databases_update_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

## Show Request Sample

```python
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`](https://docs.digitalocean.com/reference/api/reference/databases/index.html.md#databases_update_do_settings) in the API reference for additional detail on responses, headers, parameters, and more.