Reglas y estadísticas

Reglas

Las reglas definen valores por defecto y límites para todos los objetos bajo un prefijo: visibilidad, expiración, tamaño máximo, extensiones permitidas, caché y eliminación automática. Se aplican a todas las subidas bajo el prefijo, tanto si vienen del SDK como de un token de subida o del panel. Consulta Update Settings para ver los límites de cada plan y cómo se emparejan los prefijos.

`rules.get()`

const rules = await blob.rules.get();

Devuelve las reglas guardadas como un array. Cada regla tiene los campos de abajo más created_at, y active_from cuando tiene delete_after_days.

active_from es opcional: la API solo lo envía en las reglas con delete_after_days. En TypeScript, ten en cuenta que puede ser undefined.

`rules.set(rules)`

await blob.rules.set([
    { prefix: "tmp/", delete_after_days: 7 },
    { prefix: "avatars/", max_size: 5 * 1024 * 1024, extensions: ["png", "jpg"] },
]);

rules.set() reemplaza toda la lista. Envía todas las reglas que quieras conservar; rules.set([]) las elimina todas. Para añadir una regla, lee primero la lista:

const current = await blob.rules.get();
await blob.rules.set([
    ...current.map(({ created_at, active_from, ...rule }) => rule),
    { prefix: "exports/", expire: "30d" },
]);

Devuelve la lista guardada, igual que rules.get().

Campo	Tipo	Descripción
`prefix`	`string`	Obligatorio. El prefijo al que se aplica la regla, p. ej. `"a/b/"`.
`private`	`boolean`	Visibilidad por defecto.
`expire`	`string`	Expiración por defecto (`"30d"`, `"168h"`, …).
`max_size`	`number`	Tamaño máximo del archivo en bytes, de 512 B a 10 GiB.
`extensions`	`string[]`	De 1 a 50 extensiones permitidas, que cumplan `^[a-z0-9]{1,16}(\.[a-z0-9]{1,16})?$`.
`cache_control`	`string`	`Cache-Control` por defecto.
`delete_after_days`	`number`	Elimina los objetos este número de días después de escribirse, de 7 a 3650 (Enterprise desde 1).

delete_after_days solo surte efecto 24 horas después de guardar la regla (consulta active_from). Una vez activa, los objetos eliminados no se pueden recuperar.

Cuando se rechaza una regla, el extra del error contiene el prefix problemático:

import { SquareCloudBlobError } from "@squarecloud/blob";

try {
    await blob.rules.set(rules);
} catch (error) {
    if (error instanceof SquareCloudBlobError) {
        console.error(error.code, error.extra.prefix);
    }
}

rules.get() es una lectura y se reintenta. rules.set() tiene un único intento.

Estadísticas

const stats = await blob.stats();

console.log(stats.usage.objects); // total objects
console.log(stats.usage.storage); // storage used, in bytes

Campo	Descripción
`usage.objects`	Número de objetos.
`usage.storage`	Almacenamiento usado, en bytes.
`plan.included`	Almacenamiento incluido en tu plan, en bytes.
`billing`	`extraStorage`, `storagePrice`, `objectsPrice`, `totalEstimate`.
`month`	`days` y `average_storage` del mes en curso.

Las estadísticas son una estimación, que el servidor almacena en caché durante 60 segundos. billing es solo una estimación del almacenamiento por encima de tu plan, no una factura.

Consulta Account Stats.

Servicios

Runtimes

Plataforma

Solución de problemas

CLI

SDKs

Changelog

Reglas

`rules.get()`

`rules.set(rules)`

Estadísticas

​Reglas

​rules.get()

​rules.set(rules)

​Estadísticas

Reglas

`rules.get()`

`rules.set(rules)`

Estadísticas