pydo.databases.promote_replica()
Generated on 25 November 2024
from pydo version v0.6.0
Description
To promote a specific read-only replica, send a PUT request to /v2/databases/$DATABASE_ID/replicas/$REPLICA_NAME/promote.
Note: Read-only replicas are not supported for Redis clusters.
A status of 204 will be given. This indicates that the request was processed successfully, but that no response body is needed.
Parameters
| Name |
Type |
Required |
Description |
Default Value |
database_cluster_uuid |
string |
True |
A unique identifier for a database cluster. |
|
replica_name |
string |
True |
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")
Responses
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.
The action was successful and the response body is empty.
Unauthorized
Click to expand an example response.
{
"id": "unauthorized",
"message": "Unable to authenticate you."
}
The resource was not found.
Click to expand an example response.
{
"id": "not_found",
"message": "The resource you requested could not be found."
}
API Rate limit exceeded
Click to expand an example response.
{
"id": "too_many_requests",
"message": "API Rate limit exceeded."
}
Server error.
Click to expand an example response.
{
"id": "server_error",
"message": "Unexpected server-side error"
}
Unexpected error
Click to expand an example response.
{
"id": "example_error",
"message": "some error message"
}