• /
  • EnglishEspañolFrançais日本語한국어Português
  • ログイン今すぐ開始

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

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

AWS Lambdaアクション

|View as Markdown (English)

このページでは、ワークフロー自動化アクションカタログで利用可能な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"

Copyright © 2026 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.