演習 - 入力バインディングと出力バインディングの種類を確認する

パラメーター req は "トリガー バインディング" であり、パラメーター res は "出力バインディング" です。 これらのパラメーターは、"要求" と "応答" の省略形と考えるとわかりやすくなります。

パラメーター Request は "トリガー バインディング" であり、パラメーター Response は "出力バインディング" です。

1. サンドボックスのアクティブ化に使ったアカウントを使って、Azure portal にサインインします。

2. リソース メニューで、または [ホーム] ページから、[リソースの作成] を選択します。 [リソースの作成] ウィンドウが表示されます。

3. [リソースの作成] メニューの [計算] を選択し、結果の一覧で [関数アプリ] を選択します。 [サービスとマーケットプレースの検索] ウィンドウで「Function App」を検索することが必要になる場合があります。

4. [従量課金] を選択し、[選択] ボタンを選択します。 [関数アプリの作成] ウィンドウが表示されます。

5. [基本] タブで、各設定に対して次の値を入力します。

   設定	値	説明
   プロジェクトの詳細
   サブスクリプション	コンシェルジェ サブスクリプション	この演習に使用する Azure サブスクリプション。
   リソース グループ	ドロップダウン リストから、[サンドボックス リソース グループ名] を選択します	サンドボックスのリソース グループ。
   インスタンスの詳細
   関数アプリ名	"グローバルに一意な名前" を入力します	この名前が、新しい関数アプリを示します。 有効な文字は、a-z、0-9、および - です。
   ランタイム スタック	ドロップダウン リストから、[Node.js] を選択します。	このモジュールのサンプル コードは、JavaScript で記述されています。
   Version	"既定値" をそのまま使用します。	この演習では既定値で十分です。
   リージョン	ドロップダウン リストから、[場所] を選択します	最寄りのリージョンを選択します。

6. 他のすべてのオプションについては、既定値をそのまま使用します。 [確認と作成] を選択して設定を検証し、[作成] を選択して関数アプリをプロビジョニングし、デプロイします。

7. デプロイには時間がかかることがあります。 アカウント名の横にあるグローバル コントロールで、[通知] アイコンを選択し、[デプロイに成功しました] メッセージを監視します。

8. 関数のデプロイが完了したら、[リソースに移動] を選択します。 関数アプリの [概要] ペインが表示されます。

1. サンドボックスのアクティブ化に使ったのと同じアカウントを使って、Azure portal にサインインします。

2. リソース メニューで、または [ホーム] ページから、[リソースの作成] を選択します。 [リソースの作成] ウィンドウが表示されます。

3. [リソースの作成] メニューの [計算] を選択し、結果の一覧で [関数アプリ] を選択します。 [サービスとマーケットプレースの検索] ウィンドウで「Function App」を検索することが必要になる場合があります。

4. [従量課金] を選択し、[選択] ボタンを選択します。 [関数アプリの作成] ウィンドウが表示されます。

5. [基本] タブで、各設定に対して次の値を入力します。

   設定	値	説明
   プロジェクトの詳細
   サブスクリプション	コンシェルジェ サブスクリプション	この演習に使用する Azure サブスクリプション。
   リソース グループ	ドロップダウン リストから、[サンドボックス リソース グループ名] を選択します	サンドボックスのリソース グループ。
   インスタンスの詳細
   関数アプリ名	"グローバルに一意な名前" を入力します	この名前が、新しい関数アプリを示します。 有効な文字は、a-z、0-9、および - です。
   ランタイム スタック	ドロップダウン リストから [PowerShell Core] を選択します。	このモジュールのサンプル コードは、PowerShell で記述されています。
   Version	"既定値" をそのまま使用します。	この演習では既定値で十分です。
   リージョン	ドロップダウン リストから、[場所] を選択します	最寄りのリージョンを選択します。

6. 他のすべてのオプションについては、既定値をそのまま使用します。 [確認と作成] を選択して入力を検証し、[作成] を選択して関数アプリをプロビジョニングし、デプロイします。

7. デプロイには時間がかかることがあります。 アカウント名の横にあるグローバル コントロールで、[通知] アイコンを選択し、[デプロイに成功しました] メッセージを監視します。

