クイックスタート: Azure Functions を使用してスケーラブルな Web API を構築する

このクイックスタートでは、Azure Developer コマンドラインツールを使用して、HTTP 要求に応答する関数エンドポイントを含むスケーラブルな Web API を構築します。コードをローカルでテストした後、Azure Functions の Flex 従量課金プランで実行して作成した新しいサーバーレス関数アプリにデプロイします。

プロジェクトソースでは、Azure へのコードのデプロイを簡略化するために Azure Developer CLI (azd) が使用されます。このデプロイは、セキュリティで保護されたスケーラブルな Azure Functions デプロイの最新のベストプラクティスに従います。

既定では、Flex 従量課金プランは 従量課金 制の課金モデルに従います。つまり、このクイックスタートを完了すると、Azure アカウントで数 USD セント以下の小さなコストが発生します。

Prerequisites

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure Developer CLI
Azure Functions Core Tools

Java 17 Developer Kit
- 別のサポートされているバージョンの Java を使用する場合は、プロジェクトの pom.xml ファイルを更新する必要があります。
- JAVA_HOME環境変数は、Java Development Kit (JDK) の正しいバージョンのインストール場所に設定する必要があります。
Apache Maven 3.8.x

Node.js 20

JSON ペイロードを含む要求を関数エンドポイントに送信するための安全な HTTP テストツール。この記事では、curl を使用します。

プロジェクトを初期化する

azd init コマンドを使用して、テンプレートからローカル Azure Functions コードプロジェクトを作成します。

ローカルターミナルまたはコマンドプロンプトで、空のフォルダーで次の azd init コマンドを実行します。
```
azd init --template functions-quickstart-dotnet-azd -e httpendpoint-dotnet
```
このコマンドは、テンプレートリポジトリからプロジェクトファイルをプルし、現在のフォルダー内のプロジェクトを初期化します。 -e フラグでは、現在の環境の名前が設定されます。 azdでは、環境はアプリの一意のデプロイコンテキストを維持し、複数を定義できます。これは、Azure で作成するリソースグループの名前でも使用されます。
次のコマンドを実行して、http アプリフォルダーに移動します。
```
cd http
```
次の JSON データを含むフォルダーにlocal.settings.jsonという名前のファイルを作成します。
```
{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
    }
}
```
このファイルは、ローカルで実行する場合に必要です。

ローカルターミナルまたはコマンドプロンプトで、空のフォルダーで次の azd init コマンドを実行します。
```
azd init --template azure-functions-java-flex-consumption-azd -e httpendpoint-java 
```
このコマンドは、テンプレートリポジトリからプロジェクトファイルをプルし、現在のフォルダー内のプロジェクトを初期化します。 -e フラグでは、現在の環境の名前が設定されます。 azdでは、環境はアプリの一意のデプロイコンテキストを維持し、複数を定義できます。これは、Azure で作成するリソースグループの名前でも使用されます。
次のコマンドを実行して、http アプリフォルダーに移動します。
```
cd http
```
次の JSON データを含むフォルダーにlocal.settings.jsonという名前のファイルを作成します。
```
{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "java"
    }
}
```
このファイルは、ローカルで実行する場合に必要です。

ローカルターミナルまたはコマンドプロンプトで、空のフォルダーで次の azd init コマンドを実行します。
```
azd init --template functions-quickstart-javascript-azd -e httpendpoint-js
```
このコマンドは、テンプレートリポジトリからプロジェクトファイルをプルし、ルートフォルダー内のプロジェクトを初期化します。 -e フラグでは、現在の環境の名前が設定されます。 azdでは、環境はアプリの一意のデプロイコンテキストを維持し、複数を定義できます。これは、Azure で作成するリソースグループの名前でも使用されます。
次の JSON データを含む local.settings.json という名前のファイルをルートフォルダーに作成します。
```
{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "node"
    }
}
```
このファイルは、ローカルで実行する場合に必要です。

