Contenedor lógico de Cloudflare R2 donde se almacenan objetos, como archivos, imágenes, vídeos o copias de seguridad, dentro del servicio de almacenamiento de objetos de Cloudflare.
En Cloudflare, cuando alguien habla de un “bucket”, casi siempre se refiere a un bucket de R2. Un bucket es el espacio donde guardas objetos dentro de R2. Todos los objetos se almacenan dentro de un bucket, y Cloudflare indica que su estructura es plana, es decir, no hay carpetas reales como en un sistema de archivos tradicional, aunque puedas simular rutas con nombres como imagenes/logo.png. Cada bucket puede configurarse con opciones como CORS, notificaciones de eventos, clases de almacenamiento, bloqueo y acceso público. Por defecto, un bucket no es público; si quieres exponer su contenido en Internet, debes habilitarlo de forma explícita, ya sea con un dominio propio o con una URL r2.dev pensada para desarrollo. Para un desarrollador que empieza, puede entenderse como “la carpeta principal” de un almacenamiento en la nube, aunque técnicamente no funcione con carpetas reales. Creas un bucket, subes objetos y luego tu aplicación los lee o los sirve desde Workers, desde herramientas compatibles con S3 o desde el panel de Cloudflare.
export default { async fetch(request, env) { await env.MI_BUCKET.put("documentos/saludo.txt", "Hola desde un bucket de R2"); const objeto = await env.MI_BUCKET.get("documentos/saludo.txt"); const contenido = await objeto.text(); return new Response(contenido); } };
