

# Compreender os métodos de invocação de funções do Lambda
<a name="lambda-invocation"></a>

Após implantar sua função do Lambda, você poderá invocá-la de várias maneiras:
+ O [console do Lambda](testing-functions.md): use o console do Lambda para criar rapidamente um evento de teste para invocar sua função.
+ O [AWS SDK](https://aws.amazon.com/developer/tools/): use o AWS SDK para invocar programaticamente sua função.
+ A API [Invoke](https://docs.aws.amazon.com/lambda/latest/api/API_Invoke.html): use a API Invoke do Lambda para invocar diretamente sua função.
+ A [AWS Command Line Interface (AWS CLI)](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/invoke.html): use o comando `aws lambda invoke` da AWS CLI para invocar diretamente sua função diretamente da linha de comando.
+ Um [endpoint HTTP(S) de URL da função](urls-configuration.md): use URLs de função para criar um endpoint HTTP(S) dedicado que você pode usar para invocar a função.

Todos esses métodos são formas *diretas* de invocar sua função. No Lambda, um caso de uso comum é invocar sua função com base em um evento que ocorre em outro lugar da sua aplicação. Alguns serviços podem invocar uma função do Lambda a cada novo evento. Isso é chamado de [acionador](lambda-services.md). Para serviços baseados em fluxos e filas, o Lambda invoca a função com lotes de registros. Isso é chamado de [mapeamento de origem de eventos](invocation-eventsourcemapping.md).

Quando você invocar uma função, poderá optar por invocá-la de forma síncrona ou assíncrona. Com a [invocação síncrona](invocation-sync.md), você aguarda a função processar o evento e retornar uma resposta. Com a invocação [assíncrona](invocation-async.md), o Lambda coloca o evento na fila para processamento e retorna uma resposta imediatamente. O [parâmetro de solicitação `InvocationType` na API Invoke](https://docs.aws.amazon.com/lambda/latest/api/API_Invoke.html#API_Invoke_RequestParameters) determina como o Lambda invocará sua função. Um valor de `RequestResponse` indica invocação síncrona e um valor de `Event` indica invocação assíncrona.

Para invocar sua função pelo IPv6, use os [endpoints de pilha dupla](https://docs.aws.amazon.com/general/latest/gr/rande.html#dual-stack-endpoints) públicos do Lambda. Os endpoints de pilha dupla são compatíveis com IPv4 e IPv6. Os endpoints de pilha dupla do Lambda usam a seguinte sintaxe:

```
{{protocol}}://lambda.{{us-east-1}}.api.aws
```

Também é possível usar as [URLs de função do Lambda](urls-configuration.md) para invocar funções por IPv6. Os endpoints de URLs de função têm o seguinte formato:

```
https://{{url-id}}.lambda-url.{{us-east-1}}.on.aws
```

Se a invocação da função resultar em um erro, para invocações síncronas, visualize a mensagem de erro na resposta e repita a invocação manualmente. Para invocações assíncronas, o Lambda processa novas tentativas automaticamente e pode enviar registros de invocação para um [destino](invocation-async-retain-records.md#invocation-async-destinations).