Azure Functions における Azure Blob Storage の入力バインド

[アーティクル]
05/21/2024

入力バインドを使用すると、Azure 関数への入力として BLOB Storage データを読み取ることができます。

セットアップと構成の詳細については、概要に関する記事を参照してください。

重要

この記事では、タブを使用して、Node.js プログラミングモデルの複数のバージョンに対応しています。 v4 モデルは一般提供されており、JavaScript と TypeScript の開発者にとって、より柔軟で直感的なエクスペリエンスが得られるように設計されています。 v4 モデルの動作の詳細については、Azure Functions Node.js 開発者ガイドを参照してください。 v3 と v4 の違いの詳細については、移行ガイドを参照してください。

Azure Functions では、Python の 2 つのプログラミングモデルがサポートされています。バインドを定義する方法は、選択したプログラミングモデルによって異なります。

Python v2 プログラミングモデルでは、Python 関数コードでデコレーターを使用してバインドを直接定義できます。詳細については、「Python 開発者ガイド」を参照してください。

この記事は、両方のプログラミングモデルをサポートしています。

例

A C# 関数は、次の C# モードのいずれかを使用して作成できます。

分離されたワーカーモデル: ランタイムから分離されたワーカープロセスで実行されるコンパイル済みの C# 関数。分離ワーカープロセスは、LTS および非 LTS バージョンの .NET および .NET Framework で実行されている C# 関数をサポートするために必要です。分離ワーカープロセス関数の拡張機能では、Microsoft.Azure.Functions.Worker.Extensions.* 名前空間が使用されます。
インプロセスモデル: Functions ランタイムと同じプロセスで実行されるコンパイル済みの C# 関数。このモデルの一部では、主に C# ポータルの編集のためにサポートされている C# スクリプトを使用して Functions を実行できます。インプロセス関数の拡張機能では、Microsoft.Azure.WebJobs.Extensions.* 名前空間が使用されます。

重要

インプロセスモデルのサポートは 2026 年 11 月 10 日に終了します。完全なサポートのために、分離ワーカーモデルにアプリを移行することを強くお勧めします。

分離プロセス
インプロセス

次の例は C# 関数であり、分離ワーカープロセスで実行され、BLOB 入力と BLOB 出力の両方の BLOB バインドを持つ BLOB トリガーを使用します。この関数は、test-sample-trigger コンテナーの BLOB の作成によってトリガーされます。 test-samples-input コンテナーからテキストファイルを読み取り、トリガーされたファイルの名前に基づいて、出力コンテナーに新しいテキストファイルを作成します。

    public static class BlobFunction
    {
        [Function(nameof(BlobFunction))]
        [BlobOutput("test-samples-output/{name}-output.txt")]
        public static string Run(
            [BlobTrigger("test-samples-trigger/{name}")] string myTriggerItem,
            [BlobInput("test-samples-input/sample1.txt")] string myBlob,
            FunctionContext context)
        {
            var logger = context.GetLogger("BlobFunction");
            logger.LogInformation("Triggered Item = {myTriggerItem}", myTriggerItem);
            logger.LogInformation("Input Item = {myBlob}", myBlob);

            // Blob Output
            return "blob-output content";
        }
    }
}

次の例は、キュートリガーと入力 BLOB バインディングを使用する C# 関数です。キューメッセージには BLOB の名前が含まれ、関数は BLOB のサイズをログに記録します。


[FunctionName("BlobInput")]
public static void Run(
    [QueueTrigger("myqueue-items")] string myQueueItem,
    [Blob("samples-workitems/{queueTrigger}", FileAccess.Read)] Stream myBlob,
    ILogger log)
{
    log.LogInformation($"BlobInput processed blob\n Name:{myQueueItem} \n Size: {myBlob.Length} bytes");
}

このセクションには、次の例が含まれています。

HTTP トリガー、クエリ文字列から BLOB を検索する
キュートリガー、キューメッセージから BLOB 名前を受け取る

HTTP トリガー、クエリ文字列から BLOB を検索する

