Blob Storage でトリガーされる Azure 関数の作成
Blob Storage コンテナーでファイルをアップロードしたり、更新したりするときにトリガーされる関数の作成方法について説明します。
Note
ポータル内編集は、JavaScript、PowerShell、および C# スクリプト関数でのみサポートされます。 Python のポータル内編集は、従量課金プランで実行されている場合にのみサポートされます。 可能であれば、関数をローカルで開発する必要があります。
Azure portal での関数コードの編集に関する制限事項の詳細については、Azure portal での開発の制限事項に関するページを参照してください。
前提条件
- Azure サブスクリプション。 お持ちでない場合は、開始する前に無料アカウントを作成してください。
Azure Function App の作成
Azure portal のメニューまたは [ホーム] ページから [リソースの作成] を選択します。
[新規] ページで、 [計算]>、 [関数アプリ] の順に選択します。
[基本] ページで、下の表に指定されている関数アプリの設定を使用します。
設定 提案された値 説明 サブスクリプション 該当するサブスクリプション 新しい関数アプリを作成するサブスクリプション。 リソース グループ myResourceGroup 関数アプリを作成する新しいリソース グループの名前。 既存のリソース グループに新しい関数アプリを作成する際の既知の制限があるため、新しいリソース グループを作成する必要があります。 関数アプリ名 グローバルに一意の名前 新しい関数アプリを識別する名前。 有効な文字は、 a-z(大文字と小文字の区別をしない)、0-9、および-です。コードまたはコンテナー イメージをデプロイしますか? コード コード ファイルまたは Docker コンテナーの発行オプション。 ランタイム スタック 優先言語 お気に入りの関数プログラミング言語をサポートするランタイムを選択します。 ポータル内編集は、JavaScript、PowerShell、Python、TypeScript、C# スクリプトでのみ利用できます。 C# クラス ライブラリ、Java の関数はローカルで開発する必要があります。 バージョン バージョン番号 インストールされているランタイムのバージョンを選択します。 リージョン 優先リージョン 自分の近く、または関数がアクセスできる他のサービスの近くのリージョンを選択します。 オペレーティング システム Windows オペレーティング システムは、ランタイム スタックの選択に基づいてあらかじめ選択されますが、必要に応じて設定を変更できます。 ポータルでの編集は Windows でのみサポートされます。 コンテナーの発行は Linux でのみサポートされています。 ホスティング オプションとプラン 従量課金プラン (サーバーレス) 関数アプリにどのようにリソースが割り当てられるかを定義するホスティング プラン。 既定の [従量課金プラン] では、リソースは関数の必要に応じて動的に追加されます。 このサーバーレスのホスティングでは、関数が実行された時間にのみ課金されます。 Premium プランでは、動的スケーリングも提供されます。 App Service プランで実行する場合は、関数アプリのスケーリングを管理する必要があります。 [ストレージ] タブで新しいストレージ アカウントを作成し、[監視] タブで新しい Application Insight インスタンスを作成する既定のオプションを受け入れます。既存のストレージ アカウントまたは Application Insights インスタンスを使用することもできます。
[確認と作成] を選択して選択したアプリ設定をレビューし、[作成] を選択して関数アプリをプロビジョニングおよびデプロイします。
ポータルの右上隅の [通知] アイコンを選択し、"デプロイメントに成功しました" というメッセージが表示されるまで待ちます。
[リソースに移動] を選択して、新しい関数アプリを確認します。 また、 [ダッシュボードにピン留めする] を選択することもできます。 ピン留めすると、ダッシュボードからこの関数アプリ リソースに戻るのが容易になります。
これで、新しい関数アプリを作成できました。
次に、新しい Function App で関数を作成します。
Azure Blob Storage でトリガーされる関数の作成
関数アプリで [概要] を選択し、[関数] で [+ 作成] を選択します。
[テンプレートの選択] で下にスクロールし、Azure Blob Storage トリガー テンプレートを選択します。
[テンプレートの詳細] で、次の表に示すように設定を使用して新しいトリガーを構成し、[作成] を選択します。
設定 提案された値 説明 新規関数 Function App 内で一意 この BLOB によってトリガーされる関数の名前。 パス samples-workitems/{name} 監視されている Blob Storage ストレージ内の位置。 Blob のファイル名は、name パラメーターとしてバインディングで渡されます。 ストレージ アカウント接続 AzureWebJobsStorage Function App によって既に使用されているストレージ アカウント接続を使用するか、新しく作成できます。 Azure では、指定された値に基づいて Blob Storage によってトリガーされる関数が作成されます。
次に、samples-workitems コンテナーを作成します。
コンテナーの作成
関数の [概要] ページで、リソース グループを選択します。
リソース グループのストレージ アカウントを見つけて、選択します。
[コンテナー] を選択し、 [+ コンテナー] を選択します。
[名前] フィールドに「
samples-workitems」と入力して、 [作成] を選択します。
Blob コンテナーが用意されているので、このコンテナーにファイルをアップロードすることによって、関数をテストできます。
関数をテストする
Azure Portal に戻り、関数を参照して、ページ下部の [ログ] を展開して、ログ ストリーミングが一時停止していないことを確認します。
別のブラウザー ウィンドウで、Azure portal のリソース グループに移動して、ストレージ アカウントを選択します。
[コンテナー] を選択し、samples-workitems コンテナーを選択します。
[アップロード] を選択し、フォルダー アイコンを選択して、アップロードするファイルを選択します。
画像ファイルなど、ローカル コンピューター上のファイルを参照して、そのファイルを選択します。 [開く] 、 [アップロード] の順に選択します。
関数ログに戻り、Blob が読み取られたことを確認します。
Note
既定の従量課金プランで Function App を実行する場合、Blob が追加されたり更新されてから関数がトリガーされるまで、最高数分間の遅延が生じることがあります。 Blob でトリガーされた関数で待機時間を短くする必要がある場合は、App Service プランで Function App を実行することを検討してください。
リソースをクリーンアップする
このコレクションの他のクイックスタートは、このクイックスタートに基づいています。 クイック スタート、チュートリアル、またはこのクイック スタートで作成したサービスのいずれかでの作業を引き続き行う場合は、リソースをクリーンアップしないでください。
Azure の "リソース" とは、関数アプリ、関数、ストレージ アカウントなどのことを指します。 これらは "リソース グループ" に分類されており、グループを削除することでグループ内のすべてのものを削除できます。
これで、これらのクイックスタートを完了するためのリソースが作成されました。 アカウントの状態とサービスの価格によっては、これらのリソースに対して課金される可能性があります。 リソースの必要がなくなった場合にそれらを削除する方法を、次に示します。
Azure Portal で、 [リソース グループ] ページに移動します。
関数アプリ ページからこのページに移動するには、[概要] タブを選択し、[リソース グループ] の下にあるリンクを選択します。
ダッシュボードからこのページに移動するには、 [リソース グループ] を選択してから、この記事用に使用したリソース グループを選択します。
[リソース グループ] ページで、含まれているリソースの一覧を確認し、削除するものであることを確認します。
[リソース グループの削除] を選択し、指示に従います。
削除には数分間かかることがあります。 実行されると、通知が数秒間表示されます。 ページの上部にあるベルのアイコンを選択して、通知を表示することもできます。
次のステップ
Blob Storage で Blob が追加または更新されたときに実行する関数を作成しました。 Blob Storage トリガーの詳細については、「Azure Functions における Blob Storage バインディング」を参照してください。
最初の関数を作成した後は、メッセージを Storage キューに書き込む出力バインディングをこの関数に追加しましょう。