はじめに

この記事は、SAM版ハンズオン記事の比較版です。

SAM版ではコマンド数本でインフラが完成しましたが、「その裏で何が起きているのか？」「SAMを使わない場合はどれだけ手間がかかるのか？」 を実感してもらうために、全く同じメモアプリAPIをAWSコンソールのみで手作業で構築する手順を詳細に解説します。

この記事を読むとわかること：

• AWS各サービス（DynamoDB・IAM・Lambda・API Gateway）を個別に設定する流れ
• SAMが裏側で自動処理していること（IAMロール・API Gatewayルーティング・権限付与など）
• SAMとコンソール手動操作、それぞれの使いどころ

SAM vs コンソール：どれだけ違うか

まず差分を数字で確認します。

「それでもコンソール操作を知っておく価値はあるか？」という問いに対して、答えは Yes です。

コンソール操作が特に有効な場面：

• 障害調査 — 実際にどのリソースがどう設定されているか目視確認する
• SAMのデバッグ — SAMでデプロイしたリソースをコンソールで確認・修正する
• 初学習 — 各サービスの設定項目を理解するための最初の一歩

Amazon検索[本 AWS 開発]

構築するもの

SAM版と全く同じ構成・機能のAPIを構築します。

インターネット
  ↓ HTTPS
API Gateway（Prod ステージ）
  ↓ Lambdaプロキシ統合
Lambda（MemoFunction / Python 3.12）
  ↓ boto3
DynamoDB（memo-api-dynamodb-stack-Memos テーブル）

全体の作業順序

SAMは依存関係を自動解決しますが、コンソールでは依存する順番通りに作成する必要があります。

① DynamoDB テーブル作成
      ↓（テーブル名が必要）
② IAM ロール作成（Lambda実行用）
      ↓（ロールARNが必要）
③ Lambda 関数作成（zipアップロード・環境変数設定）
      ↓（関数ARNが必要）
④ API Gateway 作成・リソース・メソッド設定・デプロイ
      ↓
⑤ Lambda に API Gateway からの実行許可を確認・付与

この順序を守らないと、設定画面で参照先リソースが見つからずエラーになります。

① DynamoDB テーブル作成

AWSコンソール → DynamoDB → テーブル → 「テーブルの作成」

設定値

「テーブルの作成」ボタンをクリック。作成完了まで数十秒待ちます。

▶ 控えておく情報：

• テーブル名: memo-api-dynamodb-stack-Memos

キャパシティーモードはオンデマンドを選ぶ理由：
デフォルトの「プロビジョンド」はあらかじめ読み書き容量を指定して課金されます。学習目的ではアクセスがない時間も課金されてしまうため、アクセスがあった分だけ課金される「オンデマンド」を選択します。SAMの BillingMode: PAY_PER_REQUEST に相当します。

② IAM ロール作成（Lambda実行用）

AWSコンソール → IAM → ロール → 「ロールを作成」

SAMでは DynamoDBCrudPolicy を1行書くだけで自動生成されていたIAMロールを、ここでは手動で作成します。

2-1. 信頼ポリシーの設定

「次へ」をクリックします。

2-2. 許可ポリシーのアタッチ（CloudWatch Logs 用）

検索ボックスに AWSLambdaBasicExecutionRole と入力してチェックを入れます。

→ 「次へ」

2-3. ロール名を設定して作成

「ロールを作成」をクリックします。

2-4. DynamoDB CRUD 権限をインラインポリシーで追加

作成したロール memo-api-lambda-role を開き → 「許可を追加」→「インラインポリシーを作成」→「JSON」タブ を選択して以下を貼り付けます：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:Scan",
        "dynamodb:Query"
      ],
      "Resource": "arn:aws:dynamodb:ap-northeast-1:*:table/memo-api-dynamodb-stack-Memos"
    }
  ]
}

ポリシー名（例: DynamoDBCrudPolicy-Memos）を入力して「ポリシーの作成」をクリックします。

▶ 控えておく情報：

• ロール ARN（例: arn:aws:iam::123456789012:role/memo-api-lambda-role）

SAMとの差分： SAMの DynamoDBCrudPolicy は必要な6つのDynamoDBアクションとCloudWatch Logs権限を1行で自動付与します。コンソールでは「管理ポリシーのアタッチ」と「インラインポリシーの作成」の2手順が必要です。

③ Lambda 関数作成

3-1. Lambdaコードをzipファイルに圧縮する（ローカル作業）

src/app.py と src/requirements.txt を zip 圧縮します。

Windowsエクスプローラーでの操作：

1. src/ フォルダを開く
2. app.py と requirements.txt を両方選択
3. 右クリック → 「ZIPファイルに圧縮」
4. lambda.zip という名前で保存

【注意】フォルダごとではなくファイルを直接zipする

src/ フォルダ自体を右クリックしてzipすると、中身のパスが src/app.py になります。LambdaはCodeUri直下に app.py があることを期待するため、フォルダの中身のファイルを選択してからzipしてください。フォルダごと圧縮するとパスが変わって Handler: app.lambda_handler が見つからずエラーになります。

コードの内容はSAM版ハンズオン記事のStep 3を参照してください。

3-2. Lambda 関数の作成

AWSコンソール → Lambda → 関数 → 「関数の作成」

「関数の作成」をクリックします。

3-3. コードのアップロード

関数ページ → 「コードソース」セクション → 「アップロード元」→「.zip ファイル」→ lambda.zip を選択 → 「保存」

3-4. ハンドラーの設定

「コード」タブ → 画面を下にスクロール → 「ランタイム設定」→「編集」

「保存」をクリックします。

ハンドラーを変更する理由：
Lambda のデフォルトハンドラーは lambda_function.lambda_handler（lambda_function.py を参照）。本ハンズオンのコードは app.py なので、変更しないと No module named 'lambda_function' エラーになります。

3-5. 環境変数の設定

「設定」タブ → 「環境変数」→「編集」→「環境変数を追加」

「保存」をクリックします。

SAMとの差分： SAMでは template.yaml の Environment.Variables.TABLE_NAME: !Ref MemosTable が自動でテーブル名を解決して設定します。コンソールでは①で作成したテーブル名を手動でコピーして貼り付ける必要があります。

3-6. タイムアウトの設定

「設定」タブ → 「一般設定」→「編集」

「保存」をクリックします。

▶ 控えておく情報：

• 関数 ARN（例: arn:aws:lambda:ap-northeast-1:123456789012:function:MemoFunction）

④ API Gateway 作成・設定・デプロイ

ここが最も手順が多いセクションです。5エンドポイント × 複数設定 = 大量のクリック作業になります。SAMが Events: セクションの数行で自動処理していた部分を全て手動で設定します。

4-1. REST API の作成

AWSコンソール → API Gateway → 「APIを作成」

「APIを作成」をクリックします。

4-2. リソース /memos の作成

「リソース」→「リソースを作成」

「リソースを作成」をクリックします。

4-3. POST /memos メソッドの作成

/memos リソースを選択 →「メソッドを作成」

「メソッドを作成」をクリックします。

「Lambda プロキシ統合」をオンにする理由：
オンにすると、HTTPリクエスト全体（メソッド・パス・ボディ・ヘッダー）がそのままLambdaの event に渡されます。オフにすると、マッピングテンプレートを別途設定する必要があり手順が大幅に増えます。SAMはデフォルトでプロキシ統合を使用します。

4-4. GET /memos メソッドの作成

/memos リソースを選択 →「メソッドを作成」

「メソッドを作成」をクリックします。

4-5. リソース /memos/{id} の作成

/memos リソースを選択 →「リソースを作成」

「リソースを作成」をクリックします。

{id} は波括弧ごと入力する
{id} と入力することで API Gateway がパスパラメータとして認識し、Lambda の event['pathParameters']['id'] で受け取れるようになります。

4-6. GET /memos/{id} メソッドの作成

/memos/{id} リソースを選択 →「メソッドを作成」

「メソッドを作成」をクリックします。

4-7. PUT /memos/{id} メソッドの作成

/memos/{id} リソースを選択 →「メソッドを作成」

「メソッドを作成」をクリックします。

4-8. DELETE /memos/{id} メソッドの作成

/memos/{id} リソースを選択 →「メソッドを作成」

「メソッドを作成」をクリックします。

4-9. API のデプロイ

「APIをデプロイ」ボタンをクリックします。

「デプロイ」をクリックします。

ステージ画面の「呼び出し URL」に表示されるURLを控えておきます：

https://xxxxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/Prod

▶ 控えておく情報：

• 呼び出し URL（テストで使います）

⑤ Lambda に API Gateway からの実行許可を確認・付与

API GatewayがLambdaを呼び出す権限を確認します。

Lambda プロキシ統合でメソッドを作成した際に「Lambda関数に権限を追加しますか？」という確認ダイアログが表示されて「OK」をクリックした場合は、この手順は自動で完了しています。

もし 403 Forbidden エラーが出た場合は、以下の手順で手動付与します：

Lambda → 対象関数 → 「設定」タブ → 「リソースベースのポリシーステートメント」→「追加」

テスト（CMDでの動作確認）

テスト手順はSAM版と同じです。コンソールで取得した呼び出し URLを使って実行します。

set API_URL=https://xxxxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/Prod

POST /memos — メモを作成する

curl -s -X POST "%API_URL%/memos" -H "Content-Type: application/json" -d "{\"title\":\"初めてのメモ\",\"content\":\"DynamoDBに保存されます\"}"

レスポンス例：

{
  "memoId": "6150433b-4834-4cfe-81f5-266d3dad9e57",
  "title": "初めてのメモ",
  "content": "DynamoDBに保存されます",
  "createdAt": "2026-02-20T10:00:00.000000+00:00",
  "updatedAt": "2026-02-20T10:00:00.000000+00:00"
}

GET /memos — メモ一覧を取得する

curl -s "%API_URL%/memos"

GET /memos/{id} — メモ1件を取得する

curl -s "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57"

PUT /memos/{id} — メモを更新する

curl -s -X PUT "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57" -H "Content-Type: application/json" -d "{\"title\":\"更新後タイトル\",\"content\":\"内容も更新しました\"}"

DELETE /memos/{id} — メモを削除する

curl -s -X DELETE "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57"

CMDでのテストの詳細な注意点（変数未設定によるCloudFront 400エラーなど）はSAM版ハンズオン記事のStep 9を参照してください。

⑥ リソースの削除（コンソール）

削除する順番が重要です（依存関係の逆順）。 SAMなら sam delete 1コマンドで完了するところを、4サービスを個別に手動削除します。

1. API Gateway を削除する

API Gateway → MemoApi を選択 → 「削除」→ 確認テキストを入力 → 「削除」

2. Lambda を削除する

Lambda → 関数 → MemoFunction を選択 → 「アクション」→「削除」→ 確認テキストを入力 → 「削除」

3. IAM ロールを削除する

IAM → ロール → memo-api-lambda-role を選択 → 「削除」→ ロール名を入力 → 「削除」

4. DynamoDB テーブルを削除する

DynamoDB → テーブル → memo-api-dynamodb-stack-Memos → 「削除」→ テーブル名を入力して確認 → 「削除」

SAMとの差分： SAMの sam delete は CloudFormation スタックを削除することで、S3・Lambda・API Gateway・DynamoDB・IAMロールを一括で削除します。コンソールでは依存関係の逆順に4サービスを個別に削除する必要があります。

まとめ

今回の手順で確認したこと

コンソール操作を通じて、SAMが裏側で自動処理している内容が明確になりました：

コンソール操作で学べたこと

• IAMロールの構造 — 信頼ポリシー（誰がロールを使えるか）とアクセス許可ポリシー（何ができるか）の2層構造
• API Gatewayの仕組み — リソース（パス）とメソッド（HTTPメソッド）を組み合わせてエンドポイントを定義する
• Lambdaプロキシ統合 — リクエスト全体をeventとしてLambdaに渡す仕組み
• リソース間の依存関係 — 作成順序・削除順序が決まっている理由

どちらを使うべきか

関連記事

• SAM版ハンズオン — VS Codeで全自動デプロイ

AWS初心者ハンズオン - Lambda＋API Gateway＋DynamoDBでメモアプリAPIを作ろう【Windows対応】

はじめに「AWSのサーバーレスを試してみたい」「Lambda・API Gateway・DynamoDBを組み合わせて何か作ってみたい」と思っていませんか？この記事では、AWS SAM（Serverless Application Model...

caymezon.com

2026.02.20

Amazon検索[本 AWS 開発]

The post AWSコンソールだけでメモアプリAPIを構築する手順【Lambda＋API Gateway＋DynamoDB / SAMとの比較付き】 first appeared on CayTech Lab.

はじめに

「AWSのサーバーレスを試してみたい」「Lambda・API Gateway・DynamoDBを組み合わせて何か作ってみたい」と思っていませんか？

この記事では、AWS SAM（Serverless Application Model） を使って、メモの作成・取得・更新・削除ができるREST APIをゼロから構築するハンズオンを紹介します。

このハンズオンで実際に作るもの：

インターネット
  ↓ HTTPS
API Gateway（Prod ステージ）
  ↓ プロキシ統合
Lambda（Python 3.12）
  ↓ boto3
DynamoDB（メモデータを保存）

この記事の特徴：

• Macユーザー向けの記事が多い中、Windows（VSCode）での実際の操作手順を詳細に解説
• 実際にハマった Windowsならではのエラーと対処法 を丁寧に紹介
• VSCode上でCMD・PowerShell・Git Bashを使い分ける際の注意点も解説
• ハンズオン完了後のリソース削除手順まで含めた完全ガイド

Amazon検索[本 AWS 開発]

前提条件

以下のツールがインストール・設定済みであることを確認してください。

必要なツール

AWS認証の確認

aws sts get-caller-identity

上記コマンドでアカウントIDが表示されれば認証設定済みです。表示されない場合は aws configure で認証情報を設定してください。

アーキテクチャと使用サービス

使用するAWSサービス

学習目的の短時間ハンズオンであれば、ほぼ無料枠内で収まります。
ただし、ハンズオン完了後は必ずリソースを削除してください。

APIエンドポイント設計

Step 1: プロジェクトフォルダの作成

フォルダ構造

memo-api-dynamodb/
├── template.yaml       # SAMテンプレート（インフラ定義）
├── samconfig.toml      # デプロイ設定（gitignore対象・手動作成が必要）
├── README.md
└── src/
    ├── app.py          # Lambda関数（CRUD処理）
    └── requirements.txt

作業ディレクトリを開く

VSCodeでターミナルを開き、プロジェクトを管理したいディレクトリに移動します。

cd C:\my-aws\aws-learning-projects
mkdir memo-api-dynamodb
cd memo-api-dynamodb
mkdir src

Step 2: SAMテンプレートの作成（template.yaml）

memo-api-dynamodb/template.yaml を作成します。このファイルがAWSリソース全体の設計図です。

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: Memo API with Lambda, API Gateway, and DynamoDB

Globals:
  Function:
    Runtime: python3.12
    Timeout: 30
    MemorySize: 128
    Environment:
      Variables:
        # Lambda関数からDynamoDBテーブル名を参照するための環境変数
        TABLE_NAME: !Ref MemosTable

Resources:

  # DynamoDB テーブル
  MemosTable:
    Type: AWS::DynamoDB::Table
    Properties:
      # スタック名をテーブル名に含めることで、複数環境でも名前が衝突しない
      TableName: !Sub "${AWS::StackName}-Memos"
      # PAY_PER_REQUEST: アクセスがない時間は課金ゼロ（学習・開発に最適）
      BillingMode: PAY_PER_REQUEST
      AttributeDefinitions:
        - AttributeName: memoId
          AttributeType: S   # S = String
      KeySchema:
        - AttributeName: memoId
          KeyType: HASH      # パーティションキー（一意のID）

  # Lambda 関数（全エンドポイントを1つの関数で処理）
  MemoFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: src/
      Handler: app.lambda_handler
      Description: CRUD handler for Memo API
      Policies:
        # DynamoDBCrudPolicy: SAM組み込みのポリシーテンプレート
        # GetItem / PutItem / UpdateItem / DeleteItem / Scan / Query が自動付与される
        - DynamoDBCrudPolicy:
            TableName: !Ref MemosTable
      Events:
        # POST /memos - メモ作成
        CreateMemo:
          Type: Api
          Properties:
            Path: /memos
            Method: post
        # GET /memos - メモ一覧取得
        ListMemos:
          Type: Api
          Properties:
            Path: /memos
            Method: get
        # GET /memos/{id} - メモ1件取得
        GetMemo:
          Type: Api
          Properties:
            Path: /memos/{id}
            Method: get
        # PUT /memos/{id} - メモ更新
        UpdateMemo:
          Type: Api
          Properties:
            Path: /memos/{id}
            Method: put
        # DELETE /memos/{id} - メモ削除
        DeleteMemo:
          Type: Api
          Properties:
            Path: /memos/{id}
            Method: delete

# Outputs: デプロイ後に表示される情報
Outputs:
  MemoApiUrl:
    Description: "Memo API エンドポイント URL"
    Value: !Sub "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod"
  MemoFunctionArn:
    Description: "Lambda 関数 ARN"
    Value: !GetAtt MemoFunction.Arn
  DynamoDBTableName:
    Description: "DynamoDB テーブル名"
    Value: !Ref MemosTable

template.yaml のポイント解説

Transform: AWS::Serverless-2016-10-31
CloudFormationをSAM用に拡張する宣言。これがないと AWS::Serverless::Function などのSAMリソースが使えません。

BillingMode: PAY_PER_REQUEST
DynamoDBの課金モード。リクエストがない時間は課金ゼロなので、学習・開発用途に最適です。

DynamoDBCrudPolicy
SAMが提供する組み込みポリシーテンプレート。自分でIAMポリシーをゼロから書く必要がなく、必要最小限の権限（CRUD操作のみ）が自動付与されます。

Step 3: Lambda関数の作成（src/app.py）

memo-api-dynamodb/src/app.py を作成します。

"""
メモアプリ API - Lambda 関数
Lambda + API Gateway + DynamoDB による CRUD API の実装
"""
import json
import os
import uuid
from datetime import datetime, timezone

import boto3

# DynamoDB クライアント初期化
# テーブル名は環境変数 TABLE_NAME から取得（template.yaml で設定）
dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table(os.environ['TABLE_NAME'])


# -------------------------------------------------------
# ヘルパー関数
# -------------------------------------------------------

def success(body, status_code=200):
    """成功レスポンスを生成する共通関数"""
    return {
        'statusCode': status_code,
        'headers': {
            'Content-Type': 'application/json',
            'Access-Control-Allow-Origin': '*',  # CORS対応
        },
        'body': json.dumps(body, ensure_ascii=False),
    }


def error(message, status_code=400):
    """エラーレスポンスを生成する共通関数"""
    return {
        'statusCode': status_code,
        'headers': {
            'Content-Type': 'application/json',
            'Access-Control-Allow-Origin': '*',
        },
        'body': json.dumps({'error': message}, ensure_ascii=False),
    }


def now_iso():
    """現在時刻を ISO 8601 形式（UTC）で返す"""
    return datetime.now(timezone.utc).isoformat()


# -------------------------------------------------------
# CRUD 処理
# -------------------------------------------------------

def create_memo(body):
    """POST /memos - メモを新規作成する"""
    if not body:
        return error('リクエストボディが空です', 400)

    data = json.loads(body)
    title = data.get('title', '').strip()
    content = data.get('content', '').strip()

    if not title:
        return error('title は必須です', 400)

    memo_id = str(uuid.uuid4())  # UUID でユニークなIDを自動生成
    timestamp = now_iso()

    item = {
        'memoId': memo_id,
        'title': title,
        'content': content,
        'createdAt': timestamp,
        'updatedAt': timestamp,
    }
    table.put_item(Item=item)

    return success(item, 201)


def list_memos():
    """GET /memos - メモ一覧を取得する"""
    result = table.scan()  # テーブル全件取得
    items = result.get('Items', [])

    # createdAt の降順（新しい順）でソート
    items.sort(key=lambda x: x.get('createdAt', ''), reverse=True)

    return success({'memos': items, 'count': len(items)})


def get_memo(memo_id):
    """GET /memos/{id} - 指定IDのメモを1件取得する"""
    result = table.get_item(Key={'memoId': memo_id})
    item = result.get('Item')

    if not item:
        return error(f'memoId={memo_id} のメモが見つかりません', 404)

    return success(item)


def update_memo(memo_id, body):
    """PUT /memos/{id} - 指定IDのメモを更新する"""
    if not body:
        return error('リクエストボディが空です', 400)

    # 更新前に存在確認
    check = table.get_item(Key={'memoId': memo_id})
    if not check.get('Item'):
        return error(f'memoId={memo_id} のメモが見つかりません', 404)

    data = json.loads(body)
    title = data.get('title', '').strip()
    content = data.get('content', '').strip()

    if not title:
        return error('title は必須です', 400)

    timestamp = now_iso()

    result = table.update_item(
        Key={'memoId': memo_id},
        UpdateExpression='SET title = :title, content = :content, updatedAt = :updatedAt',
        ExpressionAttributeValues={
            ':title': title,
            ':content': content,
            ':updatedAt': timestamp,
        },
        ReturnValues='ALL_NEW',  # 更新後の全属性を返す
    )

    return success(result['Attributes'])


def delete_memo(memo_id):
    """DELETE /memos/{id} - 指定IDのメモを削除する"""
    # 削除前に存在確認
    check = table.get_item(Key={'memoId': memo_id})
    if not check.get('Item'):
        return error(f'memoId={memo_id} のメモが見つかりません', 404)

    table.delete_item(Key={'memoId': memo_id})

    return success({'message': f'memoId={memo_id} を削除しました'})


# -------------------------------------------------------
# エントリーポイント（ルーター）
# -------------------------------------------------------

def lambda_handler(event, context):
    """
    API Gateway からのリクエストを受け取り、
    HTTPメソッドとパスに応じて適切な関数に振り分ける
    """
    http_method = event.get('httpMethod', '')
    path = event.get('path', '')
    path_parameters = event.get('pathParameters') or {}
    body = event.get('body')

    try:
        if http_method == 'POST' and path == '/memos':          # POST /memos - メモ作成
            return create_memo(body)

        elif http_method == 'GET' and path == '/memos':         # GET /memos - メモ一覧取得
            return list_memos()

        elif http_method == 'GET' and 'id' in path_parameters:  # GET /memos/{id} - メモ1件取得
            return get_memo(path_parameters['id'])

        elif http_method == 'PUT' and 'id' in path_parameters:  # PUT /memos/{id} - メモ更新
            return update_memo(path_parameters['id'], body)

        elif http_method == 'DELETE' and 'id' in path_parameters:  # DELETE /memos/{id} - メモ削除
            return delete_memo(path_parameters['id'])

        else:
            return error('エンドポイントが存在しません', 404)

    except json.JSONDecodeError:
        return error('リクエストボディのJSONが不正です', 400)
    except Exception as e:
        print(f'Unexpected error: {e}')  # CloudWatch Logs に記録
        return error('サーバー内部エラーが発生しました', 500)

Step 4: requirements.txtの作成

memo-api-dynamodb/src/requirements.txt を作成します。

# boto3 is included in the Lambda runtime, no need to list it here.
# Add external libraries here if needed.
# Example: requests==2.31.0

【Windows注意点】requirements.txt に日本語コメントを書いてはいけない

requirements.txt に日本語コメントを書くと、sam build で以下のエラーが発生します：

Build Failed
Error: PythonPipBuilder:ResolveDependencies - 'cp932' codec can't decode byte 0x84 in position 43: illegal multibyte sequence

原因： Windows の SAM CLI（PythonPipBuilder）は requirements.txt を cp932（Shift-JIS）で読み込もうとします。UTF-8で書かれた日本語文字をcp932として解釈しようとするとエラーになります。

対処： requirements.txt のコメントは必ず英語で書きましょう。template.yaml のコメントはSAMがpipに直接渡さないため日本語でも問題ありません。

Step 5: Gitリポジトリの初期化

cd C:\my-aws\aws-learning-projects\memo-api-dynamodb
git init

.gitignore を作成します：

# SAM関連（デプロイ設定・ビルド成果物）
samconfig.toml
.aws-sam/

# Python
__pycache__/
*.pyc
.venv/

# テスト用の一時ファイル
test_*.json

samconfig.toml はGit管理外にする理由： リージョン名やスタック名など環境固有の設定が含まれるためです。チームで開発する場合も、各自が自分の環境に合わせて作成します。

初期コミット：

git add template.yaml src/app.py src/requirements.txt .gitignore README.md
git commit -m "memo-api-dynamodb: プロジェクトフォルダと基本ファイルを作成"

Step 6: samconfig.tomlの作成

samconfig.toml は .gitignore で管理外になっているため、手動で作成します。memo-api-dynamodb/samconfig.toml を新規作成し、以下を貼り付けてください：

version = 0.1

[default.deploy.parameters]
stack_name = "memo-api-dynamodb-stack"
resolve_s3 = true
s3_prefix = "memo-api-dynamodb-stack"
region = "ap-northeast-1"
confirm_changeset = true
capabilities = "CAPABILITY_IAM"
disable_rollback = true
image_repositories = []

[default.global.parameters]
region = "ap-northeast-1"

【注意】samconfig.toml の置き場所

samconfig.toml は memo-api-dynamodb/ フォルダの直下 に置く必要があります。
別のフォルダに置いてしまうと、sam deploy で以下のエラーが発生します：

Error: Missing option '--stack-name', 'sam deploy --guided' can be used to provide and save needed parameters for future deploys.

Step 7: sam build（ビルド）

sam build

成功すると以下のように表示されます：

Build Succeeded

Built Artifacts  : .aws-sam/build
Built Template   : .aws-sam/build/template.yaml

Commands you can use next
=========================
[*] Validate SAM template: sam validate
[*] Invoke Function: sam local invoke
[*] Test Function in the Cloud: sam sync --stack-name {stack-name} --watch
[*] Deploy: sam deploy --guided

