Obter métricas do banco de dados pelo 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"
}
]
}
Bancos de dados
Obter métricas do banco de dados pelo ID
Retorna as métricas de um banco de dados específico pelo seu ID, das últimas 24 horas.
GET
/
v1
/
databases
/
{id}
/
metrics
Obter métricas do banco de dados pelo 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
obrigatório
O ID do banco de dados do qual obter as métricas. Se o banco de dados pertencer a um workspace, informe o ID dele no parâmetro de query
workspace_id.string
Se o banco de dados pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que atuam sobre um banco de dados que não lhes pertence.
Resposta
array
Um array de objetos de métricas do banco de dados nas últimas 24 horas.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O uso de CPU do container do banco de dados (por exemplo, “0.00%”).
string
O uso de RAM do container do banco de dados em MB (por exemplo, “0.00 MB”).
string
O uso de armazenamento do container do banco de dados em MB (por exemplo, “0.00 MB”).
array
Um array com o tráfego de rede de entrada e de saída em bytes [entrada, saída].
string
A data e hora em que a métrica foi registrada.
{
"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"
}
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: O headerAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: A chave de API é usada a partir de um IP fora da sua lista de IPs permitidos, ou não tem o escopo que a rota exige (403).ACCESS_DENIED: O recurso pertence a outra conta, ou você não tem a permissão de workspace para ele (403).FORBIDDEN: O usuário não tem permissão para acessar o banco de dados.DATABASE_NOT_FOUND: O banco de dados informado não existe.
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
{
"code": "ACCESS_DENIED"
}
{
"code": "DATABASE_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
Última modificação em 28 de outubro de 2026