Regole e statistiche

Regole

Le regole impostano valori predefiniti e limiti per ogni oggetto sotto un prefisso: visibilità, scadenza, dimensione massima, estensioni consentite, cache ed eliminazione automatica. Si applicano a ogni upload sotto il prefisso, che provenga dall’SDK, da un token di upload o dalla dashboard. Vedi Update Settings per i limiti dei piani e la corrispondenza dei prefissi.

`rules.get()`

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

Restituisce le regole salvate come array. Ogni regola ha i campi riportati sotto più created_at, e active_from quando ha delete_after_days.

active_from è opzionale: l’API lo invia solo per le regole con delete_after_days. In TypeScript, gestisci il caso in cui sia 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() sostituisce l’intero elenco. Invia ogni regola che vuoi mantenere; rules.set([]) le rimuove tutte. Per aggiungere una regola, leggi prima l’elenco:

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

Restituisce l’elenco salvato, come rules.get().

Campo	Tipo	Descrizione
`prefix`	`string`	Obbligatorio. Il prefisso a cui si applica la regola, ad es. `"a/b/"`.
`private`	`boolean`	Visibilità predefinita.
`expire`	`string`	Scadenza predefinita (`"30d"`, `"168h"`, …).
`max_size`	`number`	Dimensione massima del file in byte, da 512 B a 10 GiB.
`extensions`	`string[]`	Da 1 a 50 estensioni consentite, conformi a `^[a-z0-9]{1,16}(\.[a-z0-9]{1,16})?$`.
`cache_control`	`string`	`Cache-Control` predefinito.
`delete_after_days`	`number`	Elimina gli oggetti questo numero di giorni dopo la loro scrittura, da 7 a 3650 (Enterprise da 1).

delete_after_days ha effetto solo 24 ore dopo il salvataggio della regola (vedi active_from). Una volta attiva, gli oggetti eliminati non possono essere recuperati.

Quando una regola viene rifiutata, l’extra dell’errore riporta il prefix responsabile:

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() è una lettura e viene ritentato. rules.set() ha un solo tentativo.

Statistiche

const stats = await blob.stats();

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

Campo	Descrizione
`usage.objects`	Numero di oggetti.
`usage.storage`	Storage utilizzato, in byte.
`plan.included`	Storage incluso nel tuo piano, in byte.
`billing`	`extraStorage`, `storagePrice`, `objectsPrice`, `totalEstimate`.
`month`	`days` e `average_storage` per il mese corrente.

Le statistiche sono una stima, memorizzata in cache dal server per 60 secondi. billing è solo una stima dello storage oltre il tuo piano, non una fattura.

Vedi Account Stats.

Servizi

Runtimes

Piattaforma

Risoluzione dei problemi

CLI

SDKs

Changelog

Regole

`rules.get()`

`rules.set(rules)`

Statistiche

​Regole

​rules.get()

​rules.set(rules)

​Statistiche

Regole

`rules.get()`

`rules.set(rules)`

Statistiche