SDK Blob: link di condivisione

Una condivisione è un link a un oggetto che può scadere, essere revocato, limitare il numero di download e, nei piani Pro ed Enterprise, richiedere una password. Vedi Link e condivisione per il funzionamento dei link. Gli esempi usano il client blob di Creare il client.

Condivisione o `downloadUrl()`?

	`downloadUrl()`	`shares.create()`
Oggetto pubblico	URL CDN permanente (`expires_at: null`)	Reindirizza all’URL pubblico permanente (vedi l’avviso più sotto)
Oggetto privato	Link temporaneo, fino a 24 ore	Link di condivisione, fino a 30 giorni
Revocabile	No	Sì, con `shares.revoke()`
Limite di download	No	Sì, `max_downloads`
Password	No	Sì, Pro ed Enterprise

Usa downloadUrl() per link a breve durata che distribuisci tu stesso, e una condivisione quando devi poter ritirare il link o controllare chi lo scarica.

Creare una condivisione

const share = await blob.shares.create(id, {
    expires_in: 86400,     // seconds, 60 to 2592000 (default 86400)
    max_downloads: 10,     // 1 to 10000
    password: "secret123", // 8 to 128 characters, Pro and Enterprise
});

console.log(share.url);

Opzione	Tipo	Descrizione
`expires_in`	`number`	Durata del link in secondi, da 60 a 2592000 (30 giorni). Predefinito 86400.
`max_downloads`	`number`	Da 1 a 10000.
`password`	`string`	Da 8 a 128 caratteri. Pro ed Enterprise; gli altri piani ricevono `UPGRADE_REQUIRED`.

Il risultato ha id, url, expires_at, max_downloads, password (se ne è impostata una), object e object_is_public.

Se object_is_public è true, il link di condivisione reindirizza all’URL pubblico permanente dell’oggetto: password, limite di download e scadenza non proteggono nulla, perché il file resta raggiungibile a quell’URL. Rendi prima privato l’oggetto, poi condividilo:

const [result] = await blob.update(id, { private: true });
if (result.ok) {
    id = result.id; // the id changes
    const share = await blob.shares.create(id, { max_downloads: 1 });
}

Elencare le condivisioni

const shares = await blob.shares.list();

Restituisce un array di condivisioni, ciascuna con id, url, object, expires_at, remaining_downloads, password e created_at.

Revocare una condivisione

await blob.shares.revoke(share.id);

Il link smette di funzionare. revoke() non restituisce nulla, e revocare una condivisione che non esiste fallisce con SHARE_NOT_FOUND.

Eliminare, spostare o rinominare l’oggetto, oppure cambiarne la visibilità, interrompe anche i suoi link di condivisione: puntano al vecchio id. Crea nuove condivisioni per il nuovo id.

shares.create() e shares.revoke() hanno un solo tentativo. Solo shares.list(), una lettura, viene ritentato.

Riferimento API: Create Share, List Shares, Delete Share.

Prossimi passi

Regole e statistiche

Regole per prefisso e statistiche di utilizzo.

Link e condivisione

Come si comportano URL pubblici, link di download e condivisioni.

CLI

VS Code

SDKs

SDK Blob: link di condivisione

Condivisione o `downloadUrl()`?

Creare una condivisione

Elencare le condivisioni

Revocare una condivisione

Prossimi passi

Regole e statistiche

Link e condivisione

​Condivisione o downloadUrl()?

​Creare una condivisione

​Elencare le condivisioni

​Revocare una condivisione

​Prossimi passi

Regole e statistiche

Link e condivisione

Condivisione o `downloadUrl()`?

Creare una condivisione

Elencare le condivisioni

Revocare una condivisione

Prossimi passi