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 ComputeHTTP請求映射邏輯

Function Compute會將HTTP請求映射成Event事件對象傳給請求處理常式（Handler），映射邏輯如下：

• HTTP要求標頭映射為event結構中的headers。

• HTTP請求參數映射為queryParameters。

• HTTP請求的上下文資訊映射為requestContext。

• POST請求的請求體映射為body。

請求映射樣本

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"

響應結構體格式

函數的響應結構體格式如下。當您的請求處理常式返迴響應結構體時，Function Compute會解析響應並將其轉換為HTTP響應。

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

Function Compute響應解析邏輯

Function Compute會解析響應並構造HTTP Response返回給用戶端。

• 如果您的函數返回有效JSON並且包含statusCode欄位，Function Compute解析邏輯如下：

  • statusCode：函數返回JSON中的statusCode值。

  • Content-Type：函數返回JSON中的Content-Type值。如果JSON中沒有Content-Type，Content-Type預設為application/json。

  • body：函數響應，函數返回JSON中的body值。

  • isBase64Encoded：函數返回JSON中的isBase64Encoded值，如果JSON中沒有isBase64Encoded，則預設為false。

• 如果您的函數返回有效JSON但是沒有包含statusCode欄位，或者返回的不是有效JSON，Function Compute會做出以下假設，構造響應結構體。

  • statusCode：預設為200。

  • Content-Type：預設為application/json。

  • body：函數響應，即代碼中return的資料。

  • isBase64Encoded：預設為false。

Function Compute會將函數響應結構體映射成HTTP響應返回給用戶端，映射邏輯如下：

• statusCode映射為HTTP響應的狀態代碼。

• headers映射為HTTP回應標頭。

• body映射為HTTP響應體，如果存在isBase64Encoded且為true，則先將body進行Base64解碼，再映射到HTTP響應體。

響應映射樣本

以下樣本介紹了函數的輸出如何映射到函數響應結構體，以及函數響應結構體如何映射到最終的HTTP響應。當用戶端調用函數HTTP觸發器時，就可以看到HTTP響應。

Base64解碼機制

當函數輸出為有效JSON格式，且JSON中的isBase64Encoded欄位為true時，Function Compute會將JSON中的body欄位進行Base64解碼，再將解碼後的資料通過HTTP響應體返回給用戶端。

如果對body欄位解碼失敗，Function Compute不會報錯，而是直接將原始的body欄位的值返回給用戶端。

回應標頭（HTTP Response Header）

使用HTTP觸發器調用函數時，回應標頭中會包含Function Compute預設添加的回應標頭X-Fc-Request-Id，這是此次請求的唯一標識。除了X-Fc-Request-Id，Function Compute不會預設添加其他回應標頭。

您可以在代碼中返回自訂的回應標頭，但不支援X-Fc-開頭的回應標頭和以下Function Compute保留的回應標頭：

• connection

• content-length

• date

• keep-alive

• server

• content-disposition

如果您在回應標頭中設定了這些保留字，Function Compute會直接忽略您設定的回應標頭。

錯誤處理

當遇到函數錯誤時，通過API調用會返回具體的錯誤資訊，HTTP返回碼為200。比如Python的ModuleNotFound錯誤的響應如下：

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

但使用HTTP 觸發器調用時，Function Compute會隱藏這些錯誤資訊，直接返回Internal Server Error，HTTP返回碼為502。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在日誌中尋找具體的報錯資訊。