Ações do AWS Lambda

Esta página fornece uma referência para as ações do AWS Lambda disponíveis no catálogo de ações de automação de fluxo de trabalho. Use estas ações para gerenciar e invocar funções do Lambda como parte das definições do seu fluxo de trabalho.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Invocar uma função do Lambda

O identificador da ação é aws.lambda.invoke.

Invoca uma função Lambda de forma síncrona ou assíncrona com uma carga opcional.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a função está localizada.	`us-east-2`
`functionName`	Corda	Obrigatório. Nome da função do Lambda a ser invocada.	`hello-you`
`payload`	Mapa	Opcional. Carga de entrada a ser passada para a função.	`{"user": "R2-D2"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "payload", "expression": ".payload"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`payload`	Mapa	`{"statusCode": 200, "body": "Hello R2-D2!"}`
`statusCode`	Interno	`200`
`executedVersion`	Corda	`"$LATEST"`
`functionError`	Corda	`"Unhandled::Error occurred"`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Atualizar configuração da função do Lambda

O identificador da ação é aws.lambda.updateFunctionConfiguration.

Modifica a configuração de uma função do Lambda. Forneça apenas os parâmetros que você deseja alterar.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a função está localizada.	`us-east-2`
`functionName`	Corda	Obrigatório. Nome da função do Lambda a ser atualizada.	`my-lambda-function-to-update`
`role`	Corda	Opcional. ARN da função do IAM para atribuir à função.	`arn:aws:iam::123456789012:role/new-lambda-role`
`handler`	Corda	Opcional. Manipulador atualizado para a função.	`main.new_handler`
`description`	Corda	Opcional. Descrição atualizada para a função.	`Updated function description`
`parameters`	Mapa	Opcional. Campos adicionais do boto3 não modelados de outra forma. Aceita qualquer argumento opcional da API.	`{"Timeout": "60", "MemorySize": 123}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "response", "expression": ".response"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"FunctionName": "hello-you", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 30, "MemorySize": 128}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (ResourceNotFoundException) when calling the UpdateFunctionConfiguration operation: Function not found"`

Saída

Tipo

Exemplo

response

Objeto

{"FunctionName": "hello-you", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 30, "MemorySize": 128}

success

Boleano

true

false

errorMessage

Corda

"An error occurred (ResourceNotFoundException) when calling the UpdateFunctionConfiguration operation: Function not found"

Descreva uma função do Lambda

O identificador da ação é aws.lambda.getFunction.

Recupera os detalhes de configuração, a localização do código e outros metadados para uma função do Lambda específica.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a função está localizada.	`us-east-2`
`functionName`	Corda	Obrigatório. Nome da função do Lambda.	`my-lambda-function`
`parameters`	Mapa	Opcional. Campos adicionais do boto3 não modelados de outra forma. Aceita qualquer argumento opcional da API.	`{"Qualifier": "1"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "response", "expression": ".response"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Resposta completa da API. Consulte a referência get_function do Boto3 .
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"ResourceNotFoundException: Function not found"`

Saída

Tipo

Exemplo

response

Objeto

Resposta completa da API. Consulte a

referência get_function do Boto3

success

Boleano

true

false

errorMessage

Corda

"ResourceNotFoundException: Function not found"

Listar aliases para uma função do Lambda

O identificador da ação é aws.lambda.listAliases.

Retorna uma lista de aliases para uma função do Lambda. Aliases são ponteiros nomeados para versões de função. Use marker e maxItems para paginar grandes conjuntos de resultados.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a função está localizada.	`us-east-2`
`functionName`	Corda	Obrigatório. Nome da função do Lambda.	`my-lambda-function`
`marker`	Corda	Opcional. Token de paginação. Passe o valor `NextMarker` de uma resposta anterior para recuperar a próxima página.	`"abcd....."`
`maxItems`	Interno	Opcional. Número máximo de aliases para retornar.	`123`
`parameters`	Mapa	Opcional. Campos adicionais do boto3 não modelados de outra forma. Aceita qualquer argumento opcional da API.	`{"AnotherOptionalParam": "value"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "response", "expression": ".response"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Resposta completa da API. Consulte a referência list_aliases do Boto3 .
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"ResourceNotFoundException: Function not found"`

Saída

Tipo

Exemplo

response

Objeto

Resposta completa da API. Consulte a

referência list_aliases do Boto3

success

Boleano

true

false

errorMessage

Corda

"ResourceNotFoundException: Function not found"

Listar funções do Lambda

O identificador da ação é aws.lambda.listFunctions.

Retorna uma lista de funções do Lambda em uma região, com a configuração específica da versão de cada uma. A AWS retorna no máximo 50 funções por chamada — use marker e maxItems para paginar grandes conjuntos de resultados.

Esta ação retorna um subconjunto de FunctionConfiguration campos. Para obter o conjunto completo — incluindo State, StateReasonCode, LastUpdateStatus e RuntimeVersionConfig — use aws.lambda.getFunction em vez disso.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS da qual listar funções.	`us-west-2`
`functionVersion`	Corda	Opcional. Defina como `ALL` para incluir todas as versões publicadas de cada função, além da versão não publicada.	`ALL`
`marker`	Corda	Opcional. Token de paginação. Passe o valor `NextMarker` de uma resposta anterior para recuperar a próxima página.	`"abcd....."`
`maxItems`	Interno	Opcional. Número máximo de funções a serem retornadas por chamada. A AWS limita isso a 50, independentemente de um valor maior.	`50`
`parameters`	Mapa	Opcional. Campos adicionais do boto3 não modelados de outra forma. `MasterRegion` é relevante apenas para funções do Lambda@Edge e requer `functionVersion: ALL` quando definido.	`{"MasterRegion": "us-east-1"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "functions", "expression": ".response.Functions"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"Functions": [{"FunctionName": "helloworld", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 3, "MemorySize": 128}], "NextMarker": "..."}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"InvalidParameterValueException: 1 validation error detected"`

