Exemples d’utilisation de l’AWS CLI avec Lambda - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Lambda

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Lambda.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser add-layer-version-permission.

AWS CLI

Pour ajouter des autorisations à une version de couche

L’exemple add-layer-version-permission suivant autorise le compte spécifié à utiliser la version 1 de la couche my-layer.

aws lambda add-layer-version-permission \
    --layer-name my-layer \
    --statement-id xaccount \
    --action lambda:GetLayerVersion  \
    --principal 123456789012 \
    --version-number 1

Sortie :

{
    "RevisionId": "35d87451-f796-4a3f-a618-95a3671b0a0c",
    "Statement":
    {
        "Sid":"xaccount",
        "Effect":"Allow",
        "Principal":{
            "AWS":"arn:aws:iam::210987654321:root"
        },
        "Action":"lambda:GetLayerVersion",
        "Resource":"arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1"
    }
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

L’exemple de code suivant montre comment utiliser add-permission.

AWS CLI

Pour ajouter des autorisations à une fonction Lambda existante

L’exemple add-permission suivant accorde au service Amazon SNS l’autorisation d’invoquer une fonction nommée my-function.

aws lambda add-permission \
    --function-name my-function \
    --action lambda:InvokeFunction \
    --statement-id sns \
    --principal sns.amazonaws.com

Sortie :

{
    "Statement":
    {
        "Sid":"sns",
        "Effect":"Allow",
        "Principal":{
            "Service":"sns.amazonaws.com"
        },
        "Action":"lambda:InvokeFunction",
        "Resource":"arn:aws:lambda:us-east-2:123456789012:function:my-function"
    }
}

Pour plus d’informations, consultez Utilisation de politiques basées sur les ressources pour AWS Lambda dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez AddPermission dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-alias.

AWS CLI

Pour créer un alias de fonction Lambda

L’exemple create-alias suivant crée un alias de fonction Lambda nommé LIVE qui pointe vers la version 1 de la fonction Lambda my-function.

aws lambda create-alias \
    --function-name my-function \
    --description "alias for live version of function" \
    --function-version 1 \
    --name LIVE

Sortie :

{
    "FunctionVersion": "1",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6",
    "Description": "alias for live version of function"
}

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez CreateAlias dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-event-source-mapping.

AWS CLI

Pour créer un mappage entre une source d’événement et une fonction AWS Lambda

L’exemple create-event-source-mapping suivant crée un mappage entre une file d’attente SQS et la fonction Lambda my-function.

aws lambda create-event-source-mapping \
    --function-name my-function \
    --batch-size 5 \
    --event-source-arn arn:aws:sqs:us-west-2:123456789012:mySQSqueue

Sortie :

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569284520.333,
    "BatchSize": 5,
    "State": "Creating",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Pour plus d’informations, consultez Mappage des sources d’événements AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez CreateEventSourceMapping dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-function.

AWS CLI

Pour créer une fonction Lambda

L'exemple create-function suivant crée une fonction Lambda nommée my-function.

aws lambda create-function \
    --function-name my-function \
    --runtime nodejs18.x \
    --zip-file fileb://my-function.zip \
    --handler my-function.handler \
    --role arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-tges6bf4

Contenu de my-function.zip :

This file is a deployment package that contains your function code and any dependencies.

Sortie :

{
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=",
    "FunctionName": "my-function",
    "CodeSize": 308,
    "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6",
    "MemorySize": 128,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
    "Timeout": 3,
    "LastModified": "2023-10-14T22:26:11.234+0000",
    "Handler": "my-function.handler",
    "Runtime": "nodejs18.x",
    "Description": ""
}

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez CreateFunction dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-alias.

AWS CLI

Pour supprimer un alias de fonction Lambda

L’exemple delete-alias suivant supprime l’alias nommé LIVE de la fonction Lambda my-function.

aws lambda delete-alias \
    --function-name my-function \
    --name LIVE

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez DeleteAlias dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-event-source-mapping.

AWS CLI

Pour supprimer le mappage entre une source d’événement et une fonction AWS Lambda

L’exemple delete-event-source-mapping suivant supprime le mappage entre une file d’attente SQS et la fonction Lambda my-function.

aws lambda delete-event-source-mapping \
    --uuid  a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

Sortie :

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569285870.271,
    "BatchSize": 5,
    "State": "Deleting",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Pour plus d’informations, consultez Mappage des sources d’événements AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez DeleteEventSourceMapping dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-function-concurrency.

AWS CLI

Pour supprimer une limite d’exécution simultanée d’une fonction

L’exemple delete-function-concurrency suivant supprime la limite d’exécution simultanée réservée de la fonction my-function.

aws lambda delete-function-concurrency \
    --function-name  my-function

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Réservation de simultanéité pour une fonction Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez DeleteFunctionConcurrency dans la Référence des applets de commande AWS CLI.

L’exemple de code suivant montre comment utiliser delete-function-event-invoke-config.

AWS CLI

Pour supprimer une configuration d’invocation asynchrone

L’exemple delete-function-event-invoke-config suivant supprime la configuration d’invocation asynchrone pour l’alias GREEN de la fonction spécifiée.

aws lambda delete-function-event-invoke-config --function-name my-function:GREEN

L’exemple de code suivant montre comment utiliser delete-function.

AWS CLI

Exemple 1 : pour supprimer une fonction Lambda par nom de fonction

L'exemple delete-function suivant supprime la fonction Lambda my-function nommée en spécifiant le nom de la fonction.

aws lambda delete-function \
    --function-name my-function

Cette commande ne produit aucune sortie.

Exemple 2 : pour supprimer une fonction Lambda par ARN de fonction

L'exemple delete-function suivant supprime la fonction Lambda nommée my-function en spécifiant l’ARN de la fonction.

aws lambda delete-function \
    --function-name arn:aws:lambda:us-west-2:123456789012:function:my-function

Cette commande ne produit aucune sortie.

Exemple 3 : pour supprimer une fonction Lambda par ARN partiel de fonction

L'exemple delete-function suivant supprime la fonction Lambda nommée my-function en spécifiant l’ARN partiel de la fonction.

aws lambda delete-function \
    --function-name 123456789012:function:my-function

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez DeleteFunction dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-layer-version.

AWS CLI

Pour supprimer une version d’une couche Lambda

L’exemple delete-layer-version suivant supprime la version 2 de la couche nommée my-layer.

aws lambda delete-layer-version \
    --layer-name my-layer \
    --version-number 2

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez DeleteLayerVersion dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-provisioned-concurrency-config.

AWS CLI

Pour supprimer une configuration de simultanéité allouée

L’exemple delete-provisioned-concurrency-config suivant supprime la configuration de simultanéité allouée pour l’alias GREEN de la fonction spécifiée.

aws lambda delete-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier GREEN

L’exemple de code suivant montre comment utiliser get-account-settings.

AWS CLI

Pour récupérer les informations relatives à votre compte dans une Région AWS

L’exemple get-account-settings suivant affiche les limites Lambda et les informations d’utilisation de votre compte.

aws lambda get-account-settings

Sortie :

{
    "AccountLimit": {
       "CodeSizeUnzipped": 262144000,
       "UnreservedConcurrentExecutions": 1000,
       "ConcurrentExecutions": 1000,
       "CodeSizeZipped": 52428800,
       "TotalCodeSize": 80530636800
    },
    "AccountUsage": {
       "FunctionCount": 4,
       "TotalCodeSize": 9426
    }
}

Pour plus d’informations, consultez Limites AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez GetAccountSettings dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-alias.

AWS CLI

Pour récupérer les informations relatives à un alias de fonction

L’exemple get-alias suivant affiche les détails de l’alias nommé LIVE de la fonction Lambda my-function.

aws lambda get-alias \
    --function-name my-function \
    --name LIVE

Sortie :

{
    "FunctionVersion": "3",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93",
    "Description": "alias for live version of function"
}

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez GetAlias dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-event-source-mapping.

AWS CLI

Pour récupérer des détails sur un mappage des sources d’événements

L’exemple get-event-source-mapping suivant affiche les détails du mappage entre une file d’attente SQS et la fonction Lambda my-function.

aws lambda get-event-source-mapping \
    --uuid "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Sortie :

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569284520.333,
    "BatchSize": 5,
    "State": "Enabled",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Pour plus d’informations, consultez Mappage des sources d’événements AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez GetEventSourceMapping dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-function-concurrency.

AWS CLI

Pour afficher le paramètre de simultanéité réservé pour une fonction

L’exemple get-function-concurrency suivant récupère le paramètre de simultanéité réservé pour la fonction spécifiée.

aws lambda get-function-concurrency \
    --function-name my-function

Sortie :

{
    "ReservedConcurrentExecutions": 250
}

  • Pour plus de détails sur l’API, consultez GetFunctionConcurrency dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-function-configuration.

AWS CLI

Pour récupérer les paramètres d’une fonction Lambda spécifiques à sa version

L’exemple get-function-configuration suivant affiche les paramètres de la version 2 de la fonction my-function.

aws lambda get-function-configuration \
    --function-name  my-function:2

Sortie :

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "2",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2",
    "Handler": "index.handler"
}

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez GetFunctionConfiguration dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-function-event-invoke-config.

AWS CLI

Pour afficher une configuration d’invocation asynchrone

L’exemple get-function-event-invoke-config suivant récupère la configuration d’invocation asynchrone pour l’alias BLUE de la fonction spécifiée.

aws lambda get-function-event-invoke-config \
    --function-name my-function:BLUE

Sortie :

{
    "LastModified": 1577824396.653,
    "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {
            "Destination": "arn:aws:sqs:us-east-2:123456789012:failed-invocations"
        }
    }
}

L’exemple de code suivant montre comment utiliser get-function.

AWS CLI

Pour récupérer les informations sur une fonction

L’exemple get-function suivant affiche les informations sur la fonction my-function.

aws lambda get-function \
    --function-name  my-function

Sortie :

{
    "Concurrency": {
        "ReservedConcurrentExecutions": 100
    },
    "Code": {
        "RepositoryType": "S3",
        "Location": "https://awslambda-us-west-2-tasks.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-function..."
    },
    "Configuration": {
        "TracingConfig": {
            "Mode": "PassThrough"
        },
        "Version": "$LATEST",
        "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=",
        "FunctionName": "my-function",
        "VpcConfig": {
            "SubnetIds": [],
            "VpcId": "",
            "SecurityGroupIds": []
        },
        "MemorySize": 128,
        "RevisionId": "28f0fb31-5c5c-43d3-8955-03e76c5c1075",
        "CodeSize": 304,
        "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
        "Handler": "index.handler",
        "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
        "Timeout": 3,
        "LastModified": "2019-09-24T18:20:35.054+0000",
        "Runtime": "nodejs10.x",
        "Description": ""
    }
}

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez GetFunction dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-layer-version-by-arn.

AWS CLI

Pour récupérer les informations sur une version de couche Lambda

L’exemple get-layer-version-by-arn suivant affiche les informations sur la version de la couche avec l’Amazon Resource Name (ARN) spécifié.

aws lambda get-layer-version-by-arn \
    --arn "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2"

Sortie :

{
    "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2",
    "Description": "AWS Lambda SciPy layer for Python 3.11 (scipy-1.1.0, numpy-1.15.4) https://github.com/scipy/scipy/releases/tag/v1.1.0 https://github.com/numpy/numpy/releases/tag/v1.15.4",
    "CreatedDate": "2023-10-12T10:09:38.398+0000",
    "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x",
    "Content": {
        "CodeSize": 41784542,
        "CodeSha256": "GGmv8ocUw4cly0T8HL0Vx/f5V4RmSCGNjDIslY4VskM=",
        "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/..."
    },
    "Version": 2,
    "CompatibleRuntimes": [
        "python3.11"
    ],
    "LicenseInfo": "SciPy: https://github.com/scipy/scipy/blob/main/LICENSE.txt, NumPy: https://github.com/numpy/numpy/blob/main/LICENSE.txt"
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez GetLayerVersionByArn dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-layer-version-policy.

AWS CLI

Pour récupérer la politique d’autorisations pour une version de la couche Lambda

L’exemple get-layer-version-policy suivant affiche les informations sur la politique relative à la version 1 pour la couche nommée my-layer.

aws lambda get-layer-version-policy \
    --layer-name my-layer \
    --version-number 1

Sortie :

{
    "Policy": {
        "Version":"2012-10-17",		 	 	 
        "Id":"default",
        "Statement":
        [
            {
                "Sid":"xaccount",
                "Effect":"Allow",
                "Principal": {"AWS":"arn:aws:iam::123456789012:root"},
                "Action":"lambda:GetLayerVersion",
                "Resource":"arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1"
            }
        ]
    },
    "RevisionId": "c68f21d2-cbf0-4026-90f6-1375ee465cd0"
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez GetLayerVersionPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-layer-version.

AWS CLI

Pour récupérer les informations sur une version de couche Lambda

L’exemple get-layer-version suivant affiche les informations sur la version 1 de la couche nommé my-layer.

aws lambda get-layer-version \
    --layer-name my-layer \
    --version-number 1

Sortie :

{
    "Content": {
        "Location": "https://awslambda-us-east-2-layers.s3.us-east-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...",
        "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=",
        "CodeSize": 169
    },
    "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
    "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
    "Description": "My Python layer",
    "CreatedDate": "2018-11-14T23:03:52.894+0000",
    "Version": 1,
    "LicenseInfo": "MIT",
    "CompatibleRuntimes": [
        "python3.10",
        "python3.11"
    ]
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez GetLayerVersion dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-policy.

AWS CLI

Pour récupérer la politique IAM basée sur les ressources d’une fonction, d’une version ou d’un alias

L’exemple get-policy suivant affiche les informations de politique relative à la fonction Lambda my-function.

aws lambda get-policy \
    --function-name my-function

Sortie :

{
    "Policy": {
        "Version":"2012-10-17",		 	 	 
        "Id":"default",
        "Statement":
        [
            {
                "Sid":"iot-events",
                "Effect":"Allow",
                "Principal": {"Service":"iotevents.amazonaws.com"},
                "Action":"lambda:InvokeFunction",
                "Resource":"arn:aws:lambda:us-west-2:123456789012:function:my-function"
            }
        ]
    },
    "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668"
}

Pour plus d’informations, consultez Utilisation de politiques basées sur les ressources pour AWS Lambda dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez GetPolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-provisioned-concurrency-config.

AWS CLI

Pour afficher la configuration de la simultanéité allouée

L’exemple get-provisioned-concurrency-config suivant affiche les détails de la configuration de simultanéité allouée pour l’alias BLUE de la fonction spécifiée.

aws lambda get-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier BLUE

Sortie :

{
    "RequestedProvisionedConcurrentExecutions": 100,
    "AvailableProvisionedConcurrentExecutions": 100,
    "AllocatedProvisionedConcurrentExecutions": 100,
    "Status": "READY",
    "LastModified": "2019-12-31T20:28:49+0000"
}

L’exemple de code suivant montre comment utiliser invoke.

AWS CLI

Exemple 1 : pour invoquer une fonction Lambda de manière synchrone

L'exemple invoke suivant invoque la fonction my-function de manière synchrone. L'option cli-binary-format est obligatoire si vous utilisez l’interface de ligne de commande AWS version 2. Pour plus d’informations, consultez les options de ligne de commande prises en charge par la CLI AWS dans le Guide de l’interface de ligne de commande AWS.

aws lambda invoke \
    --function-name my-function \
    --cli-binary-format raw-in-base64-out \
    --payload '{ "name": "Bob" }' \
    response.json

Sortie :

{
    "ExecutedVersion": "$LATEST",
    "StatusCode": 200
}

Pour plus d’informations, consultez Invocation d’une fonction Lambda de manière synchrone dans le Manuel du développeur AWS Lambda.

Exemple 2 : pour invoquer une fonction Lambda de manière asynchrone

L'exemple invoke suivant invoque la fonction my-function de manière asynchrone. L'option cli-binary-format est obligatoire si vous utilisez l’interface de ligne de commande AWS version 2. Pour plus d’informations, consultez les options de ligne de commande prises en charge par la CLI AWS dans le Guide de l’interface de ligne de commande AWS.

aws lambda invoke \
    --function-name my-function \
    --invocation-type Event \
    --cli-binary-format raw-in-base64-out \
    --payload '{ "name": "Bob" }' \
    response.json

Sortie :

{
    "StatusCode": 202
}

Pour plus d’informations, consultez Invocation d’une fonction Lambda de manière asynchrone dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez Invoke dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-aliases.

AWS CLI

Pour récupérer la liste des alias d’une fonction Lambda

L’exemple list-aliases suivant affiche la liste des alias de la fonction Lambda my-function.

aws lambda list-aliases \
    --function-name my-function

Sortie :

{
    "Aliases": [
        {
            "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:BETA",
            "RevisionId": "a410117f-ab16-494e-8035-7e204bb7933b",
            "FunctionVersion": "2",
            "Name": "BETA",
            "Description": "alias for beta version of function"
        },
        {
            "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
            "RevisionId": "21d40116-f8b1-40ba-9360-3ea284da1bb5",
            "FunctionVersion": "1",
            "Name": "LIVE",
            "Description": "alias for live version of function"
        }
    ]
}

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez ListAliases dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-event-source-mappings.

AWS CLI

Pour répertorier les mappages des sources d’événements pour une fonction

L’exemple list-event-source-mappings suivant affiche la liste des mappages des sources d’événements pour la fonction Lambda my-function.

aws lambda list-event-source-mappings \
    --function-name my-function

Sortie :

{
    "EventSourceMappings": [
        {
            "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "StateTransitionReason": "USER_INITIATED",
            "LastModified": 1569284520.333,
            "BatchSize": 5,
            "State": "Enabled",
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
            "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
        }
    ]
}

Pour plus d’informations, consultez Mappage des sources d’événements AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez ListEventSourceMappings dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-function-event-invoke-configs.

AWS CLI

Pour afficher la liste des configurations d’invocation asynchrone

L’exemple list-function-event-invoke-configs suivant répertorie les configurations d’invocation asynchrone pour la fonction spécifiée.

aws lambda list-function-event-invoke-configs \
    --function-name my-function

Sortie :

{
    "FunctionEventInvokeConfigs": [
        {
            "LastModified": 1577824406.719,
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN",
            "MaximumRetryAttempts": 2,
            "MaximumEventAgeInSeconds": 1800
        },
        {
            "LastModified": 1577824396.653,
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
            "MaximumRetryAttempts": 0,
            "MaximumEventAgeInSeconds": 3600
        }
    ]
}

L’exemple de code suivant montre comment utiliser list-functions.

AWS CLI

Pour récupérer la liste des fonctions Lambda

L'exemple list-functions suivant affiche une liste de toutes les fonctions pour l'utilisateur actuel.

aws lambda list-functions

Sortie :

{
    "Functions": [
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=",
            "FunctionName": "helloworld",
            "MemorySize": 128,
            "RevisionId": "1718e831-badf-4253-9518-d0644210af7b",
            "CodeSize": 294,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:helloworld",
            "Handler": "helloworld.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
            "Timeout": 3,
            "LastModified": "2023-09-23T18:32:33.857+0000",
            "Runtime": "nodejs18.x",
            "Description": ""
        },
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668",
            "CodeSize": 266,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2023-10-01T16:47:28.490+0000",
            "Runtime": "nodejs18.x",
            "Description": ""
        },
        {
            "Layers": [
                {
                    "CodeSize": 41784542,
                    "Arn": "arn:aws:lambda:us-west-2:420165488524:layer:AWSLambda-Python37-SciPy1x:2"
                },
                {
                    "CodeSize": 4121,
                    "Arn": "arn:aws:lambda:us-west-2:123456789012:layer:pythonLayer:1"
                }
            ],
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "ZQukCqxtkqFgyF2cU41Avj99TKQ/hNihPtDtRcc08mI=",
            "FunctionName": "my-python-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 128,
            "RevisionId": "80b4eabc-acf7-4ea8-919a-e874c213707d",
            "CodeSize": 299,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-python-function",
            "Handler": "lambda_function.lambda_handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/my-python-function-role-z5g7dr6n",
            "Timeout": 3,
            "LastModified": "2023-10-01T19:40:41.643+0000",
            "Runtime": "python3.11",
            "Description": ""
        }
    ]
}

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez ListFunctions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-layer-versions.

AWS CLI

Pour répertorier les versions d’une couche AWS Lambda

L’exemple list-layers-versions suivant affiche les informations sur les versions de la couche nommée my-layer.

aws lambda list-layer-versions \
    --layer-name my-layer

Sortie :

{
    "Layers": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "python3.10",
                "python3.11"
            ]
        }
    ]
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez ListLayerVersions dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-layers.

AWS CLI

Pour répertorier les couches compatibles avec l’exécution de votre fonction

L’exemple list-layers suivant affiche les informations sur les couches compatibles avec l’exécution Python 3.11.

aws lambda list-layers \
    --compatible-runtime python3.11

Sortie :

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2023-11-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.10",
                    "python3.11"
                ]
            }
        }
    ]
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez ListLayers dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-provisioned-concurrency-configs.

AWS CLI

Pour obtenir une liste des configurations de simultanéité allouée

L’exemple list-provisioned-concurrency-configs suivant répertorie les configurations de simultanéité allouée pour la fonction spécifiée.

aws lambda list-provisioned-concurrency-configs \
    --function-name my-function

Sortie :

{
    "ProvisionedConcurrencyConfigs": [
        {
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN",
            "RequestedProvisionedConcurrentExecutions": 100,
            "AvailableProvisionedConcurrentExecutions": 100,
            "AllocatedProvisionedConcurrentExecutions": 100,
            "Status": "READY",
            "LastModified": "2019-12-31T20:29:00+0000"
        },
        {
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
            "RequestedProvisionedConcurrentExecutions": 100,
            "AvailableProvisionedConcurrentExecutions": 100,
            "AllocatedProvisionedConcurrentExecutions": 100,
            "Status": "READY",
            "LastModified": "2019-12-31T20:28:49+0000"
        }
    ]
}

L’exemple de code suivant montre comment utiliser list-tags.

AWS CLI

Pour récupérer la liste des balises d’une fonction Lambda

L’exemple list-tags suivant affiche les balises associées à la fonction Lambda my-function.

aws lambda list-tags \
    --resource arn:aws:lambda:us-west-2:123456789012:function:my-function

Sortie :

{
    "Tags": {
        "Category": "Web Tools",
        "Department": "Sales"
    }
}

Pour plus d’informations, consultez Étiquetage des fonctions Lambda dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez ListTags dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-versions-by-function.

AWS CLI

Pour récupérer la liste des versions d’une fonction

L’exemple list-versions-by-function suivant affiche la liste des versions de la fonction Lambda my-function.

aws lambda list-versions-by-function \
    --function-name my-function

Sortie :

{
    "Versions": [
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668",
            "CodeSize": 266,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:$LATEST",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2019-10-01T16:47:28.490+0000",
            "Runtime": "nodejs10.x",
            "Description": ""
        },
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "1",
            "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "949c8914-012e-4795-998c-e467121951b1",
            "CodeSize": 304,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:1",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2019-09-26T20:28:40.438+0000",
            "Runtime": "nodejs10.x",
            "Description": "new version"
        },
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "2",
            "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "cd669f21-0f3d-4e1c-9566-948837f2e2ea",
            "CodeSize": 266,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2019-10-01T16:47:28.490+0000",
            "Runtime": "nodejs10.x",
            "Description": "newer version"
        }
    ]
}

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez ListVersionsByFunction dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser publish-layer-version.

AWS CLI

Pour créer une version de la couche Lambda

L’exemple publish-layer-version suivant crée une nouvelle version de la couche de bibliothèque Python. La commande extrait le contenu de la couche d’un fichier nommé layer.zip dans le compartiment S3 spécifié.

aws lambda publish-layer-version \
    --layer-name my-layer \
    --description "My Python layer" \
    --license-info "MIT" \
    --content S3Bucket=lambda-layers-us-west-2-123456789012,S3Key=layer.zip \
    --compatible-runtimes python3.10 python3.11

Sortie :

{
    "Content": {
        "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...",
        "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=",
        "CodeSize": 169
    },
    "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer",
    "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1",
    "Description": "My Python layer",
    "CreatedDate": "2023-11-14T23:03:52.894+0000",
    "Version": 1,
    "LicenseInfo": "MIT",
    "CompatibleRuntimes": [
        "python3.10",
        "python3.11"
    ]
}

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez PublishLayerVersion dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser publish-version.

AWS CLI

Pour publier une nouvelle version d’une fonction

L’exemple publish-version suivant publie une nouvelle version de la fonction Lambda my-function.

aws lambda publish-version \
    --function-name my-function

Sortie :

{
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=",
    "FunctionName": "my-function",
    "CodeSize": 294,
    "RevisionId": "f31d3d39-cc63-4520-97d4-43cd44c94c20",
    "MemorySize": 128,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:3",
    "Version": "2",
    "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
    "Timeout": 3,
    "LastModified": "2019-09-23T18:32:33.857+0000",
    "Handler": "my-function.handler",
    "Runtime": "nodejs10.x",
    "Description": ""
}

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez PublishVersion dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-function-concurrency.

AWS CLI

Pour configurer une limite de simultanéité réservée pour une fonction

L’exemple put-function-concurrency suivant configure 100 exécutions simultanées réservées pour la fonction my-function.

aws lambda put-function-concurrency \
    --function-name  my-function  \
    --reserved-concurrent-executions 100

Sortie :

{
    "ReservedConcurrentExecutions": 100
}

Pour plus d’informations, consultez Réservation de simultanéité pour une fonction Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez PutFunctionConcurrency dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-function-event-invoke-config.

AWS CLI

Pour configurer la gestion des erreurs pour l’invocation asynchrone

L’exemple put-function-event-invoke-config suivant définit un âge d’événement maximal d’une heure et désactive les nouvelles tentatives pour la fonction spécifiée.

aws lambda put-function-event-invoke-config \
    --function-name my-function \
    --maximum-event-age-in-seconds 3600 \
    --maximum-retry-attempts 0

Sortie :

{
    "LastModified": 1573686021.479,
    "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {}
    }
}

L’exemple de code suivant montre comment utiliser put-provisioned-concurrency-config.

AWS CLI

Pour allouer une simultanéité allouée

L’exemple put-provisioned-concurrency-config suivant alloue 100 simultanéités allouées à l’alias BLUE de la fonction spécifiée.

aws lambda put-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier BLUE \
    --provisioned-concurrent-executions 100

Sortie :

{
    "Requested ProvisionedConcurrentExecutions": 100,
    "Allocated ProvisionedConcurrentExecutions": 0,
    "Status": "IN_PROGRESS",
    "LastModified": "2019-11-21T19:32:12+0000"
}

L’exemple de code suivant montre comment utiliser remove-layer-version-permission.

AWS CLI

Pour supprimer les autorisations de version de couche

L’exemple remove-layer-version-permission suivant supprime l’autorisation pour un compte de configurer une version de couche.

aws lambda remove-layer-version-permission \
    --layer-name my-layer \
    --statement-id xaccount \
    --version-number 1

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Couches AWS Lambda dans le Manuel du développeur AWS Lambda.

L’exemple de code suivant montre comment utiliser remove-permission.

AWS CLI

Pour supprimer les autorisations d’une fonction Lambda existante

L’exemple remove-permission retire l’autorisation d’invoquer une fonction nommée my-function.

aws lambda remove-permission \
    --function-name my-function \
    --statement-id sns

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Utilisation de politiques basées sur les ressources pour AWS Lambda dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez RemovePermission dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Pour ajouter des balises à une fonction Lambda existante

L’exemple tag-resource suivant ajoute une balise avec le nom de clé DEPARTMENT et la valeur Department A à la fonction Lambda spécifiée.

aws lambda tag-resource \
    --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \
    --tags "DEPARTMENT=Department A"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Étiquetage des fonctions Lambda dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Pour supprimer des balises d’une fonction Lambda existante

L’exemple untag-resource suivant supprime la balise dont la clé est DEPARTMENT de la fonction Lambda my-function.

aws lambda untag-resource \
    --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \
    --tag-keys DEPARTMENT

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Étiquetage des fonctions Lambda dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-alias.

AWS CLI

Pour mettre à jour un alias de fonction

L’exemple update-alias suivant met à jour l’alias de fonction Lambda nommé LIVE pour qu’il pointe vers la version 3 de la fonction Lambda my-function.

aws lambda update-alias \
    --function-name my-function \
    --function-version 3 \
    --name LIVE

Sortie :

{
    "FunctionVersion": "3",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93",
    "Description": "alias for live version of function"
}

Pour plus d’informations, consultez Configuration des alias des fonctions AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez UpdateAlias dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-event-source-mapping.

AWS CLI

Pour mettre à jour le mappage entre une source d’événement et une fonction AWS Lambda

L’exemple update-event-source-mapping suivant met à jour la taille du lot sur 8 dans le mappage spécifié.

aws lambda update-event-source-mapping \
    --uuid  "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
    --batch-size 8

Sortie :

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569284520.333,
    "BatchSize": 8,
    "State": "Updating",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Pour plus d’informations, consultez Mappage des sources d’événements AWS Lambda dans le Manuel du développeur AWS Lambda.

  • Pour plus de détails sur l’API, consultez UpdateEventSourceMapping dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-function-code.

AWS CLI

Pour mettre à jour le code d'une fonction Lambda

L'exemple update-function-code suivant remplace le code de la version non publiée ($LATEST) de la fonction my-function par le contenu du fichier zip spécifié.

aws lambda update-function-code \
    --function-name  my-function \
    --zip-file fileb://my-function.zip

Sortie :

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Handler": "index.handler"
}

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

  • Pour plus de détails sur l’API, consultez UpdateFunctionCode dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-function-configuration.

AWS CLI

Pour modifier la configuration d’une fonction

L'exemple update-function-configuration suivant modifie la taille de la mémoire à 256 Mo pour la version non publiée ($LATEST) de la fonction my-function.

aws lambda update-function-configuration \
    --function-name  my-function \
    --memory-size 256

Sortie :

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Handler": "index.handler"
}

Pour plus d’informations, consultez Configuration des options de fonction Lambda AWS dans le Manuel du développeur AWS.

L’exemple de code suivant montre comment utiliser update-function-event-invoke-config.

AWS CLI

Pour mettre à jour une configuration d’invocation asynchrone

L’exemple update-function-event-invoke-config suivant ajoute une destination en cas d’échec à la configuration d’invocation asynchrone existante pour la fonction spécifiée.

aws lambda update-function-event-invoke-config \
    --function-name my-function \
    --destination-config '{"OnFailure":{"Destination": "arn:aws:sqs:us-east-2:123456789012:destination"}}'

Sortie :

{
    "LastModified": 1573687896.493,
    "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {
            "Destination": "arn:aws:sqs:us-east-2:123456789012:destination"
        }
    }
}