Function Compute:HTTPトリガーの設定と使用

ステップ1: トリガーを作成する

1. Function Computeコンソールにログインします。 左側のナビゲーションウィンドウで、[サービスと機能] をクリックします。

2. 上部のナビゲーションバーで、リージョンを選択します。 [サービス] ページで、目的のサービスをクリックします。

3. 関数ページをクリックします。関数の作成.

4. 関数の作成ページで、組み込みランタイムの使用を選択し、ビジネス要件に基づいて関数を作成するためのパラメーターを設定します。

   次の表に、設定する必要があるパラメーターを示します。 他のパラメーターの既定値を保持します。 詳細については、「関数の作成」をご参照ください。

   パラメーター	説明
   基本設定
   関数名	関数の名前を指定します。
   ハンドラタイプ	[HTTPハンドラ] を選択します。
   (オプション) トリガー設定
   名前	トリガーの名前を指定します。
   リクエスト方法	トリガーのトリガーに使用できるHTTPメソッドを指定します。
   インターネットURLの無効化	デフォルトでは、このパラメーターは [いいえ] に設定され、パブリックドメイン名はトリガーにアクセスできます。 [はい] を選択した場合、トリガーに使用できるデフォルトのパブリックドメイン名はありません。 この場合、パブリックドメイン名を使用して関数を呼び出すと、関数によってアクセスが拒否されたインターネットURLが無効になるエラーメッセージが返されます。 ただし、カスタムドメイン名を使用する場合、関数は期待どおりに呼び出すことができます。
   認証方法	HTTPリクエストの認証に使用されるメソッド。 有効な値： 認証なし: Function ComputeはHTTPリクエストを認証せず、関数への匿名アクセスをサポートします。 すべてのユーザーがHTTPリクエストを使用して関数を呼び出すことができます。 署名認証: HTTPリクエストにはID認証が必要です。 署名認証のサンプルコードの詳細については、「署名認証」をご参照ください。 JWT認証: HTTPリクエストは、JSON Webトークン (JWT) を使用して認証する必要があります。 詳細については、「HTTPトリガーのJWT認証の設定」をご参照ください。

   ビジネス要件に基づいて、作成されたHTTPトリガーの設定を変更できます。 たとえば、トリガーの [バージョンまたはエイリアス] 、[リクエスト方法] 、[インターネットURLの無効化] 、および [認証方法] のパラメーターを変更できます。

ステップ2: コードの書き込みとデプロイ

HTTPトリガーが作成されたら、関数のコードを記述できます。

var getRawBody = require('raw-body')
module.exports.handler = function (request, response, context) {
    // get request info
    getRawBody(request, function (err, data) {
        var params = {
            path: request.path,
            queries: request.queries,
            headers: request.headers,
            method: request.method,
            body: data,
            url: request.url,
            clientIP: request.clientIP,
        }
        // you can deal with your own logic here
        // set response
        var respBody = new Buffer.from(JSON.stringify(params));
        // var respBody = new Buffer( )
        response.setStatusCode(200)
        response.setHeader('content-type', 'application/json')
        response.send(respBody)
    })
};

# -*- coding: utf-8 -*-
import json
HELLO_WORLD = b"Hello world!\n"
def handler(environ, start_response):
    request_uri = environ['fc.request_uri']
    response_body = {
      'uri':environ['fc.request_uri'],
      'method':environ['REQUEST_METHOD']
    }
    # do something here
    status = '200 OK'
    response_headers = [('Content-type', 'text/json')]
    start_response(status, response_headers)
    # Python2
    return [json.dumps(response_body)]
    # Python3 tips: When using Python3, the str and bytes types cannot be mixed.
    # Use str.encode() to go from str to bytes
    # return [json.dumps(response_body).encode()]

<?php
use RingCentral\Psr7\Response;
function handler($request, $context): Response{
    /*
    $body       = $request->getBody()->getContents();
    $queries    = $request->getQueryParams();
    $method     = $request->getMethod();
    $headers    = $request->getHeaders();
    $path       = $request->getAttribute("path");
    $requestURI = $request->getAttribute("requestURI");
    $clientIP   = $request->getAttribute("clientIP");
    */
    return new Response(
        200,
        array(
            "custom_header1" => "v1",
            "custom_header2" => ["v2", "v3"],
        ),
        "hello world"
    );
}

ステップ3: 関数のテスト

方法1: function Computeコンソールで関数をテストする

方法2: ブラウザを使用して関数をテストする

次のいずれかの方法を使用して、HTTPトリガーのURLを取得できます。

• 新しいHTTPトリガーの場合、Function Computeによって割り当てられたサブドメイン名をHTTPトリガーのURLとして使用することを推奨します。

  サブドメイン形式:

  <subdomain>.<region_id>.fcapp.run/[action?queries] 

  サンプルコード：

  funcname-svcname-khljsjksld.cn-shanghai.fcapp.run/action?hello=world

  説明

  アセンブリルールに基づいて、既存のHTTPトリガーのURLをアセンブルすることもできます。 割り当てられたサブドメインをHTTPトリガーのURLとして使用して関数をテストすると、404エラーや関数コード内のfunction Computeのサービス名の結合を防ぐことができます。 これにより、コードの移植性を向上させることができる。 404エラーを処理する方法の詳細については、「ブラウザまたはcURLツールを使用して関数にアクセスするときに404エラーが発生した場合の対処方法 」をご参照ください。

