AWS Lambdaアクション

このページでは、ワークフロー自動化アクションカタログで利用可能な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`	弦	失敗時のエラーメッセージ。

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"`

出力

タイプ

例

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`	オブジェクト	完全なAPIレスポンス。 get_function Boto3リファレンスを参照してください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`"ResourceNotFoundException: Function not found"`

出力

タイプ

例

response

オブジェクト

完全なAPIレスポンス。

get_function Boto3リファレンス

を参照してください。

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`	オブジェクト	完全なAPIレスポンス。 list_aliases Boto3リファレンスをご覧ください。
`success`	ブール値	`true` または `false`
`errorMessage`	弦	`"ResourceNotFoundException: Function not found"`

出力

タイプ

例

response

オブジェクト

完全なAPIレスポンス。

list_aliases Boto3リファレンス

をご覧ください。

success

ブール値

true

または

false

errorMessage

弦

"ResourceNotFoundException: Function not found"

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"`

出力

タイプ

例

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"`

出力

タイプ

例

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"`

出力

タイプ

例

response

オブジェクト

{"ReservedConcurrentExecutions": 100}

success

ブール値

true

または

false

errorMessage

弦

"InvalidParameterValueException: Specified ReservedConcurrentExecutions decreases account's UnreservedConcurrentExecution below its minimum value"

この機械翻訳は、参考として提供されています。

前提条件.css-21sua1{background:none;border:none;width:0;padding:0;}

Lambda関数を呼び出す

Lambda関数の設定を更新する

Lambda関数の説明

Lambda関数のエイリアスを一覧表示する

Lambda関数の一覧

Lambdaの永続的な実行履歴を取得

Lambda関数の同時実行数を設定する

前提条件