Function Compute:HTTP トリガーを使用した関数の呼び出し

フォーマット

Function Compute は、受信した HTTP リクエストを次の構造を持つイベントオブジェクトにマッピングします。

{
    "version": "v1",
    "rawPath": "/example",
    "body": "Hello FC!",
    "isBase64Encoded": false,
    "headers": {
        "header1": "value1",
        "header2": "value1,value2"
    },
    "queryParameters": {
        "parameter1": "value1",
        "parameter2": "value1,value2"
    },
    "requestContext": {
        "accountId": "123456*********",
        "domainName": "<http-trigger-id>.<region-id>.fcapp.run",
        "domainPrefix": "<http-trigger-id>",
        "http": {
            "method": "GET",
            "path": "/example",
            "protocol": "HTTP/1.1",
            "sourceIp": "11.11.11.**",
            "userAgent": "PostmanRuntime/7.32.3"
        },
        "requestId": "1-64f6cd87-*************",
        "time": "2023-09-05T06:41:11Z",
        "timeEpoch": "1693896071895"
    }
}

パラメーター

マッピングロジック

Function Compute は、次のように HTTP リクエストをイベントオブジェクトにマッピングします。

• HTTP リクエストヘッダー → event.headers

• HTTP クエリパラメーター → event.queryParameters

• リクエストコンテキスト（リクエスト ID、タイムスタンプ、呼び出し元 ID） → event.requestContext

• POST リクエストボディ → event.body

Base64 エンコーディング

Function Compute は、リクエストボディを Base64 エンコードするかどうかを判断するために、Content-Type ヘッダーを確認します。

リクエストマッピングの例

curl -v "https://example.cn-hangzhou.fcapp.run?parameter1=value1&parameter2=value2"

POST / HTTP/1.1
Content-Type: application/json

curl -v -H "Content-Type: application/json" -d '{"message": "Hello"}' "https://example.cn-hangzhou.fcapp.run"

フォーマット

関数の出力は、HTTP レスポンスにマッピングされる前にレスポンス構造体に解析されます。

{
    "statusCode": 200,
    "headers": {
        "Content-Type": "application/json",
        "Custom-Header-1": "Custom Value"
    },
    "isBase64Encoded": false,
    "body": "{\"message\":\"Hello FC!\"}"
}

マッピングロジック

Function Compute は、出力が statusCode フィールドを含む有効な JSON であるかどうかに基づいて、関数の出力を HTTP 応答にマッピングします。

出力がstatusCode を含む有効な JSON の場合:

出力が statusCode を含まない有効な JSON、または JSON ではない場合:

Function Compute は次のデフォルト値を使用します。

レスポンスマッピングの例

以下の例は、関数の出力が解析を経て最終的な HTTP レスポンスになるまでの流れを示しています。

HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Length: 12
Content-Type: application/json
X-Fc-Request-Id: 1-64f6d6e7-e01edb1cce58240ed59b59d9

Hello World!

HTTP/1.1 200 OK
Content-Disposition: attachment
Content-Length: 27
Content-Type: application/json
X-Fc-Request-Id: 1-64f6d867-7302fc1ac6338b6fd2adb782

{"message": "Hello World!"}

HTTP/1.1 201 OK
Content-Type: application/json
My-Custom-Header: Custom Value
X-Fc-Request-Id: 1-64f6dcb3-e787580749d3ba13b047ce14

{"message": "Hello world!"}

Base64 デコーディング

関数が、isBase64Encoded が true に設定された有効な JSON を返す場合、Function Compute は HTTP レスポンスボディにマッピングする前に body を Base64 デコードします。デコードに失敗した場合、Function Compute はエラーを報告せずに body の値を直接返します。

レスポンスヘッダー

Function Compute は、すべての応答に X-Fc-Request-Id ヘッダーを自動的に追加します。このヘッダーはリクエストを一意に識別し、ログの追跡やエラーの診断に役立ちます。X-Fc-Request-Id 以外に、Function Compute は、デフォルトで他のレスポンスヘッダーを追加しません。

エラーハンドリング

HTTP トリガーによる呼び出しと直接 API 呼び出しでは、関数のエラー処理が異なります。

例えば、Python の ModuleNotFoundError が発生した直接 API 呼び出しは、以下のエラー詳細を返します。

{
    "errorMessage": "Unable to import module 'index'",
    "errorType": "ImportModuleError",
    "stackTrace": [
        "ModuleNotFoundError: No module named 'not_exist_module'"
    ]
}

HTTP トリガー経由で呼び出された関数でエラーが発生した場合、クライアントは次のようなレスポンスを受け取ります。

HTTP/1.1 502 Bad Gateway
Content-Disposition: attachment
Content-Type: application/json
X-Fc-Request-Id: 1-64f6df91-fe144d52e4fd27afe3d8dd6f
Content-Length: 21

Internal Server Error

X-Fc-Request-Id 値を使用して、関数の呼び出しログでエラーの詳細を検索します。