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는 호출당 최대 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	선택 사항. 호출당 반환할 최대 함수 수입니다. 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	선택 사항. 호출당 반환할 최대 기록 이벤트 수입니다. 기본값은 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 함수 동시성 설정

전제 조건