結論
AWS Lambda(ラムダ)は、サーバーを用意せずに、イベントが起きたときだけコードを動かす AWS のサーバーレスの実行サービスです。料金は「リクエスト数」と「実行時間×メモリ(GB秒)」の従量制で、月100万リクエストと40万GB秒の無料利用枠があります(2026年11月18日時点)。
この記事でわかること
- イベント・関数・ランタイム・ハンドラーの関係と、呼び出し方の種類
- 公式の単価で月の費用を出す Python と、場面別の試算の表
- 上限の表・向く処理と向かない処理の判断表・EC2/ECS との違い
この記事で実際に動かしたもの:公式の単価で月の費用を出す Python、公式の S3 イベントの形を渡してハンドラーを手元で呼ぶ Python、処理の見込みを公式の上限と照らす Python。Lambda の関数は作っておらず、AWS には接続していません。
Lambda は「何かが起きたら、その分だけ短いプログラムを動かす」ための仕組みです。流れを図にすると次のようになります。
flowchart TD
E[イベントが起きる<br>S3 に保存・API に届く・時刻] --> T[トリガーが関数を呼ぶ]
T --> Q{使える実行環境がある?}
Q -->|ない| I[Init<br>ランタイム起動・ハンドラー外のコード]
I --> H
Q -->|ある| H[Invoke<br>ハンドラーが event を処理]
H --> R[結果を返す・ログを出す]
R --> F[実行環境は凍結され<br>次の呼び出しで再利用されうる]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| AWS Lambda とは | サーバーの管理なしに、イベントに応じてコードを動かすサービス | AWS Lambdaとは |
| Lambda の仕組み | トリガー→実行環境(ランタイム)→ハンドラーが event を処理 | Lambdaの仕組み |
| Lambda の料金 | 100万リクエストあたり 0.20 USD+GB秒あたり 0.0000166667 USD(x86) | AWS Lambdaの料金の仕組み |
| 無料でどこまで使えるか | 月100万リクエストと40万GB秒。128MB なら320万秒 | Lambdaの料金を計算する |
| 最大の実行時間 | 1回900秒(15分)。既定は3秒 | Lambdaの上限 |
| 対応している言語 | Node.js・Python・Java・.NET・Ruby。ほかの言語は OS のみのランタイムで | Lambdaの仕組み |
| 向かない処理 | 15分を超える処理・常に動かし続けるサーバー・大きな応答を同期で返す処理 | 向いている処理・向かない処理 |
| EC2・ECS との違い | Lambda は呼ばれた分だけ課金。EC2 は OS から自分で管理、ECS はコンテナ単位 | LambdaとEC2・ECSの違い |
| Python の lambda との違い | 別物。Python の lambda は名前のない小さな関数を書く構文 | AWS Lambdaとは |
確認環境:Ubuntu 24.04.5 LTS の上の Python 3.13.18 で、公式の料金ページの単価を使って月の費用を計算するスクリプト、公式ドキュメントの Amazon S3 の通知イベントの JSON をそのまま渡してハンドラーを呼ぶスクリプト、公式の上限の値と処理の見込みを照らすスクリプトを動かしました(AWS の認証情報は環境変数ごと外し、外部への送信はしていません)。Lambda の関数の作成・呼び出し、マネジメントコンソールの画面、実際の課金は行っておらず、仕組み・料金・上限・ランタイム・エラーの文言は AWS の公式(AWS Lambda 開発者ガイド・AWS Lambda の料金ページ・AWS の料金のしくみのホワイトペーパー・AWS のコンピューティングサービスの選び方のガイド)で1つずつ確かめました。図は mermaid で描画を確かめています(確認日 2026年11月18日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「AWS Lambdaとは|仕組み・料金の計算・できることと向かない処理」
AWS Lambdaとは(サーバーレスの実行サービス)
この節では、AWS Lambda が何をするサービスなのかと、「サーバーレス」の意味が分かります。
AWS Lambda は、コードを置いておくと、決めたイベントが起きたときだけ AWS がそれを動かしてくれるサービスです。 AWS の開発者ガイドは次のように説明しています。
AWS Lambda は、サーバーレスコンピューティングサービスです。Lambda を使用すると、サーバーをプロビジョニングまたは管理しなくてもコードを実行できます。
「サーバーレス」は、サーバーが無いという意味ではありません。サーバーはありますが、OS の更新・台数の増減・故障したときの入れ替えを AWS が受け持ち、使う側はコード(関数)と設定だけを用意します。ガイドは、Lambda がインフラストラクチャ(サーバーのメンテナンス・容量の用意・スケーリング・パッチの適用)を自動で管理するので、アプリケーションのロジックに集中できる、と書いています。
1呼ばれたときだけ動く
ファイルの保存・API へのリクエスト・決まった時刻などのイベントで動き、処理が終われば止まる。待っている間の実行時間には課金されない。
2増減は自動
呼び出しが増えると Lambda が実行環境を増やし、減れば片付ける。台数を決める作業が無い。
31回の処理は短く
1回の実行は最長15分。メモリは最大10,240MB。長く動かし続ける処理は別のサービスに向く。
「Lambda」で検索すると、Python の lambda 式の話も出てきますが、別物です。 Python の lambda は sorted(data, key=lambda x: x[1]) のように名前のない小さな関数をその場で書く構文で、AWS とは関係ありません。手元で動かすと [('c', 1), ('b', 2), ('a', 3)] のように並べ替えに使えます。Python の lambda 式の使い方は、関連記事「Python lambdaの使い方|sorted・map・filterのコピペ例一覧」で扱っています。
2026年の呼び方:Lambda Event Functions
開発者ガイドでは、従来からの Lambda の関数を Lambda Event Functions と呼ぶようになっています。ガイドによると、これは Lambda Web Functions・Lambda MicroVMs と区別するための名前で、API(CreateFunction・Invoke)、SDK、AWS CLI、ARN は引き続き「function」を使うので、コードや設定を変える要はない、と説明されています。この記事で「Lambda の関数」と書くときは、この Event Functions を指します。
Lambdaの仕組み:イベント・関数・ランタイム・ハンドラー
この節では、Lambda を理解するのに要る6つの言葉と、それぞれの関係が分かります。
トリガーがイベントを受けて関数を呼び、実行環境の中のランタイムが、関数のハンドラーに event を渡して動かします。 開発者ガイドの「Lambda の仕組み」の説明を、短くまとめると次の表になります。
| 言葉 | 意味(公式の説明の要約) | たとえば |
|---|---|---|
| 関数(function) | イベントに応じて動くコード。1つの関数は1つの仕事を受け持つ | 画像を縮小する関数 |
| イベント(event) | 関数に渡されるデータ。JSON で届き、言語のオブジェクトに変換される | 保存されたファイルのバケット名とキー |
| トリガー(trigger) | 関数をイベントの発生源につなぐ設定。1つの関数に複数つけられる | S3 への保存・API Gateway |
| 実行環境 | Lambda が管理する隔離された環境。関数を動かすプロセスと資源を持つ | メモリ 512MB の環境 |
| ランタイム | 実行環境の中で、Lambda と関数の間でイベントと応答を受け渡す言語ごとの環境 | python3.13・nodejs24.x |
| ハンドラー | イベントを処理するメソッド。関数のコードに複数の関数があっても、ハンドラーは1つ | lambda_function.lambda_handler |
コードと依存ライブラリはデプロイパッケージにまとめて渡します。形式は .zip ファイルとコンテナイメージの2つです。
Python のハンドラーの形
Python では、ハンドラーは引数を2つ取ります。1つ目が event、2つ目が context です。開発者ガイドは、引数が1つのハンドラーを定義すると、Lambda が実行しようとしたときにエラーになる、と書いています。ハンドラー名は「ファイル名.関数名」で、lambda_function.py の lambda_handler なら lambda_function.lambda_handler です。
def lambda_handler(event, context):
# event:トリガーから届いたデータ(JSON は dict に変換される)
# context:呼び出しの情報(リクエストID・残り時間など)
return {"statusCode": 200}
同期で呼ばれたときは、ハンドラーの戻り値が JSON にされて呼び出し元に返ります。return が無いときは null になり、非同期で呼ばれたときは戻り値は捨てられます。
対応しているランタイム(2026年11月18日時点)
開発者ガイドの「サポートされているランタイム」の表から、主なものを抜き出しました。プレビューの版は本番で使わないよう公式が案内しています。
| 言語 | 識別子(例) | OS | 非推奨になる日 |
|---|---|---|---|
| Python | python3.14・python3.13・python3.12 |
Amazon Linux 2023 | 2029年6月30日・2029年6月30日・2028年10月31日 |
| Node.js | nodejs24.x・nodejs22.x |
Amazon Linux 2023 | 2028年4月30日・2027年5月30日 |
| Java | java25・java21 |
Amazon Linux 2023 | 2029年6月30日 |
| .NET | dotnet10 |
Amazon Linux 2023 | 2028年11月14日 |
| Ruby | ruby4.0・ruby3.4 |
Amazon Linux 2023 | 2029年3月31日・2028年3月31日 |
| OS のみ(Go・Rust など) | provided.al2023 |
Amazon Linux 2023 | 2029年6月30日 |
表には、プレビューとして python3.15・nodejs26.x も載っています。公式は、これらは Lambda の SLA とテクニカルサポートの対象外で、本番では使わないように、と書いています。CPU のアーキテクチャは x86_64 と arm64(AWS Graviton)から選べ、公式は arm64 のほうが同じ関数を x86_64 で動かすより価格と性能で大きく有利になりうる、と説明しています。
Lambdaの呼び出し方とトリガーの種類
この節では、Lambda の関数がどこから・どう呼ばれるのかと、呼び出し方で何が変わるのかが分かります。
呼び出し方は「同期」「非同期」「イベントソースマッピング」の3つで、エラーのときの再試行のされ方が違います。 開発者ガイドは、トリガーとして API Gateway・Amazon S3・Amazon SQS・EventBridge のほか、200以上の AWS のサービスにつなげられる、と書いています。
| 呼び出し方 | 動き | 主な呼び出し元 | エラーのとき |
|---|---|---|---|
同期(RequestResponse) |
処理が終わるのを待ち、結果を受け取る | API Gateway・関数 URL・SDK や CLI からの直接の呼び出し | 呼び出し元にエラーが返る |
非同期(Event) |
Lambda がイベントをキューに入れ、すぐに成功を返す | Amazon S3・Amazon SNS など | 既定で2回まで再試行(1分後・2分後)。イベントの最大の保持は6時間 |
| イベントソースマッピング | Lambda がキュー・ストリームを読みに行き、まとめて(バッチで)渡す | Amazon SQS・Amazon Kinesis・Amazon DynamoDB・Amazon MSK など | 発生源ごとの設定による |
公式によると、直接のトリガー(S3・SNS・API Gateway など)は、イベントを出す側のサービスが Lambda に押し込む形で、トリガーの設定もそのサービスの側に保存されます。イベントソースマッピングは Lambda の側の設定で、大量のメッセージやストリームを効率よく処理するための仕組みです。
押し込まれる(直接のトリガー)
S3 にファイルが保存された
API Gateway にリクエストが届いた
設定はイベントを出すサービスの側
読みに行く(イベントソースマッピング)
SQS のキューにメッセージがたまった
Kinesis・DynamoDB のストリームに記録が来た
設定は Lambda の側。バッチで渡される
このほか、関数ごとに専用の HTTPS のエンドポイントを持たせる関数 URL もあります(形式は https://url-id.lambda-url.us-east-1.on.aws)。API Gateway との組み合わせ方は関連記事「API Gateway Lambda|REST APIとHTTP APIの違い」で扱っています。
AWS Lambdaの料金の仕組み(リクエスト数×GB秒)
この節では、Lambda の料金が何で決まるのかと、公式の単価・無料利用枠が分かります。
Lambda の関数(Event Functions)の料金は「リクエストの料金」と「実行時間の料金」の合計です。 実行時間の料金は、割り当てたメモリ(GB)×実行した秒数=GB秒で数えます。以下は AWS の料金ページ(米国東部(バージニア北部))の記載で、2026年11月18日時点の値です。
| 項目 | 単価・無料利用枠 | メモ |
|---|---|---|
| リクエスト | 100万リクエストあたり 0.20 USD | 1リクエストあたり 0.0000002 USD |
| 実行時間(x86) | GB秒あたり 0.0000166667 USD | 公式の計算例で使われている最初の段階の単価 |
| 実行時間(Arm) | GB秒あたり 0.0000133334 USD | 公式の計算例(Arm の関数)で使われている単価 |
| 無料利用枠 | 月100万リクエスト+月40万GB秒 | プロビジョニングされた同時実行を有効にした関数には適用されない |
| エフェメラルストレージ(/tmp) | 512MB までは追加料金なし。超えた分は GB秒あたり 0.0000000309 USD | x86・Arm のどちらでも設定できる |
- 実行時間は 1ms 単位で数えます。 料金ページは、メモリの大きさごとの「1ms あたりの料金」の表を載せています。
- 初期化(Init)の時間も実行時間に入ります。 AWS の公式ブログによると、2025年8月1日から、マネージドランタイムで .zip の関数をオンデマンドで呼んだときの Init の時間も課金の対象になりました(それまでは対象外でした)。
- 使用量が多い月は、段階的に単価が下がる区分があります。 料金ページは、最初の段階の例として「米国東部(オハイオ)で月60億GB秒まで」と書いており、段階は同じアーキテクチャの関数の合計に適用されます。
- Lambda の外の料金は別です。 ホワイトペーパーは、S3 の読み書き・保存や、関数を動かしたリージョンの外とのデータ転送には別に料金がかかる、と書いています。
- 1〜3年の利用を約束する Compute Savings Plans で、最大17%節約できる、とホワイトペーパーに記載があります。
料金はリージョンと時期で変わります。見積もりの前に、AWS の料金ページで最新の値を確かめるのが確実です。
Lambdaの料金を計算する(Pythonで月の費用を試算)
この節では、公式の単価で月の費用を出す方法と、場面ごとの金額の目安が分かります。
月の費用は「(リクエスト数−100万)×0.20 USD÷100万+(GB秒−40万)×GB秒の単価」で出せます。 公式の単価をそのまま使ったスクリプトを作り、手元で動かしました。
# AWS Lambda(Event Functions・オンデマンド)の月額を試算する
# 単価は AWS 公式の料金ページ(米国東部(バージニア北部))の記載。2026年11月18日に確認
REQ_PER_MILLION = 0.20 # USD / 100万リクエスト
GBS_X86 = 0.0000166667 # USD / GB秒(x86・最初の段階)
GBS_ARM = 0.0000133334 # USD / GB秒(Arm・公式の計算例で使われている単価)
FREE_REQ = 1_000_000 # 無料利用枠:月100万リクエスト
FREE_GBS = 400_000 # 無料利用枠:月40万GB秒
EPH_GBS = 0.0000000309 # エフェメラルストレージ 512MB 超の分 USD / GB秒
def monthly(requests, avg_ms, memory_mb, arch="x86", eph_mb=512, free=True):
sec = requests * avg_ms / 1000
gbs = sec * memory_mb / 1024
rate = GBS_X86 if arch == "x86" else GBS_ARM
bill_gbs = max(gbs - FREE_GBS, 0) if free else gbs
bill_req = max(requests - FREE_REQ, 0) if free else requests
compute = bill_gbs * rate
req = bill_req / 1_000_000 * REQ_PER_MILLION
eph = sec * max(eph_mb - 512, 0) / 1024 * EPH_GBS
return gbs, compute, req, eph, compute + req + eph
gbs, c, r, e, t = monthly(3_000_000, 120, 1536)
print(f"GB秒 {gbs:,.0f} / 実行時間 ${c:.2f} / リクエスト ${r:.2f} / 合計 ${t:.2f}")
まず、料金ページにある計算例(月300万回・平均120ms・メモリ1,536MB・x86)を再現しました。公式の答えと同じ 2.73 USD になりました。
== 公式の計算例の再現(300万回・120ms・1536MB・x86)==
GB秒 540,000 / 実行時間 $2.33 / リクエスト $0.40 / 合計 $2.73
場面別の月額(無料利用枠あり・なし)
同じスクリプトで、よくある場面の月額を出しました。「枠なし」は、無料利用枠を使い切ったあとや、他の関数とあわせて枠を超えている場合の目安です。
| 場面(回数・平均時間・メモリ) | GB秒 | 枠あり | 枠なし |
|---|---|---|---|
| 社内の通知(月3万回・200ms・128MB) | 750 | 0.00 USD | 0.02 USD |
| 画像の縮小(月10万回・1.5秒・1,024MB) | 150,000 | 0.00 USD | 2.52 USD |
| API(月300万回・120ms・512MB・x86) | 180,000 | 0.40 USD | 3.60 USD |
| API(同じ条件・Arm) | 180,000 | 0.40 USD | 3.00 USD |
| API(月3,000万回・120ms・512MB) | 1,800,000 | 29.13 USD | 36.00 USD |
| 重い集計(月1万回・60秒・2,048MB) | 1,200,000 | 13.33 USD | 20.00 USD |
月300万回の API では、費用の大半がリクエストの料金ではなく実行時間の料金です。 同じ条件なら、Arm にすると実行時間の分が約2割安くなりました(3.60 USD → 3.00 USD)。ただし、Arm で動かしたときの処理時間が x86 と同じとは限らないので、実際の時間を測ってから比べます。
無料利用枠の40万GB秒で動かせる時間
40万GB秒は、メモリを大きくするほど短くなります。
== 無料利用枠の40万GB秒で動かせる時間(メモリ別)==
128MB: 3,200,000 秒 = 888.9 時間 / 100msの呼び出しなら 32,000,000 回
512MB: 800,000 秒 = 222.2 時間 / 100msの呼び出しなら 8,000,000 回
1024MB: 400,000 秒 = 111.1 時間 / 100msの呼び出しなら 4,000,000 回
1769MB: 231,543 秒 = 64.3 時間 / 100msの呼び出しなら 2,315,432 回
3008MB: 136,170 秒 = 37.8 時間 / 100msの呼び出しなら 1,361,702 回
10240MB: 40,000 秒 = 11.1 時間 / 100msの呼び出しなら 400,000 回
128MB の「320万秒」は、ホワイトペーパーの「最大 320 万秒のコンピューティング時間」と一致します。100ms の呼び出しなら、128MB では GB秒の枠より先に100万リクエストの枠を使い切ります。
メモリを増やすと高くなるとは限らない
Lambda は、メモリに比例して CPU の力を割り当てます(1,769MB で1 vCPU 相当、と公式に記載)。CPU を使う処理では、メモリを倍にすると時間が縮むことがあり、時間がちょうど半分になれば GB秒は変わりません。
== メモリを倍にして時間が半分になった場合(月100万回・枠なし・x86)==
512MB × 800ms: GB秒 400,000 月額 $6.87
1024MB × 400ms: GB秒 400,000 月額 $6.87
2048MB × 200ms: GB秒 400,000 月額 $6.87
2048MB × 300ms: GB秒 600,000 月額 $10.20
最後の行のように、時間が思ったほど縮まなければ費用は上がります。メモリの値は、実際の処理時間を何通りか測って決めます。
Lambdaの上限(タイムアウト・メモリ・ペイロード)
この節では、Lambda で決まっている主な上限の値と、超えそうなときの考え方が分かります。
設計でまず効くのは、実行時間900秒・メモリ10,240MB・同期のペイロード6MB・非同期のペイロード1MB・.zip の展開後250MB の5つです。 開発者ガイドの「Lambda のクォータ」から抜き出しました(2026年11月18日時点)。
| 項目 | 上限 | メモ |
|---|---|---|
| タイムアウト | 900秒(15分) | 既定は3秒。Managed Instances の非同期などは5,400秒まで |
| メモリ | 128MB〜10,240MB(1MB きざみ) | 既定は128MB。1,769MB で1 vCPU 相当 |
| ペイロード(同期) | リクエスト・応答それぞれ6MB | ストリーミングの応答は200MB まで |
| ペイロード(非同期) | 1MB | S3 の通知などのイベントの大きさ |
| デプロイパッケージ(.zip) | アップロード50MB・展開後250MB | レイヤーを含む。大きいファイルは S3 経由 |
| コンテナイメージ | 10GB(展開後・全レイヤー込み) | 大きな依存ライブラリはこちら |
/tmp |
512MB〜10,240MB | 512MB を超えた分は課金 |
| 環境変数・レイヤー | 環境変数は合計4KB・レイヤーは5つまで | 大きな設定値は別の保管場所へ |
| 同時実行数 | リージョンごとに1,000(引き上げを申請できる) | 新しいアカウントは低めに始まり、使用量に応じて上がる |
処理の見込みを上限と照らすスクリプトを作り、5つの例で試しました。
サムネイル作成 収まる
Webhookの受け口 収まる
CSVを受けて返すAPI 収まらない: ペイロード 8MB > 6MB(同期)
夜間の集計 収まらない: 実行時間 1800s > 900s
機械学習の推論 収まらない: 展開後 1800MB > 250MB(コンテナイメージなら10GBまで)
「収まらない」ときの考え方は、上限の種類で決まります。
- 1ペイロードが大きい → データは S3 に置き、イベントではキーだけ渡す同期6MB・非同期1MB を超えないようにする
- 2ライブラリが大きい → コンテナイメージで配る.zip の展開後250MB に対し、イメージは10GB まで
- 315分を超える → 処理を分ける1件ずつの処理に分けて SQS で流す、複数の手順を順につなぐ
- 4分けられない長い処理 → コンテナや仮想サーバーへECS(Fargate)・EC2 を選ぶ
タイムアウトの直し方は、関連記事「Task timed out afterの直し方|Lambdaタイムアウト原因別」で原因別に扱っています。
コールドスタートと実行環境の再利用
この節では、Lambda の1回目の呼び出しが遅くなる理由と、実行環境がどう使い回されるかが分かります。
使える実行環境が無いときは、Lambda がコードを取ってきて環境を立ち上げ、ハンドラーの外のコードを動かしてからハンドラーを呼びます。この準備がコールドスタートです。 開発者ガイドは、実行環境のライフサイクルを Init・Invoke・Shutdown の3つに分けて説明しています。
Init(初期化)
拡張機能の起動、ランタイムの起動、関数のハンドラーの外のコード(import や SDK のクライアントの作成)の実行。オンデマンドの関数では10秒までで、終わらなければ最初の呼び出しのときに、関数のタイムアウトの時間でやり直す。
Invoke(呼び出し)
ハンドラーが event を処理する。関数のタイムアウトは、このフェーズ全体の長さを区切る。
凍結と再利用
呼び出しが終わると実行環境は凍結され、同じ関数に次のリクエストが来れば再利用されうる。ハンドラーの外で作ったオブジェクトや /tmp の中身は残る。
Shutdown(終了)
使われなくなった環境は片付けられる。公式は、動き続けている関数でも数時間ごとに実行環境を入れ替える、と書いている。
公式によると、コールドスタートは呼び出しの1%未満で起き、長さは100ms 未満から1秒を超えるものまであります。先に書いたとおり、Init の時間も課金の対象です。
手元で、ハンドラーの外に呼び出し回数を数える変数を置き、同じプロセスで2回呼ぶと、2回目は前の値を引き継ぎました(次の節の calls_in_this_env が 1 → 2)。Lambda でも、再利用された実行環境では同じことが起きます。このため、利用者ごとのデータをハンドラーの外の変数や /tmp に残さないことが大切です。 開発者ガイドも、呼び出しをまたいだ情報の漏れを防ぐため、実行環境に利用者のデータを保存しないよう勧めています。
コールドスタートを減らす SnapStart・プロビジョニングされた同時実行は、関連記事「Lambdaコールドスタート対策|SnapStartとプロビジョンド同時実行の比較」で比べています。
Lambdaのハンドラーを手元で呼んでみる(公式のS3イベントの形)
この節では、Lambda に渡される event が実際にどんな形で、ハンドラーがそれをどう読むのかが分かります。
ハンドラーはただの関数なので、event の dict と、context の代わりのオブジェクトを渡せば手元でも呼べます。 event には、開発者ガイドの「Amazon S3 の通知イベントの例」の JSON をそのまま使いました(S3 は関数を非同期で呼びます)。
{
"Records": [
{
"eventVersion": "2.1",
"eventSource": "aws:s3",
"awsRegion": "us-east-2",
"eventTime": "2019-09-03T19:37:27.192Z",
"eventName": "ObjectCreated:Put",
"s3": {
"s3SchemaVersion": "1.0",
"bucket": {
"name": "amzn-s3-demo-bucket",
"arn": "arn:aws:s3:::lambda-artifacts-deafc19498e3f2df"
},
"object": {
"key": "b21b84d653bb07b05b1e6b33684dc11b",
"size": 1305107,
"eTag": "b21b84d653bb07b05b1e6b33684dc11b",
"sequencer": "0C0F6F405D6ED209E1"
}
}
}
]
}
(公式の例には userIdentity・requestParameters・responseElements なども入っています。ここでは紙面の都合で省きましたが、実行には全部入りの952バイトの JSON を使いました。)
ハンドラーは、保存されたファイルのバケット名・キー・大きさを取り出して返すだけにしました。
import json
import time
import urllib.parse
# ハンドラーの外:実行環境ができたとき(Init)に1回だけ動く
INIT_AT = time.time()
CALLS = 0
def lambda_handler(event, context):
global CALLS
CALLS += 1
out = []
for rec in event["Records"]:
bucket = rec["s3"]["bucket"]["name"]
key = urllib.parse.unquote_plus(rec["s3"]["object"]["key"])
size = rec["s3"]["object"]["size"]
out.append({"bucket": bucket, "key": key, "size_kb": round(size / 1024, 1)})
return {
"statusCode": 200,
"calls_in_this_env": CALLS,
"request_id": context.aws_request_id,
"remaining_ms": context.get_remaining_time_in_millis(),
"objects": out,
}
S3 のイベントのキーは URL エンコードされて届くため、unquote_plus で戻しています。呼び出し側では、context の一部(リクエスト ID と残り時間)だけを真似たクラスを作り、2回続けて呼びました。
import json, time
import lambda_function as lf
class FakeContext:
"""Lambda の context の一部だけを真似る(手元の確認用)"""
def __init__(self, timeout_s=3):
self.aws_request_id = "00000000-0000-0000-0000-000000000001"
self.function_name = "local-test"
self.memory_limit_in_mb = 128
self._deadline = time.monotonic() + timeout_s
def get_remaining_time_in_millis(self):
return int((self._deadline - time.monotonic()) * 1000)
event = json.load(open("event_s3.json"))
for i in range(2):
res = lf.lambda_handler(event, FakeContext())
print(json.dumps(res, ensure_ascii=False))
実行結果です。calls_in_this_env が2回目に2になり、ハンドラーの外の変数が引き継がれたことが分かります。remaining_ms は、タイムアウトを既定と同じ3秒にした残り時間です。
{"statusCode": 200, "calls_in_this_env": 1, "request_id": "00000000-0000-0000-0000-000000000001", "remaining_ms": 2999, "objects": [{"bucket": "amzn-s3-demo-bucket", "key": "b21b84d653bb07b05b1e6b33684dc11b", "size_kb": 1274.5}]}
{"statusCode": 200, "calls_in_this_env": 2, "request_id": "00000000-0000-0000-0000-000000000001", "remaining_ms": 2999, "objects": [{"bucket": "amzn-s3-demo-bucket", "key": "b21b84d653bb07b05b1e6b33684dc11b", "size_kb": 1274.5}]}
手元で出たエラーの原文
同じやり方で、よくある3つの間違いを起こしました。Lambda のログでも、同じ種類の例外として現れます。
--- 引数が1つのハンドラー
TypeError: one_arg() takes 1 positional argument but 2 were given
--- S3以外の形のイベントを渡す
KeyError: 'Records'
--- JSONにできない値を返す
TypeError: Object of type datetime is not JSON serializable
KeyError は「トリガーの種類とハンドラーが想定する event の形が合っていない」ときの典型です。 API Gateway から呼ぶと、event の形は S3 のものとまったく違います。手元で確かめるときは、つなぐトリガーの公式の event の例を使います。Python のハンドラーの書き方とローカルテストは、関連記事「AWS Lambda Python入門|3.14対応handler例とローカルテスト」で扱っています。
Lambdaに向いている処理・向かない処理(判断表)
この節では、作りたい処理が Lambda に合うかどうかを、上限と料金の仕組みから判断できます。
「イベントが起きたときに、15分以内で終わる、状態を持たない処理」が Lambda に向きます。 逆に、長く動き続ける処理や、ずっと待ち受けるサーバーは、Lambda の料金と上限の仕組みに合いません。
| 処理 | Lambda との相性 | 理由 |
|---|---|---|
| S3 に保存された画像の縮小・形式の変換 | 向く | 保存のイベントで動き、数秒で終わる |
| Webhook の受け口・小さな API | 向く | 呼ばれた分だけの課金。アクセスが少なければほぼ無料 |
| 決まった時刻の集計・通知 | 向く(15分以内なら) | EventBridge から呼べる。待ち時間の課金が無い |
| SQS にたまったメッセージの処理 | 向く | イベントソースマッピングでバッチ処理できる |
| 15分を超えるバッチ・動画の長い変換 | 向かない | タイムアウトは最大900秒。分けられなければ ECS・EC2 へ |
| 常に動かし続けるサーバー・常時接続 | 向かない | 1回ごとの呼び出しが前提。動かし続けると GB秒が積み上がる |
| 数MB を超えるファイルを同期で受け渡す API | 工夫が要る | 同期のペイロードは6MB。S3 の署名付き URL などで直接やり取りする |
| 大きなモデル・ライブラリを使う処理 | 工夫が要る | .zip は展開後250MB。コンテナイメージ(10GB)にする |
- 11回の処理は15分以内に終わるか終わらないなら、分けられるか考える
- 2受け渡すデータは同期6MB・非同期1MB に収まるか大きいデータは S3 に置き、キーだけ渡す
- 3状態を関数の中に持たずに済むか状態は DynamoDB・S3・RDS などの外に置く
- 4同じイベントが2回届いても結果が同じになるか非同期は再試行される。公式も冪等なコードを勧めている
- 51回目の遅れ(コールドスタート)を受け入れられるか受け入れられないなら SnapStart などを検討する
LambdaとEC2・ECS(Fargate)の違い
この節では、同じ AWS の実行サービスである EC2・ECS(Fargate)と Lambda の違いが、表で分かります。
Lambda は「コードだけ」、ECS(Fargate)は「コンテナ」、EC2 は「仮想サーバー(OS から)」を預ける、という違いです。 AWS のコンピューティングサービスの選び方のガイドと、各サービスの料金ページから整理しました(2026年11月18日時点)。
| 比べる点 | Lambda | ECS(Fargate) | EC2 |
|---|---|---|---|
| 預けるもの | 関数(コード) | コンテナ | 仮想サーバー |
| 管理するもの | コードと設定 | コンテナイメージとタスクの設定 | OS・ミドルウェア・パッチ・台数 |
| 課金 | リクエスト数+GB秒(1ms 単位) | 使った vCPU・メモリ・ストレージ(秒単位・最低1分) | インスタンスの時間(時間または秒単位・最低60秒) |
| 1回の長さ | 最大15分 | 動かし続けられる | 動かし続けられる |
| ガイドが勧める場面 | キュー・ストリーム・S3・スケジュールなどのイベントの処理 | 長く動く処理・ランタイムを細かく決めたい HTTP サービス | OS・インスタンスの種類・ソフトウェア全体を決めたいとき |
常に動かすサーバーを Lambda で作る
見分ける問い:「呼ばれていない時間も動いている必要があるか」
1つの関数に何でも詰める
見分ける問い:「この関数の仕事を一言で言えるか」
EC2 の種類と料金の試算は、記事「EC2とは|インスタンスの種類・料金の試算・起動から接続まで」で扱っています。
Lambdaの新しい形:Web Functions・MicroVMs・durable functions・Managed Instances
この節では、2026年11月18日時点の開発者ガイドに載っている、従来の関数とは別の Lambda の形が分かります。
15分の上限や1環境1リクエストといった従来の前提に合わない用途のために、別の形が用意されています。 開発者ガイドの比較表と料金ページの記載を要約します。
| 形 | 向いている用途(公式の記載) | 長さ | 料金の考え方 |
|---|---|---|---|
| Lambda Event Functions | リクエスト・応答、イベント駆動の処理(API・データ処理・自動化) | 1回15分まで | リクエスト+GB秒 |
| Lambda Web Functions | HTTP を直接受ける Web アプリ・API(Node.js で、ポートで待ち受ける) | 1リクエスト15分まで(既定30秒) | リクエスト+CPU が動いた時間(1ms 単位)+メモリ |
| Lambda MicroVMs | 利用者や AI が作った、信頼できないコードを動かす環境 | 1セッション8時間まで(停止・再開できる) | 動いている間の秒単位+停止中のスナップショットの保存 |
| durable functions | 複数の手順からなる長い処理の流れ | 最大1年 | 操作の回数・書き込んだデータ・保持の量 |
| Lambda Managed Instances | EC2 のインスタンスの上で Lambda の関数を動かす形 | 非同期などは90分まで | リクエスト+EC2 の料金+管理の手数料(EC2 のオンデマンド料金の15%) |
入門の段階では、まず Event Functions の仕組み(この記事の前半)を押さえるのが近道です。新しい形はまだ情報が少なく、料金や上限も変わりやすいので、使う前に開発者ガイドと料金ページの最新の記載を確かめます。
Lambdaでよくあるエラー・つまずき(症状表)
この節では、Lambda を使い始めたときによく出るエラーの文言と、原因・直し方が分かります。
エラーの文言には原因の手がかりがそのまま入っています。 公式の「呼び出しのトラブルシューティング」の記載と、手元で出した Python の例外をまとめました。
| 表示(原文) | 原因 | 直し方 |
|---|---|---|
Task timed out after 3.00 seconds |
Init か Invoke がタイムアウトを超えた。既定の3秒のままのことが多い | タイムアウトを延ばす・メモリを増やす(CPU も増える)・初期化を軽くする |
TypeError: ... takes 1 positional argument but 2 were given |
ハンドラーの引数が1つ | def lambda_handler(event, context): にする |
KeyError: 'Records' |
トリガーの event の形とコードの想定が違う | つなぐトリガーの公式の event の例で確かめる |
TypeError: Object of type datetime is not JSON serializable |
戻り値に JSON にできない値がある | 文字列(ISO 形式など)に変えて返す |
... is not authorized to perform: lambda:InvokeFunction ... |
呼び出す側に関数を呼ぶ権限が無い | 呼び出す側に lambda:InvokeFunction を許可する |
ResourceConflictException: ... state: Pending |
VPC の設定つきで作った関数の準備がまだ終わっていない | 状態が Pending を抜けるまで待つ |
| 関数が何度も呼ばれ続ける | S3 のトリガーと同じバケットに関数が書き込み、自分を呼んでいる | バケットを分けるか、トリガーを入力用のプレフィックスに限る |
| 前の呼び出しのデータが残っている | 実行環境が再利用され、ハンドラーの外の変数・/tmp が残った |
利用者ごとのデータは外の保管場所に置く |
AWS CLI で関数を作る・更新する手順は、関連記事「AWS CLIでLambdaを作成・更新 環境変数とレイヤー」にあります。
よくある質問
この節では、AWS Lambda についてよく聞かれる疑問への短い答えが分かります。
Q. AWS Lambda は無料で使えますか。
月100万リクエストと40万GB秒までは無料利用枠の範囲です(2026年11月18日時点の料金ページ)。ただし、プロビジョニングされた同時実行を有効にした関数には枠が適用されず、S3 などのほかのサービスやデータ転送の料金は別にかかります。
Q. 関数を作っただけで料金はかかりますか。
Lambda の関数(Event Functions)の料金はリクエストと実行時間なので、呼ばれなければ実行の料金はかかりません。コンテナイメージを置いた ECR や、ログの保存など、関連するサービスの料金は別に確かめます。
Q. Lambda のメモリはどれくらいにすればよいですか。
既定は128MB で、128MB〜10,240MB を1MB きざみで選べます。CPU はメモリに比例して割り当てられるので、何通りかのメモリで処理時間を測り、GB秒が小さくなる値を選びます。
Q. 15分を超える処理は Lambda でできませんか。
Event Functions の1回の実行は最大900秒です。処理を分けて SQS などでつなぐか、長く動かせる ECS(Fargate)・EC2 を使います。開発者ガイドには、最大1年続く複数の手順の処理のための durable functions も載っています。
Q. Lambda で使える言語は何ですか。
マネージドランタイムは Node.js・Python・Java・.NET・Ruby です。Go や Rust などは、OS のみのランタイム(provided.al2023)やコンテナイメージで動かします。
Q. コールドスタートはどれくらい遅いですか。
公式は、呼び出しの1%未満で起き、100ms 未満から1秒を超えるものまである、と説明しています。import するライブラリが大きいほど初期化に時間がかかります。
Q. x86 と Arm はどちらを選べばよいですか。
公式の計算例の単価では、Arm の GB秒の単価は x86 より約2割低く、公式は arm64 のほうが価格と性能で有利になりうると説明しています。ネイティブのライブラリが Arm に対応しているかを確かめ、処理時間を測って比べます。
Q. Lambda の関数から別の関数を呼べますか。
SDK から呼べますが、関数が自分を呼び続ける形になると呼び出しが増え続け、費用も増えます。公式も再帰的な呼び出しを避けるよう勧めています。複数の処理をつなぐなら、キューやイベントでつなぐ形が分かりやすくなります。
Q. Lambda と API Gateway は何が違いますか。
API Gateway は HTTP のリクエストを受ける入口で、Lambda はその後ろで処理を動かす側です。関数ごとに HTTPS のエンドポイントを持たせる関数 URL という方法もあります。
Q. AWS Lambda と Python の lambda は関係がありますか。
関係はありません。Python の lambda は名前のない関数を1行で書く構文で、AWS Lambda は AWS のサービスの名前です。
まとめ
- AWS Lambda は、サーバーを管理せずに、イベントが起きたときだけコード(関数)を動かすサーバーレスの実行サービス。トリガー→実行環境(ランタイム)→ハンドラーの順に動く。
- 料金はリクエスト(100万あたり 0.20 USD)+GB秒(x86 は 0.0000166667 USD)。無料利用枠は月100万リクエストと40万GB秒(2026年11月18日時点)。公式の計算例の 2.73 USD は手元の計算でも一致した。
- 主な上限は、実行時間900秒(既定3秒)・メモリ10,240MB・同期のペイロード6MB・非同期1MB・.zip の展開後250MB。
- 15分以内で終わり、状態を持たないイベントの処理に向く。常に動かすサーバーや長い処理は ECS(Fargate)・EC2 に向く。
- 実行環境は再利用されるので、ハンドラーの外の変数と
/tmpは残る。初期化は外に、利用者ごとのデータは外の保管場所に置く。
参考・出典
確認日はいずれも 2026年11月18日です。
- AWS「AWS Lambda とは」(AWS Lambda 開発者ガイド):https://docs.aws.amazon.com/ja_jp/lambda/latest/dg/welcome.html
- AWS「How Lambda works」:https://docs.aws.amazon.com/lambda/latest/dg/concepts-basics.html
- AWS「AWS Lambda の料金」:https://aws.amazon.com/jp/lambda/pricing/
- AWS「AWS Lambda」(AWS 料金体系の仕組み):https://docs.aws.amazon.com/ja_jp/whitepapers/latest/how-aws-pricing-works/aws-lambda.html
- AWS Compute Blog「AWS Lambda standardizes billing for INIT Phase」:https://aws.amazon.com/blogs/compute/aws-lambda-standardizes-billing-for-init-phase/
- AWS「Lambda quotas」:https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html
- AWS「Lambda runtimes」:https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html
- AWS「Selecting and configuring an instruction set architecture」:https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html
- AWS「Define Lambda function handler in Python」:https://docs.aws.amazon.com/lambda/latest/dg/python-handler.html
- AWS「Understanding the Lambda execution environment lifecycle」:https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtime-environment.html
- AWS「Invoking Lambda functions」:https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html
- AWS「Handling errors for asynchronous invocation」:https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-error-handling.html
- AWS「How Lambda processes records from stream and queue-based event sources」:https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html
- AWS「Process Amazon S3 event notifications with Lambda」:https://docs.aws.amazon.com/lambda/latest/dg/with-s3.html
- AWS「Configure Lambda function timeout」:https://docs.aws.amazon.com/lambda/latest/dg/configuration-timeout.html
- AWS「Configure Lambda function memory」:https://docs.aws.amazon.com/lambda/latest/dg/configuration-memory.html
- AWS「Troubleshoot invocation issues in Lambda」:https://docs.aws.amazon.com/lambda/latest/dg/troubleshooting-invocation.html
- AWS「Choosing an AWS compute service」:https://docs.aws.amazon.com/decision-guides/latest/compute-on-aws-how-to-choose/choosing-aws-compute-service.html
- AWS「Amazon EC2 オンデマンド料金」:https://aws.amazon.com/ec2/pricing/on-demand/
- AWS「AWS Fargate の料金」:https://aws.amazon.com/fargate/pricing/
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「AWS Lambdaとは|仕組み・料金の計算・できることと向かない処理」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。