• 既存のHTTPトリガーの場合、アセンブリルールに基づいてHTTPトリガーURLを生成できます。

  アセンブリルール:

  <account_id>.<region_id>.fc.aliyuncs.com/<version>/proxy/<serviceName>/<functionName>/[action?queries]            

  サンプルコード：

  164901546557****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/serviceName/functionName/action?hello=world           

  パラメーターの説明：

  パラメーター	説明
  account_id	Alibaba Cloud アカウントの ID です。 Alibaba CloudアカウントのIDは、Alibaba Cloud管理コンソールの [セキュリティ設定] ページで取得できます。 Resource Access Management (RAM) ユーザーとしてログインしている場合は、コンソールの右上隅にあるプロフィール写真の上にポインターを移動して、Alibaba CloudアカウントのIDを取得します。
  region_id	Function Computeが存在するリージョンのID。
  バージョン	Function Compute APIのバージョン。
  serviceName	サービス名。
  functionName	関数名。
  アクション	カスタム要求パス。
  クエリ	クエリパラメーター。

方法3: cURLを使用して関数をテストする

• 同期呼び出し

  次のコマンドを実行します。 コマンドの実行後、結果が返されます。

  curl -v https://http-***.cn-shenzhen.fcapp.run/$path

• 非同期呼び出し

  次のコマンドを実行します。 コマンド出力は、Function Computeが非同期呼び出しリクエストを受信したかどうかを示します。 202ステータスコードが返された場合、非同期呼び出し要求は成功します。 別のステータスコードが返された場合、非同期呼び出し中にエラーが発生します。 ステータスコードの詳細については、「トラブルシューティング」をご参照ください。

  curl -v -H "X-Fc-Invocation-Type: Async" https://http-***.cn-shenzhen.fcapp.run/$path

(オプション) API Gatewayを使用してHTTP関数を保護する

デフォルトでは、Function ComputeはHTTPリクエストを認証せず、HTTP関数への匿名アクセスをサポートします。 誰でもHTTPリクエストを送信してHTTP関数を呼び出すことができます。 匿名アクセスによるリソースの浪費やセキュリティリスクを防ぐために、ID認証を有効にしながらHTTP関数をAPI Gatewayに接続できます。 IPベースのアクセス制御プラグイン、JWT認証プラグイン、またはAPI Gatewayの基本認証プラグインを使用して、HTTP機能を保護できます。

1. Function Computeコンソールで、管理するHTTP関数を見つけます。 関数の詳細ページで、[トリガー] タブをクリックし、HTTPトリガーを編集します。 表示されるダイアログボックスで、[認証] を [はい] に設定します。

2. にログインします。API GatewayコンソールHTTP関数が存在するリージョンに切り替えます。

3. グループを作成します。 詳細については、「HTTPタイプのバックエンドサービスでAPIを作成する」トピックの [APIグループの作成] セクションをご参照ください。

4. Canonical name (CNAME) を使用して、API Gatewayが提供する第2レベルのドメイン名にドメイン名を解決します。 詳細については、「CNAMEレコードの追加」をご参照ください。

5. APIを作成します。

   主なパラメーターの設定方法を次に示します。 ビジネス要件に基づいて、デフォルト値を保持するか、他のパラメーターのカスタム値を設定します。 詳細については、「APIの作成」をご参照ください。

   • セキュリティ認証: [認証なし] を選択します。 その後の操作では、プラグインが認証に使用されます。

   • リクエストパス: ルートディレクトリ /を入力し、[すべてのサブパスに一致] を選択します。

   • HTTPメソッド: [ANY] を選択します。

   • リクエストモード: パススルーを選択します。

   • バックエンドサービスタイプ: [Function Compute] を選択します。

   • 関数タイプ: [HTTP関数] を選択します。

   • トリガーパス: function ComputeでHTTP関数の内部エンドポイントを選択します。

   • ContentType: [パススルークライアントコンテンツタイプヘッダー] を選択します。

6. APIを公開します。 作成したAPIを見つけ、[操作] 列の [発行] をクリックし、オンライン環境を選択して、[発行] をクリックします。

7. Backend Signatureタイプのプラグインを作成します。 Alibaba CloudアカウントのAccessKey IDおよびAccessKey secretにkeyおよびvalueを設定します。 次に、作成したAPIにプラグインをバインドします。 詳細については、「概要」をご参照ください。

トラブルシューティング

HTTP関数を実行できないのはなぜですか?

• 新しいトリガーの場合、キャッシュの更新には約10秒かかります。 後でもう一度試すことができます。

• 関数に指定したハンドラーが有効かどうかを確認できます。 HTTP関数のハンドラは、通常の関数のハンドラとは異なります。 さまざまな言語のHTTP関数の詳細については、次のトピックを参照してください。

  • Node.jsランタイムのHTTPハンドラー

  • PythonランタイムのHTTPハンドラー

  • PHPランタイムのHTTPハンドラー

  • JavaランタイムのHTTPハンドラー

  • C# ランタイムのHTTPハンドラー

  • カスタムランタイムのHTTPハンドラー

  • カスタムコンテナランタイムのHTTPハンドラー

関数の実行を終了できないのはなぜですか?

トラブルシューティング

問題が解決しない場合は、DingTalkユーザーグループに参加します (ID:11721331Function Computeテクニカルサポートにお問い合わせください。

詳細情報

既存のトリガーを変更または削除するには、「トリガーの管理」をご参照ください。