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" />
<PackageReference Include="ForEach.Storage.S3" />
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
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#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
#tool nuget:?package=ForEach.Storage.S3&version=0.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
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,SecretKeyare 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
S3RetryPolicyon top of the SDK's own retries: it also retries the spurious403 AccessDeniedsome 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;
DeleteFolderAsyncdeletes one object per key (no batch call). - With
PresignedDownloads,CreateDownloadUrlsigns a SigV4 GET locally (no request) that makes S3 send the file's MIME type andCache-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 | Versions 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.
-
net10.0
- AWSSDK.S3 (>= 4.0.104.12)
- ForEach.Storage.Abstractions (>= 0.1.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Options (>= 10.0.9)
-
net8.0
- AWSSDK.S3 (>= 4.0.104.12)
- ForEach.Storage.Abstractions (>= 0.1.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.9)
- Microsoft.Extensions.Options (>= 10.0.9)
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 |