Obtener el estado de una base de datos por ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}/status', 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}/status"
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}/status"
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": "db-abc123def456",
"cpu": "12.30%",
"ram": "256.00 MB",
"storage": "512.00 MB",
"status": "running",
"running": true,
"network": {
"total": "320.15KB ↓ 20.10KB ↑",
"now": "5.00KB ↑ 1.00KB ↓"
},
"uptime": 7200,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-11T15:06:41.449Z"
}
}
Bases de datos
Obtener el estado de una base de datos por ID
Obtiene el estado actual y el uso de recursos de una base de datos a partir de su ID.
GET
/
v1
/
databases
/
{id}
/
status
Obtener el estado de una base de datos por ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}/status', 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}/status"
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}/status"
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": "db-abc123def456",
"cpu": "12.30%",
"ram": "256.00 MB",
"storage": "512.00 MB",
"status": "running",
"running": true,
"network": {
"total": "320.15KB ↓ 20.10KB ↑",
"now": "5.00KB ↑ 1.00KB ↓"
},
"uptime": 7200,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-11T15:06:41.449Z"
}
}
string
requerido
El ID de la base de datos cuyo estado 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.
Una base de datos detenida responde
200, no un error. El contenedor de una base de datos detenida no existe (se elimina al detenerla), y eso es un estado normal, no un fallo. La API devuelve 200 con status: "stopped", running: false y todas las métricas a cero. Solo una lectura del estado que realmente falla devuelve 500.Respuesta
object
Los detalles del estado y del uso de recursos de la base de datos.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID de la base de datos.
string
Porcentaje de uso de CPU, ya formateado (por ejemplo,
12.30%).string
Uso de RAM, ya formateado (por ejemplo,
256.00 MB).string
Uso de almacenamiento, ya formateado (por ejemplo,
512.00 MB).string
El estado de la base de datos:
running o stopped.boolean
Indica si la base de datos está en ejecución en este momento.
object
number
El tiempo de actividad de la base de datos en segundos.
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.
{
"response": {
"id": "db-abc123def456",
"cpu": "12.30%",
"ram": "256.00 MB",
"storage": "512.00 MB",
"status": "running",
"running": true,
"network": {
"total": "320.15KB ↓ 20.10KB ↑",
"now": "5.00KB ↑ 1.00KB ↓"
},
"uptime": 7200,
"created_at": "2026-03-09T15:51:47.234Z",
"updated_at": "2026-03-11T15:06:41.449Z"
}
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
DATABASE_NOT_FOUND: La base de datos indicada no existe.FORBIDDEN: El usuario no tiene permiso para acceder a la base de datos.INTERNAL_SERVER_ERROR: No se pudo leer el estado. Una base de datos detenida no es este caso; consulta la nota de arriba.
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "DATABASE_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
{
"code": "INTERNAL_SERVER_ERROR"
}
Última modificación el 28 de octubre de 2026