Azure Blob Storage と .NET の作業を始める

この記事では、.NET 用 Azure Blob Storage クライアント ライブラリを使用して、Azure Blob Storage に接続する方法について説明します。 接続されると、コードは、Blob Storage サービスのコンテナー、BLOB、機能を使って動作できます。

API リファレンス | ライブラリ ソース コード | PAKケージ (NuGet) | サンプル | フィードバックを送る

前提条件

プロジェクトの設定

このセクションでは、.NET 用 Azure Blob Storage クライアント ライブラリを操作するためのプロジェクトの準備について説明します。

プロジェクト ディレクトリから、dotnet add package コマンドを使用して、Azure Blob Storage と Azure ID のクライアント ライブラリのパッケージをインストールします。 Azure サービスへのパスワードレス接続には、Azure.Identity パッケージが必要です。

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

次の using ディレクティブをコード ファイルの先頭に追加します。

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

BLOB クライアント ライブラリ情報:

  • Azure.Storage.Blobs: サービス、コンテナー、BLOB を操作するために使用できるプライマリ クラス ("クライアント オブジェクト") が含まれています。

  • Azure.Storage.Blobs.Specialized: BLOB の種類 (ブロック BLOB など) に固有の操作を実行するために使用できるクラスが含まれています。

  • Azure.Storage.Blobs.Models: 他のすべてのユーティリティ クラス、構造体、列挙型。

Blob Storage へのアクセスを承認して接続する

アプリを BLOB Storage に接続するには、BlobServiceClient クラスのインスタンスを作成します。 このオブジェクトは、ストレージ アカウント レベルでデータ リソースを操作するための開始点となります。 それを使って、ストレージ アカウントとそのコンテナーを操作できます。 また、操作する必要があるリソースに応じて、サービス クライアントを使用してコンテナー クライアントまたは BLOB クライアントを作成することもできます。

クライアント オブジェクトの作成と管理の詳細については、「データ リソースを操作するクライアント オブジェクトを作成および管理する」を参照してください。

Microsoft Entra 認可トークン、アカウント アクセス キー、または Shared Access Signature (SAS) を使用して、BlobServiceClient オブジェクトを認可できます。 最適なセキュリティのため、Microsoft では、可能な限り、Microsoft Entra ID とマネージド ID を使って、BLOB データに対する要求を認可することをお勧めします。 詳しくは、Microsoft Entra ID を使用した BLOB へのアクセスの認可に関する記事をご覧ください。

Microsoft Entra ID を使用して認可するには、セキュリティ プリンシパルを使用する必要があります。 必要なセキュリティ プリンシパルの種類は、アプリが実行される場所によって異なります。 次の表を参考にしてください。

アプリが実行される場所 セキュリティ プリンシパル ガイダンス
ローカル コンピューター (開発とテスト) サービス プリンシパル アプリの登録、Microsoft Entra グループの設定、ロールの割り当て、環境変数の構成の方法を確認するには、開発者サービス プリンシパルを使用してアクセスを認可する方法に関する記事を参照してください
ローカル コンピューター (開発とテスト) ユーザー ID Microsoft Entra グループを設定し、ロールを割り当て、Azure にサインインする方法については、開発者資格情報を使用してアクセスを認可する方法に関する記事を参照してください
Azure でホスト マネージド ID マネージド ID を有効にしてロールを割り当てる方法については、マネージド ID を使用して Azure でホストされるアプリからのアクセスを承認する方法に関する記事を参照してください
Azure の外部でホストされる (オンプレミス アプリなど) サービス プリンシパル アプリを登録し、ロールを割り当て、環境変数を構成する方法については、アプリケーション サービス プリンシパルを使用してオンプレミス アプリからのアクセスを承認する方法に関する記事を参照してください

DefaultAzureCredential を使用してアクセスを承認する

Blob Storage へのアクセスを承認して接続する最も簡単で安全な方法は、DefaultAzureCredential インスタンスを作成して OAuth トークンを取得することです。 その後、その資格情報を使用して BlobServiceClient オブジェクトを作成できます。

この例では、DefaultAzureCredential を使用して認可された BlobServiceClient オブジェクトを作成します。

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

ユーザーの認証に使用する資格情報の種類が正確にわかっている場合は、.NET 用 Azure ID クライアント ライブラリの他のクラスを使用して OAuth トークンを取得できます。 これらのクラスは TokenCredential クラスから取得されます。

これらの各承認メカニズムについて詳しくは、「Azure Storage 内のデータへのアクセスを承認する」をご覧ください。

アプリの構築

Azure Blob Storage のデータ リソースを操作するアプリを構築する際、コードでは主に、ストレージ アカウント、コンテナー、BLOB という 3 つのリソースの種類と対話します。 これらのリソースの種類、リソースの相互関係、およびアプリがリソースと対話する方法について詳しくは、「アプリが Blob Storage データ リソースと対話する方法を理解する」を参照してください。

以下のガイドでは、.NET 用の Azure Storage クライアント ライブラリを使用してデータにアクセスし、特定のアクションを実行する方法について説明します。

ガイド 説明
BLOB にデータを追加する 追加 BLOB を作成し、その BLOB にデータを追加する方法について説明します。
再試行ポリシーを構成する クライアント操作の再試行ポリシーを実装します。
BLOB をコピーする ある場所から別の場所に BLOB をコピーします。
コンテナーの作成 コンテナーを作成します。
ユーザーの委任 SAS の作成 コンテナーまたは BLOB 用のユーザー委任 SAS を作成します。
BLOB のリースを作成および管理する BLOB に対するロックを確立して管理します。
コンテナーのリースを作成および管理する コンテナーに対するロックを確立して管理します。
BLOB の削除と復元 BLOB を削除し、論理的な削除が有効になっている場合は、削除された BLOB を復元します。
コンテナーを削除して復元する コンテナーを削除し、論理的な削除が有効になっている場合は、削除されたコンテナーを復元します。
BLOB をダウンロードする 文字列、ストリーム、ファイル パスを使って BLOB をダウンロードします。
タグを使って BLOB を検索する タグの設定と取得を行い、タグを使って BLOB を検索します。
BLOB をリストする さまざまな方法で BLOB の一覧を表示します。
コンテナーをリストする アカウントのコンテナーの一覧を表示し、さまざまなオプションを使って一覧をカスタマイズします。
プロパティとメタデータを管理する BLOB のプロパティとメタデータを取得および設定します。
プロパティとメタデータを管理する コンテナーのプロパティとメタデータを取得および設定します。
データ転送のパフォーマンス チューニング データ転送操作のパフォーマンスを最適化します。
BLOB のアクセス層を設定または変更する ブロック BLOB のアクセス層を設定または変更します。
BLOB をアップロードする 文字列、ストリーム、ファイル パス、その他の方法を使って BLOB をアップロードする方法について説明します。