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.promote_replica(
    database_cluster_uuid="9cc10173-e9ea-4176-9dbc-a4cee4c4ff30",
    replica_name="read-nyc3-01",
)

Description

To promote a specific read-only replica, send a PUT request to /v2/databases/{database_cluster_uuid}/replicas/{replica_name}/promote.

Note: Read-only replicas are not supported for Caching or Valkey clusters.

A status of 204 will be given. This indicates that the request was processed successfully, but that no response body is needed.

Parameters

database_cluster_uuid string required

A unique identifier for a database cluster.

replica_name string required

The name of the database replica.

Request Sample

import os
from pydo import Client

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

resp = client.databases.promote_replica(database_cluster_uuid="a7a8bas", replica_name="ba8ab22")

More Information

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