> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

**id** `string` *required*

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`.

**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.

> [!NOTE]
>
> **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

**response** `object`

Los detalles del estado y del uso de recursos de la base de datos.

**Mostrar objeto**

**id** `string`

El ID de la base de datos.

**cpu** `string`

Porcentaje de uso de CPU, ya formateado (por ejemplo, `12.30%`).

**ram** `string`

Uso de RAM, ya formateado (por ejemplo, `256.00 MB`).

**storage** `string`

Uso de almacenamiento, ya formateado (por ejemplo, `512.00 MB`).

**status** `string`

El estado de la base de datos: `running` o `stopped`.

**running** `boolean`

Indica si la base de datos está en ejecución en este momento.

**network** `object`

Detalles del uso de red.

**Mostrar objeto**

**total** `string`

Tráfico de red total desde que se inició el contenedor, de entrada y de salida en una sola cadena.

**now** `string`

Tráfico de red actual, de entrada y de salida en una sola cadena.

**uptime** `number`

El tiempo de actividad de la base de datos en segundos.

**created\_at** `string`

La marca de tiempo en que se creó la base de datos.

**updated\_at** `string`

La marca de tiempo de la última actualización de la base de datos.

```json Response theme={null}
{
  "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

**code** `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.

**message** `string`

Un mensaje descriptivo con más detalles sobre el error.

```json Error Response (404) theme={null}
{
  "code": "DATABASE_NOT_FOUND"
}
```

```json Error Response (401) theme={null}
{
  "code": "FORBIDDEN"
}
```

```json Error Response (500) theme={null}
{
  "code": "INTERNAL_SERVER_ERROR"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.