INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:LambdaとAPI Gateway:入力・テスト・失敗調査

API Gateway入門:HTTP APIとLambdaの連携・認可を図解

Amazon API Gatewayは、アプリからのAPI要求を受け取り、設定した処理先へつなぐAWSサービスです。 Lambdaが処理を実行し、API Gatewayは要求の振り分けやアクセス制御、HTTP応答への受け渡しを担います。「レポートを1件取得する」例で、入口から応答までを追いましょう。

この教材で学ぶこと

用途に合うAPI種別を選び、HTTP APIの1要求について、ルート・認可・Lambda統合・応答を説明し、失敗した段階を根拠から区別できる。

先に知っておくこと

Lambdaのイベント・ハンドラー・戻り値とログの違い・実行ロールと、HTTP要求にメソッド・パス・応答コードがあること。必要な用語は本文でも説明します。AWSアカウントや課金操作は不要です。固定の架空例を読み、選択問題で確かめます。実APIの作成・呼出しやトークン入力は行いません。

何を公開したいかで、APIの種類を選ぶ

APIは、アプリ同士が決めた形式で要求と応答をやり取りするための窓口です。ここでは「GETで指定したレポートの情報を返す」という約束を作ります。API Gateway自体がレポートの業務判断や保存をすべて引き受けるわけではありません。

三つの製品名を、用途で読み分ける
種類選ぶ理由の例この教材での扱い
HTTP APIHTTPの要求・応答でLambdaへつなぎ、JWTによるアクセス制御を使いたい。この教材の中心。必要な機能が足りることを確認して選ぶ。
REST APIprivate API endpoint、AWS WAF連携、リクエスト検証や利用プラン等が必要。HTTP APIとの差を知る。構築手順は扱わない。
WebSocket API接続を維持し、チャット等でサーバー側からもメッセージを送りたい。1要求1応答とは異なる用途として区別する。

LambdaをHTTPで呼ぶ方式にはfunction URLもあります。この教材は、ルートとJWT authorizerを持つHTTP APIを選んだ場合を学びます。Lambdaを使うならAPI Gatewayが必須、とはしません。

選択すると、正誤と理由が表示されます。

Lambdaでレポートを取得し、JWTで利用を制限したい。private API endpointや利用プランは不要。まず検討できるものは?
答えと理由を読む

正解:HTTP API · この要件にはHTTP APIのLambda統合とJWT authorizerが対応します。料金だけでなく、必要な機能が揃うかで選びます。

ルートは「何を求めたか」、統合は「どこで処理するか」

要求を読むための四つの用語
用語意味固定例
メソッド / パス何の操作を、どの対象へ求めるか。GETは取得の要求。GET /reports/demo-001
ステージ(stage)デプロイしたAPIを利用する環境・参照先。ルートの照合より先に選ばれる。この例では到達すべきステージが選択済み。
ルート(route)HTTPメソッドとパスの組合せで、受け付ける要求を表す。GET /reports/{reportId}
統合(integration)選ばれたルートを、処理するLambda等のbackendへつなぐ設定。この例はLambda proxy integration、payload format 2.0。
要求を受け取り、処理して、HTTP応答を返す
要求を受け取り、処理して、HTTP応答を返す1: アプリの要求 — HTTP要求 — API Gateway. 2: API Gateway — 同期呼出し — Lambda12アプリの要求API GatewayLambda要求を受け取り、処理して、HTTP応答を返す1: アプリの要求 — HTTP要求 — API Gateway. 2: API Gateway — 同期呼出し — Lambda12アプリの要求API GatewayLambda
  1. アプリの要求 → API GatewayHTTP要求
  2. API Gateway → Lambda同期呼出し
アプリの要求
GET /reports/demo-001を要求する。
API Gateway
ルートを照合し、この例のJWT認可を確認。
Lambda
渡されたイベントを処理し、応答を返す。

図の矢印は要求の向きです。応答は逆に、Lambdaの応答 → API Gateway → 呼び出したアプリへ返ります。API Gatewayは同期呼出しの結果を待って、HTTP応答へ受け渡します。Lambdaからアプリへ直接接続し直す図ではありません。

選択すると、正誤と理由が表示されます。

R1でPOST /reports/demo-001が来た。GETルートと、パスの文字列が同じならLambdaへ届く?
答えと理由を読む

正解:届かない。この設計では一致するルートがない · GET以外のルートもANY/$defaultもないため、この要求に対応する統合は選ばれません。実構成にfallbackがあれば別です。

固定例:要求がイベントになり、応答がHTTPになる

イベントはLambdaへ渡す入力です。このHTTP APIでは、イベントと応答の形式であるpayload format 2.0を選びます。GET /reports/demo-001のdemo-001は、pathParameters.reportIdに入ります。任意のevent.reportIdを自動で作るわけではありません。API種別やformat versionを変えると入力形式も変わるので、混ぜて読みません。

R1:HTTP APIのイベントの抜粋(送信・実行しない)長い行は横スクロールで読めます。コード欄では左右キーを使えます。
{
  "version": "2.0",
  "routeKey": "GET /reports/{reportId}",
  "pathParameters": {
    "reportId": "demo-001"
  },
  "requestContext": {
    "http": {
      "method": "GET"
    },
    "authorizer": {
      "jwt": {
        "claims": {
          "sub": "reader-demo"
        },
        "scopes": [
          "reports:read"
        ]
      }
    }
  }
}

Lambdaのハンドラーは、reportIdの形式、利用者にそのレポートを見せてよいか、対象データがあるかを判断します。この例ではdemo-001が閲覧可能で、状態readyを返すという与件です。返すのはレポートの情報で、PDF本体ではありません。保存先への接続や実データの検索は実装・実行しません。

R1:Lambdaが返す応答オブジェクトの例長い行は横スクロールで読めます。コード欄では左右キーを使えます。
{
  "statusCode": 200,
  "headers": {
    "content-type": "application/json"
  },
  "body": "{\"reportId\":\"demo-001\",\"state\":\"ready\"}",
  "isBase64Encoded": false
}
オブジェクトの外側と、HTTP本文を区別する
項目意味
statusCode: 200HTTPの応答コード。この例では正常な取得応答と指定した。
headerscontent-typeで本文をJSONとして扱うことを示す。
bodyJSON文書を表す文字列。外側のJSONでは引用符がエスケープされる。
isBase64Encoded: falseこの例のbodyはBase64符号化ではない。

選択すると、正誤と理由が表示されます。

R1の抜粋で、ハンドラーがレポートIDを読む場所は?
答えと理由を読む

正解:event.pathParameters.reportId · ルートの{reportId}に対応した値を、format 2.0のpathParametersから読みます。形式の確認や対象単位の認可も別に必要です。

利用者の認可と、AWS側の権限を分ける

JWT(JSON Web Token)は、主体等を表すclaimという情報を持つトークン形式です。発行者(issuer)はトークンを発行したID基盤を識別する値、宛先(audience)はそのトークンの想定利用先を識別する値です。JWT authorizerは、設定した発行者・宛先等に照らして署名や時刻条件を検証し、ルートにscopeを設定した場合はその条件も確認します。scopeはreports:readのような利用範囲を表す名前です。ここでの認証は提示されたトークンの主体情報を信頼できるか、認可は要求された利用を許すか、という別の問いです。単に文字列をデコードしただけでは検証になりません。

同じ「許可」でも、主体と対象が違う
境界確認するもの代用できないもの
利用者 → APIルートJWT authorizerと、ここではreports:readというroute scope。レポート単位のアプリ内認可、LambdaのAWS権限。
API Gateway → Lambdaこの例では、関数のresource-based policyにあるinvoke許可と対象API等の範囲。利用者本人のJWT検証。
Lambda → AWS資源関数のexecution role(実行ロール)と対象資源への権限。APIルートを利用する人の認可。
利用者 → 個々のレポート検証済み主体と対象の所有・共有条件等を、アプリ内で照合。route scopeだけで全レポートへの閲覧を認めること。

選択すると、正誤と理由が表示されます。

reports:readを持つ検証済みの利用者なら、全員分のレポートを返してよい?
答えと理由を読む

正解:アプリで利用者と対象レポートの関係も確認する · JWTの検証とroute scopeだけでは対象単位の権限は完成しません。検証済みの主体と、所有・共有等の条件を照合します。

JWT認可が通ったが、API Gatewayから関数へのinvoke許可が不足。どこを確認する?
答えと理由を読む

正解:対象関数のresource-based policyのinvoke許可 · 利用者→APIとAPI Gateway→関数は別の境界です。対象API等に範囲を絞ったinvoke許可を確認します。

同じエラーコードでも、どこで止まったかを確かめる

