Function Compute:HTTP トリガーの概要

トリガーの制限事項

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

• ビルトインドメイン名はテスト専用です。安定性が保証されていないため、外部の本番サービスには使用しないでください。

  説明

  外部に Web サイトサービスを提供するには、ICP 申請済みのカスタムドメイン名を使用してください。ドメインを関数にバインドし、そのドメインを介してトラフィックを処理します。詳細については、「カスタムドメイン名の設定」をご参照ください。

HTTP(S) の制限事項

• HTTP リクエストの制限事項

  • リクエストヘッダーは、x-fc- で始まるカスタムフィールドや、以下のフィールドをサポートしていません：

    • connection

    • keep-alive

  • リクエストが以下のいずれかの制限を超えた場合、システムはステータスコード 400 とエラーコード InvalidArgument を返します：

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

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

    • ボディサイズ：同期呼び出しリクエストの合計ボディサイズは 32 MB を超えることはできません。非同期呼び出しリクエストのボディサイズの制限については、「関数の実行リソースの制限」をご参照ください。

• HTTP レスポンスの制限事項

  • レスポンスヘッダーは、x-fc- で始まるカスタムフィールドや、以下のフィールドをサポートしていません：

    • connection

    • content-length

    • date

    • keep-alive

    • server

    • upgrade

    • content-disposition:attachment

      説明

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

  • レスポンスが以下のいずれかの制限を超えた場合、システムはステータスコード 502 とエラーコード BadResponse を返します：

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

同期呼び出し

同期呼び出しでは、関数はイベントを処理し、すぐに結果を返します。HTTP トリガーはデフォルトで同期呼び出しを使用します。詳細については、「同期呼び出し」をご参照ください。

非同期呼び出し

非同期呼び出しでは、Function Compute はリクエストを永続化し、実行の完了を待たずにすぐにレスポンスを返します。

• 非同期呼び出し：リクエストヘッダー "X-Fc-Invocation-Type":"Async" を追加して、リクエストレベルで関数を非同期に呼び出します。

• 非同期タスク：HTTP 関数の非同期タスクを有効にした後、リクエストヘッダー "X-Fc-Async-Task-Id":"g6u*****iyvhd3jk8s6bhj0hh" を追加して、非同期タスクの呼び出し ID を設定します。

リクエストヘッダーの詳細については、「関数の呼び出し」をご参照ください。

非同期呼び出しが成功すると、Function Compute はステータスコード 202 を返します。これは、リクエストが正常に受信されたことを示します。また、レスポンスヘッダーにリクエスト ID を返します。形式は "X-Fc-Request-Id": "80bf7****281713e1" です。

単純リクエスト

単純リクエストにはプリフライトリクエストは必要ありません。関数コードで Access-Control-Allow-* で始まるヘッダーを設定して、基本的なアクセスの制御を実装できます。単純リクエストの場合、FC は次のカスタムヘッダーをサポートしています：Access-Control-Allow-Origin、Access-Control-Allow-Headers、 および Access-Control-Max-Age。

カスタムヘッダーを設定しない場合、FC はデフォルトで次のレスポンスヘッダーを設定します：

• Access-Control-Allow-Origin：リクエストの Origin ヘッダー。

• Access-Control-Allow-Credentials：デフォルト値は true です。

• Access-Control-Expose-Headers：FC によって定義されたカスタムヘッダー。

単純でないリクエスト

単純でないリクエストは、実際のリクエストの前にプリフライトリクエストを送信します。ブラウザは OPTIONS メソッドを使用してプリフライトリクエストを送信し、その後、実際のリクエストを送信して関数を呼び出します。単純でないリクエストのルールは、単純リクエストのルールと一致します。プリフライトレスポンスをカスタマイズするには、HTTP トリガーに OPTIONS メソッドを追加し、関数コードで OPTIONS リクエストを処理します。具体的には、Access-Control-Allow-* で始まるヘッダーを設定して、クロスオリジンの動作を制御します。

プリフライトリクエストの場合、FC は次のカスタムヘッダーをサポートしています：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 設定済み CORS

API 設定済み CORS は現在、招待制プレビュー段階です。有効にするには、Alibaba Cloud アカウント ID (UID) をご用意の上、弊社までご連絡ください。