ForEach.Storage.S3 0.1.0

dotnet add package ForEach.Storage.S3 --version 0.1.0
                    
NuGet\Install-Package ForEach.Storage.S3 -Version 0.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ForEach.Storage.S3" Version="0.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ForEach.Storage.S3" Version="0.1.0" />
                    
Directory.Packages.props
<PackageReference Include="ForEach.Storage.S3" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ForEach.Storage.S3 --version 0.1.0
                    
#r "nuget: ForEach.Storage.S3, 0.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package ForEach.Storage.S3@0.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ForEach.Storage.S3&version=0.1.0
                    
Install as a Cake Addin
#tool nuget:?package=ForEach.Storage.S3&version=0.1.0
                    
Install as a Cake Tool

ForEach.Storage.S3

IFileBlobStore over an S3-compatible bucket (AWS S3, Hetzner Object Storage, Ceph). A key maps to the object {Prefix}{key}.

services.AddS3FileStorage(options => configuration.GetSection(S3FileStorageOptions.SectionName).Bind(options));

// The store is a keyed singleton; forward it when S3 is the only provider.
services.AddSingleton(sp => sp.GetRequiredKeyedService<IFileBlobStore>(ForEach.Storage.S3.ServiceCollectionExtensions.ServiceKey));
  • Options (S3FileStorageOptions): ServiceUrl, Bucket, Region, AccessKey, SecretKey are required and checked at startup; Prefix, ForcePathStyle (default true), MaxAttempts / BaseDelayMs / MaxDelayMs, PresignedDownloads, PresignedUrlLifetimeSeconds (60 to 3600, default 300). Keep the credentials out of appsettings.
  • Every call goes through S3RetryPolicy on top of the SDK's own retries: it also retries the spurious 403 AccessDenied some S3-compatible stores answer on a valid request, any 5xx, 429, throttling codes, timeouts and transport failures, with exponential backoff and equal jitter. A real credential error (SignatureDoesNotMatch, ...) is not retried.
  • Writes send a plain signed payload (no aws-chunked encoding); the SDK checksums are only sent where S3 requires them.
  • Reads download the whole object inside the retry and return a seekable stream; a missing object returns null.
  • Listing follows continuation tokens; DeleteFolderAsync deletes one object per key (no batch call).
  • With PresignedDownloads, CreateDownloadUrl signs a SigV4 GET locally (no request) that makes S3 send the file's MIME type and Cache-Control: private, max-age=<lifetime>.

Targets net8.0 and net10.0. Source and release notes: https://github.com/foreach-rs/nuget-releases/tree/main/packages/Storage

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0 66 11/19/2026