Step 8: sam deploy（デプロイ）

samconfig.tomlがある場合

sam deploy

初回に対話式で設定する場合（--guided）

samconfig.toml を作成していない場合は --guided オプションで対話式に設定できます。自動的に samconfig.toml が生成されます：

sam deploy --guided

以下のように順番に聞かれます：

Stack Name [sam-app]: memo-api-dynamodb-stack   ← これを入力
AWS Region [ap-northeast-1]: Enter（そのままEnter）
Confirm changes before deploy [Y/n]: Y（そのままEnter）
Allow SAM CLI IAM role creation [Y/n]: Y（そのままEnter）
Disable rollback [y/N]: y    ← yを入力
Save arguments to configuration file [Y/n]: Y（そのままEnter）
SAM configuration file [samconfig.toml]: Enter（そのままEnter）
SAM configuration environment [default]: Enter（そのままEnter）

最後に変更内容が表示されて Deploy this changeset? と聞かれるので y を入力します。

デプロイ完了の確認

デプロイが完了すると、ターミナルに Outputs が表示されます：

CloudFormation outputs from deployed stack
---------------------------------------------------------------------------------------------------------------
Outputs
---------------------------------------------------------------------------------------------------------------
Key                 MemoApiUrl
Description         Memo API エンドポイント URL
Value               https://xxxxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/Prod
---------------------------------------------------------------------------------------------------------------

この URL を控えておいてください。 テストで使います。

Step 9: 動作テスト

デプロイで取得したURLを使ってAPIをテストします。

VSCode上のターミナルの選択肢

VSCodeでは複数のターミナルが使えますが、コマンドの書き方が異なります：

CMD でのテスト手順

まずAPI URLを変数にセットします：

set API_URL=https://xxxxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/Prod

POST /memos — メモを作成する

curl -s -X POST "%API_URL%/memos" -H "Content-Type: application/json" -d "{\"title\":\"初めてのメモ\",\"content\":\"DynamoDBに保存されます\"}"

レスポンス例：

{
  "memoId": "6150433b-4834-4cfe-81f5-266d3dad9e57",
  "title": "初めてのメモ",
  "content": "DynamoDBに保存されます",
  "createdAt": "2026-02-20T10:00:00.000000+00:00",
  "updatedAt": "2026-02-20T10:00:00.000000+00:00"
}

返ってきた memoId を控えておいてください。 以降のコマンドで使います。

GET /memos — メモ一覧を取得する

curl -s "%API_URL%/memos"

GET /memos/{id} — メモ1件を取得する

curl -s "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57"

PUT /memos/{id} — メモを更新する

curl -s -X PUT "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57" -H "Content-Type: application/json" -d "{\"title\":\"更新後タイトル\",\"content\":\"内容も更新しました\"}"

【Windows CMD 注意点】PUT/DELETEでのURL変数エラー

以下のように %MEMO_ID% を使って変数でIDを指定しようとするとエラーが発生することがあります：

set MEMO_ID=6150433b-4834-4cfe-81f5-266d3dad9e57
curl -s -X PUT "%API_URL%/memos/%MEMO_ID%" ...

400 ERROR - Bad request (Generated by cloudfront)

原因： CMDでは変数を set してもターミナルセッションを閉じると消えます。新しいターミナルを開いて %MEMO_ID% を使うと変数が未設定のまま %MEMO_ID% という文字列がURLに含まれてしまいます。CloudFrontは % をパーセントエンコーディングの開始として解釈するため、不正なURLとして400エラーを返します。

対処： UUIDを直接URLに貼り付けて実行してください。

DELETE /memos/{id} — メモを削除する

curl -s -X DELETE "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57"

エラー確認（404テスト）

削除済みのIDで取得を試みて404が返ることを確認：

curl -s "%API_URL%/memos/6150433b-4834-4cfe-81f5-266d3dad9e57"

{"error": "memoId=6150433b-4834-4cfe-81f5-266d3dad9e57 のメモが見つかりません"}

Git Bash でのテスト手順（参考）

bash構文が使えるので、より読みやすく書けます：

API_URL="https://xxxxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/Prod"
MEMO_ID="6150433b-4834-4cfe-81f5-266d3dad9e57"

# POST
curl -s -X POST "${API_URL}/memos" \
  -H "Content-Type: application/json" \
  -d '{"title":"初めてのメモ","content":"テスト"}'

# GET一覧
curl -s "${API_URL}/memos"

# PUT
curl -s -X PUT "${API_URL}/memos/${MEMO_ID}" \
  -H "Content-Type: application/json" \
  -d '{"title":"更新後タイトル","content":"内容も更新"}'

# DELETE
curl -s -X DELETE "${API_URL}/memos/${MEMO_ID}"

VSCodeでGit Bashターミナルを使う方法：
ターミナルパネルの右上にある + ボタンの横の ∨ をクリック → Git Bash を選択

Step 10: AWS管理コンソールで確認

テスト後、AWSマネジメントコンソールからも各サービスの状態を確認できます。

DynamoDB

DynamoDB → テーブル → memo-api-dynamodb-stack-Memos → 「テーブルアイテムの探索」

作成したメモのデータが保存されていることを確認できます。

Lambda

Lambda → 関数 → memo-api-dynamodb-stack-MemoFunction-XXXX

関数の設定・環境変数・モニタリングが確認できます。

CloudWatch Logs（エラー確認）

Lambda → 対象関数 → 「モニタリング」タブ → 「CloudWatch Logs を表示」

エラーが発生した場合はここでログを確認します。print() で出力した内容もここに記録されます。

Step 11: リソースの削除

課金を止めるために、ハンズオン完了後は必ずリソースを削除してください。

sam delete --stack-name memo-api-dynamodb-stack --region ap-northeast-1

対話式で確認が入ります：

        Are you sure you want to delete the stack memo-api-dynamodb-stack in the region ap-northeast-1 ? [y/N]: y
        Are you sure you want to delete the folder memo-api-dynamodb-stack in S3 which contains the artifacts? [y/N]: y

両方 y で進めると数分で削除が完了します。

削除完了の確認

aws cloudformation describe-stacks --stack-name memo-api-dynamodb-stack --region ap-northeast-1

An error occurred (ValidationError) when calling the DescribeStacks operation: Stack with id memo-api-dynamodb-stack does not exist

このメッセージが表示されれば削除完了です。

注意： DynamoDB テーブル内のデータも同時に削除されます。必要なデータは事前にエクスポートしてください。

トラブルシューティング一覧

実際のハンズオン中に遭遇したエラーと対処法をまとめました。

まとめ

今回のハンズオンで実現したこと：

• SAMテンプレート1ファイルでLambda・API Gateway・DynamoDBの3サービスを一括定義
• CRUD 5エンドポイント（POST/GET/GET{id}/PUT/DELETE）を持つREST APIを構築
• sam build → sam deploy → sam delete のサーバーレスアプリのライフサイクルを体験
• Windows特有のハマりポイント（cp932エラー・CMDの変数・curlの書き方の違い）を解消

Macで書かれたAWSチュートリアルをWindowsで試してエラーが出た経験がある方も多いと思います。この記事でそのハマりポイントが解決できれば幸いです。

SAMがやってくれていたことをコンソールで確認する

「SAMは便利だけど、裏で何をやっているのかわからない」と感じた方向けに、全く同じAPIをAWSコンソールのみで手動構築する手順を比較記事としてまとめました。

コンソールで手動構築すると何が起きるか（一部抜粋）：

操作ステップ数はSAMの約5ステップに対してコンソール手動は約50〜60クリック。SAMの価値をコンソール操作を通じて実感できます。

• AWSコンソールだけでメモアプリAPIを構築する手順【SAMとの比較付き】

AWSコンソールだけでメモアプリAPIを構築する手順【Lambda＋API Gateway＋DynamoDB / SAMとの比較付き】

はじめにこの記事は、SAM版ハンズオン記事の比較版です。SAM版ではコマンド数本でインフラが完成しましたが、「その裏で何が起きているのか？」「SAMを使わない場合はどれだけ手間がかかるのか？」 を実感してもらうために、全く同じメモアプリAP...

caymezon.com

2026.02.20

次のステップ

このハンズオンを完成させたら、以下の発展的な内容にもチャレンジしてみてください：

• API Key認証の追加 — 外部からの不正アクセスを防ぐ
• Cognito認証の追加 — ユーザーごとにメモを管理する
• フロントエンドと連携 — React/Vue.jsからこのAPIを呼び出す
• CI/CDパイプラインの構築 — GitHub ActionsでSAMデプロイを自動化

Amazon検索[本 AWS 開発]

The post AWS初心者ハンズオン - Lambda＋API Gateway＋DynamoDBでメモアプリAPIを作ろう【Windows対応】 first appeared on CayTech Lab.