• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# `aws:invokeLambdaFunction` – Invoca uma função do AWS Lambda
<a name="automation-action-lamb"></a>

Chama a função do AWS Lambda especificada.

**nota**  
Cada ação `aws:invokeLambdaFunction` pode ser executada por uma duração máxima de cinco minutos (300 segundos). Você pode limitar o tempo limite especificando o parâmetro `timeoutSeconds` para uma etapa `aws:invokeLambdaFunction`.

**nota**  
A ação `aws:invokeLambdaFunction` suporta uma nova tentativa automática de controle de utilização. Para obter mais informações, consulte [Configurar a repetição automática para operações com controle de utilização](automation-throttling-retry.md).

**Input**  
Essa ação oferece suporte para a maioria dos parâmetros invocados do serviço Lambda. Para obter mais informações, consulte [Invoke](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html).

------
#### [ YAML ]

```
name: invokeMyLambdaFunction
action: aws:invokeLambdaFunction
maxAttempts: 3
timeoutSeconds: 120
onFailure: Abort
inputs:
  FunctionName: MyLambdaFunction
```

------
#### [ JSON ]

```
{
    "name": "invokeMyLambdaFunction",
    "action": "aws:invokeLambdaFunction",
    "maxAttempts": 3,
    "timeoutSeconds": 120,
    "onFailure": "Abort",
    "inputs": {
        "FunctionName": "MyLambdaFunction"
    }
}
```

------

FunctionName  
O nome da função do Lambda. Essa função deve existir.  
Tipo: String  
Exigido: sim

Qualifier  
A versão da função ou nome do alias.  
Tipo: string  
Obrigatório: não

InvocationType  
O tipo de invocação. O valor padrão é `RequestResponse`.  
Tipo: string  
Valores válidos: `Event` \$1 `RequestResponse` \$1 `DryRun`  
Obrigatório: não

LogType  
Se o valor padrão for `Tail`, o tipo de invocação deverá ser `RequestResponse`. O Lambda retorna os últimos 4 KB de dados de log produzidos pela sua função Lambda, codificados em base64.  
Tipo: string  
Valores válidos: `None` \$1 `Tail`  
Obrigatório: não

ClientContext  
As informações específicas do cliente.  
Obrigatório: não

InputPayload  
Um objeto JSON ou YAML que será transmitido para o primeiro parâmetro do manipulador. É possível usar essa entrada a fim de transmitir dados para a função. Essa entrada fornece mais flexibilidade e suporte do que a entrada `Payload` legada. Se você definir `InputPayload` e `Payload` para a ação, `InputPayload` tem precedência e o valor `Payload` não será usado.  
Tipo: StringMap  
Obrigatório: não

Carga útil  
Uma string JSON que é transmitida para o primeiro parâmetro do manipulador. É possível usá-la a fim de transmitir dados de entrada para a função. Recomendamos usar a entrada `InputPayload` para funcionalidade adicional.  
Tipo: string  
Obrigatório: nãoOutput

StatusCode  
Código de status do HTTP

FunctionError  
Se presente, ele indica que ocorreu um erro durante a execução da função. Os detalhes do erro estão incluídos na carga útil da resposta.

LogResult  
Os logs codificados pelo base64 para a invocação da função Lambda. Os logs estarão presentes apenas se o tipo de invocação for `RequestResponse` e se tiverem sido solicitados.

Carga útil  
A representação JSON do objeto retornado pela função Lambda. A carga útil estará presente apenas se o tipo de invocação for `RequestResponse`.

A seguir é mostrada uma parte do runbook `AWS-PatchInstanceWithRollback` que demonstra como fazer referência a saídas da ação `aws:invokeLambdaFunction`.

------
#### [ YAML ]

```
- name: IdentifyRootVolume
  action: aws:invokeLambdaFunction
  inputs:
    FunctionName: "IdentifyRootVolumeLambda-{{automation:EXECUTION_ID}}"
    Payload: '{"InstanceId": "{{InstanceId}}"}'
- name: PrePatchSnapshot
  action: aws:executeAutomation
  inputs:
    DocumentName: "AWS-CreateSnapshot"
    RuntimeParameters:
      VolumeId: "{{IdentifyRootVolume.Payload}}"
      Description: "ApplyPatchBaseline restoration case contingency"
```

------
#### [ JSON ]

```
{
    "name": "IdentifyRootVolume",
    "action": "aws:invokeLambdaFunction",
    "inputs": {
      "FunctionName": "IdentifyRootVolumeLambda-{{automation:EXECUTION_ID}}",
      "Payload": "{\"InstanceId\": \"{{InstanceId}}\"}"
    }
  },
  {
    "name": "PrePatchSnapshot",
    "action": "aws:executeAutomation",
    "inputs": {
      "DocumentName": "AWS-CreateSnapshot",
      "RuntimeParameters": {
        "VolumeId": "{{IdentifyRootVolume.Payload}}",
        "Description": "ApplyPatchBaseline restoration case contingency"
      }
    }
  }
```

------