# EventSourceMappingConfiguration Um mapeamento entre um recurso da AWS e uma função do Lambda. Para obter mais detalhes, consulte [CreateEventSourceMapping](API_CreateEventSourceMapping.md). ## Conteúdo ** AmazonManagedKafkaEventSourceConfig ** Definições de configuração específicas para uma origem de eventos do Amazon Managed Streaming for Apache Kafka (Amazon MSK). Tipo: objeto [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) Obrigatório: não ** BatchSize ** O número máximo de registros em cada batch que o Lambda extrai da sua transmissão ou fila e envia para sua função. O Lambda transmite todos os registros no batch para a função em uma única chamada até o limite de carga útil para invocação síncrona (6 MB). Valor padrão: varia de acordo com o serviço. Para o Amazon SQS, o padrão é 10. Para todos os outros serviços, o padrão é 100. Configuração relacionada: quando você define `BatchSize` como um valor maior que 10, deve definir `MaximumBatchingWindowInSeconds` como pelo menos 1. Tipo: inteiro Intervalo válido: valor mínimo de 1. Valor máximo de 10000. Obrigatório: não ** BisectBatchOnFunctionError ** (Somente fluxos do Kinesis e do DynamoDB) Se a função retornar um erro, divida o lote em dois e tente novamente. O valor padrão é falso. Tipo: booliano Obrigatório: não ** DestinationConfig ** (Somente origens de evento do Kinesis, DynamoDB Streams, Amazon MSK e Apache Kafka autogerenciado) Um objeto de configuração que especifica o destino de um evento após o Lambda processá-lo. Tipo: objeto [DestinationConfig](API_DestinationConfig.md) Obrigatório: não ** DocumentDBEventSourceConfig ** Definições de configuração específicas de uma origem do evento do DocumentDB. Tipo: objeto [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) Obrigatório: não ** EventSourceArn ** O nome de recurso da Amazon (ARN) da origem do evento. Tipo: string Padrão: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` Obrigatório: não ** FilterCriteria ** Um objeto que define os critérios de filtros que determinam se o Lambda deve processar um evento. Para saber mais, consulte o tópico sobre [Filtragem de eventos do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html). Tipo: objeto [FilterCriteria](API_FilterCriteria.md) Obrigatório: não ** FunctionArn ** O ARN da função Lambda. Tipo: string Padrão: `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-_]+))?` Obrigatório: não ** FunctionResponseTypes ** (Fluxos do Kinesis e do DynamoDB e Amazon SQS) Uma lista de enumerações de tipos de resposta atuais aplicadas ao mapeamento da origem do evento. Tipo: matriz de strings Membros da Matriz: número mínimo de 0 itens. Número máximo de 1 item. Valores Válidos: `ReportBatchItemFailures` Obrigatório: não ** LastModified ** A data em que o mapeamento de fontes de eventos foi atualizado pela última vez ou seu estado mudou, em segundos no horário do Unix. Tipo: Carimbo de data/hora Obrigatório: não ** LastProcessingResult ** O resultado da última invocação do Lambda da sua função. Tipo: string Exigido: não ** MaximumBatchingWindowInSeconds ** O tempo máximo usado pelo Lambda, em segundos, para reunir os registros antes de invocar a função. É possível configurar `MaximumBatchingWindowInSeconds` para qualquer valor de 0 a 300 segundos em incrementos de segundos. Para fluxos e fontes de eventos do Amazon SQS, a janela de lote padrão é de 0 segundos. Para origens do evento do Amazon MSK, Apache Kafka autogerenciado, Amazon MQ e DocumentDB, a janela de lotes padrão é de 500 ms. Observe que, como só é possível alterar `MaximumBatchingWindowInSeconds` em incrementos de segundos, você não pode reverter para a janela de lotes padrão de 500 ms depois da alteração. Para restaurar a janela de lotes padrão, é necessário criar um novo mapeamento de fonte de evento. Configuração relacionada: para fluxos e fontes de eventos do Amazon SQS, quando você define `BatchSize` como um valor maior que 10, deve definir `MaximumBatchingWindowInSeconds` como pelo menos 1. Tipo: inteiro Intervalo válido: valor mínimo de 0. Valor máximo de 300. Obrigatório: não ** MaximumRecordAgeInSeconds ** (Somente fluxos do Kinesis e do DynamoDB) Descarte registros mais antigos que a idade especificada. O valor padrão é -1, o que define a idade máxima como infinito. Quando o valor é definido como infinito, o Lambda nunca descarta registros antigos. O valor mínimo válido para a idade máxima de registro é 60. Embora valores menores que 60 e maiores que -1 estejam dentro do intervalo absoluto do parâmetro, eles não são permitidos Tipo: inteiro Intervalo válido: valor mínimo de -1. Valor máximo de 604800. Obrigatório: não ** MaximumRetryAttempts ** (Somente fluxos do Kinesis e do DynamoDB) Descarte registros após o número especificado de novas tentativas. O valor padrão é -1, o que define o número máximo de tentativas como infinito. Quando MaximumRetryAttempts é infinito, o Lambda tenta executar novamente os registros com falha até que o registro expire na fonte de eventos. Tipo: inteiro Intervalo válido: valor mínimo de -1. Valor máximo de 10000. Obrigatório: não ** ParallelizationFactor ** (Somente fluxos do Kinesis e do DynamoDB) O número de lotes a serem processados simultaneamente de cada fragmento. O valor padrão é 1. Tipo: inteiro Intervalo válido: valor mínimo de 1. Valor máximo de 10. Obrigatório: não ** Queues ** (Amazon MQ) O nome da fila de destino do agente do Amazon MQ a ser consumido. Tipo: matriz de strings Membros da matriz: número fixo de 1 item. Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.000. Padrão: `[\s\S]*` Obrigatório: não ** ScalingConfig ** (Somente para o Amazon SQS) A configuração de escalabilidade para a origem do evento. Para obter mais informações, consulte [Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency) (Configuração de simultaneidade máxima para origens de eventos do Amazon SQS). Tipo: objeto [ScalingConfig](API_ScalingConfig.md) Obrigatório: não ** SelfManagedEventSource ** O cluster autogerenciado do Apache Kafka para sua fonte de eventos. Tipo: objeto [SelfManagedEventSource](API_SelfManagedEventSource.md) Obrigatório: não ** SelfManagedKafkaEventSourceConfig ** Definições de configuração específicas para uma origem de eventos do Apache Kafka autogerenciado. Tipo: objeto [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) Obrigatório: não ** SourceAccessConfigurations ** Uma matriz do protocolo de autenticação, os componentes da VPC ou o host virtual para proteger e definir a fonte de eventos. Tipo: matriz de objetos [SourceAccessConfiguration](API_SourceAccessConfiguration.md) Membros da Matriz: número mínimo de 0 itens. Número máximo de 22 itens. Obrigatório: não ** StartingPosition ** A posição em um fluxo da qual você deseja iniciar a leitura. Obrigatório para origens de eventos do Amazon Kinesis e do Amazon DynamoDB Streams. `AT_TIMESTAMP` é compatível somente com os fluxos do Amazon Kinesis, o Amazon DocumentDB, o Amazon MSK e o Apache Kafka autogerenciado. Tipo: string Valores Válidos: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` Obrigatório: não ** StartingPositionTimestamp ** Com `StartingPosition` definido como `AT_TIMESTAMP`, o tempo a partir do qual a leitura é iniciada, em segundos de tempo do Unix. `StartingPositionTimestamp` não pode ser no futuro. Tipo: Carimbo de data/hora Obrigatório: não ** State ** O estado do mapeamento da fonte de eventos. Pode ser um destes: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating` ou `Deleting`. Tipo: string Exigido: não ** StateTransitionReason ** Indica se um usuário ou o Lambda fez a última alteração no mapeamento de fontes de eventos. Tipo: string Exigido: não ** Topics ** O nome do tópico do Kafka. Tipo: matriz de strings Membros da matriz: número fixo de 1 item. Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 249. Padrão: `^[^.]([a-zA-Z0-9\-_.]+)` Obrigatório: não ** TumblingWindowInSeconds ** (Somente fluxos do Kinesis e DynamoDB) A duração, em segundos, de uma janela de processamento para origens do evento de fluxos do DynamoDB e do Kinesis. O valor de 0 segundo indica que não há janela em queda. Tipo: inteiro Intervalo válido: valor mínimo de 0. Valor máximo de 900. Obrigatório: não ** UUID ** O identificador do mapeamento de fontes de eventos. Tipo: string Exigido: não ## Ver também Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte: + [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 para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/EventSourceMappingConfiguration)