Migration Guide

FluentStorage is the successor of Storage.NET, which had many systemic issues that I could not fix before. The community that gathered around FluentStorage added a few features, but the API has stayed in mostly the same shape. The library was also very limited, and only offered basic read/write functionality for storage providers, with a focus on Azure. GCP and S3 were an afterthought, and were implemented in a partial, inconsistant and unsatisfactory manner.

In 2026, the situation has changed. With the world moving onto the cloud, we need a cloud-first approach. We need an API surface that can unify the needs of AWS, Azure, GCP, and all other cloud storage providers, in addition to offering compatibility with disk based systems like FTP and SFTP.

In this release my goals were:

1. Redesign the API surface to offer a unified API across all major cloud providers
2. Add all of the popular cloud storage providers
3. Add all the "missing" APIs to make this library actually functional in complex projects
4. Fix broken logic, the broken path system, and the various unjustifiable decisions made by the original author
5. Fix technical debt by dropping old providers and outdated concepts
6. Modernize the codebase
7. Improve code organization
8. Improve the automated test suite

Instead of making multiple releases with constant breaking API changes, I decided to roll this into a single large release. v8 is the culmination of all of the above goals.

1. All extension-method factory API has been removed: For example StorageFactory.Blobs and StorageFactory.Messages no longer exist.
2. Factory classes have been introduced on a per-provided basis.
3. Factory classes can be accessed directly to construct new IStore objects: For example StorageFactory.Blobs.AwsS3 is now AwsS3Storage.FromCredentials.
4. All methods are async and the "Async" suffix has been dropped. The old goal of supporting sync and async makes no sense since all cloud transfer APIs are async and the handful of edge cases like local memory storage and local disk storage do not matter.
5. All methods have an optional CancellationToken rather than forcing users to provide one.
6. At initialization, S3-compatible stores will no longer create the bucket if the specified bucket does not exist. FluentStorage is not an IaC framework and this "feature" has been troublesome for many cloud storage providers.
7. WriteAsync() is renamed to SetObject() and will auto compute the object's MIME type (Content-Type) if it is not supplied.
8. GetPresignedUrl() and its variations will auto compute the object's MIME type (Content-Type).
9. CreateDirectory() will no longer create a "dummy file" in a cloud storage bucket.
10. RenameAsync() is renamed to MoveObject() and will no longer perform a recursive copy and delete, instead it will efficiently move the object/file from the old path to the new path only if it exists.
11. ExistsAsync() is renamed to ObjectExists() and will consistently return true/false if the file or folder exists on the bucket/server.
12. DeleteAsync() is renamed to DeleteObject() and will consistently delete a single file or folder from the bucket/server.
13. DeleteObjects() will consistently delete multiple files or folders from the bucket/server.
14. GetClient() will consistently return the internal cloud SDK client for all types of cloud storage. (Replaces NativeBlobClient)
15. Collections returned by APIs will always be List instead of IReadOnlyCollection.
16. StoragePath.Normalize has been completely rewritten to offer a unified path system across all disk and cloud stores
17. Exceptions are moved into the FluentStorage.Exceptions namespace
18. Enums are moved into the FluentStorage.Enums namespace
19. FTP and SFTP server stores now support directory and server API in addition to the object manipulation API
20. Bucket stores now support streaming/seeking, presigned URL and more object manipulation API
21. We no longer support Databricks, ServiceFabric, EventHub, Virtual storage and ZIP archives

1. Add these imports into code that uses FluentStorage:

using FluentStorage.Enums;
using FluentStorage.Exceptions;
using FluentStorage.Model;

2. Find and replace the most common terms:

3. Switch to the new factory classes instead of using StorageFactory.Blobs.
4. Delete the suffix "Async" from all API method calls.

• AwsS3Storage
• AwsSqsStorage
• BackblazeB2Storage
• CloudflareR2Storage
• DigitalOceanSpacesStorage
• HetznerStorage
• VultrStorage
• WasabiStorage
• AzureBlobStore
• AzureDataLakeStorage
• AzureFilesStorage
• AzureKeyVaultStorage
• AzureQueueStorage
• AzureServiceBus
• GoogleCloudStorage
• MinioStorage
• MinioS3Storage
• AlibabaStorage
• FtpStorage
• SftpStorage

• Server info
  • GetServer
• Directory manipulation
  • CreateDirectory
  • DeleteDirectory
  • DirectoryExists
  • MoveDirectory
  • GetFilePermissions
  • SetFilePermissions
• File manipulation
  • MoveObject
  • DownloadObject
  • UploadObject
  • GetBytes
  • SetBytes

• Client info
  • GetClient
• File seeking/streaming
  • OpenSeekable
  • OpenRange
  • GetObjectLength
• File manipulation
  • MoveObject
  • DownloadObject
  • UploadObject
  • OpenRead
  • OpenWrite
• Presigned URL generation
  • GetUploadUrl
  • GetDownloadUrl
  • GetPresignedUrl (S3 friendly)
  • GetObjectSas (Azure friendly)

The entire FluentStorage API surface was redesigned from scratch to keep it meaningful, simple and consistent.

We have deleted less used functionality to reduce bloat and help focus on our priority offering.

The following libraries have been deprecated and deleted from our codebase, reducing the maintenance effort and helping us focus on the important parts of our offering.

	Package	Reason
	FluentStorage.Databricks	We will no longer maintain this package because DBFS is not a mainstream storage backend for a storage abstraction library.
	FluentStorage.Azure.EventHub	Due to low community usage, we will no longer maintain this library.
	FluentStorage.Azure.DataLake	We are no longer maintaining this package as it only caters to DataLake Gen 1, which has been superseded by DataLake Gen2. Gen1 is considered a legacy service and is no longer the direction Microsoft recommends for new development.
	FluentStorage.Azure.ServiceFabric	We will no longer maintain this package because ServiceFabric is not a first-class object storage or messaging service, which is outside our current scope, and it also has extremely low community usage.

Change your NuGet packages and your imports using this mapping: