Actions AWS Lambda

Cette page fournit une référence pour les actions AWS Lambda disponibles dans le catalogue des actions d’automatisation des workflows. Utilisez ces actions pour gérer et invoquer des fonctions Lambda dans le cadre de vos définitions de workflow.

Prérequis

Pour les prérequis et la configuration des identifiants, consultez Configurer les identifiants AWS.

Invoquer une fonction Lambda

L’identifiant de l’action est aws.lambda.invoke.

Invoque une fonction Lambda de manière synchrone ou asynchrone avec une charge utile optionnelle.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où la fonction est située.	`us-east-2`
`functionName`	Chaîne	Obligatoire. Nom de la fonction Lambda à invoquer.	`hello-you`
`payload`	Carte	Facultatif. Charge d’entrée à passer à la fonction.	`{"user": "R2-D2"}`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "payload", "expression": ".payload"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`payload`	Carte	`{"statusCode": 200, "body": "Hello R2-D2!"}`
`statusCode`	Int	`200`
`executedVersion`	Chaîne	`"$LATEST"`
`functionError`	Chaîne	`"Unhandled::Error occurred"`
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	Message d’erreur en cas d’échec.

Mettre à jour la configuration de la fonction Lambda

L’identifiant de l’action est aws.lambda.updateFunctionConfiguration.

Modifie la configuration d’une fonction Lambda. Fournissez uniquement les paramètres que vous souhaitez modifier.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où la fonction est située.	`us-east-2`
`functionName`	Chaîne	Obligatoire. Nom de la fonction Lambda à mettre à jour.	`my-lambda-function-to-update`
`role`	Chaîne	Facultatif. ARN du rôle IAM à attribuer à la fonction.	`arn:aws:iam::123456789012:role/new-lambda-role`
`handler`	Chaîne	Facultatif. Gestionnaire mis à jour pour la fonction.	`main.new_handler`
`description`	Chaîne	Facultatif. Description mise à jour pour la fonction.	`Updated function description`
`parameters`	Carte	Facultatif. Champs boto3 supplémentaires non modélisés par ailleurs. Accepte tout argument facultatif de l'API.	`{"Timeout": "60", "MemorySize": 123}`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "response", "expression": ".response"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	`{"FunctionName": "hello-you", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 30, "MemorySize": 128}`
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (ResourceNotFoundException) when calling the UpdateFunctionConfiguration operation: Function not found"`

Sortir

Type

Exemple

response

Objet

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

success

Booléen

true

false

errorMessage

Chaîne

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

Décrire une fonction Lambda

L’identifiant de l’action est aws.lambda.getFunction.

Récupère les détails de la configuration, l'emplacement du code et d'autres métadonnées pour une fonction Lambda spécifique.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où la fonction est située.	`us-east-2`
`functionName`	Chaîne	Obligatoire. Nom de la fonction Lambda.	`my-lambda-function`
`parameters`	Carte	Facultatif. Champs boto3 supplémentaires non modélisés par ailleurs. Accepte tout argument facultatif de l'API.	`{"Qualifier": "1"}`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "response", "expression": ".response"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Réponse complète de l’API. Consultez la référence Boto3 get_function .
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"ResourceNotFoundException: Function not found"`

Sortir

Type

Exemple

response

Objet

Réponse complète de l’API. Consultez la

référence Boto3 get_function

success

Booléen

true

false

errorMessage

Chaîne

"ResourceNotFoundException: Function not found"

Lister les alias d'une fonction Lambda

L’identifiant de l’action est aws.lambda.listAliases.

Renvoie une liste d'alias pour une fonction Lambda. Les alias sont des pointeurs nommés vers des versions de fonction. Utilisez marker et maxItems pour parcourir de grands ensembles de résultats.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où la fonction est située.	`us-east-2`
`functionName`	Chaîne	Obligatoire. Nom de la fonction Lambda.	`my-lambda-function`
`marker`	Chaîne	Facultatif. Jeton de pagination. Passez la valeur `NextMarker` d'une réponse précédente pour récupérer la page suivante.	`"abcd....."`
`maxItems`	Int	Facultatif. Nombre maximal d'alias à renvoyer.	`123`
`parameters`	Carte	Facultatif. Champs boto3 supplémentaires non modélisés par ailleurs. Accepte tout argument facultatif de l'API.	`{"AnotherOptionalParam": "value"}`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "response", "expression": ".response"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Réponse API complète. Consultez la référence Boto3 list_aliases .
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"ResourceNotFoundException: Function not found"`

Sortir

Type

Exemple

response

Objet

Réponse API complète. Consultez la

référence Boto3 list_aliases

success

Booléen

true

false

errorMessage

Chaîne

"ResourceNotFoundException: Function not found"

Répertorier les fonctions Lambda

L’identifiant de l’action est aws.lambda.listFunctions.

Renvoie une liste de fonctions Lambda dans une région, avec la configuration spécifique à la version de chacune. AWS renvoie au maximum 50 fonctions par appel ; utilisez marker et maxItems pour paginer les grands ensembles de résultats.

Cette action renvoie un sous-ensemble de FunctionConfiguration champs. Pour obtenir l’ensemble complet, y compris State, StateReasonCode, LastUpdateStatus, et RuntimeVersionConfig, utilisez plutôt aws.lambda.getFunction.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS à partir de laquelle lister les fonctions.	`us-west-2`
`functionVersion`	Chaîne	Facultatif. Définissez sur `ALL` pour inclure toutes les versions publiées de chaque fonction en plus de la version non publiée.	`ALL`
`marker`	Chaîne	Facultatif. Jeton de pagination. Passez la valeur `NextMarker` d'une réponse précédente pour récupérer la page suivante.	`"abcd....."`
`maxItems`	Int	Facultatif. Nombre maximal de fonctions à renvoyer par appel. AWS plafonne cette valeur à 50, indépendamment d'une valeur supérieure.	`50`
`parameters`	Carte	Facultatif. Champs boto3 supplémentaires non modélisés par ailleurs. `MasterRegion` n’est pertinent que pour les fonctions Lambda@Edge et nécessite `functionVersion: ALL` lorsqu’il est défini.	`{"MasterRegion": "us-east-1"}`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "functions", "expression": ".response.Functions"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	`{"Functions": [{"FunctionName": "helloworld", "FunctionArn": "arn:aws:lambda:...", "Runtime": "nodejs20.x", "Timeout": 3, "MemorySize": 128}], "NextMarker": "..."}`
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"InvalidParameterValueException: 1 validation error detected"`

Sortir

Type

Exemple

response

Objet

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

success

Booléen

true

false

errorMessage

Chaîne

"InvalidParameterValueException: 1 validation error detected"

Obtenir l’historique d’exécution durable Lambda

L’identifiant de l’action est aws.lambda.getDurableExecutionHistory.

Récupère l’historique d’exécution pour une exécution durable Lambda, en affichant toutes les étapes, les rappels et les événements qui se sont produits. Cette action s’applique uniquement aux exécutions durables Lambda : elle ne peut pas récupérer l’historique d’invocation des fonctions Lambda classiques. L’historique est disponible pendant que l’exécution est en cours et pour une période de rétention configurable après son achèvement (1 - 90 jours, 30 jours par défaut).

Pour les exécutions de longue durée avec de nombreuses étapes ou rappels, définissez includeExecutionData sur false lorsque vous n’avez besoin que des types d’événements et des horodatages plutôt que des charges complètes : cela produit une réponse plus compacte.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où se trouve l'exécution durable.	`us-west-2`
`durableExecutionArn`	Chaîne	Obligatoire. ARN de l'exécution durable pour laquelle récupérer l'historique.	`arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123`
`includeExecutionData`	Booléen	Facultatif. Incluez les résultats d'étape et les charges de rappel dans les événements de l'historique. Définissez sur `false` pour une réponse plus compacte. La valeur par défaut est `true` .	`true`
`maxItems`	Int	Facultatif. Nombre maximal d'événements d'historique à renvoyer par appel. Par défaut 100, maximum 1000. Définissez sur `0` pour utiliser la valeur par défaut.	`100`
`marker`	Chaîne	Facultatif. Jeton de pagination. Transmettez la valeur `NextMarker` d'une réponse précédente. Les jetons expirent après 24 heures.	`"abcd....."`
`reverseOrder`	Booléen	Facultatif. Renvoie les événements les plus récents en premier (ordre chronologique inverse). La valeur par défaut est `false` (les plus anciens en premier).	`true`
`parameters`	Carte	Facultatif. Champs boto3 supplémentaires non modélisés par ailleurs.
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "events", "expression": ".response.Events"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	`{"Events": [{"EventType": "ExecutionStarted", "EventId": 1, "EventTimestamp": "2026-08-11T05:40:49.000+0000"}, {"EventType": "ExecutionSucceeded", "EventId": 4}], "NextMarker": ""}`
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"ResourceNotFoundException: Durable execution not found: arn:aws:lambda:us-west-2:123456789012:function:my-function:execution:abc123"`

Sortir

Type

Exemple

response

Objet

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

success

Booléen

true

false

errorMessage

Chaîne

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

Définir la simultanéité de la fonction Lambda

L’identifiant de l’action est aws.lambda.putFunctionConcurrency.

Définit la simultanéité réservée pour une fonction Lambda, le nombre maximal d'exécutions simultanées. La réservation de la simultanéité garantit à la fois que la fonction dispose de la capacité pour ce nombre d'exécutions simultanées et l'empêche d'évoluer au-delà de ce niveau. Le paramètre de simultanéité s'applique à toutes les versions publiées et à la version non publiée. Définir reservedConcurrentExecutions sur 0 désactive la fonction sans la supprimer.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où la fonction est située.	`us-west-2`
`functionName`	Chaîne	Obligatoire. Nom, `name:version` , ou ARN de la fonction. La contrainte de longueur de 64 caractères s’applique uniquement lors de la spécification du nom seul (et non de l’ARN complet).	`my-function`
`reservedConcurrentExecutions`	Int	Obligatoire. Nombre d’exécutions simultanées à réserver. La valeur minimale est `0` (désactive la fonction). Le maximum effectif est le pool de simultanéité non réservé de votre compte. Au moins 100 exécutions non réservées doivent rester pour les fonctions sans limite par fonction.	`100`
`parameters`	Carte	Facultatif. Champs boto3 supplémentaires non modélisés par ailleurs.
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "response", "expression": ".response"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	`{"ReservedConcurrentExecutions": 100}`
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"InvalidParameterValueException: Specified ReservedConcurrentExecutions decreases account's UnreservedConcurrentExecution below its minimum value"`

Sortir

Type

Exemple

response

Objet

{"ReservedConcurrentExecutions": 100}

success

Booléen

true

false

errorMessage

Chaîne

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

Cette traduction automatique est fournie pour votre commodité.

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

Invoquer une fonction Lambda

Mettre à jour la configuration de la fonction Lambda

Décrire une fonction Lambda

Lister les alias d'une fonction Lambda

Répertorier les fonctions Lambda

Obtenir l’historique d’exécution durable Lambda

Définir la simultanéité de la fonction Lambda

Prérequis