를 호출합니다. AWS Lambda Step 함수를 포함하는 함수 - AWS Step Functions
지원됨 APIs예시IAM정책

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 호출합니다. AWS Lambda Step 함수를 포함하는 함수

Step Functions를 사용하여 이벤트 기반 서버리스 애플리케이션의 일부로서 Lambda 함수를 동기 또는 비동기 방식으로 호출하는 방법을 알아보십시오.

통합에 대해 알아보려면 AWS Step Functions의 서비스에 대해서는 및 을 참조하십시오 서비스 통합. Step API Functions에서 서비스에 파라미터 전달하기

최적화된 Lambda 통합의 주요 기능

  • 응답 Payload 필드는 이스케이프된 Json에서 Json으로 파싱됩니다.

  • 응답에 FunctionError 필드가 포함되어 있거나 Lambda 함수 내에서 예외가 발생하면 작업이 실패합니다.

상태 입력, 출력, 결과 관리에 대한 자세한 내용은 Step Functions에서 입력 및 출력 처리하기 단원을 참조하십시오.

지원되는 Lambda APIs

워크플로우 예제

다음에는 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
}

또는 “Resource” 필드에 함수를 직접 지정하여 Lambda ARN 함수를 호출할 수 있습니다. 이런 방식으로 Lambda 함수를 간접적으로 호출할 때는 .waitForTaskToken을 지정할 수 없으며 작업 결과에 함수 출력만 포함됩니다.

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

필드에 해당 옵션을 지정하여 특정 Lambda 함수 버전 또는 별칭을 호출할 수 있습니다. ARN Resource Lambda 설명서에서 다음을 참조하세요.

IAM통화 정책 AWS Lambda

다음 예제 템플릿은 방법을 보여줍니다. AWS Step Functions 스테이트 머신 정의의 리소스를 기반으로 IAM 정책을 생성합니다. 자세한 내용은 Step Functions가 통합 서비스를 위한 IAM 정책을 생성하는 방법 및 Step Functions에서 서비스 통합 패턴을 살펴보세요 단원을 참조하세요.

AWS Step Functions 스테이트 머신 정의를 기반으로 IAM 정책을 생성합니다. 두 개가 있는 스테이트 머신의 경우 AWS Lambda function1및 function2 를 호출하는 작업 상태에는 두 함수에 대한 lambda:Invoke 권한이 있는 정책을 사용해야 합니다.

방법은 다음 예제와 같습니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "lambda:InvokeFunction"
            ],
            "Resource": [
                "arn:aws:lambda:[[region]]:[[accountId]]:function:[[function1]]",
                "arn:aws:lambda:[[region]]:[[accountId]]:function:[[function2]]"
            ]
        }
    ]
}