# GetEventSourceMapping
<a name="API_GetEventSourceMapping"></a>

Retorna detalhes sobre um mapeamento de origem do evento. Você pode obter o identificador de um mapeamento a partir da saída de [ListEventSourceMappings](API_ListEventSourceMappings.md).

## Sintaxe da Solicitação
<a name="API_GetEventSourceMapping_RequestSyntax"></a>

```
GET /2015-03-31/event-source-mappings/UUID HTTP/1.1
```

## Parâmetros da Solicitação de URI
<a name="API_GetEventSourceMapping_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [UUID](#API_GetEventSourceMapping_RequestSyntax) **   <a name="lambda-GetEventSourceMapping-request-UUID"></a>
O identificador do mapeamento da origem do evento.  
Obrigatório: sim

## Corpo da Solicitação
<a name="API_GetEventSourceMapping_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da Resposta
<a name="API_GetEventSourceMapping_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string"
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "EventSourceArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "LastModified": number,
   "LastProcessingResult": "string",
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "ParallelizationFactor": number,
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string"
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "State": "string",
   "StateTransitionReason": "string",
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number,
   "UUID": "string"
}
```

## Elementos de Resposta
<a name="API_GetEventSourceMapping_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [AmazonManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-AmazonManagedKafkaEventSourceConfig"></a>
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)

 ** [BatchSize](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-BatchSize"></a>
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.

 ** [BisectBatchOnFunctionError](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-BisectBatchOnFunctionError"></a>
(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

 ** [DestinationConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-DestinationConfig"></a>
(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)

 ** [DocumentDBEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-DocumentDBEventSourceConfig"></a>
Definições de configuração específicas de uma origem do evento do DocumentDB.  
Tipo: objeto [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md)

 ** [EventSourceArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-EventSourceArn"></a>
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})?:(.*)` 

 ** [FilterCriteria](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FilterCriteria"></a>
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)

 ** [FunctionArn](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FunctionArn"></a>
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-_]+))?` 

 ** [FunctionResponseTypes](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-FunctionResponseTypes"></a>
(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` 

 ** [LastModified](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LastModified"></a>
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

 ** [LastProcessingResult](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-LastProcessingResult"></a>
O resultado da última invocação do Lambda da sua função.  
Tipo: string

 ** [MaximumBatchingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumBatchingWindowInSeconds"></a>
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.

 ** [MaximumRecordAgeInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumRecordAgeInSeconds"></a>
(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.

 ** [MaximumRetryAttempts](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-MaximumRetryAttempts"></a>
(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.

 ** [ParallelizationFactor](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ParallelizationFactor"></a>
(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.

 ** [Queues](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-Queues"></a>
 (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]*` 

 ** [ScalingConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-ScalingConfig"></a>
(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)

 ** [SelfManagedEventSource](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SelfManagedEventSource"></a>
O cluster autogerenciado do Apache Kafka para sua fonte de eventos.  
Tipo: objeto [SelfManagedEventSource](API_SelfManagedEventSource.md)

 ** [SelfManagedKafkaEventSourceConfig](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SelfManagedKafkaEventSourceConfig"></a>
Definições de configuração específicas para uma origem de eventos do Apache Kafka autogerenciado.  
Tipo: objeto [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md)

 ** [SourceAccessConfigurations](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-SourceAccessConfigurations"></a>
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.

 ** [StartingPosition](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StartingPosition"></a>
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` 

 ** [StartingPositionTimestamp](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StartingPositionTimestamp"></a>
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

 ** [State](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-State"></a>
O estado do mapeamento da fonte de eventos. Pode ser um destes: `Creating`, `Enabling`, `Enabled`, `Disabling`, `Disabled`, `Updating` ou `Deleting`.  
Tipo: string

 ** [StateTransitionReason](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-StateTransitionReason"></a>
Indica se um usuário ou o Lambda fez a última alteração no mapeamento de fontes de eventos.  
Tipo: string

 ** [Topics](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-Topics"></a>
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\-_.]+)` 

 ** [TumblingWindowInSeconds](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-TumblingWindowInSeconds"></a>
(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.

 ** [UUID](#API_GetEventSourceMapping_ResponseSyntax) **   <a name="lambda-GetEventSourceMapping-response-UUID"></a>
O identificador do mapeamento de fontes de eventos.  
Tipo: string

## Erros
<a name="API_GetEventSourceMapping_Errors"></a>

Para obter informações sobre os erros que todas as ações retornam, consulte [Erros comuns](CommonErrors.md).

 ** InvalidParameterValueException **   
Um dos parâmetros da solicitação não é válido.  
Código de Status HTTP: 400

 ** ResourceNotFoundException **   
O recurso especificado na solicitação não existe.  
Código de Status HTTP: 404

 ** ServiceException **   
O serviço AWS Lambda encontrou um erro interno.  
Código de Status HTTP: 500

 ** TooManyRequestsException **   
O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte [Cotas do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de status HTTP: 429

## Ver também
<a name="API_GetEventSourceMapping_SeeAlso"></a>

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte:
+  [AWS Interface de linha de comando](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetEventSourceMapping) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetEventSourceMapping)