Azure Storage client libraries for .NET

Article
06/18/2024

The Azure Storage client libraries for .NET offer a convenient interface for making calls to Azure Storage. For more information about Azure Storage, see Introduction to Azure Storage.

Libraries for data access

The latest version of the Azure Storage client library for data access is version 12.x.x. Microsoft recommends using version 12.x.x for new applications.

If you cannot update existing applications to version 12.x.x, then Microsoft recommends using version 11.x.x.

Version 12.x.x

The version 12.x.x client libraries for .NET are part of the Azure SDK for .NET. The source code for the Azure Storage client libraries for .NET is available on GitHub.

Use the following version 12.x.x libraries to work with blobs, files, and queues:

Library	Reference	Package	Source
Azure.Storage.Blobs.Batch		NuGet	GitHub
Azure.Storage.Blobs	Reference	NuGet	GitHub
Azure.Storage.Common		NuGet	GitHub
Azure.Storage.Files.DataLake	Reference	NuGet	GitHub
Azure.Storage.Files.Shares	Reference	NuGet	GitHub
Azure.Storage.Queues	Reference	NuGet	GitHub

Version 11.x.x

The source code for the Azure Storage client libraries for .NET is available on GitHub.

Use the following version 11.x.x libraries to work with blobs, files, and queues:

Library	Reference	Package	Source
Microsoft.Azure.Storage.Blob	Reference	NuGet	GitHub
Microsoft.Azure.Storage.Common		NuGet	GitHub
Microsoft.Azure.Storage.File	Reference	NuGet	GitHub
Microsoft.Azure.Storage.Queue	Reference	NuGet	GitHub

Libraries for resource management

The latest version of the Azure Storage client library for resource management is version 1.x.x. Microsoft recommends using version 1.x.x for new applications.

If you cannot update existing applications to version 1.x.x, then Microsoft recommends using version 25.x.x.

Version 1.x.x

Use the following version 1.x.x library to work with the Azure Storage resource provider:

Library	Reference	Package	Source
Azure.ResourceManager.Storage	Reference	NuGet	GitHub

Version 25.x.x

Use the following version 25.x.x library to work with the Azure Storage resource provider:

Library	Reference	Package	Source
Microsoft.Azure.Management.Storage	Reference	NuGet	GitHub

Known issues

This section details known issues for the Azure Storage client libraries for .NET.

InvalidHeaderValue error message when using beta version of SDK

In rare scenarios, applications that have upgraded to the latest beta or generally available version of the SDK can receive an InvalidHeaderValue error message. This issue can occur when using any of the Storage libraries. The error message looks similar to the following sample:

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error>

If you've upgraded to the latest beta or generally available version of the SDK and you experience this error, it's recommended that you downgrade to the previous generally available version of the SDK to see if the issue resolves. If the issue persists, or if the recommendation is not feasible, open a support ticket to explore further options.

Share via