ローカルターミナルまたはコマンドプロンプトで、空のフォルダーで次の azd init コマンドを実行します。
```
azd init --template functions-quickstart-powershell-azd -e httpendpoint-ps
```
このコマンドは、テンプレートリポジトリからプロジェクトファイルをプルし、ルートフォルダー内のプロジェクトを初期化します。 -e フラグでは、現在の環境の名前が設定されます。 azdでは、環境はアプリの一意のデプロイコンテキストを維持し、複数を定義できます。これは、Azure で作成するリソースグループの名前でも使用されます。
次のコマンドを実行して、src アプリフォルダーに移動します。
```
cd src
```

次の JSON データを含むフォルダーにlocal.settings.jsonという名前のファイルを作成します。

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "powershell",
        "FUNCTIONS_WORKER_RUNTIME_VERSION": "7.2"
    }
}

このファイルは、ローカルで実行する場合に必要です。

ローカルターミナルまたはコマンドプロンプトで、空のフォルダーで次の azd init コマンドを実行します。
```
azd init --template functions-quickstart-typescript-azd -e httpendpoint-ts
```
このコマンドは、テンプレートリポジトリからプロジェクトファイルをプルし、ルートフォルダー内のプロジェクトを初期化します。 -e フラグでは、現在の環境の名前が設定されます。 azdでは、環境はアプリの一意のデプロイコンテキストを維持し、複数を定義できます。環境名は、Azure で作成するリソースグループの名前にも使用されます。
次の JSON データを含む local.settings.json という名前のファイルをルートフォルダーに作成します。
```
{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "node"
    }
}
```
このファイルは、ローカルで実行する場合に必要です。

ローカルターミナルまたはコマンドプロンプトで、空のフォルダーで次の azd init コマンドを実行します。
```
azd init --template functions-quickstart-python-http-azd -e httpendpoint-py
```
このコマンドは、テンプレートリポジトリからプロジェクトファイルをプルし、ルートフォルダー内のプロジェクトを初期化します。 -e フラグでは、現在の環境の名前が設定されます。 azdでは、環境はアプリの一意のデプロイコンテキストを維持し、複数を定義できます。環境名は、Azure で作成するリソースグループの名前にも使用されます。
次の JSON データを含む local.settings.json という名前のファイルをルートフォルダーに作成します。
```
{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "UseDevelopmentStorage=true",
        "FUNCTIONS_WORKER_RUNTIME": "python"
    }
}
```
このファイルは、ローカルで実行する場合に必要です。

仮想環境を作成してアクティブにする

ルートフォルダーで、次のコマンドを実行して、.venv という名前の仮想環境を作成してアクティブにします。

python3 -m venv .venv
source .venv/bin/activate

Python で Venv パッケージが Linux ディストリビューションにインストールされない場合は、次のコマンドを実行します。

sudo apt-get install python3-venv

py -m venv .venv
source .venv/scripts/activate

py -m venv .venv
.venv\scripts\activate

ローカル環境で実行する

ターミナルまたはコマンドプロンプトでアプリフォルダーから次のコマンドを実行します。
```
func start
```
```
mvn clean package
mvn azure-functions:run
```
```
npm install
func start  
```
```
npm install
npm start  
```
Functions ホストがローカルプロジェクトフォルダーで起動すると、HTTP によってトリガーされる関数の URL エンドポイントがターミナル出力に書き込まれます。

Note

ローカルで実行する場合、アクセスキーの承認は適用されないため、返される関数の URL にはアクセスキーの値が含まれていないため、関数を呼び出すために必要ありません。
ブラウザーで、 httpget エンドポイントに移動します。この URL は次のようになります。

http://localhost:7071/api/httpget
新しいターミナルまたはコマンドプロンプトウィンドウから、次の curl コマンドを実行して、JSON ペイロードを含む POST 要求を httppost エンドポイントに送信します。
```
curl -i http://localhost:7071/api/httppost -H "Content-Type: text/json" -d @testdata.json
```
```
curl -i http://localhost:7071/api/httppost -H "Content-Type: text/json" -d "@src/functions/testdata.json"
```
このコマンドにより、testdata.json プロジェクトファイルから JSON ペイロードデータが読み取られます。両方の HTTP 要求の例は test.http プロジェクトファイルにあります。
完了したら、ターミナルウィンドウで Ctrl + C キーを押して、func.exe ホストプロセスを停止します。

