
AWS Lambda の Event Function の 30 分タイムアウトを非同期呼び出しと Step Functions で試してみた
はじめに
2026年11月19日に、AWS Lambda Event Function(従来の Lambda)のタイムアウトを 30 分まで設定できるようになるアップデートがありました。
この記事では、Timeout を 1,800 秒にした関数を作成し、非同期呼び出しと Step Functions Standard の両方で呼び出した結果を紹介します。
検証環境
検証環境は次のとおりです。
- リージョン: ap-northeast-1
- ランタイム: Python 3.13
- アーキテクチャ: arm64
- メモリ: 128 MB
- Timeout: 1800 秒
- AWS CLI: 2.41.2
関数は 3 本です。どの関数も 10 秒ごとに現在時刻を出力します。
import os, time
from datetime import datetime, timezone
def now():
return datetime.now(timezone.utc).isoformat(timespec="seconds")
def handler(event, context):
run = int(os.environ["RUN_SECONDS"]) # 0 = 上限まで動き続ける
start = time.monotonic()
print("start", now(), "run_seconds", run)
while True:
elapsed = time.monotonic() - start
if run and elapsed >= run:
break
print("tick", now(), int(elapsed))
time.sleep(10)
print("end", now())
return {"finished": now()}
| 関数名 | RUN_SECONDS | 呼び出し方 |
|---|---|---|
| timeout30-async-30min | 1790 | 非同期呼び出し |
| timeout30-async-limit | 0 | 非同期呼び出し |
| timeout30-sfn-target | 1790 | Step Functions Standard |
検証したのは on-demand の同期呼び出しと非同期呼び出しです。イベントソースマッピング(ESM)や Lambda Managed Instances で使うときの条件は、公式ブログに書かれています。
タイムアウトの設定
CloudFormation
AWS::Lambda::Function の Timeout に 1800 を指定したテンプレートを template.yaml として保存し、スタックを作成します。
aws cloudformation create-stack --stack-name timeout30-verify --template-body file://template.yaml --capabilities CAPABILITY_IAM
template.yaml(timeout30-async-30min の抜粋)
検証で使ったテンプレートから、timeout30-async-30min に必要なリソース(実行ロール、ロググループ、関数、EventInvokeConfig)だけを残しています。
AWSTemplateFormatVersion: '2010-09-09'
Parameters:
Runtime:
Type: String
Default: python3.13
Resources:
FunctionRole:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: '2012-10-17'
Statement:
- Effect: Allow
Principal: { Service: lambda.amazonaws.com }
Action: sts:AssumeRole
ManagedPolicyArns:
- arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
Async30minLogGroup:
Type: AWS::Logs::LogGroup
Properties:
LogGroupName: /aws/lambda/timeout30-async-30min
RetentionInDays: 1
Async30min:
Type: AWS::Lambda::Function
DependsOn: Async30minLogGroup
Properties:
FunctionName: timeout30-async-30min
Runtime: !Ref Runtime
Architectures: [arm64]
MemorySize: 128
Timeout: 1800
Handler: index.handler
Role: !GetAtt FunctionRole.Arn
Environment:
Variables:
RUN_SECONDS: '1790'
Code:
ZipFile: |
import os, time
from datetime import datetime, timezone
def now():
return datetime.now(timezone.utc).isoformat(timespec="seconds")
def handler(event, context):
run = int(os.environ["RUN_SECONDS"]) # 0 = 上限まで動き続ける
start = time.monotonic()
print("start", now(), "run_seconds", run)
while True:
elapsed = time.monotonic() - start
if run and elapsed >= run:
break
print("tick", now(), int(elapsed))
time.sleep(10)
print("end", now())
return {"finished": now()}
Async30minConfig:
Type: AWS::Lambda::EventInvokeConfig
Properties:
FunctionName: !Ref Async30min
Qualifier: $LATEST
MaximumRetryAttempts: 0
計測結果
表の時刻は、関数が CloudWatch Logs に出力した値(UTC)です。Duration は REPORT 行の値です。経過 900 秒の出力が、従来の上限 15 分に当たります。
| 関数名 | 開始 | 経過 900 秒の出力 | 最後の出力 | Duration | 結果 |
|---|---|---|---|---|---|
| timeout30-async-30min | 11/19 23:57:47 | 11/20 00:12:47 | end(11/20 00:27:37) | 1790044.22 ms | 正常終了 |
| timeout30-async-limit | 11/19 23:57:47 | 11/20 00:12:47 | tick 1790(11/20 00:27:37) | 1800000.00 ms | Status: timeout |
| timeout30-sfn-target | 11/19 23:57:48 | 11/20 00:12:48 | end(11/20 00:27:38) | 1790044.61 ms | 正常終了 |
非同期呼び出し
--invocation-type Event を付けて invoke を実行すると、関数の完了を待たずに 202 が返ります。
aws lambda invoke --function-name timeout30-async-30min --invocation-type Event --cli-binary-format raw-in-base64-out --payload '{}' response.json
{
"StatusCode": 202
}
timeout30-async-limit も、関数名だけを変えて同じコマンドで呼び出しました。
1,790 秒で終わる timeout30-async-30min のログです。
start 2026-11-19T23:57:47+00:00 run_seconds 1790
tick 2026-11-19T23:57:47+00:00 0
...
tick 2026-11-20T00:12:47+00:00 900
...
tick 2026-11-20T00:27:27+00:00 1780
end 2026-11-20T00:27:37+00:00
END RequestId: e56f4d7d-2580-41b6-895c-75a691a3e4a9
REPORT RequestId: e56f4d7d-2580-41b6-895c-75a691a3e4a9 Duration: 1790044.22 ms Billed Duration: 1790128 ms Memory Size: 128 MB Max Memory Used: 31 MB Init Duration: 83.77 ms
上限まで動き続ける timeout30-async-limit のログです。
start 2026-11-19T23:57:47+00:00 run_seconds 0
tick 2026-11-19T23:57:47+00:00 0
...
tick 2026-11-20T00:12:47+00:00 900
...
tick 2026-11-20T00:27:37+00:00 1790
END RequestId: 75ca460e-a8b0-40bf-b6f9-204fac038f65
REPORT RequestId: 75ca460e-a8b0-40bf-b6f9-204fac038f65 Duration: 1800000.00 ms Billed Duration: 1800089 ms Memory Size: 128 MB Max Memory Used: 31 MB Init Duration: 88.81 ms Status: timeout
今回の Python 3.13 の関数では、REPORT 行末の Status: timeout で打ち切りを判別できました。Task timed out の行は出力されませんでした。
Step Functions Standard からの同期呼び出し
Step Functions Standard の lambda:invoke タスクから、1,790 秒で終わる timeout30-sfn-target を同期で呼び出しました。実行は次のコマンドで開始しました。
aws stepfunctions start-execution --state-machine-arn arn:aws:states:ap-northeast-1:123456789012:stateMachine:timeout30-sfn --name run-1 --input '{}'
約 30 分後に describe-execution で取得した結果です(時刻は JST)。
"status": "SUCCEEDED",
"startDate": "2026-11-20T08:57:47.712000+09:00",
"stopDate": "2026-11-20T09:27:38.227000+09:00",
ステートマシンの定義(StateMachineRole と StateMachine)
呼び出される関数 SfnTarget は、上の template.yaml の Async30min の FunctionName を timeout30-sfn-target に変えた定義です。SfnTarget には EventInvokeConfig を付けていません。
StateMachineRole:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: '2012-10-17'
Statement:
- Effect: Allow
Principal: { Service: states.amazonaws.com }
Action: sts:AssumeRole
Policies:
- PolicyName: invoke-sfn-target
PolicyDocument:
Version: '2012-10-17'
Statement:
- Effect: Allow
Action: lambda:InvokeFunction
Resource: !GetAtt SfnTarget.Arn
StateMachine:
Type: AWS::StepFunctions::StateMachine
Properties:
StateMachineName: timeout30-sfn
StateMachineType: STANDARD
RoleArn: !GetAtt StateMachineRole.Arn
DefinitionString: !Sub |
{
"StartAt": "InvokeLongFunction",
"States": {
"InvokeLongFunction": {
"Type": "Task",
"Resource": "arn:aws:states:::lambda:invoke",
"Parameters": {
"FunctionName": "${SfnTarget.Arn}",
"Payload.$": "$"
},
"End": true
}
}
}
同期呼び出しでは、呼び出し元によって待てる時間が異なります。Step Functions は関数が返るまで待ちますが、API Gateway が待つのは REST API で既定 29 秒、HTTP API で最大 30 秒です。
まとめ
AWS Lambda の on-demand Event Function は、Timeout が従来の 15 分から 30 分に延長されました。
15 分を少し超えることがあるバッチ処理などで Lambda のタイムアウトが課題だった場合は、今回のアップデートをお試しください。
なお、公式ブログでも案内されているとおり、タイムアウトの延長により、同期呼び出しではクライアント側の例外処理が重要になります。なるべく非同期呼び出しを利用し、同期呼び出しが必要な場合は Step Functions など安定した実行環境から行うことをおすすめします。








