Function Compute:Web 関数

制限事項

• 各関数バージョンまたはエイリアスに対して作成できる HTTP トリガーは 1 つだけです。詳細については、「バージョンの管理」および「エイリアスの管理」をご参照ください。

• HTTP リクエストの制限

  • リクエストヘッダーには、x-fc- で始まるカスタムフィールドや、次のフィールドを含めることはできません：

    • connection

    • keep-alive

  • リクエストが次の制限を超えた場合、FC は状態コード 400 とエラーコード InvalidArgument を返します。

    • ヘッダーサイズ： ヘッダー内のすべてのキーと値の合計サイズは 8 KB を超えることはできません。

    • パスサイズ： すべてのクエリパラメーターを含むパスの合計サイズは 4 KB を超えることはできません。

    • 本文サイズ： 同期呼び出しのリクエスト本文の合計サイズは 32 MB を超えることはできません。非同期呼び出しのリクエスト本文の合計サイズは 128 KB を超えることはできません。

• HTTP レスポンスの制限

  • レスポンスヘッダーには、x-fc- で始まるカスタムフィールドや、次のフィールドを含めることはできません：

    • connection

    • content-length

    • date

    • keep-alive

    • server

    • content-disposition:attachment

      説明

      セキュリティ上の理由から、Function Compute のデフォルトの aliyuncs.com ドメインを使用する場合、サーバーはレスポンスに content-disposition: attachment ヘッダーを強制的に追加します。このヘッダーにより、レスポンスはブラウザで添付ファイルとしてダウンロードされます。この制限を解除するには、カスタムドメイン名を設定してください。

  • レスポンスが次の制限を超えた場合、FC は状態コード 502 とエラーコード BadResponse を返します。

    • ヘッダーサイズ： ヘッダー内のすべてのキーと値の合計サイズは 8 KB を超えることはできません。

• 補足事項

  カスタムドメイン名をバインドすることで、さまざまな HTTP アクセスパスを関数にマップできます。詳細については、「カスタムドメイン名を設定」をご参照ください。

HTTP 呼び出し (推奨)

HTTP 呼び出しの場合、FC はパススルーモードを使用します。クライアントの HTTP リクエストをご利用の HTTP サーバーに転送し、サーバーのレスポンスをクライアントに返します。FC は一部のシステム予約フィールドをパススルーしません。詳細については、「制限事項」をご参照ください。

API 呼び出し

InvokeFunction API を使用して関数が呼び出されると、FC は API リクエストを HTTP リクエストに変換し、ご利用の HTTP サーバーに送信します。この変換は次のルールに従います：

• InvokeFunction リクエストの event パラメーターは、HTTP リクエストのメッセージ本文になります。

• パス は /invoke です。

• メソッド は POST です。

• Content-Type リクエストヘッダーは application/octet-stream です。

FC は、ご利用の HTTP サーバーからのレスポンスを InvokeFunction API レスポンスに変換し、クライアントに返します。この変換は次のルールに従います：

• HTTP レスポンスの本文は、InvokeFunction のレスポンス本文になります。

• この変換では、HTTP レスポンスのヘッダーと状態コードは破棄されます。

"hello world"

> POST /invoke HTTP/1.1
> Host: 21.0.X.X
> Content-Length: 11
> Content-Type: application/octet-stream

hello world

< HTTP/1.1 200 OK
< Date: Mon, 10 Jul 2025 10:37:15 GMT
< Content-Type: application/octet-stream
< Content-Length: 11
< Connection: keep-alive

hello world

hello world

< HTTP/1.1 400 Bad Request
< Date: Mon, 10 Jul 2025 10:37:15 GMT
< Content-Type: application/octet-stream
< Content-Length: 28
< Connection: keep-alive

{"errorMessage":"exception"}

{"errorMessage":"exception"}

Function Compute のレスポンスコードとレスポンスヘッダー

カスタムランタイムは、本質的にはユーザーが実装する HTTP サーバーです。したがって、各関数呼び出しは HTTP リクエストであり、各レスポンスには状態コードとレスポンスヘッダーが含まれます。

• レスポンスの status code

  • 200： 成功。

  • 404： 失敗。

• レスポンスヘッダー x-fc-status

  • 200： 成功。

  • 404： 失敗。

x-fc-status レスポンスヘッダーを使用して、関数の実行ステータスを FC にレポートできます。

• x-fc-status ヘッダーを設定しない場合、FC はデフォルトで呼び出しが成功したと見なします。ただし、関数でエラーが発生してもそれをレポートしない場合、FC はその失敗を認識しません。これはビジネスロジックに影響しないかもしれませんが、モニタリングと可観測性に影響します。次のコードに例を示します：

      print("FC Invoke Start RequestId: " + rid)
      data = request.stream.read()
      print("Path: " + path)
      print("Data: " + str(data))
      # Simulate an exception to trigger a runtime error
      raise Exception("mock exception")
      print("FC Invoke End RequestId: " + rid)
      return "Hello, World!"
  if __name__ == '__main__':
      app.run(host='0.0.0.0', port=9000)

• x-fc-status ヘッダーを設定すると、関数でエラーが発生したときに FC に失敗をレポートし、エラースタックトレースをログに出力できます。たとえば、x-fc-status レスポンスヘッダーを 404 に設定すると、FC はその呼び出しを InvocationError 型の失敗として識別し、呼び出し結果は mock exception となります。次の app.py ファイルに例を示します：

  @app.route('/', defaults={'path': ''})
  @app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE'])
  def hello_world(path):
      rid = request.headers.get(REQUEST_ID_HEADER)
      print("FC Invoke Start RequestId: " + rid)
      try:
          raise Exception("mock exception")
      except Exception as e:
          print("FC Invoke End RequestId: " + rid + ", Error: Unhandled Exception")
          print(str(e))
          return str(e), 404, [{"x-fc-status", "404"}]

コード例

関数のトリガーを設定する際、任意のプログラミング言語で HTTP サーバーを実装できます。このトピックでは、Python を例として使用します。

import os
from flask import Flask
from flask import request
REQUEST_ID_HEADER = 'x-fc-request-id'
app = Flask(__name__)
@app.route('/', defaults={'path': ''})
@app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE'])
def hello_world(path):
    rid = request.headers.get(REQUEST_ID_HEADER)
    data = request.stream.read()
    print("Path: " + path)
    print("Data: " + str(data))
    return "Hello, World!", 200, [('Function-Name', os.getenv('FC_FUNCTION_NAME'))]
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=9000)
            

このコードは次のように動作します：

• @app.route('/', defaults={'path': ''})： これは、ルートパスに対応するデフォルトのルートです。

• @app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE'])： これは、GET、POST、PUT、DELETE リクエストを処理できるパスパラメーターを持つ動的ルートです。このルートは、パスパラメーターの値を hello_world 関数の path 引数として渡します。

• rid = request.headers.get(REQUEST_ID_HEADER)： リクエストヘッダーから x-fc-request-id フィールドの値を取得します。

• data = request.stream.read()： リクエストの内容を読み取り、data 変数に割り当てます。

• return "Hello, World!", 200, [('Function-Name', os.getenv('FC_FUNCTION_NAME'))]： "Hello, World!" を含むレスポンス本文、状態コード 200、および Function-Name レスポンスヘッダーを返します。