次の例では、Java 関数が HttpTrigger 注釈を利用し、BLOB ストレージコンテナーのファイル名を含むパラメーターを受け取ります。 BlobInput 注釈によってファイルが読み取られ、その内容が byte[] として関数に渡されます。

  @FunctionName("getBlobSizeHttp")
  @StorageAccount("Storage_Account_Connection_String")
  public HttpResponseMessage blobSize(
    @HttpTrigger(name = "req", 
      methods = {HttpMethod.GET}, 
      authLevel = AuthorizationLevel.ANONYMOUS) 
    HttpRequestMessage<Optional<String>> request,
    @BlobInput(
      name = "file", 
      dataType = "binary", 
      path = "samples-workitems/{Query.file}") 
    byte[] content,
    final ExecutionContext context) {
      // build HTTP response with size of requested blob
      return request.createResponseBuilder(HttpStatus.OK)
        .body("The size of \"" + request.getQueryParameters().get("file") + "\" is: " + content.length + " bytes")
        .build();
  }

キュートリガー、キューメッセージから BLOB 名前を受け取る

次の例では、Java 関数が QueueTrigger 注釈を利用し、BLOB ストレージコンテナーのファイル名を含むメッセージを受け取ります。 BlobInput 注釈によってファイルが読み取られ、その内容が byte[] として関数に渡されます。

  @FunctionName("getBlobSize")
  @StorageAccount("Storage_Account_Connection_String")
  public void blobSize(
    @QueueTrigger(
      name = "filename", 
      queueName = "myqueue-items-sample") 
    String filename,
    @BlobInput(
      name = "file", 
      dataType = "binary", 
      path = "samples-workitems/{queueTrigger}") 
    byte[] content,
    final ExecutionContext context) {
      context.getLogger().info("The size of \"" + filename + "\" is: " + content.length + " bytes");
  }

Java 関数ランタイムライブラリで、その値が BLOB に由来するパラメーター上で @BlobInput 注釈を使用します。この注釈は、Java のネイティブ型、POJO、または Optional<T> を使用した null 許容値で使用できます。

モデル v4
モデル v3

キューによってトリガーされ、BLOB のコピーを作成する TypeScript 関数を次の例に示します。関数は、コピーする BLOB の名前を含むキューメッセージによってトリガーされます。新しい BLOB の名前は {originalblobname}-Copy です。

import { app, input, InvocationContext, output } from '@azure/functions';

const blobInput = input.storageBlob({
    path: 'samples-workitems/{queueTrigger}',
    connection: 'MyStorageConnectionAppSetting',
});

const blobOutput = output.storageBlob({
    path: 'samples-workitems/{queueTrigger}-Copy',
    connection: 'MyStorageConnectionAppSetting',
});

export async function storageQueueTrigger1(queueItem: unknown, context: InvocationContext): Promise<unknown> {
    return context.extraInputs.get(blobInput);
}

app.storageQueue('storageQueueTrigger1', {
    queueName: 'myqueue-items',
    connection: 'MyStorageConnectionAppSetting',
    extraInputs: [blobInput],
    return: blobOutput,
    handler: storageQueueTrigger1,
});

モデル v4
モデル v3

キューによってトリガーされ、BLOB のコピーを作成する JavaScript 関数を次の例に示します。関数は、コピーする BLOB の名前を含むキューメッセージによってトリガーされます。新しい BLOB の名前は {originalblobname}-Copy です。

const { app, input, output } = require('@azure/functions');

const blobInput = input.storageBlob({
    path: 'samples-workitems/{queueTrigger}',
    connection: 'MyStorageConnectionAppSetting',
});

const blobOutput = output.storageBlob({
    path: 'samples-workitems/{queueTrigger}-Copy',
    connection: 'MyStorageConnectionAppSetting',
});

app.storageQueue('storageQueueTrigger1', {
    queueName: 'myqueue-items',
    connection: 'MyStorageConnectionAppSetting',
    extraInputs: [blobInput],
    return: blobOutput,
    handler: (queueItem, context) => {
        return context.extraInputs.get(blobInput);
    },
});

次の例は、function.json ファイルの BLOB 入出力バインドと、そのバインドを使用する JavaScript コードを示しています。関数は、BLOB のコピーを作成します。関数は、コピーする BLOB の名前を含むキューメッセージによってトリガーされます。新しい BLOB の名前は {originalblobname}-Copy です。

function.json ファイルでは、queueTrigger メタデータプロパティは path プロパティ内の BLOB 名の指定に使用されます。

