使用 Step Functions 叫用 Lambda - AWS Step Functions

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 Step Functions 叫用 Lambda

Step Functions 可以直接從Amazon States Language(ASL)控制某些 AWS 服務。如需了解詳細資訊,請參閱 使用其他 服務將參數傳遞至服務 API

最佳化 Lambda 整合與 Lambda AWS 開發套件整合有何不同
  • 響應Payload字段從轉義的 Json 解析為 Json。

  • 如果回應包含欄位,FunctionError或在 Lambda 函數中引發例外狀況,則工作會失敗。

如需管理狀態輸入、輸出和結果的詳細資訊,請參閱Step Functions 中的輸入和輸出處理

支援的 AWS Lambda API:

注意

中的參數Step Functions會在中表示 PascalCase,即使原生服務 API 位於駝峰中也是如此。例如,您可以使用 Step Functions API 動作startSyncExecution並將其參數指定為StateMachineArn

以下內容包含叫用 Lambda 函數的Task狀態。

{ "StartAt":"CallLambda", "States":{ "CallLambda":{ "Type":"Task", "Resource":"arn:aws:states:::lambda:invoke", "Parameters":{ "FunctionName":"arn:aws:lambda:us-east-1:123456789012:function:MyFunction" }, "End":true } } }

以下包含 Task 狀態,此狀態會實作回呼服務整合模式。

{ "StartAt":"GetManualReview", "States":{ "GetManualReview":{ "Type":"Task", "Resource":"arn:aws:states:::lambda:invoke.waitForTaskToken", "Parameters":{ "FunctionName":"arn:aws:lambda:us-east-1:123456789012:function:get-model-review-decision", "Payload":{ "model.$":"$.new_model", "token.$":"$$.Task.Token" }, "Qualifier":"prod-v1" }, "End":true } } }

當您叫用 Lambda 函數時,執行會等待函數完成。如果您使用回呼工作叫用 Lambda 函數,則在 Lambda 函數完成執行並傳回結果之前,活動訊號逾時才會開始計算。只要執行 Lambda 函數,就不會強制執行活動訊號逾時。

您也可以使用InvocationType參數以非同步方式呼叫 Lambda,如下列範例所示:

注意

對於 Lambda 函數的非同步叫用,活動訊號逾時期間會立即開始。

{ "Comment": "A Hello World example of the Amazon States Language using Pass states", "StartAt": "Hello", "States": { "Hello": { "Type": "Task", "Resource": "arn:aws:states:::lambda:invoke", "Parameters": { "FunctionName": "arn:aws:lambda:us-east-1:123456789012:function:echo", "InvocationType": "Event" }, "End": true } } }

傳回Task結果時,函數輸出會嵌套在中繼資料字典中。例如:

{ "ExecutedVersion":"$LATEST", "Payload":"FUNCTION OUTPUT", "SdkHttpMetadata":{ "HttpHeaders":{ "Connection":"keep-alive", "Content-Length":"4", "Content-Type":"application/json", "Date":"Fri, 26 Mar 2021 07:42:02 GMT", "X-Amz-Executed-Version":"$LATEST", "x-amzn-Remapped-Content-Length":"0", "x-amzn-RequestId":"0101aa0101-1111-111a-aa55-1010aaa1010", "X-Amzn-Trace-Id":"root=1-1a1a000a2a2-fe0101aa10ab;sampled=0" }, "HttpStatusCode":200 }, "SdkResponseMetadata":{ "RequestId":"6b3bebdb-9251-453a-ae45-512d9e2bf4d3" }, "StatusCode":200 }

或者,您可以直接在「資源」欄位中指定函數 ARN 來叫用 Lambda 函數。當您以這種方式叫用 Lambda 函數時,您無法指定.waitForTaskToken,且工作結果只包含函數輸出。

{ "StartAt":"CallFunction", "States":{ "CallFunction": { "Type":"Task", "Resource":"arn:aws:lambda:us-east-1:123456789012:function:HelloFunction", "End": true } } }

您可以在Resource欄位中的 ARN 中指定這些選項,以叫用特定的 Lambda 函數版本或別名。請參閱 Lambda 文件中的下列內容:

如需Step Functions與其他 AWS 服務搭配使用時如何設定IAM權限的相關資訊,請參閱整合式服務的 IAM 政策