Exemples Lambda utilisant AWS CLI

Pour ajouter des autorisations à une version de couche

L'add-layer-version-permissionexemple suivant autorise le compte spécifié à utiliser la version 1 de la couchemy-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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

Pour ajouter des autorisations à une fonction Lambda existante

L'add-permissionexemple suivant accorde au service Amazon SNS l'autorisation d'appeler 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 la section Utilisation de politiques basées sur les ressources pour Lambda AWS dans le guide du développeur AWS Lambda.

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 la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

Pour créer un mappage entre une source d'événements et une fonction AWS Lambda

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

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 la section Mappage des sources d'événements AWS Lambda dans le guide du développeur AWS Lambda.

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 Guide du développeur AWS .

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 aucun résultat.

Pour plus d'informations, consultez la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

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

L'delete-event-source-mappingexemple suivant supprime le mappage entre une file d'attente SQS et la fonction Lambdamy-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 la section Mappage des sources d'événements AWS Lambda dans le guide du développeur AWS Lambda.

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 aucun résultat.

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

Pour supprimer une configuration d'appel asynchrone

L'delete-function-event-invoke-configexemple suivant supprime la configuration d'appel asynchrone pour l'GREENalias de la fonction spécifiée.

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

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 aucun résultat.

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 aucun résultat.

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 aucun résultat.

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

Pour supprimer une version d'une couche Lambda

L'delete-layer-versionexemple suivant supprime la version 2 de la couche nomméemy-layer.

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

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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

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

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 Guide du développeur AWS  Lambda.

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 la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

Pour récupérer des informations sur le mappage d'une source d'événement

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

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 la section Mappage des sources d'événements AWS Lambda dans le guide du développeur AWS Lambda.

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 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 Guide du développeur AWS .

Pour afficher une configuration d'appel asynchrone

L'get-function-event-invoke-configexemple suivant récupère la configuration d'appel asynchrone pour l'BLUEalias 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"
        }
    }
}

Pour récupérer des informations sur une fonction

L'exemple get-function suivant affiche des 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 Guide du développeur AWS .

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

L'get-layer-version-by-arnexemple suivant affiche des informations sur la version de la couche avec le nom de ressource Amazon (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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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

L'get-layer-version-policyexemple suivant affiche les informations de politique relatives à la version 1 pour la couche nomméemy-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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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

L'get-layer-versionexemple suivant affiche les informations relatives à la version 1 de la couche nomméemy-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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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 des 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 la section Utilisation de politiques basées sur les ressources pour Lambda AWS dans le guide du développeur AWS Lambda.

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"
}

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'cli-binary-formatoption est obligatoire si vous utilisez la version 2 de la AWS CLI. Pour plus d'informations, veuillez consulter 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 la section Invoquer une fonction Lambda de manière synchrone dans le guide du développeur Lambda AWS .

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'cli-binary-formatoption est obligatoire si vous utilisez la version 2 de la AWS CLI. Pour plus d'informations, veuillez consulter 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 la section Invocation d'une fonction Lambda de manière asynchrone dans AWS le guide du développeur Lambda.

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

L'list-aliasesexemple suivant affiche la liste des alias de la fonction my-function Lambda.

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 la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

Pour répertorier les mappages de sources d'événements pour une fonction

L'list-event-source-mappingsexemple suivant affiche une liste des mappages de sources d'événements pour la fonction my-function Lambda.

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 la section Mappage des sources d'événements AWS Lambda dans le guide du développeur AWS Lambda.

Pour afficher la liste des configurations d'appel asynchrones

L'list-function-event-invoke-configsexemple suivant répertorie les configurations d'appel asynchrones 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
        }
    ]
}

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 Guide du développeur AWS .

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

L'list-layers-versionsexemple suivant affiche des informations sur les versions de la couche nomméemy-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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

Pour répertorier les couches compatibles avec le temps d'exécution de votre fonction

L'list-layersexemple suivant affiche des informations sur les couches compatibles avec le moteur d'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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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"
        }
    ]
}

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 Guide du développeur AWS .

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 la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

Pour créer une version de couche Lambda

L'publish-layer-versionexemple suivant crée une nouvelle version de couche de bibliothèque Python. La commande récupère 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 la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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 la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

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 Guide du développeur AWS  Lambda.

Pour configurer la gestion des erreurs pour un appel asynchrone

L'put-function-event-invoke-configexemple suivant définit une durée maximale d'un événement 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": {}
    }
}

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"
}

Pour supprimer les autorisations de version de couche

L'remove-layer-version-permissionexemple 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 aucun résultat.

Pour plus d'informations, consultez la section AWS Lambda Layers dans le guide du développeur AWS Lambda.

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 aucun résultat.

Pour plus d'informations, consultez la section Utilisation de politiques basées sur les ressources pour Lambda AWS dans le guide du développeur AWS Lambda.

Pour ajouter des balises à une fonction Lambda existante

L’exemple tag-resource suivant ajoute une balise avec le nom de clé DEPARTMENT et une valeur de 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 aucun résultat.

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

Pour supprimer les 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 aucun résultat.

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

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 la section Configuration des alias de fonction AWS Lambda dans le guide du développeur Lambda AWS .

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

L'update-event-source-mappingexemple suivant met à jour la taille du lot à 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 la section Mappage des sources d'événements AWS Lambda dans le guide du développeur AWS Lambda.

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 Guide du développeur AWS .

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 Guide du développeur AWS .

Pour mettre à jour une configuration d'appel asynchrone

L'update-function-event-invoke-configexemple suivant ajoute une destination en cas d'échec à la configuration d'appel 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"
        }
    }
}