Ecng system framework
Get Started
$ dotnet add package Ecng.Backup.AWSReadme
Ecng.Backup.AWS
Amazon Web Services backup providers implementing IBackupService. Supports both Amazon S3 for frequent access and Amazon Glacier for archival storage.
Services
AmazonS3Service
High-performance object storage for frequently accessed data.
using Ecng.Backup;
using Ecng.Backup.Amazon;
// Create service using region name
var s3 = new AmazonS3Service(
endpoint: "us-east-1", // or "eu-west-1", "ap-northeast-1", etc.
bucket: "my-backup-bucket",
accessKey: "AKIAIOSFODNN7EXAMPLE",
secretKey: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
);
// Or using RegionEndpoint directly
var s3 = new AmazonS3Service(
endpoint: RegionEndpoint.USEast1,
bucket: "my-backup-bucket",
accessKey: "...",
secretKey: "..."
);
Features
| Feature | Supported |
|---|---|
| CanPublish | Yes |
| CanExpirable | Yes (up to 7 days) |
| CanFolders | No (virtual via path prefixes) |
| CanPartialDownload | Yes |
Upload with Progress
var entry = new BackupEntry { Name = "backups/2024/data.zip" };
await using var fileStream = File.OpenRead(@"C:\data.zip");
await s3.UploadAsync(entry, fileStream, progress =>
{
Console.WriteLine($"Uploaded: {progress}%");
});
Download with Resume Support
var entry = new BackupEntry { Name = "backups/2024/data.zip" };
// Get file info first
await s3.FillInfoAsync(entry);
Console.WriteLine($"File size: {entry.Size} bytes");
// Resume download from offset
long alreadyDownloaded = new FileInfo("data.zip.partial").Length;
long remaining = entry.Size - alreadyDownloaded;
await using var stream = new FileStream("data.zip.partial", FileMode.Append);
await s3.DownloadAsync(entry, stream, alreadyDownloaded, remaining,
progress => Console.WriteLine($"Progress: {progress}%"));
Publishing Files
var entry = new BackupEntry { Name = "reports/monthly.pdf" };
// Permanent public URL (requires bucket ACL permissions)
string permanentUrl = await s3.PublishAsync(entry);
// Pre-signed URL with expiration (works with any bucket)
string tempUrl = await s3.PublishAsync(entry, TimeSpan.FromHours(24));
// Maximum expiration: 7 days
// Revoke public access
await s3.UnPublishAsync(entry);