deactivate を実行して仮想環境をシャットダウンします。

コードの確認 (省略可能)

2 つの HTTP トリガー関数エンドポイントを定義するコードを確認できます。

httpget
httppost

       [Function("httpget")]
       public IActionResult Run([HttpTrigger(AuthorizationLevel.Function, "get")]
         HttpRequest req,
         string name)
       {
           var returnValue = string.IsNullOrEmpty(name)
               ? "Hello, World."
               : $"Hello, {name}.";

           _logger.LogInformation($"C# HTTP trigger function processed a request for {returnValue}.");

           return new OkObjectResult(returnValue);
       }

@FunctionName("httpget")
public HttpResponseMessage run(
        @HttpTrigger(
            name = "req",
            methods = {HttpMethod.GET},
            authLevel = AuthorizationLevel.FUNCTION)
            HttpRequestMessage<Optional<String>> request,
        final ExecutionContext context) {
    context.getLogger().info("Java HTTP trigger processed a request.");

    // Parse query parameter
    String name = Optional.ofNullable(request.getQueryParameters().get("name")).orElse("World");

    return request.createResponseBuilder(HttpStatus.OK).body("Hello, " + name).build();
}

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

app.http('httpget', {
    methods: ['GET'],
    authLevel: 'function',
    handler: async (request, context) => {
        context.log(`Http function processed request for url "${request.url}"`);

        const name = request.query.get('name') || await request.text() || 'world';

        return { body: `Hello, ${name}!` };
    }
});

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

export async function httpGetFunction(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    context.log(`Http function processed request for url "${request.url}"`);

    const name = request.query.get('name') || await request.text() || 'world';

    return { body: `Hello, ${name}!` };
};

app.http('httpget', {
    methods: ['GET'],
    authLevel: 'function',
    handler: httpGetFunction
});

この function.json ファイルにより、httpget 関数が定義されます。

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

この run.ps1 ファイルでは、関数コードが実装されます。

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
$name = $Request.Query.name

$body = "This HTTP triggered function executed successfully. Pass a name in the query string 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
})

@app.route(route="httpget", methods=["GET"])
def http_get(req: func.HttpRequest) -> func.HttpResponse:
    name = req.params.get("name", "World")

    logging.info(f"Processing GET request. Name: {name}")

    return func.HttpResponse(f"Hello, {name}!")

