Azure SDK は、さまざまな言語の Azure サービスを簡単に使用できるように構築されたライブラリのコレクションです。 SDK は、アプリケーションと Azure リソース間の操作をシンプルにするように設計されています。 コードで Azure Storage リソースを操作する際、クライアント ライブラリを使用してリソースの管理とデータの操作を行うことができます。
Azure SDK には、Azure Storage リソースを操作するための 2 つのライブラリ セットが用意されています。 一方のライブラリ セットは Azure Storage REST API 上に構築され、BLOB、キュー、ファイルのデータ アクセス操作を処理するように設計されています。 これらのライブラリは、データ プレーンと呼ばれることもあります。 もう一方のライブラリ セットは、Azure Storage リソース プロバイダー REST API 上に構築され、リソース管理操作を処理するように設計されています。 これらのライブラリは、管理プレーンと呼ばれることもあります。
この記事では、管理およびデータ プレーン ライブラリについて、およびアプリケーションの構築時に各ライブラリ セットを使用する場合について説明します。
重要
この記事では、最新の Azure Storage クライアント ライブラリを取り上げます。 これらのライブラリは、一貫したエクスペリエンスを促進し、セキュリティ態勢を強化するために定期的に更新されます。 古いライブラリについては、Microsoft から公式のサポートや更新プログラムは提供されません。 新しい機能と重要なセキュリティ更新を利用するために、新しい Azure SDK ライブラリに移行することをお勧めします。
データ アクセス用のライブラリ
データ プレーン ライブラリは、Azure Storage REST API 上に構築され、BLOB、ファイル、キューのデータを操作できるようにします。 これらのクライアント ライブラリには、BLOB コンテナーや BLOB など、操作するリソースを表す一連のクラスが用意されています。 これらのクラスは、Azure Storage リソースを操作するための操作を提供します。 たとえば、Blob Storage クライアント ライブラリを使用して、BLOB のアップロードとダウンロード、コンテナーの一覧表示、BLOB の削除を行うことができます。
次の表は、データ アクセス用の Azure Storage クライアント ライブラリを示しています。
| ライブラリ | リファレンス | パッケージ | ソース |
|---|---|---|---|
| Azure.Storage.Blobs | リファレンス | NuGet | GitHub |
| Azure.Storage.Blobs.Batch | リファレンス | NuGet | GitHub |
| Azure.Storage.Common | リファレンス | NuGet | GitHub |
| Azure.Storage.Files.DataLake | リファレンス | NuGet | GitHub |
| Azure.Storage.Files.Shares | リファレンス | NuGet | GitHub |
| Azure.Storage.Queues | リファレンス | NuGet | GitHub |
特定のデータ アクセス シナリオに Blob Storage クライアント ライブラリを使用する方法の詳細については、.NET の Blob Storage 開発者ガイドを参照してください。
ほとんどの場合、Azure Storage リソースを操作するには、データ プレーン ライブラリを使用する必要があります。 ただし、ストレージ アカウントの作成または削除、アカウント キーの管理、フェールオーバー シナリオの構成などのリソース管理操作には、管理プレーン ライブラリを使用する必要があります。
リソース管理用のライブラリ
管理プレーン ライブラリは、Azure Storage リソースプロバイダー REST API 上に構築され、Azure Storage リソースを管理できるようにします。 Azure Storage リソース プロバイダーは、Azure Resource Manager に基づくサービスであり、Azure Storage の管理リソースへのアクセスを提供します。 管理プレーン ライブラリを使用すると、ストレージ アカウント、プライベート エンドポイント、アカウント アクセス キーなどのリソースの作成、更新、管理、削除を行うことができます。
次の表は、リソース管理用の Azure Storage クライアント ライブラリを示しています。
| ライブラリ | リファレンス | パッケージ | ソース |
|---|---|---|---|
| Azure.ResourceManager.Storage | リファレンス | NuGet | GitHub |
特定のリソース管理シナリオに Azure Storage 管理ライブラリを使用する方法の詳細については、.NET の Azure Storage 開発者ガイドを参照してください。
次のステップ
- 特定のデータ アクセス シナリオに Blob Storage クライアント ライブラリを使用する方法の詳細については、次のデータ プレーン開発者ガイド参照資料を参照してください。
- 特定のリソース管理シナリオに Azure Storage 管理ライブラリを使用する方法の詳細については、「.NET 用 Azure Storage 管理ライブラリの使用を開始する」を参照してください。