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

Un mapeo entre un recurso AWS y una función Lambda. Para más información, consulte [CreateEventSourceMapping](API_CreateEventSourceMapping.md).

## Contenido
<a name="API_EventSourceMappingConfiguration_Contents"></a>

 ** AmazonManagedKafkaEventSourceConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-AmazonManagedKafkaEventSourceConfig"></a>
Ajustes de configuración específicos para orígenes de eventos de Amazon Managed Streaming para Apache Kafka (Amazon MSK).  
Tipo: objeto [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md)  
Obligatorio: no

 ** BatchSize **   <a name="lambda-Type-EventSourceMappingConfiguration-BatchSize"></a>
El número máximo de registros en cada lote que Lambda extrae del flujo o la cola y envía a su función. Lambda pasa todos los registros del lote a la función en una sola llamada hasta el límite de carga para la invocación síncrona (6 MB).  
Valor predeterminado: varía según el servicio. Para Amazon SQS, el valor predeterminado es 10. Para todos los demás servicios, el valor predeterminado es 100.  
Configuración relacionada: cuando configura `BatchSize` en un valor superior a 10, debe establecer `MaximumBatchingWindowInSeconds` en al menos 1.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 10000.  
Obligatorio: no

 ** BisectBatchOnFunctionError **   <a name="lambda-Type-EventSourceMappingConfiguration-BisectBatchOnFunctionError"></a>
(Solo Kinesis y DynamoDB Streams) Si la función devuelve un error, divida el lote en dos y vuelva a intentarlo. El valor predeterminado es false.  
Tipo: Booleano  
Obligatorio: no

 ** DestinationConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-DestinationConfig"></a>
(Solo para Kinesis, DynamoDB Streams, Amazon MSK y fuentes de eventos autogestionadas de Apache Kafka únicamente) Un objeto de configuración que especifica el destino de un evento después de que Lambda lo procese.  
Tipo: objeto [DestinationConfig](API_DestinationConfig.md)  
Obligatorio: no

 ** DocumentDBEventSourceConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-DocumentDBEventSourceConfig"></a>
Ajustes de configuración específicos para un origen de eventos de DocumentDB.  
Tipo: objeto [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md)  
Obligatorio: no

 ** EventSourceArn **   <a name="lambda-Type-EventSourceMappingConfiguration-EventSourceArn"></a>