入口・呼出し・関数の応答を分ける
段階例確認する根拠
API / stage / route到達先やメソッド/パスが合わない。該当routeなしはNot Found。到達先、stage、定義したroute、fallbackの有無。
JWT authorizer無効なaudience等で401の応答。JWT authorizer設定、応答のwww-authenticate等。生トークンを共有しない。
Lambdaの呼出しLambda APIがinvoke要求を拒否した場合は500。対象関数・invoke許可と、利用可能な統合エラー情報。
関数 / 応答形式関数エラーや不正な応答形式では502。同じ要求に対応する関数の記録、返した形式、統合情報。
アプリが意図して返すHTTP結果許可された検索範囲に対象がなく、正しい形式で404を返す等。アプリの判定と明示したstatusCode。関数呼出し自体の失敗とは別。
固定例R2/R3:Not Foundの意味を、与えられた根拠から読む
例与えられた条件読み取ること
R2R1設計へPOSTで要求。一致するrouteなし。Lambdaは呼ばれていない。入口のメソッド/routeの不一致。レポートDBを直す根拠はまだない。
R3GET routeと認可が一致。Lambdaは実行済み。対象がなく、関数が明示的な404応答を返した。アプリの対象検索の結果。GET routeがないという結論ではない。

実調査では時刻・対象API/stage・requestId等を揃え、設定したアクセスログと関数側の記録を照合します。ログはstageごとに別途有効化するもので、見つからないことだけで「呼ばれていない」とは断定しません。表の500/502も、世の中の全500/502を一意に診断する表ではありません。API GatewayのrequestContext.requestIdとLambdaのawsRequestIdを同じ値と仮定せず、対象・版・時刻と、確認できた要求の対応関係から照合します。

選択すると、正誤と理由が表示されます。

R2とR3の根拠が与えられた。最も適切な判断は?
答えと理由を読む

正解:R2はroute照合、R3はアプリの対象検索を調べる · R2は入口で不一致、R3は実行後にアプリが404を返しています。与件のある段階から調べ、無関係な権限を広げません。

待てる時間と、システム全体の費用を確認する

2026-10-26に確認した、この方式の仕様値
対象仕様値読み違えないこと
HTTP APIのintegration timeout最大30秒、増加不可。Lambdaのtimeoutを長くしても、この待ち時間の上限は伸びない。
HTTP APIのpayload10 MB。Lambda連携全体で10 MBの本文を必ず送れるわけではない。
通常の同期Event Functiontimeout最大900秒。buffered要求/応答は各6 MB。イベントの包みや符号化にもサイズが必要。HTTP APIの待ち時間や受入容量を上書きしない。

HTTP APIとREST APIはAPI呼出しや外向きデータ転送、WebSocket APIはメッセージと接続時間が費用要因です。Lambdaの要求数・実行時間、ログ等の関連サービス費用も別に考えます。この教材を読むためのAWS利用はありませんが、同じ構成を実AWSに作れば無料とは限りません。地域・利用量・アカウントの無料枠やcredit条件は、実装前に最新の料金資料で確認します。

選択すると、正誤と理由が表示されます。

R4でLambdaのtimeoutだけを900秒にすれば、45秒後の完了結果を同じHTTP API応答で必ず返せる?
答えと理由を読む

正解:保証できない。HTTP APIの待ち時間に合う処理方式が必要 · 45秒の最終結果を待つ要件は30秒に収まりません。短縮や受付/完了を分ける方式を検討します。

実AWSに同じ構成を作る前の、適切な費用確認は?
答えと理由を読む

正解:API Gatewayだけでなく、Lambda・転送・ログ等と利用条件を確認する · APIの呼出し料金だけでは全体費用になりません。無料枠の条件や対象期間もアカウントごとに確認します。

確認して、自分の言葉で説明する

  1. GET /reports/demo-001を、メソッド・パス・stage・route・integrationに分けて説明する。
  2. 利用者のJWT認可、API Gatewayのinvoke許可、関数の実行ロール、対象レポートの認可を分ける。
  3. R2/R3の失敗段階と、R4の待ち時間の不適合を、与えられた根拠から説明する。
理解を確かめる: レポート取得用のHTTP APIを設計するとき、Lambdaを選んだだけでは決まらないものは?

受け付けるメソッドとパス、stage/routeと統合、利用者と対象の認可、サービス間権限、イベント/応答形式、期限・容量・費用を決める。

Lambdaは業務処理を動かす部分です。APIへの到達、許可、データの受け渡し、HTTPの結果を別々に設計すると、失敗した段階も根拠から調べられます。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。