このページでは、ワークフロー自動化アクションカタログで利用可能なAWS Lambdaアクションのリファレンスを提供します。これらのアクションを使用して、ワークフロー定義の一部としてLambda関数を管理および呼び出します。
前提条件 前提条件と認証情報のセットアップについては、AWS認証情報のセットアップ をご覧ください。
Lambda関数を呼び出す アクション識別子はaws.lambda.invokeです。
Lambda関数を同期的またはオプションのペイロードを使用して非同期的に呼び出します。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数が配置されているAWSリージョン。
us-east-2
functionName
弦
必須。 呼び出すLambda関数の名前。
hello-you
payload
地図
オプション。 関数に渡す入力ペイロードです。
{"user": "R2-D2"}
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "payload", "expression": ".payload"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
payload
地図
{"statusCode": 200, "body": "Hello R2-D2!"}
statusCode
Int
200
executedVersion
弦
"$LATEST"
functionError
弦
"Unhandled::Error occurred"
success
ブール値
true または false
errorMessage
弦
"An error occurred (ResourceNotFoundException) when calling the Invoke operation: Function not found: arn:aws:lambda:us-east-2:123456789012:function:hello-you"
Lambda関数の設定を更新する アクション識別子はaws.lambda.updateFunctionConfigurationです。
Lambda関数の設定を変更します。変更するパラメーターのみを指定してください。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数が配置されているAWSリージョン。
us-east-2
functionName
弦
必須。 更新するLambda関数の名前。
my-lambda-function-to-update
role
弦
オプション。 関数に割り当てるIAMロールのARN。
arn:aws:iam::123456789012:role/new-lambda-role
handler
弦
オプション。 関数の更新されたハンドラー。
main.new_handler
description
弦
オプション。 関数の更新された説明。
Updated function description
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。APIからの任意のオプション引数を受け付けます。
{"Timeout": "60", "MemorySize": 123}
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "response", "expression": ".response"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"FunctionName": "hello-you", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 30, "MemorySize": 128}
success
ブール値
true または false
errorMessage
弦
"An error occurred (ResourceNotFoundException) when calling the UpdateFunctionConfiguration operation: Function not found"
Lambda関数の説明 アクション識別子はaws.lambda.getFunctionです。
特定のLambda関数の設定の詳細、コードの場所、およびその他のメタデータを取得します。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数が配置されているAWSリージョン。
us-east-2
functionName
弦
必須。 Lambda関数の名前。
my-lambda-function
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。APIからの任意のオプション引数を受け付けます。
{"Qualifier": "1"}
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "response", "expression": ".response"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"Configuration": {"FunctionName": "my-lambda-function", "FunctionArn": "arn:aws:lambda:us-east-2:...", "Runtime": "nodejs20.x", "Handler": "index.handler", "Timeout": 3, "MemorySize": 128, "State": "Active"}, "Code": {"RepositoryType": "S3"}}
success
ブール値
true または false
errorMessage
弦
"ResourceNotFoundException: Function not found"
Lambda関数のエイリアスを一覧表示する アクション識別子はaws.lambda.listAliasesです。
Lambda関数のエイリアスのリストを返します。エイリアスは、関数のバージョンへの名前付きポインターです。大きな結果セットをページ分割するには、markerとmaxItemsを使用します。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数が配置されているAWSリージョン。
us-east-2
functionName
弦
必須。 Lambda関数の名前。
my-lambda-function
marker
弦
オプション。 ページ付けトークン。次のページを取得するには、前のレスポンスからNextMarkerの値を渡します。
"abcd....."
maxItems
Int
オプション。 返すエイリアスの最大数。
123
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。APIからの任意のオプション引数を受け付けます。
{"AnotherOptionalParam": "value"}
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "response", "expression": ".response"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"Aliases": [{"AliasArn": "arn:aws:lambda:us-east-2:...", "Name": "live", "FunctionVersion": "1", "RevisionId": "abc123..."}], "NextMarker": ""}
success
ブール値
true または false
errorMessage
弦
"ResourceNotFoundException: Function not found"
Lambda関数のエイリアスを更新する アクション識別子はaws.lambda.updateAliasです。
Lambda関数のエイリアスの設定を更新します。このアクションを使用して、エイリアスの指定先を別の関数バージョンに変更したり、説明を更新したり、カナリアデプロイメント用の加重ルーティングを設定したりします。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数が配置されているAWSリージョン。
us-east-2
functionName
弦
必須。 Lambda関数の名前、部分的なARN、または完全なARN。長さ:1~140文字(未修飾名は64文字に制限されています)。
my-lambda-function
name
弦
必須。 更新するエイリアス名。文字、数字、ハイフン、アンダースコアのみ使用できます。すべて数字にすることはできません。長さ:1~128文字。
live
functionVersion
弦
オプション。 エイリアスの指定先となる、公開された数値バージョンまたは$LATEST。長さ:1~1024文字。
2
description
弦
オプション。 エイリアスの更新された説明です。長さ:0~256文字。
Updated alias description.
routingConfig
地図
オプション。 カナリアデプロイメントの加重ルーティング設定。AdditionalVersionWeightsは、公開されたバージョン番号(文字列)を0.0と1.0の間のトラフィックの重みにマッピングします。トラフィックの100%をプライマリfunctionVersionにルーティングするには、空のマップを渡してください。
{"AdditionalVersionWeights": {"1": 0.1}}
revisionId
弦
オプション。 オプティミスティック同時実行トークン。この値がエイリアスの現在のリビジョンIDと一致しない場合、AWSは PreconditionFailedException で更新を拒否します。aws.lambda.listAliases を使用して現在の値を取得します。
"abc12345-..."
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。APIからの任意のオプション引数を受け付けます。
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "aliasArn", "expression": ".response.AliasArn"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"AliasArn": "arn:aws:lambda:us-east-2:...", "Name": "live", "FunctionVersion": "2", "Description": "...", "RevisionId": "abc123...", "RoutingConfig": {"AdditionalVersionWeights": {}}}
success
ブール値
true または false
errorMessage
弦
"An error occurred (PreconditionFailedException) when calling the UpdateAlias operation: The Revision Id provided does not match the latest Revision Id. Call the GetFunction/GetAlias API to retrieve the latest Revision Id"
Lambda関数の一覧 アクション識別子はaws.lambda.listFunctionsです。
リージョン内のLambda関数のリストと、それぞれのバージョン固有の設定を返します。AWSは1回の呼び出しにつき最大50個の関数を返します — 大規模な結果セットをページ分割するには、markerとmaxItemsを使用してください。
このアクションは、FunctionConfigurationフィールドのサブセットを返します。State、StateReasonCode、LastUpdateStatus、およびRuntimeVersionConfigを含む完全なセットを取得するには、代わりにaws.lambda.getFunctionを使用してください。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数を一覧表示するAWSリージョン。
us-west-2
functionVersion
弦
オプション。 未公開バージョンに加えて、各関数の公開されているすべてのバージョンを含めるには、ALL に設定します。
ALL
marker
弦
オプション。 ページ付けトークン。次のページを取得するには、前のレスポンスからNextMarkerの値を渡します。
"abcd....."
maxItems
Int
オプション。 1回の呼び出しで返す関数の最大数。より高い値に関係なく、AWSはこれを50に制限します。
50
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。MasterRegionはLambda\@Edge関数にのみ関連しており、設定する場合はfunctionVersion: ALLが必要です。
{"MasterRegion": "us-east-1"}
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "functions", "expression": ".response.Functions"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"Functions": [{"FunctionName": "helloworld", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 3, "MemorySize": 128}], "NextMarker": "..."}
success
ブール値
true または false
errorMessage
弦
"InvalidParameterValueException: 1 validation error detected"
Lambdaの永続的な実行履歴を取得 アクション識別子はaws.lambda.getDurableExecutionHistoryです。
Lambda durable execution の実行履歴を取得し、発生したすべてのステップ、コールバック、およびイベントを表示します。このアクションはLambda durable executionにのみ適用されます — 通常のLambda関数の呼び出し履歴を取得することはできません。履歴は、実行中、および完了後の設定可能な保持期間(1~90日、デフォルトは30日)にわたって利用できます。
多くのステップやコールバックを伴う長時間の実行において、完全なペイロードではなくイベントタイプとタイムスタンプのみが必要な場合は、includeExecutionDataをfalseに設定してください — これにより、よりコンパクトなレスポンスが生成されます。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 永続的実行が配置されているAWSリージョンです。
us-west-2
durableExecutionArn
弦
必須。 履歴を取得する永続的な実行のARNです。
arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123
includeExecutionData
ブール値
オプション。 履歴イベントにステップ結果とコールバックペイロードを含めます。よりコンパクトなレスポンスにするには、falseに設定します。デフォルトはtrueです。
true
maxItems
Int
オプション。 1回の呼び出しにつき返す履歴イベントの最大数です。デフォルトは100、最大は1,000です。デフォルトを使用するには、0に設定してください。
100
marker
弦
オプション。 ページ付けトークン。以前のレスポンスからNextMarkerの値を渡してください。トークンは24時間後に期限切れになります。
"abcd....."
reverseOrder
ブール値
オプション。 イベントを新しい順(逆時系列)で返します。デフォルト設定:false(古い順)。
true
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "events", "expression": ".response.Events"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"Events": [{"EventType": "ExecutionStarted", "EventId": 1, "EventTimestamp": "2026-08-11T05:40:49.000+0000"}, {"EventType": "ExecutionSucceeded", "EventId": 4}], "NextMarker": ""}
success
ブール値
true または false
errorMessage
弦
"ResourceNotFoundException: Durable execution not found: arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123"
Lambda関数の同時実行数を設定する アクション識別子はaws.lambda.putFunctionConcurrencyです。
Lambda関数の予約済み同時実行数(同時実行の最大数)を設定します。同時実行数を予約することで、関数がその数の同時実行に対応できる容量を確保すると同時に、そのレベルを超えてスケーリングすることを防ぎます。同時実行数の設定は、公開されているすべてのバージョンと未公開のバージョンに適用されます。reservedConcurrentExecutionsを0に設定すると、関数を削除せずに無効化します。
次の表に、このアクションの入力フィールドについて説明します。
入力
タイプ
説明
例
awsRoleArn
弦
オプション。 AWS APIコール用に引き受けるIAMロールARN。
arn:aws:iam::123456789012:role/my-workflow-role
awsAccessKeyId
弦
オプション。 AWSアクセスキーID。シークレットとして渡します。
${{ :secrets:awsAccessKeyId }}
awsSecretAccessKey
弦
オプション。 AWSシークレットアクセスキー。シークレットとして渡します。
${{ :secrets:awsSecretAccessKey }}
awsSessionToken
弦
オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。
${{ :secrets:awsSessionToken }}
region
弦
必須。 関数が配置されているAWSリージョン。
us-west-2
functionName
弦
必須。 関数の名前、name:version、またはARN。64文字の長さ制限は、名前のみを指定する場合(完全なARNではない場合)にのみ適用されます。
my-function
reservedConcurrentExecutions
Int
必須。 予約する同時実行数です。最小値は0です(機能を無効にします)。実質的な最大値は、アカウントの予約されていない同時実行プールです。関数ごとの制限がない関数のために、少なくとも100の予約されていない実行を残しておく必要があります。
100
parameters
地図
オプション。 他ではモデル化されていない追加のboto3フィールド。
selectors
リスト
オプション。 アクションの出力から特定のフィールドを抽出するためのJQセレクター。
[{"name": "response", "expression": ".response"}]
次の表は、このアクションの出力フィールドについて説明しています。
出力
タイプ
例
response
オブジェクト
{"ReservedConcurrentExecutions": 100}
success
ブール値
true または false
errorMessage
弦
"InvalidParameterValueException: Specified ReservedConcurrentExecutions decreases account's UnreservedConcurrentExecution below its minimum value"