Blob-SDK: Freigabelinks

Eine Freigabe ist ein Link zu einem Objekt, der ablaufen, widerrufen werden, die Anzahl der Downloads begrenzen und bei Pro und Enterprise ein Passwort abfragen kann. Wie sich die Links verhalten, erfährst du unter Links und Freigabe. Die Beispiele verwenden den Client blob aus Client erstellen.

Freigabe oder `downloadUrl()`?

	`downloadUrl()`	`shares.create()`
Öffentliches Objekt	Dauerhafte CDN-URL (`expires_at: null`)	Leitet auf die dauerhafte öffentliche URL weiter (siehe die Warnung unten)
Privates Objekt	Temporärer Link, bis zu 24 Stunden	Freigabelink, bis zu 30 Tage
Widerrufbar	Nein	Ja, mit `shares.revoke()`
Download-Limit	Nein	Ja, `max_downloads`
Passwort	Nein	Ja, Pro und Enterprise

Verwende downloadUrl() für kurzlebige Links, die du selbst weitergibst, und eine Freigabe, wenn du den Link zurücknehmen oder kontrollieren musst, wer herunterlädt.

Eine Freigabe erstellen

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);

Option	Typ	Beschreibung
`expires_in`	`number`	Lebensdauer des Links in Sekunden, 60 bis 2592000 (30 Tage). Standard 86400.
`max_downloads`	`number`	1 bis 10000.
`password`	`string`	8 bis 128 Zeichen. Pro und Enterprise; andere Pläne erhalten `UPGRADE_REQUIRED`.

Das Ergebnis hat id, url, expires_at, max_downloads, password (ob eines gesetzt ist), object und object_is_public.

Ist object_is_public gleich true, leitet der Freigabelink auf die dauerhafte öffentliche URL des Objekts weiter: Passwort, Download-Limit und Ablauf schützen nichts, weil die Datei unter dieser URL erreichbar bleibt. Mache das Objekt zuerst privat und gib es dann frei:

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 });
}

Freigaben auflisten

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

Gibt ein Array von Freigaben zurück, jede mit id, url, object, expires_at, remaining_downloads, password und created_at.

Eine Freigabe widerrufen

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

Der Link funktioniert nicht mehr. revoke() wird ohne Wert aufgelöst, und das Widerrufen einer Freigabe, die nicht existiert, schlägt mit SHARE_NOT_FOUND fehl.

Das Löschen, Verschieben oder Umbenennen des Objekts oder eine Änderung seiner Sichtbarkeit macht seine Freigabelinks ebenfalls ungültig: Sie verweisen auf die alte ID. Erstelle neue Freigaben für die neue ID.

shares.create() und shares.revoke() erhalten einen einzigen Versuch. Nur shares.list(), ein Lesevorgang, wird wiederholt.

API-Referenz: Create Share, List Shares, Delete Share.

Nächste Schritte

Regeln und Statistiken

Regeln pro Präfix und Nutzungsstatistiken.

Links und Freigaben

Wie sich öffentliche URLs, Download-Links und Freigaben verhalten.

CLI

VS Code

SDKs

Blob-SDK: Freigabelinks

Freigabe oder `downloadUrl()`?

Eine Freigabe erstellen

Freigaben auflisten

Eine Freigabe widerrufen

Nächste Schritte

Regeln und Statistiken

Links und Freigaben

​Freigabe oder downloadUrl()?

​Eine Freigabe erstellen

​Freigaben auflisten

​Eine Freigabe widerrufen

​Nächste Schritte

Regeln und Statistiken

Links und Freigaben

Freigabe oder `downloadUrl()`?

Eine Freigabe erstellen

Freigaben auflisten

Eine Freigabe widerrufen

Nächste Schritte