8. 関数のデプロイが完了したら、[リソースに移動] を選択します。 関数アプリの [概要] ペインが表示されます。

関数アプリを用意できたので、ここでは関数を作成しましょう。 各関数には、それをアクティブにするトリガーがあります。 このモジュールでは、定義済みのテンプレートを使用して HTTP トリガーを定義します。

1. [概要] ページの [関数] タブの [Azure portal で作成] で [関数を作成] ボタンを選択します。

2. [関数の作成] ペインが表示されます。

   

3. [テンプレートの選択] セクションで、[HTTP トリガー] テンプレートを選択し、[次へ] を選択します。

4. [テンプレートの詳細] セクションで次の設定を確認します。

   • [関数名] テキスト ボックスでは、既定の名前 HttpTrigger1 をそのまま使用します。 作成する関数には、Azure によって、一意の名前が自動的に作成されます。 異なる名前を選択することもできますが、わかりやすい名前を使用するようにしてください。

   • [承認レベル] テキスト ボックスでは、既定値 [関数] をそのまま使用します。 承認レベルによって、関数を実行するために要求で提示する必要があるキーが決まります。 "関数" の承認レベルには、関数固有のキーが必要です。このキーは関数作成後に確認できます。

5. ［作成］ を選択します ご利用の関数アプリにトリガー関数が伝達されると、その "関数アプリ" の[関数] ペインが開き、HttpTrigger1 が一覧表示されます。

6. コマンド バーで、[関数の URL の取得] を選択します。 [関数の URL の取得] ダイアログ ボックスが表示されます。

7. ドロップダウン リストで [既定値 (関数キー)] を選択し、URL の最後にある [クリップボードにコピー] アイコンを選択してから、[OK] を選択してダイアログを閉じます。

8. ブラウザーの新しいタブのアドレス バーに、コピーした関数の URL を貼り付けます。 Enter キーを押して、ブラウザーで要求を実行します。 関数アプリの初期化のため、応答には数分かかる場合があります。 タイムアウト エラーが発生した場合は、更新して要求を再送信します。

   関数が応答すると、次の例のような出力がブラウザーに表示されます。

   This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.
   

9. 次のクエリ文字列 &name=Joe を URL の末尾に追加します。 結果の URL は次の例のようになります。

   https://example.azurewebsites.net/api/HttpTrigger1?code=AbCdEfGhIjKlMnOpQrStUvWxYz==&name=Joe

10. Enter キーを押して、ブラウザーで要求を実行します。 関数が応答すると、次の例のような出力がブラウザーに表示されます。

    Hello, Joe. This HTTP triggered function executed successfully.
    

    ここまでの演習からわかるように、関数を作成するときにトリガーを定義する必要があります。 関数ごとにトリガーが 1 つあります。 この例では HTTP トリガーを使用しています。つまり、この関数は HTTP 要求を受信すると起動します。 次のスクリーンショットに JavaScript で示されているテンプレートの既定の実装では、クエリ文字列または要求の本文内にあったパラメーター name の値が返されます。 クエリ文字列が指定されていない場合、関数は呼び出し元に対して名前値を指定するよう求めるメッセージで応答します。

    

11. Azure portal の [関数] メニューで、[Code + Test](コードとテスト) を選択します。

    関数の [コードとテスト] ペインが表示され、index.js ファイルの内容が表示されます。 関数の既定の JavaScript コードは、次の例のようになります。

    module.exports = async function (context, req) {
        context.log('JavaScript HTTP trigger function processed a request.');
    
        const name = (req.query.name || (req.body && req.body.name));
        const responseMessage = name
            ? "Hello, " + name + ". This HTTP triggered function executed successfully."
            : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";
    
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: responseMessage
        };
    }
    

12. では、関数のもう 1 つのファイルである function.json 構成ファイルを簡単に見てみましょう。 このファイルにアクセスするには、コード ブロックの上にあるファイルパスのドロップダウン リストから function.json を選択します。 次の JSON の一覧に、この構成データが示されています。

    {
        "bindings": [
        {
            "authLevel": "function",
            "type": "httpTrigger",
            "direction": "in",
            "name": "req",
            "methods": [
            "get",
            "post"
            ]
        },
        {
            "type": "http",
            "direction": "out",
            "name": "res"
        }
      ]
    }
    

    この関数には、種類が httpTrigger である req という名前の "トリガー バインディング" と、種類が http である res という名前の出力バインディングが含まれています。

