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 は Content-Type ヘッダーをチェックして、リクエストボディを Base64 エンコードするかどうかを決定します。

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

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 は body を Base64 デコードしてから HTTP レスポンスボディにマッピングします。デコードに失敗した場合、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 の値を使用して、関数の呼び出しログで完全なエラー詳細を検索してください。