Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bunny.net/llms.txt

Use this file to discover all available pages before exploring further.

The official .NET SDK provides a strongly-typed way to interact with Bunny Storage in your .NET applications.

​
Installation

dotnet add package BunnyCDN.Net.Storage

​
Quickstart

​
Connect to your storage zone

var bunnyCDNStorage = new BunnyCDNStorage(
    "your-storage-zone-name",
    "your-access-key",
    "de" // Optional: storage zone region
);
Available regions:
Region CodeLocationCity
deFrankfurt, DEFalkenstein (default)
ukLondon, UKLondon
nyNew York, USNew York
laLos Angeles, USLos Angeles
sgSingapore, SGSingapore
seStockholm, SEStockholm
brSao Paulo, BRSao Paulo
jhJohannesburg, ZAJohannesburg
sydSydney, AUSydney

​
List files

var files = await bunnyCDNStorage.GetStorageObjectsAsync("/storagezonename/");

// Navigate subdirectories
var subfolderFiles = await bunnyCDNStorage.GetStorageObjectsAsync("/storagezonename/my-folder/");
File metadata properties:
  • Guid - Unique identifier
  • ObjectName - File name
  • Path - Directory path
  • FullPath - Complete path to the file
  • Length - File size in bytes
  • DateCreated - Creation date
  • LastChanged - Last modification date
  • IsDirectory - Whether it’s a directory
  • ServerId - Storage server ID
  • UserId - BunnyCDN user ID
  • StorageZoneName - Storage zone name
  • StorageZoneId - Storage zone ID

​
Upload a file

Upload from stream: 
await bunnyCDNStorage.UploadAsync(stream, "/storagezonename/path/to/file.jpg");
Upload from local file: 
await bunnyCDNStorage.UploadAsync("local/file/path/file.jpg", "/storagezonename/path/to/file.jpg");
Upload with checksum verification: 
// Provide SHA-256 hash
await bunnyCDNStorage.UploadAsync(
    stream,
    "/storagezonename/file.jpg",
    "d04b98f48e8f8bcc15c6ae5ac050801cd6dcfd428fb5f9e65c4e16e7807340fa"
);

// Auto-generate hash
await bunnyCDNStorage.UploadAsync(stream, "/storagezonename/file.jpg", true);

// Auto-generate if provided hash is invalid
await bunnyCDNStorage.UploadAsync(
    stream,
    "/storagezonename/file.jpg",
    true,
    "d04b98f48e8f8bcc15c6ae5ac050801cd6dcfd428fb5f9e65c4e16e7807340fa"
);

​
Download a file

Download as stream: 
var stream = await bunnyCDNStorage.DownloadObjectAsStreamAsync("/storagezonename/path/to/file.jpg");
Download to local file: 
await bunnyCDNStorage.DownloadObjectAsync(
    "/storagezonename/path/to/file.jpg",
    "local/file/path/downloaded-file.jpg"
);

​
Delete files

// Delete a file
await bunnyCDNStorage.DeleteObjectAsync("/storagezonename/path/to/file.jpg");

// Delete a directory (including contents)
await bunnyCDNStorage.DeleteObjectAsync("/storagezonename/path/to/folder/");

​
Examples

​
ASP.NET Core Web API

using BunnyCDN.Net.Storage;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var storage = new BunnyCDNStorage(
    builder.Configuration["BunnyStorage:ZoneName"]!,
    builder.Configuration["BunnyStorage:AccessKey"]!,
    builder.Configuration["BunnyStorage:Region"] ?? "de"
);

app.MapGet("/files", async () =>
{
    var files = await storage.GetStorageObjectsAsync($"/{builder.Configuration["BunnyStorage:ZoneName"]}/");
    return Results.Ok(files);
});

app.Run();

​
Console application

using BunnyCDN.Net.Storage;

var storage = new BunnyCDNStorage(
    Environment.GetEnvironmentVariable("STORAGE_ZONE")!,
    Environment.GetEnvironmentVariable("STORAGE_ACCESS_KEY")!,
    "de"
);

// List all files
var files = await storage.GetStorageObjectsAsync($"/{Environment.GetEnvironmentVariable("STORAGE_ZONE")}/");
foreach (var file in files)
{
    Console.WriteLine($"{file.ObjectName} - {file.Length} bytes");
}

​
Upload file from disk

using BunnyCDN.Net.Storage;

var storage = new BunnyCDNStorage("my-storage-zone", "my-access-key", "de");

// Upload a local file
var localFilePath = "./images/photo.jpg";
var remotePath = "/my-storage-zone/uploads/photo.jpg";

await storage.UploadAsync(localFilePath, remotePath);
Console.WriteLine("File uploaded successfully!");

​
Download file to disk

using BunnyCDN.Net.Storage;

var storage = new BunnyCDNStorage("my-storage-zone", "my-access-key", "de");

// Download to local file
var remotePath = "/my-storage-zone/uploads/photo.jpg";
var localFilePath = "./downloads/photo.jpg";

await storage.DownloadObjectAsync(remotePath, localFilePath);
Console.WriteLine("File downloaded successfully!");

​
Stream processing

using BunnyCDN.Net.Storage;
using System.IO;

var storage = new BunnyCDNStorage("my-storage-zone", "my-access-key", "de");

// Upload from stream
using (var fileStream = File.OpenRead("./input.jpg"))
{
    await storage.UploadAsync(fileStream, "/my-storage-zone/processed/output.jpg");
}

// Download as stream
var downloadStream = await storage.DownloadObjectAsStreamAsync("/my-storage-zone/processed/output.jpg");
using (var fileStream = File.Create("./result.jpg"))
{
    await downloadStream.CopyToAsync(fileStream);
}

Console.WriteLine("Stream processing completed!");

​
Batch operations

using BunnyCDN.Net.Storage;

var storage = new BunnyCDNStorage("my-storage-zone", "my-access-key", "de");

// Get all files
var files = await storage.GetStorageObjectsAsync("/my-storage-zone/");

// Upload multiple files
var filesToUpload = Directory.GetFiles("./uploads");
foreach (var file in filesToUpload)
{
    var fileName = Path.GetFileName(file);
    await storage.UploadAsync(file, $"/my-storage-zone/batch/{fileName}");
    Console.WriteLine($"Uploaded: {fileName}");
}

// Delete old files (example: files older than 30 days)
var thirtyDaysAgo = DateTime.UtcNow.AddDays(-30);
var oldFiles = files.Where(f => !f.IsDirectory && f.LastChanged < thirtyDaysAgo);

foreach (var file in oldFiles)
{
    await storage.DeleteObjectAsync(file.FullPath);
    Console.WriteLine($"Deleted: {file.ObjectName}");
}

​
Custom HTTP handler

using BunnyCDN.Net.Storage;
using System.Net.Http;

// Create a custom HTTP handler for advanced scenarios
var httpHandler = new HttpClientHandler
{
    MaxConnectionsPerServer = 10,
    UseProxy = false
};

var storage = new BunnyCDNStorage(
    "my-storage-zone",
    "my-access-key",
    "de",
    httpHandler
);

var files = await storage.GetStorageObjectsAsync("/my-storage-zone/");
Console.WriteLine($"Found {files.Count} objects");

​
Resources