この関数の前述のコードで、req パラメーターを介して着信 HTTP 要求のペイロードにアクセスすることを確認しました。 同様に、res パラメーターを設定して HTTP 応答を送信しました。 このようにバインディングを使用すると、面倒な作業の一部が自動的に行われます。

関数アプリを用意できたので、次に関数を作成しましょう。 各関数には、それをアクティブにするトリガーがあります。 このモジュールでは、テンプレートを使用して HTTP トリガーを作成します。

1. [概要] ページの [関数] タブの [Azure portal で作成] で [関数を作成] ボタンを選択します。

2. [関数の作成] ペインが表示されます。

3. [テンプレートの選択] セクションで、[HTTP トリガー] テンプレートを選択し、[次へ] を選択します。

4. [テンプレートの詳細] セクションで次の設定を確認します。

   • [関数名] テキスト ボックスでは、既定の名前 HttpTrigger1 をそのまま使用します。 関数を作成すると、Azure によって、一意の名前が自動的に提供されます。 異なる名前を選択することもできますが、わかりやすい名前を使用するようにしてください。

   • [承認レベル] テキスト ボックスでは、既定値 [関数] をそのまま使用します。 承認レベルによって、関数を実行するために要求で提示する必要があるキーが決まります。 [関数] の場合は、関数固有のキーが必要です。

     

5. ［作成］ を選択します "関数" の [HttpTrigger1] ペインが表示されます。

6. コマンド バーで、[関数の URL の取得] を選択します。 [関数の URL の取得] ダイアログ ボックスが表示されます。

7. ドロップダウン リストで [既定値 (関数キー)] を選択し、URL の最後にある [クリップボードにコピー] アイコンを選択してから、[OK] を選択してダイアログ ボックスを閉じます。

8. ブラウザーの新しいタブのアドレス バーに、コピーした関数の URL を貼り付けます。 Enter キーを押して、ブラウザーで要求を実行します。 関数アプリの初期化のため、応答には数分かかる場合があります。 タイムアウト エラーが発生した場合は、更新して要求を再送信します。

   関数が応答すると、次の例のような出力がブラウザーに表示されます。

   This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.
   

9. URL の末尾にクエリ文字列 &name=Joe を追加します。 結果の URL は次の例のようになります。

   https://example.azurewebsites.net/api/HttpTrigger1?code=AbCdEfGhIjKlMnOpQrStUvWxYz==&name=Joe

10. Enter キーを押して、ブラウザーで要求を実行します。 関数が応答すると、次の例のような出力がブラウザーに表示されます。

    Hello, Joe. This HTTP triggered function executed successfully.
    

    ここまでの演習からわかるように、関数を作成するときにトリガーを定義する必要があります。 関数ごとにトリガーが 1 つあります。 この例では HTTP トリガーを使用しています。つまり、この関数は HTTP 要求を受信すると起動します。 次のスクリーンショットに PowerShell で示されているテンプレートの既定の実装では、Push-OutputBinding コマンドレットを使用して、クエリ文字列または要求の本文に含まれていたパラメーター名の値で応答されます。 文字列が指定されていない場合、関数により、呼び出し元に対して名前値を指定するよう求めるメッセージで応答が行われます。

    

11. [関数] メニューで、[Code + Test](コードとテスト) を選択します。 関数の [コードとテスト] ペインが表示され、run.ps1 ファイルの内容が表示されます。

    関数の既定の PowerShell コードは、次の例のようになります。

    using namespace System.Net
    
    # Input bindings are passed in via param block.
    param($Request, $TriggerMetadata)
    
    # Write to the Azure Functions log stream.
    Write-Host "PowerShell HTTP trigger function processed a request."
    
    # Interact with query parameters or the body of the request.
    $name = $Request.Query.Name
    if (-not $name) {
        $name = $Request.Body.Name
    }
    
    $body = "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."
    
    if ($name) {
        $body = "Hello, $name. This HTTP triggered function executed successfully."
    }
    
    # Associate values to output bindings by calling 'Push-OutputBinding'.
    Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
        StatusCode = [HttpStatusCode]::OK
        Body = $body
    })
    

