Ver um banco de dados

curl

curl https://app.cubehosting.com.br/api/databases/$DATABASE_ID \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/databases/${process.env.DATABASE_ID}`, { headers });
const { database } = await res.json();
console.log(database.status, database.usage?.memoryMb);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/databases/{os.environ['DATABASE_ID']}", headers=headers, timeout=30)
r.raise_for_status()
print(r.json()["database"]["status"])

{
  "database": {
    "id": "01J9A2C4E6G8J0K2M4P6R8T0V2",
    "name": "loja-db",
    "engine": "postgres",
    "engineName": "PostgreSQL",
    "host": "loja-db",
    "port": 5432,
    "status": "running",
    "memoryMb": 512,
    "usage": {
      "memoryMb": 61
    },
    "disk": {
      "usedMb": 47,
      "limitMb": 2048
    },
    "startedAt": "2026-09-28T12:26:03.000Z",
    "createdAt": "2026-09-28T12:26:00.000Z",
    "updatedAt": "2026-09-28T12:26:01.000Z"
  }
}

GET

databases

{id}

curl

curl https://app.cubehosting.com.br/api/databases/$DATABASE_ID \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/databases/${process.env.DATABASE_ID}`, { headers });
const { database } = await res.json();
console.log(database.status, database.usage?.memoryMb);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/databases/{os.environ['DATABASE_ID']}", headers=headers, timeout=30)
r.raise_for_status()
print(r.json()["database"]["status"])

{
  "database": {
    "id": "01J9A2C4E6G8J0K2M4P6R8T0V2",
    "name": "loja-db",
    "engine": "postgres",
    "engineName": "PostgreSQL",
    "host": "loja-db",
    "port": 5432,
    "status": "running",
    "memoryMb": 512,
    "usage": {
      "memoryMb": 61
    },
    "disk": {
      "usedMb": 47,
      "limitMb": 2048
    },
    "startedAt": "2026-09-28T12:26:03.000Z",
    "createdAt": "2026-09-28T12:26:00.000Z",
    "updatedAt": "2026-09-28T12:26:01.000Z"
  }
}

Use o status para saber se o banco já aceita conexões: starting é o banco que acabou de subir e ainda está preparando os dados; running é pronto. Parado, o usage vem null.

Erros comuns

Código	HTTP	O que fazer
`not_found`	404	Confira o `id` em Listar bancos de dados: o banco não existe ou não é da sua conta.
`invalid_api_key`	401	Confira o cabeçalho `Authorization: Bearer cube_…`.

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Parâmetros de caminho

string

obrigatório

O ID do banco de dados (26 caracteres), de Listar bancos de dados.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Exemplo:

"01J9A2C4E6G8J0K2M4P6R8T0V2"

Resposta

O banco.

database

object

obrigatório

Um banco de dados da conta: PostgreSQL, MySQL, MongoDB ou Redis.

Show child attributes

Visão geral

Projetos

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Avisos

Conta

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns