Cloud-native API Gateway を Function Compute (FC) のイベントソースとして使用します。リクエストがゲートウェイに到達すると、関連付けられた関数がトリガーされて実行され、結果が呼び出し元に返されます。
Function Compute 3.0 は、Cloud-native API Gateway とのみ統合できます。
仕組み
Cloud-native API Gateway は、ご利用の関数の前に配置され、ルーティング、認証、トラフィック制御を処理します。従来の API Gateway トリガー とは異なり、Cloud-native API Gateway はイベント関数と Web 関数を区別しません。ルーティングルールは受信リクエストと一致し、設定したパスとドメインに基づいて FC に転送します。
リクエストフローは次のとおりです。
クライアントがゲートウェイのドメインに HTTP リクエストを送信します。
ゲートウェイはリクエストをご利用のルーティングルールと照合し、FC に転送します。
FC は関数を実行し、結果を返します。
ゲートウェイは応答をクライアントに返送します。
前提条件
開始する前に、以下を準備してください。
Function Compute 3.0 関数。詳細については、「関数の作成」をご参照ください。
ゲートウェイインスタンス、HTTP API、サービス、およびルートを作成するための Cloud-native API Gateway へのアクセス。
関数をクラウドネイティブ API Gateway と統合する
ステップ 1: 関数の作成
ステップ 2: バックエンドサービスの設定
2.1 ゲートウェイインスタンスの作成
Cloud-native API Gateway でゲートウェイインスタンスを作成します。詳細については、「ゲートウェイインスタンスの作成」をご参照ください。
2.2 HTTP API の作成
ゲートウェイインスタンスの下に HTTP API を作成します。詳細については、「HTTP API の作成」をご参照ください。
2.3 サービスの作成
ご利用の FC 関数を指すサービスを作成します。詳細については、「サービスの作成」をご参照ください。
2.4 ルートの作成
HTTP API をバックエンドサービスに接続するルートを作成します。詳細については、「ルートの作成」をご参照ください。
以下のパラメーターを設定します。残りのパラメーターはデフォルト値のままにします。
| パラメーター | 説明 |
|---|---|
| ドメイン名 | サービスにアクセスするために使用されるドメイン。図に示されている example.com はプレースホルダーです。独自のドメインを追加して選択してください。 |
| [パス] | ルーティングパス。異なるパスは異なる関数をトリガーします。 |
| バックエンドサービス | ステップ 2.3 で作成したバックエンドサービス。 |
2.5 ルーティングルールの公開
ルートをアクティブにするためにルーティングルールを公開します。詳細については、「ルーティングルールの公開」をご参照ください。
ステップ 3: 統合の検証
サービスにバインドされている環境の第 2 レベルドメイン名を取得します。
公開された API を呼び出します。次の例では curl を使用します。
curl -i -X GET env-ct6ovnem1hknd****-cn-hangzhou.alicloudapi.com/fc成功した応答は次のようになります。
HTTP/1.1 200 OK access-control-expose-headers: Date,x-fc-request-id content-disposition: attachment content-length: 11 content-type: application/json x-fc-request-id: 1-674eae6c-15b2172f-7db950e70148 date: Tue, 03 Dec 2024 07:08:28 GMT req-cost-time: 29 req-arrive-time: 1733209708197 resp-start-time: 1733209708226 x-envoy-upstream-service-time: 28 server: istio-envoy hello world
次のステップ
認証およびトラフィック制御ポリシーを管理するには、「Cloud-native API Gateway ドキュメント」をご参照ください。
代わりに従来の API Gateway をトリガーとして使用するには、「API Gateway トリガー」をご参照ください。