12. では、関数のもう 1 つのファイルである function.json 構成ファイルを簡単に見てみましょう。 このファイルに開くには、ファイルパスのドロップダウン リストから function.json を選択します。 次の JSON の一覧に、この構成データが示されています。

    {
      "bindings": [
        {
          "authLevel": "function",
          "type": "httpTrigger",
          "direction": "in",
          "name": "Request",
          "methods": [
            "get",
            "post"
          ]
        },
        {
          "type": "http",
          "direction": "out",
          "name": "Response"
        }
      ]
    }
    

    ご覧のように、この関数には、httpTrigger 型の Request という名前のトリガー バインディングと、http 型の Response という名前の出力バインディングが含まれています。 この関数の前述のコードで、Request パラメーターを介して着信 HTTP 要求のペイロードにアクセスする方法を確認しました。 同様に、Response パラメーターを設定して HTTP 応答を送信しました。 このようにバインディングを使用すると、面倒な作業の一部が自動的に行われます。

1. [関数] メニューで、[コードとテスト] を選択します。 関数の [統合] ペインが表示されます。

   次の図に示すように、トリガーと出力バインディングは既に定義されていることに注意してください。 統合ビューは、ご利用の画面の幅と高さに最適なサイズに調整されます。 画面の幅が十分であれば、同じ情報を横方向に表示することもできます。

   

   また、"複数の" トリガーを追加できないこともわかります。 関数のトリガーを変更するには、トリガーを削除して新しいトリガーを作成する必要があります。 ただし、[入力] および [出力] セクションでは複数のバインディングを追加できるため、要求で、複数の入力値を受け取り、複数の出力値を返すことができます。

2. [入力] ボックスで、[入力の追加] を選択します。 [入力の作成] ペインが表示されます。 [バインドの種類] のドロップダウン リストを選択すると、使用できるすべての入力バインディングの種類の一覧が表示されます。

   

   少し時間をとって、ソリューションでこれらの各入力バインディングを使用する方法について考えてみましょう。

   このモジュールの後半で入力バインディングを追加しますが、ここでは [キャンセル] を選択してこのウィンドウを閉じます。

3. [出力] ボックスで [出力の追加] を選択します。 [出力の作成] ペインが表示されます。 [バインドの種類] のドロップダウン リストを選択すると、使用できるすべての出力バインドの種類の一覧が表示されます。

   

   ご覧のように、出力バインディングの種類は複数あります。 このモジュールの後半で出力バインディングを追加しますが、ここでは [キャンセル] を選択してこのウィンドウを閉じます。

1. [関数] メニューで、[コードとテスト] を選択します。 関数の [統合] ペインが表示されます。

   次の図に示すように、トリガーと出力バインディングは既に定義されていることに注意してください。 統合ビューは、ご利用の画面の幅と高さに最適なサイズに調整されます。 画面の幅が十分ではない場合は、同じ情報を垂直方向に表示できます。

   

   また、"複数の" トリガーを追加できないこともわかります。 関数のトリガーを変更するには、トリガーを削除して新しいトリガーを作成する必要があります。 ただし、[入力] および [出力] セクションでは複数のバインディングを追加できるため、関数で、複数の入力値を受け取り、複数の出力値を返すことができます。

2. [入力] ボックスで、[入力の追加] を選択します。 [入力の作成] ペインが表示されます。 [バインドの種類] のドロップダウン リストを選択すると、使用できるすべての入力バインディングの種類の一覧が表示されます。

   

   少し時間をとって、ソリューションでこれらの各入力バインディングを使用する方法について考えてみましょう。 選択できる方法は多数あります。

   このモジュールの後半で入力バインディングを追加しますが、ここでは [キャンセル] を選択してこのウィンドウを閉じます。

3. [出力] ボックスで [出力の追加] を選択します。 [出力の作成] ペインが表示されます。 [バインドの種類] のドロップダウン リストを選択すると、使用できるすべての出力バインドの種類の一覧が表示されます。

   

   ご覧のように、出力バインディングの種類は複数あります。 このモジュールの後半で出力バインディングを追加しますが、ここでは [キャンセル] を選択してこのウィンドウを閉じます。