Inicio rápido de Blob Storage: sube y sirve tu primer archivo

En cinco minutos subirás un archivo, lo harás público, crearás un enlace temporal y lo borrarás.

Crea una clave de API

En el panel, abre Configuraciones → Claves de API y crea una clave con el scope blob:write (también puede leer tus archivos con blob:read, que incluye el preset full). Guárdala en una variable de entorno:

export VERTRA_API_KEY="your_key"

Sube un archivo

La subida simple necesita una sola petición para archivos de hasta 100 MB. Los archivos son privados salvo que pidas public.

curl -X POST "https://blob.vertracloud.app/v1/objects?path=images/logo.png&visibility=public" \
  -H "Authorization: Bearer $VERTRA_API_KEY" \
  -F "file=@./logo.png"

import { BlobClient } from "@vertracloud/blob";

const blob = new BlobClient({ apiKey: process.env.VERTRA_API_KEY });
const obj = await blob.put("images/logo.png", file, { visibility: "public" });
console.log(obj.url);

obj = client.blob.put("images/logo.png", open("logo.png", "rb"), visibility="public")
print(obj["url"])

f, err := os.Open("logo.png")
if err != nil {
    log.Fatal(err)
}
defer f.Close()
info, _ := f.Stat()

obj, err := client.Blob.Put(ctx, "images/logo.png", f, info.Size(),
    &vertracloud.BlobPutOptions{Visibility: "public"})
if err != nil {
    log.Fatal(err)
}
fmt.Println(*obj.URL)

La respuesta es el objeto del archivo: su id, size, content_type y, para los archivos públicos, la url.

Lista tus archivos

curl "https://blob.vertracloud.app/v1/objects?prefix=images/&delimiter=/" \
  -H "Authorization: Bearer $VERTRA_API_KEY"

for await (const obj of blob.list({ prefix: "images/" })) {
  console.log(obj.path, obj.size);
}

for obj in client.blob.list(prefix="images/"):
    print(obj["path"], obj["size"])

it := client.Blob.List(ctx, &vertracloud.BlobListOptions{Prefix: "images/"})
for it.Next(ctx) {
    o := it.Object()
    fmt.Println(o.Path, o.Size)
}
if err := it.Err(); err != nil {
    log.Fatal(err)
}

Abre la URL pública

Un archivo público vive en https://blob.vertracloud.dev/<namespace>/images/logo.png; el campo url del objeto ya la contiene. Ábrela en un navegador o úsala en una etiqueta <img>.

Crea un enlace temporal para un archivo privado

curl "https://blob.vertracloud.app/v1/objects/$OBJECT_ID/download?expires_in=600&redirect=false" \
  -H "Authorization: Bearer $VERTRA_API_KEY"

const { url, expires_at } = await blob.downloadUrl(obj.id, { expiresIn: 600 });

link = client.blob.download_url(obj["id"], expires_in=600)

link, err := client.Blob.DownloadURL(ctx, obj.ID, &vertracloud.BlobDownloadOptions{ExpiresIn: 600})
if err != nil {
    log.Fatal(err)
}
fmt.Println(link.URL, link.ExpiresAt)

El enlace funciona durante 10 minutos. Consulta Enlaces y visibilidad.

Borra el archivo

curl -X DELETE "https://blob.vertracloud.app/v1/objects/$OBJECT_ID" \
  -H "Authorization: Bearer $VERTRA_API_KEY"

await blob.delete(obj.id);

client.blob.delete(obj["id"])

err = client.Blob.Delete(ctx, obj.ID)
if err != nil {
    log.Fatal(err)
}

Siguientes pasos

Archivos grandes y progreso: Subidas.
Dejar que los navegadores suban directamente: Servir subidas de usuarios.
Todas las rutas: Referencia de la API de Blob.

​Siguientes pasos

Siguientes pasos