AWS Lambda の Event Function の 30 分タイムアウトを非同期呼び出しと Step Functions で試してみた

AWS Lambda の Event Function の 30 分タイムアウトを非同期呼び出しと Step Functions で試してみた

AWS Lambda の on-demand Event Function に 1,800 秒のタイムアウトを設定し、非同期呼び出しと Step Functions Standard で実行しました。どちらも 15 分を超えて動作、1,800 秒まで動き続ける関数は 1,800 秒で打ち切られました。
2026.11.20

はじめに

2026年11月19日に、AWS Lambda Event Function(従来の Lambda)のタイムアウトを 30 分まで設定できるようになるアップデートがありました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/aws-lambda-30-minute-ondemand-event-functions/

この記事では、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 で使うときの条件は、公式ブログに書かれています。

https://aws.amazon.com/blogs/compute/announcing-30-minute-timeout-for-on-demand-aws-lambda-event-functions/

タイムアウトの設定

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 秒です。

https://docs.aws.amazon.com/lambda/latest/dg/lambda-services.html

まとめ

AWS Lambda の on-demand Event Function は、Timeout が従来の 15 分から 30 分に延長されました。

15 分を少し超えることがあるバッチ処理などで Lambda のタイムアウトが課題だった場合は、今回のアップデートをお試しください。

なお、公式ブログでも案内されているとおり、タイムアウトの延長により、同期呼び出しではクライアント側の例外処理が重要になります。なるべく非同期呼び出しを利用し、同期呼び出しが必要な場合は Step Functions など安定した実行環境から行うことをおすすめします。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事