UpdateFunctionEventInvokeConfig - AWS Lambda

UpdateFunctionEventInvokeConfig

함수, 버전 또는 별칭에 대한 비동기식 호출의 구성을 업데이트합니다.

비동기식 호출에 대한 옵션을 구성하려면 PutFunctionEventInvokeConfig을(를) 사용합니다.

요청 구문

POST /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 }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

DestinationConfig

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

대상
  • Function(함수) - Lambda 함수의 Amazon 리소스 이름(ARN)입니다.

  • 대기열 - 표준 SQS 대기열의 ARN.

  • 주제 - 표준 SNS 주제의 ARN.

  • Event Bus(이벤트 버스) - Amazon EventBridge 이벤트 버스의 ARN입니다.

유형: DestinationConfig 객체

FunctionArn

함수의 Amazon 리소스 이름(ARN)입니다.

유형: String

패턴: 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-_]+))?

LastModified

구성이 마지막으로 업데이트된 날짜와 시간(Unix 시간 초)입니다.

Type: Timestamp

MaximumEventAgeInSeconds

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

유형: Integer

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

MaximumRetryAttempts

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

유형: Integer

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

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

InvalidParameterValueException

요청의 파라미터 중 하나가 유효하지 않습니다.

HTTP 상태 코드: 400

ResourceConflictException

리소스가 이미 있거나 다른 작업이 진행 중입니다.

HTTP 상태 코드: 409

ResourceNotFoundException

요청에 지정된 리소스가 없습니다.

HTTP 상태 코드: 404

ServiceException

AWS Lambda 서비스에 내부 오류가 발생했습니다.

HTTP 상태 코드: 500

TooManyRequestsException

요청 처리량 제한을 초과했습니다. 자세한 내용은 Lambda 할당량을 참조하세요.

HTTP Status Code: 429

참고

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.