El nombre de recurso de Amazon (ARN) del origen de evento.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)`   
Obligatorio: no

 ** FilterCriteria **   <a name="lambda-Type-EventSourceMappingConfiguration-FilterCriteria"></a>
Un objeto que define los criterios de filtro que determinan si Lambda debe procesar un evento o no. Para obtener más información, consulte [Filtrado de eventos de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).  
Tipo: objeto [FilterCriteria](API_FilterCriteria.md)  
Obligatorio: no

 ** FunctionArn **   <a name="lambda-Type-EventSourceMappingConfiguration-FunctionArn"></a>
El ARN de la función de Lambda.  
Tipo: String  
Patrón: `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-_]+))?`   
Obligatorio: no

 ** FunctionResponseTypes **   <a name="lambda-Type-EventSourceMappingConfiguration-FunctionResponseTypes"></a>
(Kinesis, DynamoDB Streams, and Amazon SQS) Una lista de enumeraciones de tipo de respuesta actuales aplicadas a la asignación de orígenes de eventos.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.  
Valores válidos: `ReportBatchItemFailures`   
Obligatorio: no

 ** LastModified **   <a name="lambda-Type-EventSourceMappingConfiguration-LastModified"></a>
La fecha en la que se actualizó por última vez el mapeo de fuente del evento o en que su estado cambió, en segundos de tiempo Unix.  
Tipo: marca temporal  
Obligatorio: no

 ** LastProcessingResult **   <a name="lambda-Type-EventSourceMappingConfiguration-LastProcessingResult"></a>
El resultado de la última invocación de Lambda de su función.  
Tipo: cadena  
Obligatorio: no

 ** MaximumBatchingWindowInSeconds **   <a name="lambda-Type-EventSourceMappingConfiguration-MaximumBatchingWindowInSeconds"></a>
La cantidad de tiempo máxima, en segundos, que Lambda emplea a fin de recopilar registros antes de invocar la función. Puede configurar `MaximumBatchingWindowInSeconds` como cualquier valor entre 0 segundos y 300 segundos, en incrementos de segundos.  
En el caso de los flujos y los orígenes de eventos de Amazon SQS, el periodo de procesamiento por lotes predeterminado es de 0 segundos. En el caso de los orígenes de eventos de Amazon MSK, Apache Kafka autoadministrado, Amazon MQ y DocumentDB, el periodo de procesamiento por lotes predeterminado es de 500 ms. Tenga en cuenta que como solo puede cambiar `MaximumBatchingWindowInSeconds` en incrementos de segundos, no puede volver al periodo de procesamiento por lotes predeterminado de 500 ms después de haberlo cambiado. Para restaurar el plazo de procesamiento por lotes predeterminado, debe crear una nueva asignación de origen de eventos.  
Configuración relacionada: en el caso de los flujos y los orígenes de eventos de Amazon SQS, cuando establece `BatchSize` en un valor superior a 10, debe establecer `MaximumBatchingWindowInSeconds` en al menos 1.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 300.  
Obligatorio: no

 ** MaximumRecordAgeInSeconds **   <a name="lambda-Type-EventSourceMappingConfiguration-MaximumRecordAgeInSeconds"></a>
(Solo Kinesis y DynamoDB Streams) Descarte registros anteriores a la edad especificada. El valor predeterminado es -1, que establece la edad máxima en infinita. Cuando el valor se establece en infinito, Lambda nunca descarta los registros antiguos.  
El valor mínimo válido para la antigüedad máxima del registro es de 60 segundos. Si bien los valores inferiores a 60 y superiores a -1 se encuentran dentro del rango absoluto del parámetro, no están permitidos
Tipo: entero  
Rango válido: valor mínimo de -1. Valor máximo de 604800.  
Obligatorio: no

 ** MaximumRetryAttempts **   <a name="lambda-Type-EventSourceMappingConfiguration-MaximumRetryAttempts"></a>
(Solo Kinesis y DynamoDB Streams) Descarte registros después del número de reintentos especificado. El valor predeterminado es -1, que establece el número máximo de reintentos en infinito. Cuando MaximumRetryAttempts es infinito, Lambda reintenta los registros fallidos hasta que el registro caduque en la fuente de eventos.  
Tipo: entero  
Rango válido: valor mínimo de -1. Valor máximo de 10000.  
Obligatorio: no

 ** ParallelizationFactor **   <a name="lambda-Type-EventSourceMappingConfiguration-ParallelizationFactor"></a>
(Solo Kinesis y DynamoDB Streams) El número de lotes de cada partición que se procesarán en forma simultánea. El valor predeterminado es 1.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 10.  
Obligatorio: no

 ** Queues **   <a name="lambda-Type-EventSourceMappingConfiguration-Queues"></a>
 (Amazon MQ) El nombre de la cola de destino del agente de Amazon MQ que se va a consumir.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1000 caracteres.  
Patrón: `[\s\S]*`   
Obligatorio: no

 ** ScalingConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-ScalingConfig"></a>
(Solo Amazon SQS) La configuración de escalado de orígenes de eventos. Para obtener más información, consulte [Configuración de la simultaneidad máxima para los orígenes de eventos de Amazon SQS.](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)  
Tipo: objeto [ScalingConfig](API_ScalingConfig.md)  
Obligatorio: no

 ** SelfManagedEventSource **   <a name="lambda-Type-EventSourceMappingConfiguration-SelfManagedEventSource"></a>
El clúster de Apache Kafka autoadministrado para la fuente de eventos.  
Tipo: objeto [SelfManagedEventSource](API_SelfManagedEventSource.md)  
Obligatorio: no

 ** SelfManagedKafkaEventSourceConfig **   <a name="lambda-Type-EventSourceMappingConfiguration-SelfManagedKafkaEventSourceConfig"></a>
Ajustes de configuración específicos para un origen de eventos de Apache Kafka autoadministrados.  
Tipo: objeto [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md)  
Obligatorio: no

 ** SourceAccessConfigurations **   <a name="lambda-Type-EventSourceMappingConfiguration-SourceAccessConfigurations"></a>
Una matriz del protocolo de autenticación, los componentes de VPC o el host virtual para proteger y definir su fuente de eventos.  
Tipo: Matriz de objetos [SourceAccessConfiguration](API_SourceAccessConfiguration.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 22 elementos.  
Obligatorio: no

 ** StartingPosition **   <a name="lambda-Type-EventSourceMappingConfiguration-StartingPosition"></a>
La posición en el flujo donde comienza la lectura. Obligatorio para los orígenes de eventos de Amazon Kinesis y Amazon DynamoDB Stream. `AT_TIMESTAMP` solo es compatible con flujos de Amazon Kinesis, Amazon DocumentDB, Amazon MSK y Apache Kafka autoadministrado.  
Tipo: cadena  
Valores válidos: `TRIM_HORIZON | LATEST | AT_TIMESTAMP`   
Obligatorio: no

 ** StartingPositionTimestamp **   <a name="lambda-Type-EventSourceMappingConfiguration-StartingPositionTimestamp"></a>
Con `StartingPosition`, configure en `AT_TIMESTAMP` el tiempo a partir del cual comenzar la lectura, en segundos de tiempo Unix. `StartingPositionTimestamp` no puede ser futura.  
Tipo: marca temporal  
Obligatorio: no

 ** State **   <a name="lambda-Type-EventSourceMappingConfiguration-State"></a>
El estado del mapeo de fuente de eventos. Puede ser uno de los siguientes: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating`, o `Deleting`.  
Tipo: cadena  
Obligatorio: no

 ** StateTransitionReason **   <a name="lambda-Type-EventSourceMappingConfiguration-StateTransitionReason"></a>
Indica si un usuario o Lambda realizaron el último cambio en el mapeo de fuente de eventos.  
Tipo: cadena  
Obligatorio: no

 ** Topics **   <a name="lambda-Type-EventSourceMappingConfiguration-Topics"></a>
El nombre del tema de Kafka.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 249 caracteres.  
Patrón: `^[^.]([a-zA-Z0-9\-_.]+)`   
Obligatorio: no

 ** TumblingWindowInSeconds **   <a name="lambda-Type-EventSourceMappingConfiguration-TumblingWindowInSeconds"></a>
(Solo Kinesis y DynamoDB Streams) La duración en segundos de una ventana de procesamiento para orígenes de eventos de DynamoDB y Kinesis Streams. Un valor de 0 segundos indica que no hay ventanas caídas.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 900.  
Obligatorio: no

 ** UUID **   <a name="lambda-Type-EventSourceMappingConfiguration-UUID"></a>
El identificador del mapeo de fuente de eventos.  
Tipo: cadena  
Obligatorio: no

## Véase también
<a name="API_EventSourceMappingConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/EventSourceMappingConfiguration) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/EventSourceMappingConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/EventSourceMappingConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/EventSourceMappingConfiguration)