.NET 用 Azure Storage クライアント ライブラリ

.NET 用 Azure Storage クライアント ライブラリで、Azure Storage への呼び出しを行うための便利なインターフェイスを利用できます。 Azure Storage の詳細については、「 Azure Storage の概要」を参照してください。

データ アクセス用のライブラリ

データ アクセス用の Azure Storage クライアント ライブラリの最新バージョンはバージョン 12.x.x です。Microsoft では、新しいアプリケーションにバージョン 12.x.x を使用することをお勧めします。

既存のアプリケーションをバージョン 12.x.x に更新できない場合は、バージョン 11.x.x を使用することをお勧めします。

バージョン 12.x.x

.NET 用のバージョン 12.x.x クライアント ライブラリは、Azure SDK for .NET の一部です。 .NET 用 Azure Storage クライアント ライブラリのソース コードは、 GitHub で入手できます。

BLOB、ファイル、キューを操作するには、次のバージョン 12.x.x ライブラリを使用します。

ライブラリ リファレンス Package source
Azure.Storage.Blobs.Batch NuGet GitHub
Azure.Storage.Blobs リファレンス NuGet GitHub
Azure.Storage.Common NuGet GitHub
Azure.Storage.Files.DataLake リファレンス NuGet GitHub
Azure.Storage.Files.Shares リファレンス NuGet GitHub
Azure.Storage.Queues リファレンス NuGet GitHub

バージョン 11.x.x

.NET 用 Azure Storage クライアント ライブラリのソース コードは、 GitHub で入手できます。

BLOB、ファイル、キューを操作するには、次のバージョン 11.x.x ライブラリを使用します。

ライブラリ リファレンス Package source
Microsoft.Azure.Storage.Blob リファレンス NuGet GitHub
Microsoft.Azure.Storage.Common NuGet GitHub
Microsoft.Azure.Storage.File リファレンス NuGet GitHub
Microsoft.Azure.Storage.Queue リファレンス NuGet GitHub

リソース管理用のライブラリ

リソース管理用の Azure Storage クライアント ライブラリの最新バージョンはバージョン 1.x.x です。Microsoft では、新しいアプリケーションにバージョン 1.x.x を使用することをお勧めします。

既存のアプリケーションをバージョン 1.x.x に更新できない場合は、バージョン 25.x.x を使用することをお勧めします。

バージョン 1.x.x

Azure Storage リソース プロバイダーを操作するには、次のバージョン 1.x.x ライブラリを使用します。

ライブラリ リファレンス Package source
Azure.ResourceManager.Storage リファレンス NuGet GitHub

バージョン 25.x.x

Azure Storage リソース プロバイダーを操作するには、次のバージョン 25.x.x ライブラリを使用します。

ライブラリ リファレンス Package source
Microsoft.Azure.Management.Storage リファレンス NuGet GitHub

既知の問題

このセクションでは、.NET 用 Azure Storage クライアント ライブラリの既知の問題について詳しく説明します。

SDK のベータ版を使用する場合の InvalidHeaderValue エラー メッセージ

まれなシナリオでは、最新のベータ版または一般公開バージョンの SDK にアップグレードしたアプリケーションで、エラー メッセージが InvalidHeaderValue 表示される場合があります。 この問題は、ストレージ ライブラリのいずれかを使用する場合に発生する可能性があります。 エラー メッセージは、次のサンプルのようになります。

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> 

SDK の最新のベータ版または一般公開バージョンにアップグレードした後、このエラーが発生した場合は、一般公開されている以前のバージョンの SDK にダウングレードして、問題が解決するかどうかを確認することをお勧めします。 問題が解決しない場合、または推奨事項が実現できない場合は、 サポート チケットを開 いて、その他のオプションを確認してください。