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 SNS service Amazon l'autorisation d'appeler une fonction nomméemy-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 pour une fonction Lambda

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

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 SQS file d'attente 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 l'alias d'une fonction Lambda

L'delete-aliasexemple suivant supprime l'alias nommé dans la LIVE fonction my-function Lambda.

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 SQS file d'attente et la fonction my-function Lambda.

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 la limite d'exécution simultanée réservée à une fonction

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

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

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Réserver la 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 fonction ARN

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

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 : Supprimer une fonction Lambda par fonction partielle ARN

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

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é provisionnée

L'delete-provisioned-concurrency-configexemple suivant supprime la configuration de simultanéité provisionnée pour l'GREENalias 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'get-account-settingsexemple 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 la section Limites AWS Lambda dans le guide du développeur AWS Lambda.

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

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

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 SQS file d'attente 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'get-function-concurrencyexemple 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 spécifiques à la version d'une fonction Lambda

L'get-function-configurationexemple suivant affiche les paramètres de la version 2 de la my-function fonction.

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 portant le nom de ressource Amazon spécifié (ARN).

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 IAM politique basée sur les ressources pour une fonction, une version ou un alias

L'get-policyexemple suivant affiche les informations de politique relatives à la fonction my-function Lambda.

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 consulter une configuration de simultanéité provisionnée

L'get-provisioned-concurrency-configexemple suivant affiche les détails de la configuration de simultanéité provisionnée pour l'BLUEalias 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 AWS CLI la version 2. Pour plus d'informations, consultez les options de ligne de commande globales AWS CLI prises en charge dans le Guide de l'utilisateur de l'interface de ligne de AWS commande.

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 synchrone dans le Guide du développeur 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 AWS CLI la version 2. Pour plus d'informations, consultez les options de ligne de commande globales AWS CLI prises en charge dans le Guide de l'utilisateur de l'interface de ligne de AWS commande.

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

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é provisionnées

L'list-provisioned-concurrency-configsexemple suivant répertorie les configurations de simultanéité provisionnées 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'list-tagsexemple suivant affiche les balises associées à la fonction my-function Lambda.

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 la section Marquage des fonctions Lambda dans le guide du développeur AWS Lambda.

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

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

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'publish-versionexemple suivant publie une nouvelle version de la fonction my-function Lambda.

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'put-function-concurrencyexemple suivant configure 100 exécutions simultanées réservées pour la my-function fonction.

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

Sortie :

{
    "ReservedConcurrentExecutions": 100
}

Pour plus d'informations, consultez la section Réserver la 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 la simultanéité provisionnée

L'put-provisioned-concurrency-configexemple suivant alloue 100 accès simultanés à l'BLUEalias 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'remove-permissionexemple suivant supprime l'autorisation d'invoquer une fonction nomméemy-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'tag-resourceexemple suivant ajoute une balise avec le nom de la 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 la section Marquage des fonctions Lambda dans le guide du développeur AWS Lambda.

Pour supprimer des balises d'une fonction Lambda existante

L'untag-resourceexemple suivant supprime la balise avec la DEPARTMENT balise key name de la fonction my-function Lambda.

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 la section Marquage des fonctions Lambda dans le guide du développeur AWS Lambda.

Pour mettre à jour un alias de fonction

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

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'update-function-codeexemple suivant remplace le code de la version non publiée ($LATEST) de la my-function fonction 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'update-function-configurationexemple suivant modifie la taille de la mémoire à 256 Mo pour la version non publiée ($LATEST) de la my-function fonction.

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