Lambda + API Gateway ハンズオン

マネジメントコンソールで 「Lambda」→「関数の作成」 をクリックします。「一から作成」を選択します。

「関数の作成」をクリックします。これで handson-hello-role-xxxx という実行ロール（CloudWatch Logs への書き込み権限付き）が自動作成されます。

「コード」タブの lambda_function.py を以下に書き換え、「Deploy」 をクリックします。

import json
import os

def lambda_handler(event, context):
    # クエリ文字列から name を取得（HTTP API の形式）
    params = event.get("queryStringParameters") or {}
    name = params.get("name", "World")

    # 環境変数を参照
    greeting = os.environ.get("GREETING", "Hello")

    print(f"Request received: name={name}")  # CloudWatch Logs に出力

    body = {
        "message": f"{greeting}, {name}!",
        "stage": os.environ.get("STAGE", "dev")
    }
    return {
        "statusCode": 200,
        "headers": {"Content-Type": "application/json"},
        "body": json.dumps(body, ensure_ascii=False)
    }

「設定」タブ → 「環境変数」→「編集」 をクリックし、以下を追加します。

「保存」をクリックします。コードを変更せずに挙動を切り替えられるのが環境変数の利点です。

「テスト」タブを開き、テストイベントを作成します。

イベント JSON に以下を入力して「テスト」をクリックします。

{
  "queryStringParameters": { "name": "田中" }
}

実行結果に以下のようなレスポンスが返れば成功です。

{
  "statusCode": 200,
  "headers": { "Content-Type": "application/json" },
  "body": "{\"message\": \"こんにちは, 田中!\", \"stage\": \"dev\"}"
}

「概要」に実行時間・課金時間・使用メモリも表示されます。

Lambda の関数画面で 「トリガーを追加」 をクリックし、「API Gateway」 を選択します。

「追加」をクリックします。Lambda プロキシ統合された API が自動生成されます。

「API Gateway」コンソール を開き、作成された API（handson-hello-API）を選択します。「ルート」を開き、デフォルトルートを GET /hello に整えます（自動生成は ANY /handson-hello 等になる場合があるため）。

API の詳細画面に表示される 「Invoke URL」（例: https://abcd1234.execute-api.ap-northeast-1.amazonaws.com）を控え、curl で呼び出します。

「CloudWatch」→「ログ」→「ロググループ」 を開き、/aws/lambda/handson-hello を選択します。最新のログストリームを開きます。

ステップ 3 で呼び出したリクエストの Request received: name=Taro や、START / END / REPORT 行（実行時間・課金時間・メモリ使用量）が記録されています。

START RequestId: 1a2b3c... Version: $LATEST
Request received: name=Taro
END RequestId: 1a2b3c...
REPORT RequestId: 1a2b3c...  Duration: 1.45 ms  Billed Duration: 2 ms  Memory Size: 128 MB  Max Memory Used: 39 MB

コードに raise Exception("test error") を一時的に追加して Deploy し、API を叩くとログにスタックトレースが記録され、API は 500 を返します。確認後は元に戻します。

「コード」タブでコードを編集し「Deploy」を押すだけで即時反映されます。小さな修正に向いています。

外部ライブラリを含む場合は zip でデプロイします。CloudShell で以下を実行します。

「バージョン」→「新しいバージョンを発行」で不変のスナップショット（v1, v2…）を作成できます。prod エイリアスを特定バージョンに向けることで、API からは prod を参照させ、裏で安全に切り替えられます。