{
  "bindings": [
    {
      "queueName": "myqueue-items",
      "connection": "MyStorageConnectionAppSetting",
      "name": "myQueueItem",
      "type": "queueTrigger",
      "direction": "in"
    },
    {
      "name": "myInputBlob",
      "type": "blob",
      "path": "samples-workitems/{queueTrigger}",
      "connection": "MyStorageConnectionAppSetting",
      "direction": "in"
    },
    {
      "name": "myOutputBlob",
      "type": "blob",
      "path": "samples-workitems/{queueTrigger}-Copy",
      "connection": "MyStorageConnectionAppSetting",
      "direction": "out"
    }
  ],
  "disabled": false
}

これらのプロパティについては、「構成」セクションを参照してください。

JavaScript コードを次に示します。

module.exports = async function(context) {
    context.log('Node.js Queue trigger function processed', context.bindings.myQueueItem);
    context.bindings.myOutputBlob = context.bindings.myInputBlob;
};

次の例は、function.json ファイルで定義されている BLOB 入力バインドを示しています。このバインドにより、受信 BLOB データを PowerShell 関数で使用できるようになります。

json 構成を次に示します。

{
  "bindings": [
    {
      "name": "InputBlob",
      "type": "blobTrigger",
      "direction": "in",
      "path": "source/{name}",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

関数コードを次に示します。

# Input bindings are passed in via param block.
param([byte[]] $InputBlob, $TriggerMetadata)

Write-Host "PowerShell Blob trigger: Name: $($TriggerMetadata.Name) Size: $($InputBlob.Length) bytes"

この例では、SDK 型を使用して、BLOB ストレージ入力バインドによって提供される基になる BlobClient オブジェクトに直接アクセスします。

import logging

import azure.functions as func
import azurefunctions.extensions.bindings.blob as blob

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)
@app.route(route="file")
@app.blob_input(
    arg_name="client", path="PATH/TO/BLOB", connection="AzureWebJobsStorage"
)
def blob_input(req: func.HttpRequest, client: blob.BlobClient):
    logging.info(
        f"Python blob input function processed blob \n"
        f"Properties: {client.get_blob_properties()}\n"
        f"Blob content head: {client.download_blob().read(size=1)}"
    )
    return "ok"

他の SDK の種類の使用例については、 ContainerClient と StorageStreamDownloader のサンプルを参照してください。

プロジェクトで SDK 型バインドを有効にする方法など、詳細については、「 SDK 型バインドを参照してください。

このコードでは、BLOB のコピーを作成します。

import logging
import azure.functions as func

app = func.FunctionApp()

@app.function_name(name="BlobOutput1")
@app.route(route="file")
@app.blob_input(arg_name="inputblob",
                path="sample-workitems/test.txt",
                connection="<BLOB_CONNECTION_SETTING>")
@app.blob_output(arg_name="outputblob",
                path="newblob/test.txt",
                connection="<BLOB_CONNECTION_SETTING>")
def main(req: func.HttpRequest, inputblob: str, outputblob: func.Out[str]):
    logging.info(f'Python Queue trigger function processed {len(inputblob)} bytes')
    outputblob.set(inputblob)
    return "ok"

関数は、BLOB のコピーを作成します。関数は、コピーする BLOB の名前を含むキューメッセージによってトリガーされます。新しい BLOB の名前は {originalblobname}-Copy です。

function.json ファイルでは、queueTrigger メタデータプロパティは path プロパティ内の BLOB 名の指定に使用されます。

{
  "bindings": [
    {
      "queueName": "myqueue-items",
      "connection": "MyStorageConnectionAppSetting",
      "name": "queuemsg",
      "type": "queueTrigger",
      "direction": "in"
    },
    {
      "name": "inputblob",
      "type": "blob",
      "dataType": "binary",
      "path": "samples-workitems/{queueTrigger}",
      "connection": "MyStorageConnectionAppSetting",
      "direction": "in"
    },
    {
      "name": "$return",
      "type": "blob",
      "path": "samples-workitems/{queueTrigger}-Copy",
      "connection": "MyStorageConnectionAppSetting",
      "direction": "out"
    }
  ],
  "disabled": false,
  "scriptFile": "__init__.py"
}

これらのプロパティについては、「構成」セクションを参照してください。

使用されるバインドは、dataType プロパティによって決まります。次の値は、さまざまなバインド方法をサポートするために使用できます。

バインド値	Default	説明	例
`string`	×	汎用バインドを使用し、入力型を `string` としてキャストします	`def main(input: str)`
`binary`	×	汎用バインドを使用し、入力 BLOBを `bytes` Python オブジェクトとしてキャストします	`def main(input: bytes)`

function.json で dataType プロパティが定義されていない場合、既定値は string になります。

Python コードを次に示します。

import logging
import azure.functions as func


# The input binding field inputblob can either be 'bytes' or 'str' depends
# on dataType in function.json, 'binary' or 'string'.
def main(queuemsg: func.QueueMessage, inputblob: bytes) -> bytes:
    logging.info(f'Python Queue trigger function processed {len(inputblob)} bytes')
    return inputblob

属性

インプロセスと分離ワーカープロセスの C# ライブラリの両方で、属性を使って関数を定義します。 C# スクリプトでは、C# スクリプトガイドで説明されているように、代わりに function.json 構成ファイルを使用します。

分離プロセス
インプロセス

分離ワーカープロセスでは、次のパラメーターを受け取る BlobInputAttribute 属性を使用して入力バインディングを定義します。

パラメーター	説明
BlobPath	BLOB へのパス。
接続	Azure Blob への接続方法を指定するアプリ設定または設定コレクションの名前。「接続」を参照してください。

C# クラスライブラリで、BlobAttribute を使用します。これは以下のパラメーターを受け取ります。

パラメーター	説明
BlobPath	BLOB へのパス。
接続	Azure Blob への接続方法を指定するアプリ設定または設定コレクションの名前。「接続」を参照してください。
Access (アクセス)	読み取りと書き込みのどちらを行うかを示します。

次の例は、属性のコンストラクターが BLOB へのパスと、入力バインドの読み取りを示す FileAccess パラメーターを受け取る方法を示しています。

[FunctionName("BlobInput")]
public static void Run(
    [QueueTrigger("myqueue-items")] string myQueueItem,
    [Blob("samples-workitems/{queueTrigger}", FileAccess.Read)] Stream myBlob,
    ILogger log)
{
    log.LogInformation($"BlobInput processed blob\n Name:{myQueueItem} \n Size: {myBlob.Length} bytes");
}

属性は Connection プロパティを受け取りますが、 Connection を使用してストレージアカウント接続を指定することもできます。これは、ライブラリ内の他の関数とは異なるストレージアカウントを使用する必要がある場合に実行できます。コンストラクターは、ストレージ接続文字列を含むアプリ設定の名前を受け取ります。属性は、パラメーター、メソッド、またはクラスレベルで適用できます。次の例では、クラスレベルとメソッドレベルを示します。

[StorageAccount("ClassLevelStorageAppSetting")]
public static class AzureFunctions
{
    [FunctionName("StorageTrigger")]
    [StorageAccount("FunctionLevelStorageAppSetting")]
    public static void Run( //...
{
    ...
}

使用するストレージアカウントは、次の順序で決定されます。

トリガーまたはバインド属性の Connection プロパティ。
トリガーまたはバインド属性と同じパラメーターに適用された StorageAccount 属性。
関数に適用される StorageAccount 属性。
クラスに適用される StorageAccount 属性。
AzureWebJobsStorage アプリケーション設定で定義されている、関数アプリの既定のストレージアカウント。

ローカルで開発する場合は、Values コレクション内の local.settings.json ファイルにアプリケーション設定を追加します。

デコレーター

Python v2 プログラミングモデルにのみ適用されます。

デコレーターを使用して定義された Python v2 関数の場合、blob_input および blob_output デコレーターの次のプロパティによって Blob Storage トリガーが定義されます。

プロパティ	説明
`arg_name`	関数コード内の BLOB を表す変数の名前。
`path`	BLOB へのパス `blob_input` デコレーターの場合は、読み取られた BLOB です。 `blob_output` デコレーターの場合は、入力 BLOB の出力またはコピーです。
`connection`	ストレージアカウントの接続文字列。
`data_type`	動的に型指定される言語の場合は、基になるデータ型を指定します。設定可能な値は、`string`、`binary`、または `stream` です。詳細については、トリガーとバインドの概念に関する記事を参照してください。

function.json を使用して定義された Python 関数については、[構成] セクションを参照してください。

注釈

@BlobInput 属性を使用すると、関数をトリガーした BLOB にアクセスできます。この属性と共にバイト配列を使用する場合は、dataType を binary に設定します。詳細については、「入力 - 例」を参照してください。

構成

"Python v1 プログラミングモデルにのみ適用されます。"

モデル v4
モデル v3

次の表では、input.storageBlob() メソッドに渡される options オブジェクトに対して設定できるプロパティについて説明します。

プロパティ	説明
path	BLOB へのパス。
connection	Azure Blob への接続方法を指定するアプリ設定または設定コレクションの名前。「接続」を参照してください。

次の表は、function.json ファイルで設定したバインド構成のプロパティを説明しています。

プロパティ	説明
type	`blob` に設定する必要があります。
direction	`in` に設定する必要があります。例外は、使用方法のセクションに記載しています。
name	関数コード内の BLOB を表す変数の名前。
path	BLOB へのパス。
connection	Azure Blob への接続方法を指定するアプリ設定または設定コレクションの名前。「接続」を参照してください。
dataType	動的に型指定される言語の場合は、基になるデータ型を指定します。設定可能な値は、`string`、`binary`、または `stream` です。詳細については、トリガーとバインドの概念に関する記事を参照してください。

次の表は、function.json ファイルで設定したバインド構成のプロパティを説明しています。

function.json のプロパティ	説明
type	`blob` に設定する必要があります。
direction	`in` に設定する必要があります。例外は、使用方法のセクションに記載しています。
name	関数コード内の BLOB を表す変数の名前。
path	BLOB へのパス。
connection	Azure Blob への接続方法を指定するアプリ設定または設定コレクションの名前。「接続」を参照してください。
dataType	動的に型指定される言語の場合は、基になるデータ型を指定します。設定可能な値は、`string`、`binary`、または `stream` です。詳細については、トリガーとバインドの概念に関する記事を参照してください。

完全な例については、セクションの例を参照してください。

使用法

BLOB 入力でサポートされるバインドの種類は、拡張機能パッケージのバージョンと、関数アプリで使用される C# モダリティによって異なります。

分離プロセス
インプロセス

関数で 1 つの BLOB を処理するとき、BLOB 入力バインドは次の型にバインドできます。

Type	説明
`string`	BLOB コンテンツを表す文字列。 BLOB コンテンツが単純なテキストのときに使用します。
`byte[]`	BLOB コンテンツのバイト数。
JSON シリアル化可能な型	BLOB に JSON データが含まれているとき、Functions は JSON データを単純な従来の CLR オブジェクト (POCO) 型に逆シリアル化しようとします。
Stream¹	BLOB コンテンツの入力ストリーム。
BlobClient¹、 BlockBlobClient¹、 PageBlobClient¹、 AppendBlobClient¹、 BlobBaseClient¹	BLOB に接続されているクライアント。この型のセットには BLOB の処理に対する最大限の制御機能が備わっています。接続に十分なアクセス許可がある場合は、それへの書き戻しに使用できます。

関数で 1 つのコンテナーの複数の BLOB を処理するとき、BLOB 入力バインドは次の型にバインドできます。

Type	説明
`T[]` または `List<T>` (`T` は単一の BLOB 入力バインドの型のいずれか)	複数の BLOB の配列またはリスト。各エントリは、コンテナーの 1 つの BLOB を表します。これらの型によって実装される `IEnumerable<T>` などの任意のインターフェイスにバインドすることもできます。
BlobContainerClient¹	コンテナーに接続されているクライアント。この型にはコンテナーの処理に対する最大限の制御機能が備わっています。接続に十分なアクセス許可がある場合は、それへの書き込みに使用できます。

¹ これらの型を使用するには、Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs 6.0.0 以降と SDK 型バインドの一般的な依存関係に関する記事を参照する必要があります。

string または Byte[] へのバインドが推奨されるのは、BLOB のサイズが小さい場合のみです。これが推奨されるのは、BLOB 全体の内容がメモリに読み込まれるためです。ほとんどの BLOB では、Stream 型または BlobClient 型を使用します。詳細については、「コンカレンシーとメモリ使用量」を参照してください。

Storage SDK タイプの 1 つにバインドしようとしてエラーメッセージが表示された場合は、適切な Storage SDK バージョンへの参照があることを確認してください。

StorageAccountAttribute を使用して、使用するストレージアカウントを指定することもできます。これは、ライブラリ内の他の関数とは異なるストレージアカウントを使用する必要がある場合に実行できます。コンストラクターは、ストレージ接続文字列を含むアプリ設定の名前を受け取ります。属性は、パラメーター、メソッド、またはクラスレベルで適用できます。次の例では、クラスレベルとメソッドレベルを示します。

[StorageAccount("ClassLevelStorageAppSetting")]
public static class AzureFunctions
{
    [FunctionName("BlobTrigger")]
    [StorageAccount("FunctionLevelStorageAppSetting")]
    public static void Run( //...
{
    ....
}

使用するストレージアカウントは、次の順序で決定されます。

BlobTrigger 属性の Connection プロパティ。
BlobTrigger 属性と同じパラメーターに適用された StorageAccount 属性。
関数に適用される StorageAccount 属性。
クラスに適用される StorageAccount 属性。
AzureWebJobsStorage アプリケーション設定で定義されている、関数アプリの既定のストレージアカウント。

モデル v4
モデル v3

context.extraInputs.get() を使用して BLOB データにアクセスします。

function.json ファイルのバインドの name パラメーターで指定されている名前と一致するパラメーターを使用して、BLOB データにアクセスします。

InputStream に型指定したパラメーターを使用して BLOB データにアクセスします。詳細については、「入力 - 例」を参照してください。

Functions では、Azure Blob Storage の Python SDK 型バインドもサポートされています。これにより、基になる SDK の種類を使用して BLOB データを操作できます。

重要

Python の SDK の種類のサポートは現在プレビュー段階であり、Python v2 プログラミングモデルでのみサポートされています。詳細については、Python の SDK 型を参照してください。

接続

connection プロパティは、アプリを Azure BLOB に接続する方法を指定する環境構成への参照です。次が指定される場合があります。

接続文字列を含むアプリケーション設定の名前
まとめて ID ベースの接続を定義する、複数のアプリケーション設定の共有プレフィックスの名前。

構成された値が、1 つの設定に完全一致し、プレフィックスがその他の設定とも一致する場合は、完全一致が使用されます。

接続文字列

接続文字列を取得するには、「ストレージアカウントアクセスキーを管理する」の手順に従います。接続文字列は、BLOB ストレージアカウントではなく汎用ストレージアカウントに対するものである必要があります。

この接続文字列は、バインディング構成の connection プロパティで指定した値と同じ名前のアプリケーション設定に格納する必要があります。

アプリ設定の名前が "AzureWebJobs" で始まる場合は、ここで名前の残りの部分のみを指定できます。たとえば、connection を "MyStorage" に設定した場合、Functions ランタイムは "AzureWebJobsMyStorage" という名前のアプリ設定を探します。 connection を空のままにした場合、Functions ランタイムは、アプリ設定内の AzureWebJobsStorage という名前の既定のストレージ接続文字列を使用します。

ID ベースの接続

バージョン 5.x 以上の拡張機能を使用している場合 (non-.NET 言語スタックの場合は bundle 3.x 以上)、シークレットで接続文字列を使用する代わりに、アプリで Microsoft Entra ID を使用できます。 ID を使用するには、トリガーとバインドの構成の connection プロパティにマップされる共通のプレフィックスに設定を定義します。

connection を "AzureWebJobsStorage" に設定する場合は、「ID を使用してホストストレージに接続する」を参照してください。その他のすべての接続では、拡張機能に次のプロパティが必要です。

プロパティ	環境変数テンプレート	説明	値の例
Blob Service の URI	`<CONNECTION_NAME_PREFIX>__serviceUri`¹	HTTPS スキームを使用して接続している BLOB サービスのデータプレーン URI。	https://<storage_account_name>.blob.core.windows.net

¹ <CONNECTION_NAME_PREFIX>__blobServiceUri はエイリアスとして使用できます。接続構成が BLOB トリガーによって使用される場合、blobServiceUri には queueServiceUri も指定する必要があります。以下を参照してください。

全体の接続構成が BLOB、キュー、テーブル間で使用される場合、serviceUri 形式は指定できません。 URI では BLOB サービスのみを指定できます。別の方法として、サービスごとに専用の URI を指定して、1 つの接続を使用できるようにすることができます。両方のバージョンが指定された場合、マルチサービス形式が使用されます。複数のサービス用の接続を構成するには、<CONNECTION_NAME_PREFIX>__serviceUri の代わりに次を設定します。

プロパティ	環境変数テンプレート	説明	値の例
Blob Service の URI	`<CONNECTION_NAME_PREFIX>__blobServiceUri`	HTTPS スキームを使用して接続している BLOB サービスのデータプレーン URI。	https://<storage_account_name>.blob.core.windows.net
Queue Service URI (BLOB トリガーに必要²)	`<CONNECTION_NAME_PREFIX>__queueServiceUri`	HTTPS スキームを使用したキューサービスのデータプレーン URI。この値は、BLOB トリガーにのみ必要です。	https://<storage_account_name>.queue.core.windows.net

² BLOB トリガーは、複数回にわたる再試行の失敗を、有害な BLOB をキューに書き込むことで処理します。 serviceUri 形式では、AzureWebJobsStorage 接続が使用されます。ただし、blobServiceUri を指定する場合は、queueServiceUri でキューサービス URI も指定する必要があります。 BLOB サービスと同じストレージアカウントからサービスを使用することをお勧めします。また、トリガーでは、ストレージキューデータ共同作成者のようなロールを割り当てて、構成されたキューサービスのメッセージを読み書きできるようにする必要があります。

接続をカスタマイズするには、他のプロパティを設定します。「ID ベース接続に共通のプロパティ」を参照してください。

Azure Functions サービスでホストされている場合、ID ベースの接続では、マネージド ID が使用されます。ユーザー割り当て ID を credential および clientID プロパティで指定できますが、システム割り当て ID が既定で使用されます。リソース ID を使用したユーザー割り当て ID の構成はサポートされていないことに注意してください。ローカル開発などの他のコンテキストで実行する場合は、代わりに開発者 ID が使用されますが、カスタマイズすることもできます。 ID ベースの接続によるローカル開発に関するページをご覧ください。

ID にアクセス許可を付与する

使用されている ID が何であれ、目的のアクションを実行するためのアクセス許可が必要です。ほとんどの Azure では、これはそれらのアクセス許可を提供する組み込みロールまたはカスタムロールを使って、Azure RBAC でロールを割り当てる必要があることを意味します。

重要

すべてのコンテキストに必要ではない一部のアクセス許可がターゲットサービスによって公開される場合があります。可能であれば、最小限の特権の原則に従い、必要な特権だけを ID に付与します。たとえば、アプリがデータソースからの読み取りのみを行う必要がある場合は、読み取りアクセス許可のみを持つロールを使用します。サービスへの書き込みも可能なロールを割り当てることは、読み取り操作に対するアクセス許可が過剰になるため、不適切です。同様に、ロールの割り当てが、読み取る必要のあるリソースだけに限定されていることを確認する必要があります。

実行時に BLOB コンテナーへのアクセスを提供するロールの割り当てを作成する必要があります。所有者のような管理ロールでは十分ではありません。次の表は、通常の操作で Blob Storage の拡張機能を使用するときに推奨される組み込みロールを示しています。アプリケーションでは、記述したコードに基づいて追加のアクセス許可が必要になる場合があります。

[バインドの種類]	組み込みロールの例
トリガー	ストレージ BLOB データ所有者およびストレージキューデータ共同作成者¹ AzureWebJobsStorage 接続にも追加のアクセス許可を付与する必要があります。²
入力バインド	ストレージ BLOB データ閲覧者
出力バインド	ストレージ BLOB データ所有者

¹ BLOB トリガーは、複数回にわたる再試行の失敗を、接続によって指定されたストレージアカウント上のキューに有害な BLOB を書き込むことにより処理します。

² AzureWebJobsStorage 接続は、トリガーを有効にする BLOB やキューのために内部的に使用されます。 ID ベースの接続を使用するように構成されている場合は、既定の要件を超える追加のアクセス許可が必要になります。必要なアクセス許可は、ストレージ BLOB データ所有者、ストレージキューデータ共同作成者、およびストレージアカウント共同作成者の各ロールによって満たされます。詳細については、「ID を使用してホストストレージに接続する」を参照してください。

次の方法で共有

Azure Functions における Azure Blob Storage の入力バインド

例

HTTP トリガー、クエリ文字列から BLOB を検索する

キュートリガー、キューメッセージから BLOB 名前を受け取る

属性

デコレーター

注釈

構成

使用法

接続

接続文字列

ID ベースの接続

ID にアクセス許可を付与する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Functions における Azure Blob Storage の入力バインド

例

HTTP トリガー、クエリ文字列から BLOB を検索する

キュー トリガー、キュー メッセージから BLOB 名前を受け取る

属性

デコレーター

注釈

構成

使用法

接続

接続文字列

ID ベースの接続

ID にアクセス許可を付与する

次のステップ

フィードバック

その他のリソース

キュートリガー、キューメッセージから BLOB 名前を受け取る