Function Compute:HTTP トリガーの概要

トリガーの制限

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

• 組み込みドメイン名はテスト専用です。その安定性が保証されていないため、本番環境向けサービスには使用しないでください。

  説明

  Web サイト形式のサービスをパブリックにホストする場合は、ICP 登録済みのカスタムドメイン名をご利用ください。公開前に、ドメイン名を関数にバインドしてください。詳細については、「カスタムドメイン名の設定」をご参照ください。

HTTP／HTTPS プロトコルの制限

• HTTP リクエストの制限

  • x-fc- で始まるカスタムリクエストヘッダーはサポートされていません。また、以下のカスタムヘッダーもサポートされていません：

    • connection

    • keep-alive

  • リクエストが以下のいずれかの制限を超えると、Function Compute は HTTP ステータスコード 400 およびエラーコード InvalidArgument を返します。

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

    • パスのサイズ：クエリパラメーターを含むパス全体のサイズは 4 KB を超えてはなりません。

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

• HTTP 応答の制限

  • x-fc- で始まるカスタム応答ヘッダーはサポートされていません。また、以下のカスタムヘッダーもサポートされていません：

    • connection

    • content-length

    • date

    • keep-alive

    • server

    • upgrade

    • content-disposition:attachment

      説明

      セキュリティ上の理由から、Function Compute ではデフォルトの Function Compute ドメイン名（aliyuncs.com）を使用している場合、応答ヘッダーに content-disposition: attachment が自動追加されます。これにより、ブラウザが応答を添付ファイルとしてダウンロードするようになります。この動作を無効にするには、カスタムドメイン名を設定してください。詳細については、「カスタムドメイン名の設定」をご参照ください。

  • 応答が以下の制限を超えると、Function Compute は HTTP ステータスコード 502 およびエラーコード BadResponse を返します。

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

同期呼び出し

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

非同期呼び出し

非同期呼び出しでは、Function Compute がリクエストを永続化し、関数の実行完了を待たずに即座に応答を返します。

• 非同期呼び出し：リクエストヘッダーに "X-Fc-Invocation-Type":"Async" を追加することで、リクエスト単位の非同期呼び出しを有効化できます。

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

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

非同期呼び出しが成功すると、Function Compute は HTTP ステータスコード 202（リクエストが受理されたことを示す）を返します。また、応答ヘッダー内にリクエスト ID も返され、例： "X-Fc-Request-Id": "80bf7****281713e1" となります。

単純なリクエスト

単純なリクエストではプレフライトリクエストが送信されないため、関数コード内で Access-Control-Allow-* で始まるヘッダーを直接設定することで、シンプルなアクセス制御を実装できます。単純なリクエストに対して、Function Compute は以下のカスタムヘッダーをサポートしています：Access-Control-Allow-Origin、Access-Control-Allow-Headers、、および Access-Control-Max-Age。

カスタムヘッダーを設定しない場合、Function Compute は対応するリクエストヘッダーに基づき、以下の応答ヘッダーをデフォルトで設定します：

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

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

• Access-Control-Expose-Headers：Function Compute が定義するヘッダー。

単純ではないリクエスト

単純ではないリクエストでは、実際のリクエストの前にプレフライトリクエストが送信されます。単純ではないリクエストには、1 回の OPTIONS メソッド呼び出しと 1 回の実際の関数呼び出しが含まれます。実際のリクエストのルールは、単純なリクエストの場合と同じです。プレフライト応答をカスタマイズするには、HTTP トリガーに OPTIONS メソッドを追加し、関数コード内で OPTIONS リクエストを処理します。Access-Control-Allow- で始まる応答ヘッダーを設定して、クロスオリジン動作を制御します。

プレフライトリクエストに対して、Function Compute は以下のカスタマイズ可能なヘッダーをサポートしています：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）をご提供ください。