aws apigatewayv2コマンドでHTTP APIを設計する方法｜Lambda統合・Cognitoオーソライザー・スロットリングの実践構成

この記事のポイント

・HTTP API（V2）はREST APIより70%安く、aws apigatewayv2コマンドで一気に構築できる
・Lambdaプロキシ統合ではstatusCode+bodyを返す形式を守ることが最重要
・CognitoオーソライザーでJWT認証をLambda不要で設定できる
・スロットリングとアクセスログは本番公開前に必ず設定する

# HTTP API（V2）向けLambdaハンドラー（Python 3.12）
import json

def lambda_handler(event, context):
    # パスとメソッドを取得
    path    = event.get('rawPath', '/')
    method  = event.get('requestContext', {}).get('http', {}).get('method', 'GET')
    # クエリパラメータを取得（未指定時は空dict）
    params  = event.get('queryStringParameters') or {}
    # リクエストボディを取得（POST/PUT時）
    body    = event.get('body', '')

    # statusCode + body が必須（これがないと502 Bad Gatewayになる）
    return {
        "statusCode": 200,
        "headers": {"Content-Type": "application/json"},
        "body": json.dumps({"message": "Hello from Lambda", "path": path})
    }

# ステップ1: Lambda関数をデプロイ
zip function.zip lambda_function.py
aws lambda create-function \
  --function-name my-api-handler \
  --runtime python3.12 \
  --role arn:aws:iam::123456789012:role/lambda-basic-role \
  --handler lambda_function.lambda_handler \
  --zip-file fileb://function.zip

# ステップ2: HTTP APIを作成（CORS設定込み）
aws apigatewayv2 create-api \
  --name my-http-api \
  --protocol-type HTTP \
  --cors-configuration \
    AllowOrigins='["https://example.com"]',AllowMethods='["GET","POST"]',AllowHeaders='["Content-Type","Authorization"]'

# 出力例:
# {
#   "ApiId": "abc12345",
#   "ApiEndpoint": "https://abc12345.execute-api.ap-northeast-1.amazonaws.com",
#   ...
# }

# ステップ3: Lambda統合を作成
aws apigatewayv2 create-integration \
  --api-id abc12345 \
  --integration-type AWS_PROXY \
  --integration-uri arn:aws:lambda:ap-northeast-1:123456789012:function:my-api-handler \
  --payload-format-version 2.0

# IntegrationId を控える: "IntegrationId": "xyz78901"

# ステップ4: ルートを作成（GET /items にマッピング）
aws apigatewayv2 create-route \
  --api-id abc12345 \
  --route-key "GET /items" \
  --target "integrations/xyz78901"

# ステップ5: $defaultステージを作成してauto-deploy有効化
aws apigatewayv2 create-stage \
  --api-id abc12345 \
  --stage-name '$default' \
  --auto-deploy

# ステップ6: Lambdaの呼び出し権限をAPI Gatewayに付与
aws lambda add-permission \
  --function-name my-api-handler \
  --statement-id allow-api-gateway \
  --action lambda:InvokeFunction \
  --principal apigateway.amazonaws.com \
  --source-arn "arn:aws:execute-api:ap-northeast-1:123456789012:abc12345/*"

# 動作確認
curl https://abc12345.execute-api.ap-northeast-1.amazonaws.com/items

# レスポンス例
{"message": "Hello from Lambda", "path": "/items"}

# Cognitoユーザープールを確認
aws cognito-idp list-user-pools --max-results 10 \
  --query 'UserPools[*].[Id,Name]' --output table

# JWTオーソライザーを作成（Cognito連携）
aws apigatewayv2 create-authorizer \
  --api-id abc12345 \
  --name cognito-jwt-auth \
  --authorizer-type JWT \
  --identity-source '$request.header.Authorization' \
  --jwt-configuration \
    Audience=your-app-client-id,Issuer=https://cognito-idp.ap-northeast-1.amazonaws.com/ap-northeast-1_XXXXXXXXX

# 出力から AuthorizerId を控える: "AuthorizerId": "auth9012"

# ルートにオーソライザーを適用
aws apigatewayv2 update-route \
  --api-id abc12345 \
  --route-id route-id \
  --authorization-type JWT \
  --authorizer-id auth9012

# CloudWatch Logsのロググループを作成
aws logs create-log-group \
  --log-group-name /aws/apigateway/my-http-api

# スロットリングとアクセスログを同時に設定
aws apigatewayv2 update-stage \
  --api-id abc12345 \
  --stage-name '$default' \
  --default-route-settings \
    ThrottlingBurstLimit=200,ThrottlingRateLimit=100 \
  --access-log-settings \
    DestinationArn=arn:aws:logs:ap-northeast-1:123456789012:log-group:/aws/apigateway/my-http-api

# 現在のスロットリング設定を確認
aws apigatewayv2 get-stage \
  --api-id abc12345 \
  --stage-name '$default' \
  --query 'DefaultRouteSettings'

# アクセスログを確認
aws logs filter-log-events \
  --log-group-name /aws/apigateway/my-http-api \
  --limit 20 \
  --query 'events[*].message'

# Lambda関数のログでエラー詳細を確認
aws logs filter-log-events \
  --log-group-name /aws/lambda/my-api-handler \
  --filter-pattern ERROR \
  --limit 10 \
  --query 'events[*].message'

# NG: statusCodeなしのレスポンスは502になる
return {"message": "OK"}

# OK: statusCodeとbodyが必須
return {
    "statusCode": 200,
    "body": json.dumps({"message": "OK"})
}

# Lambda関数の権限ポリシーを確認
aws lambda get-policy \
  --function-name my-api-handler \
  --query 'Policy' --output text | python3 -m json.tool

# 権限がない場合は追加
aws lambda add-permission \
  --function-name my-api-handler \
  --statement-id allow-apigw-invoke \
  --action lambda:InvokeFunction \
  --principal apigateway.amazonaws.com