Obtener las métricas de una base de datos por ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}/metrics \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}/metrics', 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}/metrics"
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}/metrics"
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": [
{
"cpu": "0.50%",
"ram": "128.00 MB",
"storage": "256.00 MB",
"network": [1024, 2048],
"date": "2026-03-14T19:58:00Z"
},
{
"cpu": "0.75%",
"ram": "130.00 MB",
"storage": "256.00 MB",
"network": [2048, 4096],
"date": "2026-03-14T20:00:00Z"
}
]
}
Bases de datos
Obtener las métricas de una base de datos por ID
Obtiene las métricas de una base de datos concreta a partir de su ID durante las últimas 24 horas.
GET
/
v1
/
databases
/
{id}
/
metrics
Obtener las métricas de una base de datos por ID
curl --request GET \
--url https://api.vertracloud.app/v1/databases/{id}/metrics \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/databases/{id}/metrics', 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}/metrics"
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}/metrics"
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": [
{
"cpu": "0.50%",
"ram": "128.00 MB",
"storage": "256.00 MB",
"network": [1024, 2048],
"date": "2026-03-14T19:58:00Z"
},
{
"cpu": "0.75%",
"ram": "130.00 MB",
"storage": "256.00 MB",
"network": [2048, 4096],
"date": "2026-03-14T20:00:00Z"
}
]
}
string
requerido
El ID de la base de datos cuyas métricas se van 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
array
Un array de objetos de métricas de la base de datos durante las últimas 24 horas.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El uso de CPU del contenedor de la base de datos (por ejemplo, “0.00%”).
string
El uso de RAM del contenedor de la base de datos en MB (por ejemplo, “0.00 MB”).
string
El uso de almacenamiento del contenedor de la base de datos en MB (por ejemplo, “0.00 MB”).
array
Un array con el tráfico de red de entrada y de salida en bytes [entrada, salida].
string
La marca de tiempo en que se registró la métrica.
{
"response": [
{
"cpu": "0.50%",
"ram": "128.00 MB",
"storage": "256.00 MB",
"network": [1024, 2048],
"date": "2026-03-14T19:58:00Z"
},
{
"cpu": "0.75%",
"ram": "130.00 MB",
"storage": "256.00 MB",
"network": [2048, 4096],
"date": "2026-03-14T20:00: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).FORBIDDEN: El usuario no tiene permiso para acceder a la base de datos.DATABASE_NOT_FOUND: La base de datos indicada no existe.
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "ACCESS_DENIED"
}
{
"code": "DATABASE_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
Última modificación el 28 de octubre de 2026