Lambda、DynamoDB、API Gateway でサーバーレス CRUD API を構築する

DynamoDB は注文を保存する場所です。各注文を識別する partition key が必要で、ここでは文字列型の orderId を使います。

1. AWS Console で DynamoDB を開き、Create table を選びます。
2. Table name: Orders と入力します。
3. Partition key: orderId と入力し、データ型は String を選びます。
4. Default settings のまま Create table を押します。

Lambda 関数には、DynamoDB の読み書きと CloudWatch へのログ送信を許可する execution role が必要です。関数作成時に割り当てられるよう、先にこのロールを作成します。

1. IAM → Roles → Create role を開き、trusted entity で AWS service → Lambda を選びます。
2. managed policy を 2 つ付与します: AmazonDynamoDBFullAccess と AWSLambdaBasicExecutionRole。
3. ロール名を LambdaOrderRole にして作成を完了します。

この関数は注文の JSON body を受け取り、Orders テーブルへそのまま書き込みます。作成時は、Lambda が既定のロールを自動生成するのではなく、手順 2 の execution role を割り当てます。

1. Lambda → Create function → Author from scratch を開きます。
2. Function name: CreateOrderFunction。Runtime: Python 3.14（または最新版）。
3. Additional settings を開き、Custom execution role で Use an existing role を選び、LambdaOrderRole を指定します。
4. Create function を押します。
5. コードエディターで既定コードをすべて下記に置き換え、Deploy を押します。

import json
import boto3

dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('Orders')

def lambda_handler(event, context):
    body = json.loads(event.get('body', '{}'))
    table.put_item(Item=body)
    return {
        'statusCode': 200,
        'body': json.dumps('Order created successfully!')
    }

この関数は query string から orderId を読み取り、DynamoDB を照会して注文を返します。DecimalEncoder は DynamoDB の Decimal 型を JSON 生成時に数値へ変換します。

1. 手順 3 と同じ Create function の流れを、名前を GetOrderFunction にして繰り返します。
2. Runtime は Python、Custom execution role は LambdaOrderRole を選びます。
3. Create function を押します。
4. 既定コードを下記に置き換え、Deploy を押します。

import json
import boto3
from decimal import Decimal

class DecimalEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, Decimal):
            if obj % 1 == 0:
                return int(obj)
            return float(obj)
        return super(DecimalEncoder, self).default(obj)

dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('Orders')

def lambda_handler(event, context):
    try:
        order_id = event['queryStringParameters']['orderId']
        response = table.get_item(Key={'orderId': order_id})
        return {
            'statusCode': 200,
            'body': json.dumps(response.get('Item', {}), cls=DecimalEncoder)
        }
    except Exception as e:
        print(f"Error: {str(e)}")
        return {
            'statusCode': 500,
            'body': json.dumps("ERROR.")
        }

API Gateway は Lambda の前段にある公開の入口です。まず REST API を作成し、注文用の method をまとめる /orders リソースを追加します。

1. API Gateway を開き、REST API（Private ではない方）を見つけて Build を押します。
2. New API を選び、API name を OrderAPI にして Create API を押します。
3. Resources 画面で Create resource を押します。
4. Resource name に orders と入力し、Create resource を押します。

各 method は HTTP 動詞を Lambda 関数に結び付けます。Lambda proxy integration を有効にすると、API Gateway が request 全体（body、query string）を Lambda の event に渡します。

1. /orders リソース → Create method → POST を選びます。
2. Lambda proxy integration をチェックし、Lambda function 欄に CreateOrderFunction と入力して保存します。
3. 続けて /orders → Create method → GET を選びます。
4. Lambda proxy integration をチェックし、GetOrderFunction と入力して保存します。

API は stage へ deploy して初めて外部からアクセスできます。stage は動作確認用の Invoke URL が生成される場所でもあります。

1. Deploy API を押します。
2. Stage で New stage を選び、Stage name を dev にします。
3. Deploy を押します。
4. Invoke URL（https://xxxx.execute-api.<region>.amazonaws.com/dev の形）を控えます。

Postman、cURL、または reqbin.com で API を呼び出します。まず POST で注文を作成し、次に GET で参照して全体の流れを確認します。

1. https://<INVOKE_URL>/orders に、下記の JSON Body を付けて POST を送ります。
2. レスポンスは 'Order created successfully!'、ステータス 200 になります。
3. https://<INVOKE_URL>/orders?orderId=123 に GET を送ります。
4. GET のレスポンスとして、作成した注文の JSON が返ります。

{ "orderId": "123", "item": "Laptop", "price": 1500 }

実データが書き込まれたことの最終確認として、Orders テーブルを開いて item を見ます。

1. DynamoDB → Explore items → Orders テーブルを選びます。
2. Run を押して全 item を Scan します。
3. 作成した注文が正しい orderId、item、price で表示されることを確認します。

コストや不要なリソースを残さないよう、逆順で削除します。

1. API Gateway で REST API OrderAPI を削除します。
2. Lambda で CreateOrderFunction と GetOrderFunction を削除します。
3. DynamoDB で Orders テーブルを削除します。
4. IAM で不要になった LambdaOrderRole を削除します。