[Function("httppost")]
public IActionResult Run([HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequest req,
    [FromBody] Person person)
{
    _logger.LogInformation($"C# HTTP POST trigger function processed a request for url {req.Body}");

    if (string.IsNullOrEmpty(person.Name) | string.IsNullOrEmpty(person.Age.ToString()) | person.Age == 0)
    {
        _logger.LogInformation("C# HTTP POST trigger function processed a request with no name/age provided.");
        return new BadRequestObjectResult("Please provide both name and age in the request body.");
    }

    var returnValue = $"Hello, {person.Name}! You are {person.Age} years old.";
    
    _logger.LogInformation($"C# HTTP POST trigger function processed a request for {person.Name} who is {person.Age} years old.");
    return new OkObjectResult(returnValue);
}

@FunctionName("httppost")
public HttpResponseMessage runPost(
        @HttpTrigger(
            name = "req",
            methods = {HttpMethod.POST},
            authLevel = AuthorizationLevel.FUNCTION)
            HttpRequestMessage<Optional<String>> request,
        final ExecutionContext context) {
    context.getLogger().info("Java HTTP trigger processed a POST request.");

    // Parse request body
    String name;
    Integer age;
    try {
        ObjectMapper mapper = new ObjectMapper();
        JsonNode jsonNode = mapper.readTree(request.getBody().orElse("{}"));
        name = Optional.ofNullable(jsonNode.get("name")).map(JsonNode::asText).orElse(null);
        age = Optional.ofNullable(jsonNode.get("age")).map(JsonNode::asInt).orElse(null);
        if (name == null || age == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Please provide both name and age in the request body.").build();
        }
    } catch (Exception e) {
        context.getLogger().severe("Error parsing request body: " + e.getMessage());
        return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                .body("Error parsing request body").build();
    }

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

app.http('httppost', {
    methods: ['POST'],
    authLevel: 'function',
    handler: async (request, context) => {
        context.log(`Http function processed request for url "${request.url}"`);

        try {
            const person = await request.json();
            const { name, age } = person;

            if (!name || !age) {
                return {
                    status: 400,
                    body: 'Please provide both name and age in the request body.'
                };
            }

            return {
                status: 200,
                body: `Hello, ${name}! You are ${age} years old.`
            };
        } catch (error) {
            return {
                status: 400,
                body: 'Invalid request body. Please provide a valid JSON object with name and age.'
            };
        }
    }
});

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

interface Person {
    name: string;
    age: number;
}

function isPerson(obj: any): obj is Person {
    return typeof obj === 'object' && obj !== null && 
           typeof obj.name === 'string' && 
           typeof obj.age === 'number';
}

export async function httpPostBodyFunction(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    context.log(`Http function processed request for url "${request.url}"`);

        try {
            const data: any  = await request.json();
    
            if (!isPerson(data)) {
                return {
                    status: 400,
                    body: 'Please provide both name and age in the request body.'
                };
            }

            return {
                status: 200,
                body: `Hello, ${data.name}! You are ${data.age} years old.`
            };
        } catch (error) {
            return {
                status: 400,
                body: 'Invalid request body. Please provide a valid JSON object with name and age.'
            };
        }
};

app.http('httppost', {
    methods: ['POST'],
    authLevel: 'function',
    handler: httpPostBodyFunction
});

この function.json ファイルにより、httppost 関数が定義されます。

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

この run.ps1 ファイルでは、関数コードが実装されます。

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 the body of the request.
$name = $Request.Body.name
$age = $Request.Body.age
$status = [HttpStatusCode]::OK

$body = "This HTTP triggered function executed successfully. Pass a name in the request body for a personalized response."

if ( -not ($name -and $age)){
    $body = "Please provide both 'name' and 'age' in the request body."
    $status = [HttpStatusCode]::BadRequest
}
else {
    <# Action when all if and elseif conditions are false #>
    $body = "Hello, ${name}! You are ${age} years old."
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = $status
    Body = $body
})

@app.route(route="httppost", methods=["POST"])
def http_post(req: func.HttpRequest) -> func.HttpResponse:
    try:
        req_body = req.get_json()
        name = req_body.get('name')
        age = req_body.get('age')
        
        logging.info(f"Processing POST request. Name: {name}")

        if name and isinstance(name, str) and age and isinstance(age, int):
            return func.HttpResponse(f"Hello, {name}! You are {age} years old!")
        else:
            return func.HttpResponse(
                "Please provide both 'name' and 'age' in the request body.",
                status_code=400
            )
    except ValueError:
        return func.HttpResponse(
            "Invalid JSON in request body",
            status_code=400
        )

完全なテンプレートプロジェクトは、ここで確認できます。

関数をローカルで検証したら、Azure に発行します。

Azure に配置する

このプロジェクトは、azd up コマンドを使用して、Azure の Flex 従量課金プランの新しい関数アプリにこのプロジェクトをデプロイするように構成されています。

Tip

このプロジェクトには、ベストプラクティスに従って Flex 従量課金プランへの安全なデプロイを作成するために使用する Bicep ファイルのセット (azd フォルダー内) が含まれています。

次のコマンドを実行し、azd で必要な Azure リソースを Azure に作成し、コードプロジェクトを新しい関数アプリにデプロイします。
```
azd up
```
ルートフォルダーには、azure.yaml に必要な azd 定義ファイルが含まれています。

まだサインインしていない場合は、Azure アカウントで認証するように求められます。

プロンプトが表示されたら、次の必須のデプロイパラメーターを指定します。

Parameter	Description
Azure サブスクリプション	リソースが作成されるサブスクリプション。
Azure の場所	新しい Azure リソースを含むリソースグループを作成する Azure リージョン。現在、Flex 従量課金プランをサポートしているリージョンのみが表示されます。
vnetEnabled	False を選択します。 True に設定すると、デプロイによって新しい仮想ネットワークに関数アプリが作成されます。

azd up コマンドは、Bicep 構成ファイルでこれらのプロンプトに対する応答を使用して、次のデプロイタスクを完了します。

次の必要な Azure リソースを作成して構成します (azd provision と同等)。
- Flex 従量課金プランと関数アプリ
- Azure Storage (必須) と Application Insights (推奨)
- アカウントのアクセスポリシーとロール
- マネージド ID を使用したサービス間接続 (格納されている接続文字列の代わり)
- (オプション)関数アプリとその他の Azure リソースの両方を安全に実行するための仮想ネットワーク
コードをパッケージ化し、デプロイコンテナーにデプロイします (azd deploy と同等)。その後、アプリが起動し、デプロイされたパッケージで実行されます。

コマンドが正常に完了した後、作成したリソースへのリンクが表示されます。

Azure 上の関数を呼び出す

HTTP テストツールを使用するか、ブラウザー (GET 要求の場合) から URL に HTTP 要求を行うことで、Azure で関数エンドポイントを呼び出すようになりました。関数が Azure で実行されると、アクセスキーの承認が適用され、要求に関数アクセスキーを指定する必要があります。

Core Tools を使用して、Azure で実行されている関数の URL エンドポイントを取得できます。

ローカルターミナルまたはコマンドプロンプトで、次のコマンドを実行して URL エンドポイント値を取得します。

bash
Cmd

SET APP_NAME=$(azd env get-value AZURE_FUNCTION_NAME)
func azure functionapp list-functions $APP_NAME --show-keys

for /f "tokens=*" %i in ('azd env get-value AZURE_FUNCTION_NAME') do set APP_NAME=%i
func azure functionapp list-functions %APP_NAME% --show-keys

PowerShell
Cmd

$APP_NAME = azd env get-value AZURE_FUNCTION_NAME
func azure functionapp list-functions $APP_NAME --show-keys

for /f "tokens=*" %i in ('azd env get-value AZURE_FUNCTION_NAME') do set APP_NAME=%i
func azure functionapp list-functions %APP_NAME% --show-keys

azd env get-value コマンドでは、ローカル環境から関数アプリ名が取得されます。 --show-keysで func azure functionapp list-functions オプションを使用すると、返される呼び出し URL: 各エンドポイントの値に関数レベルのアクセスキーが含まれます。

前と同様に、HTTP テストツールを使用して、Azure で実行されている関数アプリでこれらの URL を検証します。

コードを再デプロイする

azd up コマンドを必要な回数実行して、Azure リソースをプロビジョニングし、コード更新プログラムを関数アプリにデプロイします。

Note

デプロイされたコードファイルは常に最新のデプロイパッケージによって上書きされます。

azd プロンプトに対する最初の応答と、azd によって生成された環境変数は、名前付き環境にローカルに格納されます。 azd env get-values コマンドを使用して、Azure リソースの作成時に使用した環境内のすべての変数を確認します。

リソースをクリーンアップする

関数アプリと関連リソースの操作が完了したら、次のコマンドを使用して関数アプリとその関連リソースを Azure から削除し、それ以上のコストが発生しないようにします。

azd down --no-prompt

Note

--no-prompt オプションは、確認なしでリソースグループを削除するように azd に指示します。

このコマンドは、ローカルコードプロジェクトには影響しません。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-04