# EventSourceMappingConfiguration
<a name="API_EventSourceMappingConfiguration"></a>

AWS 리소스와 Lambda 함수 간의 매핑입니다. 자세한 내용은 [CreateEventSourceMapping](API_CreateEventSourceMapping.md) 섹션을 참조하세요.

## 내용
<a name="API_EventSourceMappingConfiguration_Contents"></a>

 ** AmazonManagedKafkaEventSourceConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-AmazonManagedKafkaEventSourceConfig"></a>
Amazon Managed Streaming for Apache Kafka(Amazon MSK) 이벤트 소스에 대한 특정 구성 설정입니다.  
유형: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md)객체  
필수 항목 여부: 아니요

 ** BatchSize **   <a name="lambda-Type-EventSourceMappingConfiguration-BatchSize"></a>
Lambda가 스트림 또는 대기열에서 풀링하여 함수로 보내는 각 배치의 최대 레코드 수입니다. Lambda는 동기식 호출에 대한 페이로드 제한(6MB)까지 단일 호출로 배치의 모든 레코드를 함수로 전달합니다.  
기본값: 서비스에 따라 다릅니다. Amazon SQS의 경우 기본값은 10입니다. 다른 모든 서비스의 경우 기본값은 100입니다.  
관련 설정: `BatchSize`를 10보다 큰 값으로 설정하면 `MaximumBatchingWindowInSeconds`를 1이상으로 설정합니다.  
유형: 정수  
유효한 범위: 최소값 1. 최대값은 10,000입니다.  
필수 항목 여부: 아니요

 ** BisectBatchOnFunctionError **   <a name="lambda-Type-EventSourceMappingConfiguration-BisectBatchOnFunctionError"></a>
(Kinesis와 DynamoDB 스트림만 해당) 함수가 오류를 반환하면 배치를 둘로 분할하고 다시 시도합니다. 기본값은 false입니다.  
유형: Boolean  
필수 항목 여부: 아니요

 ** DestinationConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-DestinationConfig"></a>
(Kinesis, DynamoDB Streams, Amazon MSK 및 자체 관리형 Apache Kafka 이벤트에만 해당) Lambda가 이벤트를 처리한 후 이벤트의 대상을 지정하는 구성 객체입니다.  
유형: [DestinationConfig](API_DestinationConfig.md)객체  
필수 항목 여부: 아니요

 ** DocumentDBEventSourceConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-DocumentDBEventSourceConfig"></a>
DocumentDB 이벤트 소스에 대한 특정 구성 설정입니다.  
유형: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md)객체  
필수 항목 여부: 아니요

 ** EventSourceArn **   <a name="lambda-Type-EventSourceMappingConfiguration-EventSourceArn"></a>
이벤트 소스의 Amazon 리소스 이름(ARN)입니다.  
유형: String  
패턴: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`   
필수 항목 여부: 아니요

 ** FilterCriteria **   <a name="lambda-Type-EventSourceMappingConfiguration-FilterCriteria"></a>
Lambda가 이벤트를 처리해야 하는지를 결정하는 필터 기준을 정의하는 객체입니다. 자세한 내용은 [Lambda 이벤트 필터링](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)을 참조하세요.  
유형: [FilterCriteria](API_FilterCriteria.md)객체  
필수 항목 여부: 아니요

 ** FunctionArn **   <a name="lambda-Type-EventSourceMappingConfiguration-FunctionArn"></a>
Lambda 함수의 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-_]+))?`   
필수 항목 여부: 아니요

 ** FunctionResponseTypes **   <a name="lambda-Type-EventSourceMappingConfiguration-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams 및 Amazon SQS) 이벤트 소스 매핑에 적용된 현재 응답 유형 열거형 목록입니다.  
유형: 문자열 배열  
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수는 1개입니다.  
유효 값: `ReportBatchItemFailures`   
필수 항목 여부: 아니요

 ** LastModified **   <a name="lambda-Type-EventSourceMappingConfiguration-LastModified"></a>
이벤트 소스 매핑이 마지막으로 업데이트된 날짜 또는 상태가 변경된 날짜입니다(Unix 시간 초).  
유형: Timestamp  
필수 항목 여부: 아니요

 ** LastProcessingResult **   <a name="lambda-Type-EventSourceMappingConfiguration-LastProcessingResult"></a>
함수의 마지막 Lambda 호출의 결과입니다.  
유형: String  
필수 항목 여부: 아니요

 ** MaximumBatchingWindowInSeconds **   <a name="lambda-Type-EventSourceMappingConfiguration-MaximumBatchingWindowInSeconds"></a>
Lambda가 함수를 호출하기 전에 레코드를 수집하는 데 걸리는 최대 시간(초)입니다. `MaximumBatchingWindowInSeconds`는 0초에서 300초 사이의 값을 초 단위로 구성할 수 있습니다.  
스트림 및 Amazon SQS 이벤트 소스의 경우 기본 일괄 처리 기간은 0초입니다. Amazon MSK, 자체 관리형 Apache Kafka 및 Amazon MQ, DocumentDB 이벤트 소스의 경우 기본 일괄 처리 시간은 500ms입니다. `MaximumBatchingWindowInSeconds`는 초 단위로만 변경할 수 있기 때문에 변경한 후에는 500ms 기본 일괄 처리 기간으로 되돌릴 수 없습니다. 기본 일괄 처리 기간을 복원하려면 새 이벤트 소스 매핑을 생성해야 합니다.  
관련 설정: 스트림 및 Amazon SQS 이벤트 소스의 경우, `BatchSize`를 10보다 큰 값으로 설정하면 `MaximumBatchingWindowInSeconds`를 1이상으로 설정해야 합니다.  
유형: 정수  
유효한 범위: 최소값 0. 최대값 300입니다.  
필수 항목 여부: 아니요

 ** MaximumRecordAgeInSeconds **   <a name="lambda-Type-EventSourceMappingConfiguration-MaximumRecordAgeInSeconds"></a>
(Kinesis와 DynamoDB 스트림만 해당) 지정된 기간보다 오래된 레코드를 삭제합니다. 기본값은 -1이며, 최대 기간을 무한으로 설정합니다. 값이 무한으로 설정되면 Lambda가 오래된 레코드를 버리지 않습니다.  
최대 레코드 수명의 최소 유효 값은 60초입니다. 60보다 작거나 -1보다 큰 값은 파라미터의 절대 범위에 속하지만 허용되지 않습니다.
유형: 정수  
유효한 범위: 최소값은 -1입니다. 최대값 604,800입니다.  
필수 항목 여부: 아니요

 ** MaximumRetryAttempts **   <a name="lambda-Type-EventSourceMappingConfiguration-MaximumRetryAttempts"></a>
(Kinesis와 DynamoDB 스트림만 해당) 지정된 횟수의 재시도 후에 레코드를 삭제합니다. 기본값은 -1이며, 최대 재시도 횟수를 무한으로 설정합니다. MaximumRetryAttempts가 무한인 경우 이벤트 소스에서 레코드가 만료될 때까지 Lambda가 실패한 레코드를 다시 시도합니다.  
유형: Integer  
유효한 범위: 최소값은 -1입니다. 최대값은 10,000입니다.  
필수 항목 여부: 아니요

 ** ParallelizationFactor **   <a name="lambda-Type-EventSourceMappingConfiguration-ParallelizationFactor"></a>
(Kinesis와 DynamoDB스트림만 해당) 각 샤드에서 동시에 처리할 배치 수입니다. 기본값은 1입니다.  
유형: Integer  
유효한 범위: 최소값 1. 최대값은 10입니다.  
필수 항목 여부: 아니요

 ** Queues **   <a name="lambda-Type-EventSourceMappingConfiguration-Queues"></a>
 (Amazon MQ) 소비할 Amazon MQ 브로커 대상 대기열의 이름입니다.  
유형: 문자열 배열  
배열 멤버: 고정된 항목 수는 1개입니다.  
길이 제약: 최소 길이는 1입니다. 최대 길이는 1,000입니다.  
패턴: `[\s\S]*`   
필수 항목 여부: 아니요

 ** ScalingConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-ScalingConfig"></a>
