요청 구문 URI 요청 파라미터 요청 본문 응답 구문 응답 요소 Errors 참고

PutFunctionEventInvokeConfig

함수, 버전 또는 별칭에 대한 비동기식 호출 옵션을 구성합니다. 함수, 버전 또는 별칭에 대한 구성이 이미 있는 경우 이 작업으로 구성을 덮어씁니다. 설정을 제외하면 해당 설정이 제거됩니다. 다른 옵션의 기존 설정에 영향을 주지 않고 한 옵션을 설정하려면 UpdateFunctionEventInvokeConfig을(를) 사용합니다.

기본적으로 Lambda는 함수가 오류를 반환하는 경우 비동기식 호출을 두 번 재시도합니다. 최대 6시간 동안 대기열에 이벤트를 보관합니다. 이벤트가 모든 처리 시도에 실패하거나 비동기식 호출 대기열에 너무 오래 머무르면 Lambda는 이러한 이벤트를 삭제합니다. 삭제된 이벤트를 유지하려면 UpdateFunctionConfiguration(으)로 배달 못한 편지 대기열을 구성합니다.

호출 레코드를 대기열, 주제, 함수 또는 이벤트 버스에 보내려면 대상을 지정합니다. 성공적인 호출(성공 시)과 모든 처리 시도에 실패한 이벤트(실패 시)에 대해 별도의 대상을 구성할 수 있습니다. 배달 못한 편지 대기열 대신에, 또는 이에 더하여 배달 못한 편지 대기열을 구성할 수 있습니다.

요청 구문


PUT /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

FunctionName

Lambda 함수, 버전 또는 별칭의 이름입니다.

이름 형식

함수 이름 - my-function(이름만), my-function:v1(별칭 포함).
함수 ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.
부분적 ARN - 123456789012:function:my-function.

모든 형식에 버전 번호 또는 별칭을 추가할 수 있습니다. 길이 제한은 전체 ARN에만 적용됩니다. 함수 이름만 지정하는 경우, 길이가 64자로 제한됩니다.

길이 제약: 최소 길이는 1입니다. 최대 길이는 140입니다.

Pattern: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

필수 항목 여부: 예

Qualifier

버전 번호 또는 별칭 이름입니다.

길이 제약: 최소 길이는 1입니다. 최대 길이 128.

Pattern: (|[a-zA-Z0-9$_-]+)

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

DestinationConfig

처리를 위해 함수로 보낸 후 이벤트의 대상입니다.

대상

Function(함수) - Lambda 함수의 Amazon 리소스 이름(ARN)입니다.
대기열 - 표준 SQS 대기열의 ARN.
주제 - 표준 SNS 주제의 ARN.
Event Bus(이벤트 버스) - Amazon EventBridge 이벤트 버스의 ARN입니다.

유형: DestinationConfig 객체

필수 항목 여부: 아니요

MaximumEventAgeInSeconds

Lambda가 처리를 위해 함수에 보내는 요청의 최대 사용 기간입니다.

유형: Integer

유효한 범위: 최소값은 60이고 최대값은 21,600입니다.

필수 항목 여부: 아니요

MaximumRetryAttempts

함수가 오류를 반환할 때 재시도하는 최대 횟수입니다.

유형: Integer

유효한 범위: 최소값 0. 최대값은 2입니다.

Required: No

응답 구문


HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}