Function Compute：HTTP觸發器概述

觸發器限制

• 每個版本或別名下最多建立一個 HTTP 類型觸發器。詳細資料，請參見版本管理和別名管理。

• 內建網域名稱僅用於測試，請勿用於線上對外服務，以免受內建網域名稱穩定性影響。

  說明

  對外提供網站類服務需使用已備案的自訂網域名，將網域名稱與函數綁定後對外提供服務。更多資訊，請參見配置自訂網域名。

HTTP/HTTPS協議使用限制

• HTTP Request限制

  • Request Headers不支援以x-fc-開頭的自訂欄位和以下自訂欄位。

    • connection

    • keep-alive

  • 如果Request超過以下限制，會返回400狀態代碼和InvalidArgument錯誤碼。

    • Headers大小：Headers中的所有Key和Value的總大小不得超過8 KB。

    • Path大小：包括所有的Query Params，Path的總大小不得超過4 KB。

    • Body大小：同步調用請求的Body的總大小不得超過32 MB，關於非同步呼叫請求的Body的大小，請以函數運行資源限制為準。

• HTTP Response限制

  • Response Headers不支援以x-fc-開頭的自訂欄位和以下自訂欄位。

    • connection

    • content-length

    • date

    • keep-alive

    • server

    • upgrade

    • content-disposition:attachment

      說明

      從安全形度考慮，使用Function Compute預設的aliyuncs.com網域名稱，服務端會在Response Headers中強制添加content-disposition: attachment欄位，此欄位會使得返回結果在瀏覽器中以附件的方式下載。如果要解除該限制，需設定自訂網域名。更多資訊，請參見配置自訂網域名。

  • 如果Response超過以下限制，會返回502狀態代碼和BadResponse錯誤碼。

    • Headers大小：Headers中的所有Key和Value的總大小不得超過8 KB。

同步調用

同步調用指事件被函數處理後直接返回結果。HTTP觸發器預設的函數調用方式為同步調用。更多資訊，請參見同步調用。

非同步呼叫

非同步呼叫指Function Compute收到請求後，將請求持久化儲存，然後立即返迴響應，而不是等待請求執行完成後，再返回執行結果。

• 非同步呼叫：使用HTTP觸發器調用函數時，您可以通過增加要求標頭"X-Fc-Invocation-Type":"Async"的方式實現請求層級的非同步呼叫。

• 非同步任務：HTTP函數配置了非同步任務後，您可以通過增加要求標頭"X-Fc-Async-Task-Id":"g6u*****iyvhd3jk8s6bhj0hh"完成非同步任務調用Invocation ID的配置。

關於要求標頭的更多資訊，請參見調用函數。

非同步呼叫成功後，Function Compute會返回狀態代碼202，表示請求接收成功。同時會通過要求標頭返回Request ID，格式如"X-Fc-Request-Id": "80bf7****281713e1"。

簡單請求

簡單請求不會發送預檢請求，您可以直接在函數代碼中設定Access-Control-Allow-*開頭的Header，完成簡單的存取控制。對於簡單請求，Function Compute支援自訂的Headers包括：Access-Control-Allow-Origin、Access-Control-Allow-Headers、和Access-Control-Max-Age。

如果您沒有自訂Headers，Function Compute的Response Headers會預設設定為Request請求中相應的欄位：

• Access-Control-Allow-Origin：Request請求的Origin Header。

• Access-Control-Allow-Credentials：預設取值為true。

• Access-Control-Expose-Headers：Function Compute自訂的一些Header。

非簡單請求

非簡單請求在發送正式請求前會發送預檢請求，即一次非簡單請求包含一次OPTIONS方法的函數調用請求和一次實際的函數調用請求。正式請求的規則與上文的簡單請求相同。如果您需要自訂預檢請求的返回，則需要為HTTP觸發器添加OPTIONS方法，然後在函數代碼中處理OPTIONS請求，即設定Access-Control-Allow-*開頭的Header以控制函數的跨域行為。

對於預檢請求，Function Compute支援使用者自訂的Headers包括Access-Control-Allow-Origin、Access-Control-Allow-Headers、Access-Control-Allow-Methods和Access-Control-Max-Age。

以Node.js內建運行時為例，函數代碼中處理預檢請求的樣本如下所示：

exports.handler =  (event, context,callback) => {
      console.log('hello world');
      const method = JSON.parse(event).requestContext.http.method;
      if (method === 'OPTIONS') {
          // 設定回應標頭以處理預檢請求
          const fcResponse = {
            'statusCode': 204,
            'headers': {
              'Access-Control-Allow-Origin': 'http://www.fc.com',
              'Access-Control-Allow-Methods': 'POST',
              'Access-Control-Allow-Headers': 'Content-Type, Authorization',
              'Access-Control-Max-Age':'3600'
            },
            'body': 'hello world'
        };
        callback(null, fcResponse);
      } else {
        callback(null, {
            'statusCode': 500,
            'body': 'hello world'
        });
      }
    };

API Configured CORS

API Configured CORS 當前為邀測功能。如需開通，請聯絡我們並提供阿里雲帳號 ID（UID）。