Obtener una base de datos por ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/databases/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"id": "00000000000000000000000000000001",
"cluster": 1,
"type": 3,
"name": "MyDatabase",
"description": "I have a description :)",
"owner_id": "123456789012345678",
"owner_plan": "pro",
"status": "up",
"ram": 256,
"host": "database.example.com",
"port": 6379,
"username": "vertracloud",
"version": "8.2",
"offline_since": null,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T19:58:00Z"
}
}
Bases de datos
Obtener una base de datos por ID
Obtiene los detalles de una base de datos concreta a partir de su ID.
GET
/
v1
/
databases
/
{id}
Obtener una base de datos por ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/databases/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/databases/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"id": "00000000000000000000000000000001",
"cluster": 1,
"type": 3,
"name": "MyDatabase",
"description": "I have a description :)",
"owner_id": "123456789012345678",
"owner_plan": "pro",
"status": "up",
"ram": 256,
"host": "database.example.com",
"port": 6379,
"username": "vertracloud",
"version": "8.2",
"offline_since": null,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T19:58:00Z"
}
}
string
requerido
El ID de la base de datos que se va a obtener. Si la base de datos pertenece a un workspace, pasa su ID en el parámetro de consulta
workspace_id.string
Si la base de datos pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúan sobre una base de datos que no les pertenece.
Respuesta
object
Los detalles de la base de datos.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la base de datos.
number
El ID del clúster de la base de datos.
number
El tipo de la base de datos.
string
El nombre de la base de datos.
string
La descripción de la base de datos.
string
El ID del propietario de la base de datos.
string | null
El nombre del plan del propietario (por ejemplo,
pro o enterprise-8), o null cuando el propietario no tiene plan.string
El estado de la base de datos (por ejemplo,
up).number
La RAM asignada a la base de datos, en MB.
string
La dirección del host de la base de datos.
number
El puerto que usa la base de datos.
string
El usuario con el que conectarse. Las bases de datos creadas desde la v26.4.8 usan
vertracloud (base de datos por defecto vertracloud, sin ser superusuario); las bases de datos anteriores conservan el usuario del motor (postgres, default o root).string
La versión mayor del motor, por ejemplo
"18" u "8.0". Las actualizaciones de seguridad se aplican al reiniciar sin cambiarla.string | null
El ID del stack al que pertenece la base de datos, o
null si no forma parte de ninguno.string | null
El ID del servicio de plantilla que corresponde a esta base de datos dentro del stack, o
null si la añadiste tú.string
La marca de tiempo en que se creó la base de datos.
string
La marca de tiempo de la última actualización de la base de datos.
string | null
La marca de tiempo desde la que la base de datos está fuera de línea, si procede.
string | null
La marca de tiempo del último snapshot, si está disponible.
{
"response": {
"id": "00000000000000000000000000000001",
"cluster": 1,
"type": 3,
"name": "MyDatabase",
"description": "I have a description :)",
"owner_id": "123456789012345678",
"owner_plan": "pro",
"status": "up",
"ram": 256,
"host": "database.example.com",
"port": 6379,
"username": "vertracloud",
"version": "8.2",
"offline_since": null,
"last_snapshot": "2026-03-14T19:58:00Z",
"created_at": "2026-03-14T19:58:00Z",
"updated_at": "2026-03-14T19:58:00Z"
}
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, la clave de API no es válida o la sesión del panel fue revocada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP que no está en su lista de permitidas, o no tiene el ámbito que requiere la ruta (403).ACCESS_DENIED: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (403).DATABASE_NOT_FOUND: La base de datos indicada no existe o el usuario no tiene acceso.
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "ACCESS_DENIED"
}
{
"code": "DATABASE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026