GetFunctionConfiguration - AWS Lambda

GetFunctionConfiguration

Renvoie les paramètres spécifiques de la version d'une fonction ou d'une version Lambda. La sortie inclut uniquement les options qui peuvent varier entre les différentes versions d'une fonction. Pour modifier ces paramètres, utilisez UpdateFunctionConfiguration.

Pour obtenir tous les détails d'une fonction, y compris les paramètres au niveau de la fonction, utilisez GetFunction.

Syntaxe de la demande

GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

FunctionName

Nom de l'alias, de la version ou de la fonction Lambda.

Formats de nom

  • Nom de la fonction - my-function (name-only), my-function:v1 (avec alias).

  • ARN de fonction - arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • ARN partiel - 123456789012:function:my-function.

Vous pouvez ajouter un numéro de version ou un alias à l'un des formats. Contrainte de longueur qui s'applique uniquement à l'ARN complet. Si vous spécifiez uniquement le nom de la fonction, ce dernier est limité à 64 caractères.

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 170.

Modèle : (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Obligatoire : oui

Qualifier

Spécifiez une version ou un alias pour obtenir des détails sur une version publiée de la fonction.

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 128.

Modèle : (|[a-zA-Z0-9$_-]+)

Corps de la demande

La demande n'a pas de corps.

Syntaxe de la réponse

HTTP/1.1 200 Content-type: application/json { "Architectures": [ "string" ], "CodeSha256": "string", "CodeSize": number, "DeadLetterConfig": { "TargetArn": "string" }, "Description": "string", "Environment": { "Error": { "ErrorCode": "string", "Message": "string" }, "Variables": { "string" : "string" } }, "EphemeralStorage": { "Size": number }, "FileSystemConfigs": [ { "Arn": "string", "LocalMountPath": "string" } ], "FunctionArn": "string", "FunctionName": "string", "Handler": "string", "ImageConfigResponse": { "Error": { "ErrorCode": "string", "Message": "string" }, "ImageConfig": { "Command": [ "string" ], "EntryPoint": [ "string" ], "WorkingDirectory": "string" } }, "KMSKeyArn": "string", "LastModified": "string", "LastUpdateStatus": "string", "LastUpdateStatusReason": "string", "LastUpdateStatusReasonCode": "string", "Layers": [ { "Arn": "string", "CodeSize": number, "SigningJobArn": "string", "SigningProfileVersionArn": "string" } ], "MasterArn": "string", "MemorySize": number, "PackageType": "string", "RevisionId": "string", "Role": "string", "Runtime": "string", "SigningJobArn": "string", "SigningProfileVersionArn": "string", "State": "string", "StateReason": "string", "StateReasonCode": "string", "Timeout": number, "TracingConfig": { "Mode": "string" }, "Version": "string", "VpcConfig": { "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ], "VpcId": "string" } }

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

Architectures

Architecture de l'ensemble des instructions prise en charge par la fonction. L'architecture est un tableau de chaînes avec l'une des valeurs valides. La valeur d'architecture par défaut est x86_64.

Type : tableau de chaînes

Membres du tableau : nombre fixe de 1 élément.

Valeurs valides : x86_64 | arm64

CodeSha256

Hachage SHA256 du package de déploiement de la fonction.

Type : chaîne

CodeSize

Taille du package de déploiement de la fonction, exprimée en octets.

Type : long

DeadLetterConfig

File d'attente de lettres mortes de la fonction.

Type : objet DeadLetterConfig

Description

Description de la fonction.

Type : chaîne

Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.

Environment

Variables d'environnement de la fonction.

Type : objet EnvironmentResponse

EphemeralStorage

La taille du répertoire /tmp de la fonction en Mo. La valeur par défaut est 512, mais peut être tout nombre entier compris entre 512 et 10 240 Mo.

Type : objet EphemeralStorage

FileSystemConfigs

Paramètres de connexion pour un système de fichiers Amazon EFS.

Type : tableau d'objets FileSystemConfig

Membres du tableau : nombre maximum de 1 élément.

FunctionArn

Amazon Resource Name (ARN) de la fonction.

Type : chaîne

Modèle : arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

FunctionName

Nom de la fonction.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 170.

Modèle : (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Handler

Fonction que Lambda appelle pour commencer à exécuter votre fonction.

Type : chaîne

Contraintes de longueur : Longueur maximum de 128.

Modèle : [^\s]+

ImageConfigResponse

Valeurs de configuration d'image de la fonction.

Type : objet ImageConfigResponse

KMSKeyArn

La clé AWS KMS key qui est utilisée pour chiffrer les variables d'environnement de la fonction. Cette clé est renvoyée uniquement si vous avez configuré une clé gérée par le client.

Type : chaîne

Modèle : (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

LastModified

Date et heure de la dernière mise à jour de la fonction, au format ISO-8601 (AAAA-MM-JJThh:mm:ss.sTZD).

Type : chaîne

LastUpdateStatus

État de la dernière mise à jour effectuée sur la fonction. Cette valeur est d'abord définie sur Successful une fois la création de la fonction terminée.

Type : chaîne

Valeurs valides : Successful | Failed | InProgress

LastUpdateStatusReason

Motif pour lequel la dernière mise à jour a été effectuée sur la fonction.

Type : chaîne

LastUpdateStatusReasonCode

Code motif pour lequel la dernière mise à jour a effectuée sur la fonction.

Type : chaîne

Valeurs valides : EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage

Layers

Couches de la fonction.

Type : tableau d'objets Layer

MasterArn

Pour les fonctions Lambda @Edge, l'ARN de la fonction maître.

Type : chaîne

Modèle : arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

MemorySize

Quantité de mémoire disponible pour la fonction lors de l'exécution.

Type : entier

Plage valide : Valeur minimum de 128. Valeur maximum de 10 240.

PackageType

Type de package de déploiement. Spécifiez Image pour l'image de conteneur et Zip pour l'archive de fichier .zip.

Type : chaîne

Valeurs valides : Zip | Image

RevisionId

Dernière révision mise à jour de la fonction ou de l'alias.

Type : chaîne

Role

Rôle d'exécution de la fonction.

Type : chaîne

Modèle : arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Runtime

Environnement d'exécution de la fonction Lambda.

Type : chaîne

Valeurs valides : nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2

SigningJobArn

ARN de la tâche de signature.

Type : chaîne

Modèle : arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SigningProfileVersionArn

ARN de la version du profil de signature.

Type : chaîne

Modèle : arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

State

État actuel de la fonction. Lorsque l'état est Inactive, vous pouvez réactiver la fonction en l'appelant.

Type : chaîne

Valeurs valides : Pending | Active | Inactive | Failed

StateReason

Motif de l'état actuel de la fonction.

Type : chaîne

StateReasonCode

Code de motif de l'état actuel de la fonction. Lorsque le code est Creating, vous ne pouvez ni appeler ni modifier la fonction.

Type : chaîne

Valeurs valides : Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage

Timeout

Durée en secondes pendant laquelle Lambda autorise l'exécution d'une fonction avant de l'arrêter.

Type : entier

Plage valide : valeur minimum de 1.

TracingConfig

Configuration du suivi AWS X-Ray de la fonction.

Type : objet TracingConfigResponse

Version

Version de la fonction Lambda.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.

Modèle : (\$LATEST|[0-9]+)

VpcConfig

Configuration réseau de la fonction.

Type : objet VpcConfigResponse

Erreurs

InvalidParameterValueException

L'un des paramètres dans la demande n'est pas valide.

Code d'état HTTP : 400

ResourceNotFoundException

La ressource spécifiée dans la demande n'existe pas.

Code d'état HTTP : 404

ServiceException

Le service AWS Lambda a rencontré une erreur interne.

Code d'état HTTP : 500

TooManyRequestsException

La limite de débit de demande a été dépassée.

Code d'état HTTP : 429

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :