Azure Functions でのトリガーとバインドの概念

HTTP トリガー (HttpTrigger) は、MultiResponse オブジェクトを返す HttpExample という名前の関数の Run メソッドで定義されます。

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)
{

この例では、MultiResponse オブジェクト定義を示します。このオブジェクト定義は、HTTP 要求に HttpResponse を返し、QueueOutput バインドを使用してストレージ キューにもメッセージを書き込みます。

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public HttpResponseData HttpResponse { get; set; }
}

詳細については、「C# 分離ワーカー モデル ガイド」を参照してください。

HTTP トリガー (HttpTrigger) は、HttpExample という名前の関数のために Run メソッドで定義されます。この関数は、Queue および msg パラメーターの StorageAccount 属性で定義されたストレージ キューへの書き込みを行います。

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, 
    [Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg, 
    ILogger log)
{

詳細については、「C# インプロセス モデル ガイド」を参照してください。

関数用の Node.js のバージョン 4 では、@azure/functions モジュールからエクスポートされたオブジェクトを使用してトリガーとバインドを構成します。 詳細については、 「Node.js 開発者ガイド」を参照してください。

関数用の Node.js のバージョン 3 では、コードと同じフォルダー内にある関数固有の function.json ファイルでトリガーとバインドを構成します。 詳細については、 「Node.js 開発者ガイド」を参照してください。

エクスポートされた app オブジェクトの http メソッドは HTTP トリガーを定義し、output の storageQueue メソッドはこのトリガーの出力バインドを定義します。

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

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: async (request, context) => {
        const body = await request.text();
        context.extraOutputs.set(queueOutput, body);
        return { body: 'Created queue item.' };
    },
});

この例の function.json ファイルは、HTTP 応答を返し、ストレージ キューに書き込む HTTP トリガー関数を定義します。

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

エクスポートされた app オブジェクトの http メソッドは HTTP トリガーを定義し、output の storageQueue メソッドはこのトリガーの出力バインドを定義します。

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

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

export async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    const body = await request.text();
    context.extraOutputs.set(queueOutput, body);
    return { body: 'Created queue item.' };
}

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: httpTrigger1,
});

この例の function.json ファイルは、HTTP 応答を返し、ストレージ キューに書き込む HTTP トリガー関数を定義します。

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

関数用の Python のバージョン 2 では、デコレーターを使用してコードで関数を直接定義します。

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)

@app.route(route="HttpExample")
@app.queue_output(arg_name="msg", queue_name="outqueue", connection="AzureWebJobsStorage")
def HttpExample(req: func.HttpRequest, msg: func.Out [func.QueueMessage]) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

関数用の Python のバージョン 1 では、この例の function.json ファイルは、HTTP 応答を返し、ストレージ キューに書き込む HTTP トリガー関数を定義します。

    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}