> ## 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 uso de Blob Storage y los límites del plan

> Devuelve el almacenamiento usado, la cuota del plan, la media mensual, las transformaciones de imagen usadas y los límites del plan.

Devuelve cuánto almacenamiento de blob usa la cuenta, su cuota, el exceso si lo hay, y los `limits` del plan actual. Lee
los límites desde aquí en lugar de escribirlos en tu código: cambian con el plan. Los valores del ejemplo son ilustrativos.

**Ámbito:** `blob:read`.

**workspace\_id** `string`

El ID del workspace, cuando el blob pertenece a un workspace. La petición actúa sobre el blob del propietario del
workspace y necesita el permiso `blob:read` del workspace (`blob:manage` en las rutas que modifican datos). Omítelo
para actuar sobre tu propio blob.

### Ejemplo de petición

```bash theme={null}
curl "https://blob.vertracloud.app/v1/stats" \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Respuesta

**response** `object`

Uso, cuota y límites del plan.

**propiedades**

**objects** `number`

Número de objetos almacenados.

**used\_bytes** `number`

Bytes almacenados ahora.

**quota\_bytes** `number`

Cuota de blob del plan, en bytes.

**over\_quota\_bytes** `number`

Bytes por encima de la cuota. Es mayor que 0 solo tras un cambio a un plan inferior.

**estimated\_overage\_cents** `number`

Cargo estimado por los bytes por encima de la cuota, en céntimos, que se factura en la renovación: R\$0,20 por cada GB iniciado.

**month\_average\_bytes** `number`

Media de bytes almacenados en el mes actual.

**image\_transformations\_used** `number`

Transformaciones de imagen usadas en el mes actual.

**public\_base\_url** `string`

URL base de los archivos públicos de la cuenta.

**limits.max\_simple\_upload\_bytes** `number`

Archivo más grande aceptado por `POST /v1/objects`. 100 MB en todos los planes.

**limits.max\_single\_put\_bytes** `number`

Archivo más grande que se puede enviar en una sola parte de una subida directa.

**limits.max\_object\_bytes** `number`

Objeto único más grande: 10 GB.

**limits.min\_part\_bytes** `number`

Tamaño mínimo permitido por parte en las subidas multiparte.

**limits.max\_part\_bytes** `number`

Tamaño máximo permitido por parte en las subidas multiparte.

**limits.max\_parts** `number`

Número máximo de partes que puede tener una subida multiparte.

**limits.max\_open\_uploads** `number`

Cuántas subidas directas pueden estar en curso a la vez en el plan.

**limits.uploads\_per\_second** `number | null`

Subidas permitidas por segundo. `null` significa que no tiene límite propio (Enterprise-12 o superior); por debajo, 1 por segundo.

**limits.max\_rules** `number`

Reglas de carpeta permitidas: 5, 10 o 20, según el plan.

**limits.max\_custom\_domains** `number`

Dominios personalizados permitidos: 0, 1, 3 o 10, según el plan.

**limits.metadata\_enabled** `boolean`

Si se puede definir `metadata` (Enterprise-12 o superior).

**limits.share\_password\_enabled** `boolean`

Si los enlaces para compartir pueden tener contraseña (Enterprise-12 o superior).

**limits.no\_cache\_enabled** `boolean`

Si se permite `cache_control: "no-cache"` (Enterprise-26 o superior).

**limits.min\_expiration\_seconds** `number`

El `expires_at` más corto aceptado, contado desde ahora: 7 días, o 1 hora en Enterprise-26 o superior.

**limits.image\_transformations\_per\_month** `number`

Transformaciones de imagen incluidas al mes. `0` en Economy y Pro.

```json Response theme={null}
{
  "response": {
    "objects": 42,
    "used_bytes": 2147483648,
    "quota_bytes": 16106127360,
    "over_quota_bytes": 0,
    "estimated_overage_cents": 0,
    "month_average_bytes": 1932735283,
    "image_transformations_used": 120,
    "public_base_url": "https://blob.vertracloud.dev/k7p2m9x4qa",
    "limits": {
      "max_simple_upload_bytes": 104857600,
      "max_single_put_bytes": 104857600,
      "max_object_bytes": 10737418240,
      "min_part_bytes": 5242880,
      "max_part_bytes": 5368709120,
      "max_parts": 10000,
      "max_open_uploads": 4,
      "uploads_per_second": null,
      "max_rules": 10,
      "max_custom_domains": 3,
      "metadata_enabled": true,
      "share_password_enabled": true,
      "no_cache_enabled": false,
      "min_expiration_seconds": 604800,
      "image_transformations_per_month": 4000
    }
  }
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING` (`401`): No se envió la cabecera `Authorization`.
* `API_KEY_INVALID` (`401`): La clave de API no existe, fue revocada o su secreto no coincide.
* `API_KEY_SCOPE_DENIED` (`403`): La clave no tiene el ámbito que necesita esta ruta (`blob:read` o `blob:write`); `details.required` lo indica.
* `WORKSPACE_PERMISSION_DENIED` (`403`): Solo con `workspace_id`: no eres miembro, o tu rol no tiene el permiso de blob.
* `WORKSPACE_NOT_FOUND` (`404`): Solo con `workspace_id`: no existe un workspace con ese ID, o no eres miembro.

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

```json Error Response (403) theme={null}
{
  "code": "API_KEY_SCOPE_DENIED"
}
```

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


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