(Amazon SQS만 해당) 이벤트 소스의 크기 조정 구성입니다. 자세한 내용은 [Amazon SQS 이벤트 소스의 최대 동시성 구성](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)을 참조하세요.  
유형: [ScalingConfig](API_ScalingConfig.md)객체  
필수 항목 여부: 아니요

 ** SelfManagedEventSource **   <a name="lambda-Type-EventSourceMappingConfiguration-SelfManagedEventSource"></a>
이벤트 소스에 대한 자체 관리형 Apache Kafka 클러스터입니다.  
유형: [SelfManagedEventSource](API_SelfManagedEventSource.md) 객체  
필수 항목 여부: 아니요

 ** SelfManagedKafkaEventSourceConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-SelfManagedKafkaEventSourceConfig"></a>
자체 관리형 Apache Kafka 이벤트 소스에 대한 특정 구성 설정입니다.  
유형: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md)객체  
필수 항목 여부: 아니요

 ** SourceAccessConfigurations **   <a name="lambda-Type-EventSourceMappingConfiguration-SourceAccessConfigurations"></a>
이벤트 소스를 보호하기 위한 일련의 인증 프로토콜 또는 VPC 구성 요소입니다.  
유형: [SourceAccessConfiguration](API_SourceAccessConfiguration.md) 객체 배열  
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수는 22개입니다.  
필수 항목 여부: 아니요

 ** StartingPosition **   <a name="lambda-Type-EventSourceMappingConfiguration-StartingPosition"></a>
읽기를 시작하는 스트림 내의 위치입니다. Amazon Kinesis 및 Amazon DynamoDB Streams 이벤트 소스에 필요합니다. `AT_TIMESTAMP`는 Amazon DynamoDB Streams, Amazon DocumentDB, Amazon MSK, 자체 관리형 Apache Kafka에 대해서만 지원됩니다.  
유형: 문자열  
유효 값: `TRIM_HORIZON | LATEST | AT_TIMESTAMP`   
필수 항목 여부: 아니요

 ** StartingPositionTimestamp **   <a name="lambda-Type-EventSourceMappingConfiguration-StartingPositionTimestamp"></a>
`StartingPosition`을 `AT_TIMESTAMP`로 설정했을 때 읽기를 시작하는 시간(Unix 시간 초)입니다. `StartingPositionTimestamp`는 미래가 될 수 없습니다.  
유형: 타임스탬프  
필수 항목 여부: 아니요

 ** State **   <a name="lambda-Type-EventSourceMappingConfiguration-State"></a>
이벤트 소스 매핑의 상태입니다. `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating` 또는 `Deleting` 중 하나일 수 있습니다.  
유형: String  
필수 항목 여부: 아니요

 ** StateTransitionReason **   <a name="lambda-Type-EventSourceMappingConfiguration-StateTransitionReason"></a>
사용자 또는 Lambda가 이벤트 소스 매핑을 마지막으로 변경했는지 여부를 나타냅니다.  
유형: String  
필수 항목 여부: 아니요

 ** Topics **   <a name="lambda-Type-EventSourceMappingConfiguration-Topics"></a>
Kafka 주제의 이름입니다.  
유형: 문자열 배열  
배열 멤버: 고정된 항목 수는 1개입니다.  
길이 제약: 최소 길이는 1입니다. 최대 길이는 249입니다.  
패턴: `^[^.]([a-zA-Z0-9\-_.]+)`   
필수 항목 여부: 아니요

 ** TumblingWindowInSeconds **   <a name="lambda-Type-EventSourceMappingConfiguration-TumblingWindowInSeconds"></a>
(Kinesis 및 DynamoDB 스트림만 해당) DynamoDB 및 Kinesis 스트림 이벤트 소스에 대한 처리 시간(초)입니다. 값이 0초이면 텀블링 윈도우가 없음을 나타냅니다.  
유형: 정수  
유효한 범위: 최소값 0. 최대값은 900입니다.  
필수 항목 여부: 아니요

 ** UUID **   <a name="lambda-Type-EventSourceMappingConfiguration-UUID"></a>
이벤트 소스 매핑의 식별자입니다.  
유형: String  
필수 항목 여부: 아니요

## 참고
<a name="API_EventSourceMappingConfiguration_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/EventSourceMappingConfiguration) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/EventSourceMappingConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/EventSourceMappingConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/EventSourceMappingConfiguration)