Obtener el uso de Blob Storage y los límites del plan
curl --request GET \
--url https://blob.vertracloud.app/v1/stats \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/stats"
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": {
"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
}
}
}
Cuenta
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.
GET
/
v1
/
stats
Obtener el uso de Blob Storage y los límites del plan
curl --request GET \
--url https://blob.vertracloud.app/v1/stats \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/stats"
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": {
"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
}
}
}
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.
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
curl "https://blob.vertracloud.app/v1/stats" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
Uso, cuota y límites del plan.
Mostrar propiedades
Mostrar propiedades
number
Número de objetos almacenados.
number
Bytes almacenados ahora.
number
Cuota de blob del plan, en bytes.
number
Bytes por encima de la cuota. Es mayor que 0 solo tras un cambio a un plan inferior.
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.
number
Media de bytes almacenados en el mes actual.
number
Transformaciones de imagen usadas en el mes actual.
string
URL base de los archivos públicos de la cuenta.
number
Archivo más grande aceptado por
POST /v1/objects. 100 MB en todos los planes.number
Archivo más grande que se puede enviar en una sola parte de una subida directa.
number
Objeto único más grande: 10 GB.
number
Tamaño mínimo permitido por parte en las subidas multiparte.
number
Tamaño máximo permitido por parte en las subidas multiparte.
number
Número máximo de partes que puede tener una subida multiparte.
number
Cuántas subidas directas pueden estar en curso a la vez en el plan.
number | null
Subidas permitidas por segundo.
null significa que no tiene límite propio (Enterprise-12 o superior); por debajo, 1 por segundo.number
Reglas de carpeta permitidas: 5, 10 o 20, según el plan.
number
Dominios personalizados permitidos: 0, 1, 3 o 10, según el plan.
boolean
Si se puede definir
metadata (Enterprise-12 o superior).boolean
Si los enlaces para compartir pueden tener contraseña (Enterprise-12 o superior).
boolean
Si se permite
cache_control: "no-cache" (Enterprise-26 o superior).number
El
expires_at más corto aceptado, contado desde ahora: 7 días, o 1 hora en Enterprise-26 o superior.number
Transformaciones de imagen incluidas al mes.
0 en Economy y Pro.{
"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
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING(401): No se envió la cabeceraAuthorization.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:readoblob:write);details.requiredlo indica.WORKSPACE_PERMISSION_DENIED(403): Solo conworkspace_id: no eres miembro, o tu rol no tiene el permiso de blob.WORKSPACE_NOT_FOUND(404): Solo conworkspace_id: no existe un workspace con ese ID, o no eres miembro.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026