Saída

Tipo

Exemplo

response

Objeto

{"Functions": [{"FunctionName": "helloworld", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 3, "MemorySize": 128}], "NextMarker": "..."}

success

Boleano

true

false

errorMessage

Corda

"InvalidParameterValueException: 1 validation error detected"

Obter histórico de execução durável do Lambda

O identificador da ação é aws.lambda.getDurableExecutionHistory.

Recupera o histórico de execução de uma execução durável do Lambda, mostrando todos os passos, retornos de chamada e eventos que ocorreram. Esta ação se aplica apenas a execuções duráveis do Lambda — ela não pode recuperar o histórico de invocação para funções regulares do Lambda. O histórico está disponível enquanto a execução está em andamento e por um período de retenção configurável após a sua conclusão (1–90 dias, padrão de 30 dias).

Para execuções de longa duração com muitas etapas ou retornos de chamada, defina includeExecutionData como false quando precisar apenas de tipos de evento e timestamps em vez de cargas completas — isso produz uma resposta mais compacta.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a execução durável está localizada.	`us-west-2`
`durableExecutionArn`	Corda	Obrigatório. ARN da execução durável para a qual recuperar o histórico.	`arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123`
`includeExecutionData`	Boleano	Opcional. Incluir resultados da etapa e cargas de retorno de chamada nos eventos de histórico. Defina como `false` para uma resposta mais compacta. O padrão é `true` .	`true`
`maxItems`	Interno	Opcional. Número máximo de eventos de histórico a serem retornados por chamada. Padrão 100, máximo 1000. Defina como `0` para usar o padrão.	`100`
`marker`	Corda	Opcional. Token de paginação. Passe o valor `NextMarker` de uma resposta anterior. Os tokens expiram após 24 horas.	`"abcd....."`
`reverseOrder`	Boleano	Opcional. Retornar eventos do mais recente para o mais antigo (ordem cronológica inversa). O padrão é `false` (do mais antigo para o mais recente).	`true`
`parameters`	Mapa	Opcional. Campos adicionais do boto3 não modelados de outra forma.
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "events", "expression": ".response.Events"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"Events": [{"EventType": "ExecutionStarted", "EventId": 1, "EventTimestamp": "2026-08-11T05:40:49.000+0000"}, {"EventType": "ExecutionSucceeded", "EventId": 4}], "NextMarker": ""}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"ResourceNotFoundException: Durable execution not found: arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123"`

Saída

Tipo

Exemplo

response

Objeto

{"Events": [{"EventType": "ExecutionStarted", "EventId": 1, "EventTimestamp": "2026-08-11T05:40:49.000+0000"}, {"EventType": "ExecutionSucceeded", "EventId": 4}], "NextMarker": ""}

success

Boleano

true

false

errorMessage

Corda

"ResourceNotFoundException: Durable execution not found: arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123"

Definir a simultaneidade da função do Lambda

O identificador da ação é aws.lambda.putFunctionConcurrency.

Define a simultaneidade reservada para uma função do Lambda — o número máximo de execuções simultâneas. Reservar a simultaneidade garante que a função tenha capacidade para esse número de execuções simultâneas e impede que ela seja escalonada além desse nível. A configuração de simultaneidade se aplica a todas as versões publicadas e à versão não publicada. Definir reservedConcurrentExecutions como 0 desativa a função sem excluí-la.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a função está localizada.	`us-west-2`
`functionName`	Corda	Obrigatório. Nome, `name:version` ou ARN da função. A restrição de tamanho de 64 caracteres se aplica apenas ao especificar somente o nome (não o ARN completo).	`my-function`
`reservedConcurrentExecutions`	Interno	Obrigatório. Número de execuções simultâneas a serem reservadas. O valor mínimo é `0` (desativa a função). O máximo efetivo é o pool de simultaneidade não reservada da sua conta. Pelo menos 100 execuções não reservadas devem permanecer para funções sem um limite por função.	`100`
`parameters`	Mapa	Opcional. Campos adicionais do boto3 não modelados de outra forma.
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "response", "expression": ".response"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"ReservedConcurrentExecutions": 100}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"InvalidParameterValueException: Specified ReservedConcurrentExecutions decreases account's UnreservedConcurrentExecution below its minimum value"`

Saída

Tipo

Exemplo

response

Objeto

{"ReservedConcurrentExecutions": 100}

success

Boleano

true

false

errorMessage

Corda

"InvalidParameterValueException: Specified ReservedConcurrentExecutions decreases account's UnreservedConcurrentExecution below its minimum value"

Esta tradução de máquina é fornecida para sua comodidade.

Pré-requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Invocar uma função do Lambda

Atualizar configuração da função do Lambda

Descreva uma função do Lambda

Listar aliases para uma função do Lambda

Listar funções do Lambda

Obter histórico de execução durável do Lambda

Definir a simultaneidade da função do Lambda

Pré-requisitos