Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CreateFunction
<a name="API_CreateFunction"></a>

Crée une fonction Lambda. Pour créer une fonction, vous avez besoin d’un [package de déploiement](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html) et d’un [rôle d’exécution](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role). Le package de déploiement est une archive de fichier .zip ou une image conteneur contenant votre code de fonction. Le rôle d'exécution autorise l'utilisation de la fonctionServices AWS, telle qu'Amazon CloudWatch Logs pour le streaming des journaux et le suivi AWS X-Ray des demandes.

Si le package de déploiement est une [image de conteneur](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html), vous définissez le type de package sur `Image`. Pour une image de conteneur, la propriété code doit inclure l’URI d’une image de conteneur dans le registre Amazon ECR. Vous n’avez pas besoin de spécifier le gestionnaire et les propriétés d’exécution.

Si le package de déploiement est une [archive de fichier .zip](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip), vous définissez le type de package sur `Zip`. Pour une archive de fichier .zip, la propriété code spécifie l’emplacement du fichier .zip. Vous devez également spécifier le gestionnaire et les propriétés d’exécution. Le code du package de déploiement doit être compatible avec l’architecture de l’ensemble des instructions cible de la fonction (`x86-64` ou `arm64`). Si vous ne spécifiez pas l’architecture, la valeur par défaut est `x86-64`.

Lorsque vous créez une fonction, Lambda approvisionne une instance de la fonction et ses ressources associées. Si votre fonction se connecte à un VPC, ce processus peut prendre environ une minute. Pendant ce temps, vous ne pouvez ni invoquer ni modifier la fonction. Les champs `State`, `StateReason` et `StateReasonCode` dans la réponse de [GetFunctionConfiguration](API_GetFunctionConfiguration.md) indiquent quand la fonction est prête pour être invoquée. Pour plus d’informations, consultez [États de la fonction Lambda](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html).

Une fonction a une version non publiée et peut avoir des versions et des alias publiés. La version non publiée change quand vous mettez à jour le code et la configuration de votre fonction. Une version publiée est un instantané de votre code de fonction et de votre configuration, qui ne peut pas être modifié. Un alias est une ressource nommée qui mappe à une version, et peut être modifiée pour mapper à une version différente. Utilisez le paramètre `Publish` pour créer une version `1` de votre fonction à partir de sa configuration initiale.

Les autres paramètres vous permettent de configurer des paramètres spécifiques de la version et au niveau de la fonction. Vous pourrez modifier les paramètres spécifiques de la version ultérieurement avec [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md). Les paramètres au niveau de la fonction s’appliquent aux versions tant publiées que non publiées de la fonction, et incluent des étiquettes ([TagResource](API_TagResource.md)) ainsi que des limites de simultanéité par fonction ([PutFunctionConcurrency](API_PutFunctionConcurrency.md)).

Vous pouvez utiliser la signature de code si votre package de déploiement est une archive de fichier .zip. Pour activer la signature de code pour cette fonction, spécifiez l’ARN d’une configuration de signature de code. Lorsqu’un utilisateur tente de déployer un package de code avec [UpdateFunctionCode](API_UpdateFunctionCode.md), Lambda vérifie que le package de code possède la signature valide d’un éditeur de confiance. La configuration de la signature de code inclut un ensemble de profils de signature, qui définissent les éditeurs de confiance pour cette fonction.

Si un Compte AWS ou un Service AWS invoque votre fonction, utilisez [AddPermission](API_AddPermission.md) pour accorder l’autorisation en créant une politique Gestion des identités et des accès AWS (IAM) basée sur une ressource. Vous pouvez accorder des autorisations au niveau de la fonction sur une version ou un alias.

Pour invoquer votre fonction directement, utilisez [Invoke](API_Invoke.md). Pour invoquer votre fonction en réponse à des événements dans d’autres Services AWS, créez un mappage des sources d’événements ([CreateEventSourceMapping](API_CreateEventSourceMapping.md)), ou configurez un déclencheur de fonction dans l’autre service. Pour plus d’informations, consultez [Invocation des fonctions Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html).

## Syntaxe de la demande
<a name="API_CreateFunction_RequestSyntax"></a>

```
POST /2015-03-31/functions HTTP/1.1
Content-type: application/json

{
   "Architectures": [ "string" ],
   "Code": { 
      "ImageUri": "string",
      "S3Bucket": "string",
      "S3Key": "string",
      "S3ObjectVersion": "string",
      "ZipFile": blob
   },
   "CodeSigningConfigArn": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "PackageType": "string",
   "Publish": boolean,
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Tags": { 
      "string" : "string" 
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

## Paramètres de demande URI
<a name="API_CreateFunction_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_CreateFunction_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Architectures](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Architectures"></a>
Architecture de l’ensemble des instructions prise en charge par la fonction. Saisissez un tableau de chaînes avec l’une des valeurs valides (arm64 ou x86\$164). La valeur 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`   
Obligatoire : non

 ** [Code](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Code"></a>
Code pour la fonction.  
Type : objet [FunctionCode](API_FunctionCode.md)  
Obligatoire : oui

 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CodeSigningConfigArn"></a>
Pour activer la signature de code pour cette fonction, spécifiez l’ARN d’une configuration de signature de code. Une configuration de signature de code inclut un ensemble de profils de signature, qui définissent les éditeurs de confiance pour cette fonction.  
Type : chaîne  
Contraintes de longueur : Longueur maximum de 200.  
Modèle : `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Obligatoire : non

 ** [DeadLetterConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-DeadLetterConfig"></a>
Une configuration de file d’attente de lettres mortes qui spécifie la file d’attente ou la rubrique où Lambda envoie les événements asynchrones lorsqu’ils échouent au traitement. Pour plus d’informations, consultez [Files d’attente de lettres mortes](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq).  
Type : objet [DeadLetterConfig](API_DeadLetterConfig.md)  
Obligatoire : non

 ** [Description](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Description"></a>
Description de la fonction.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.  
Obligatoire : non

 ** [Environment](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Environment"></a>
Les variables d’environnement qui sont accessibles à partir du code de fonction au cours de l’exécution.  
Type : objet [Environment](API_Environment.md)  
Obligatoire : non

 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-EphemeralStorage"></a>
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. Pour plus d’informations, consultez la section [Configuration du stockage éphémère (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type : objet [EphemeralStorage](API_EphemeralStorage.md)  
Obligatoire : non

 ** [FileSystemConfigs](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FileSystemConfigs"></a>
Paramètres de connexion pour un système de fichiers Amazon EFS.  
Type : tableau d’objets [FileSystemConfig](API_FileSystemConfig.md)  
Membres du tableau : nombre maximum de 1 élément.  
Obligatoire : non

 ** [FunctionName](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FunctionName"></a>
Nom de la fonction Lambda.  

**Formats de nom**
+  **Nom de fonction** – `my-function`.
+  **ARN de fonction** – `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN partiel** – `123456789012:function:my-function`.
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.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.  
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

 ** [Handler](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Handler"></a>
Nom de la méthode incluse dans votre code que Lambda appelle pour exécuter votre fonction. Le gestionnaire est requis si le package de déploiement est une archive de fichier .zip. Le format inclut le nom de fichier. Il peut également inclure des espaces de noms et d’autres qualificateurs, selon l’exécution. Pour plus d’informations, consultez [Modèle de programmation Lambda](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html).  
Type : chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `[^\s]+`   
Obligatoire : non

 ** [ImageConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-ImageConfig"></a>
[Valeurs de configuration](https://docs.aws.amazon.com/lambda/latest/dg/configuration-images.html#configuration-images-settings) d’image conteneur qui remplacent les valeurs d’image conteneur Dockerfile.  
Type : objet [ImageConfig](API_ImageConfig.md)  
Obligatoire : non

 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-KMSKeyArn"></a>
ARN de la clé AWS Key Management Service (AWS KMS) gérée par le client utilisée pour chiffrer les [variables d’environnement](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) de votre fonction. Lorsque [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) est activé, Lambda utilise également cette clé pour chiffrer l'instantané de votre fonction. Si vous déployez votre fonction à l’aide d’une image de conteneur, Lambda utilise également cette clé pour chiffrer votre fonction lorsqu’elle est déployée. Notez qu’il ne s’agit pas de la même clé que celle utilisée pour protéger l’image de conteneur dans Amazon Elastic Container Registry (Amazon ECR). Si vous ne fournissez pas de clé gérée par le client, Lambda utilise une clé de service par défaut.  
Type : chaîne  
Modèle : `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Obligatoire : non

 ** [Layers](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Layers"></a>
Liste des [couches de fonction](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) à ajouter à l’environnement d’exécution de la fonction. Spécifiez chaque couche par son ARN, y compris la version.  
Type : tableau de chaînes  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.  
Modèle : `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`   
Obligatoire : non

 ** [LoggingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-LoggingConfig"></a>
Les paramètres de configuration Amazon CloudWatch Logs de la fonction.  
Type : objet [LoggingConfig](API_LoggingConfig.md)  
Obligatoire : non

 ** [MemorySize](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-MemorySize"></a>
Quantité de [mémoire disponible pour la fonction](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) lors de l’exécution. L’augmentation de la mémoire de la fonction augmente également son allocation d’UC. La valeur par défaut est de 128 Mo. La valeur peut être n’importe quel multiple de 1 Mo.  
Type : entier  
Plage valide : Valeur minimum de 128. Valeur maximum de 10 240.  
Obligatoire : non

 ** [PackageType](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-PackageType"></a>
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`   
Obligatoire : non

 ** [Publish](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Publish"></a>
Définissez sur VRAI pour publier la première version de la fonction pendant la création.  
Type : valeur booléenne  
Obligatoire : non

 ** [Role](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Role"></a>
L’Amazon Resource Name (ARN) du 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+=,.@\-_/]+`   
Obligatoire : oui

 ** [Runtime](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Runtime"></a>
Identifiant de l’[exécution](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) de la fonction. L’exécution est requise si le package de déploiement est une archive de fichiers de type .zip.  
La liste suivante contient les exécutions obsolètes. Pour plus d’informations, consultez la [Politique d’obsolescence de l’exécution](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Type : chaîne  
Valeurs valides : `nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.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 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21`   
Obligatoire : non

 ** [SnapStart](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-SnapStart"></a>
Le [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html)réglage de la fonction.  
Type : objet [SnapStart](API_SnapStart.md)  
Obligatoire : non

 ** [Tags](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Tags"></a>
Liste de [balises](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) à appliquer à la fonction.  
Type : mappage chaîne/chaîne  
Obligatoire : non

 ** [Timeout](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Timeout"></a>
Durée (en secondes) pendant laquelle Lambda autorise l’exécution d’une fonction avant de l’arrêter. Le durée par défaut est de 3 secondes. La valeur maximum autorisée est de 900 secondes. Pour plus d’informations, consultez [Environnement d’exécution Lambda](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html).  
Type : entier  
Plage valide : Valeur minimum de 1.  
Obligatoire : non

 ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TracingConfig"></a>
Définissez `Mode` sur `Active` pour échantillonner et suivre un sous-ensemble de demandes entrantes avec [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html).  
Type : objet [TracingConfig](API_TracingConfig.md)  
Obligatoire : non

 ** [VpcConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-VpcConfig"></a>
Pour une connectivité réseau vers des ressources AWS dans un VPC, spécifiez une liste de groupes de sécurité et de sous-réseaux dans le VPC. Lorsque vous vous connectez une fonction à un VPC, il peut uniquement accéder aux ressources et Internet via ce VPC. Pour de plus amples informations, veuillez consulter [Configuration d’une fonction Lambda pour accéder aux ressources d’accès dans un VPC](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html).  
Type : objet [VpcConfig](API_VpcConfig.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateFunction_ResponseSyntax"></a>

```
HTTP/1.1 201
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"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Eléments de réponse
<a name="API_CreateFunction_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 201.

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

 ** [Architectures](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Architectures"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSha256"></a>
Hachage SHA256 du package de déploiement de la fonction.  
Type : chaîne

 ** [CodeSize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSize"></a>
Taille du package de déploiement de la fonction, exprimée en octets.  
Type : long

 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DeadLetterConfig"></a>
File d’attente de lettres mortes de la fonction.  
Type : objet [DeadLetterConfig](API_DeadLetterConfig.md)

 ** [Description](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Description"></a>
Description de la fonction.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.

 ** [Environment](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Environment"></a>
[Variables d’environnement](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) de la fonction. Omis des journaux AWS CloudTrail.  
Type : objet [EnvironmentResponse](API_EnvironmentResponse.md)

 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-EphemeralStorage"></a>
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. Pour plus d’informations, consultez la section [Configuration du stockage éphémère (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Type : objet [EphemeralStorage](API_EphemeralStorage.md)

 ** [FileSystemConfigs](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FileSystemConfigs"></a>
Paramètres de connexion pour un [système de fichiers Amazon EFS](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Type : tableau d’objets [FileSystemConfig](API_FileSystemConfig.md)  
Membres du tableau : nombre maximum de 1 élément.

 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionArn"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionName"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Handler"></a>
Fonction que Lambda appelle pour commencer à exécuter votre fonction.  
Type : chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `[^\s]+` 

 ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ImageConfigResponse"></a>
Valeurs de configuration d’image de la fonction.  
Type : objet [ImageConfigResponse](API_ImageConfigResponse.md)

 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-KMSKeyArn"></a>
La AWS KMS key qui est utilisée pour chiffrer les [variables d’environnement](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) de la fonction. Lorsque [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) est activé, cette clé est également utilisée pour chiffrer l'instantané 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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastModified"></a>
Date et heure de la dernière mise à jour de la fonction, au [format ISO-8601](https://www.w3.org/TR/NOTE-datetime) (AAAA-MM-JJThh:mm:ss.sTZD).  
Type : chaîne

 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatus"></a>
É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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReason"></a>
Motif pour lequel la dernière mise à jour a été effectuée sur la fonction.  
Type : chaîne

 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReasonCode"></a>
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 | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` 

 ** [Layers](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Layers"></a>
[Couches](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) de la fonction.  
Type : tableau d’objets [Layer](API_Layer.md)

 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LoggingConfig"></a>
Les paramètres de configuration Amazon CloudWatch Logs de la fonction.  
Type : objet [LoggingConfig](API_LoggingConfig.md)

 ** [MasterArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MasterArn"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MemorySize"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-PackageType"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RevisionId"></a>
Dernière révision mise à jour de la fonction ou de l’alias.  
Type : chaîne

 ** [Role](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Role"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Runtime"></a>
Identifiant de l’[exécution](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) de la fonction. L’exécution est requise si le package de déploiement est une archive de fichiers de type .zip.  
La liste suivante contient les exécutions obsolètes. Pour plus d’informations, consultez la [Politique d’obsolescence de l’exécution](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Type : chaîne  
Valeurs valides : `nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.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 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` 

 ** [RuntimeVersionConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RuntimeVersionConfig"></a>
L’ARN de l’environnement d’exécution et toutes les erreurs qui se sont produites.  
Type : objet [RuntimeVersionConfig](API_RuntimeVersionConfig.md)

 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningJobArn"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningProfileVersionArn"></a>
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})?:(.*)` 

 ** [SnapStart](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SnapStart"></a>
Définissez `ApplyOn` sur `PublishedVersions` pour créer un instantané de l’environnement d’exécution initialisé lorsque vous publiez une version de fonction. Pour plus d'informations, consultez [Améliorer les performances de démarrage avec Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html).  
Type : objet [SnapStartResponse](API_SnapStartResponse.md)

 ** [State](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-State"></a>
État actuel de la fonction. Lorsque l’état est `Inactive`, vous pouvez réactiver la fonction en l’invoquant.  
Type : chaîne  
Valeurs valides : `Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReason"></a>
Motif de l’état actuel de la fonction.  
Type : chaîne

 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReasonCode"></a>
Code de motif de l’état actuel de la fonction. Lorsque le code est `Creating`, vous ne pouvez ni invoquer ni modifier la fonction.  
Type : chaîne  
Valeurs valides : `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` 

 ** [Timeout](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Timeout"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TracingConfig"></a>
Configuration du suivi AWS X-Ray de la fonction.  
Type : objet [TracingConfigResponse](API_TracingConfigResponse.md)

 ** [Version](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Version"></a>
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](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-VpcConfig"></a>
Configuration réseau de la fonction.  
Type : objet [VpcConfigResponse](API_VpcConfigResponse.md)

## Erreurs
<a name="API_CreateFunction_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
La configuration de signature de code spécifiée n’existe pas.  
Code d’état HTTP : 404

 ** CodeStorageExceededException **   
Votre Compte AWS a dépassé sa taille totale maximale de code. Pour plus d’informations, consultez [Quotas Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
Code d’état HTTP : 400

 ** CodeVerificationFailedException **   
La signature de code a échoué à au moins un contrôle de validation pour cause de non-concordance ou d’expiration de signature, et la politique de signature de code est définie sur ENFORCE. Lambda bloque le déploiement.  
Code d’état HTTP : 400

 ** InvalidCodeSignatureException **   
La signature du code a échoué au contrôle d’intégrité. Si le contrôle d’intégrité échoue, Lambda bloque le déploiement, même si la politique de signature de code est définie sur WARN.  
Code d’état HTTP : 400

 ** InvalidParameterValueException **   
L’un des paramètres dans la demande n’est pas valide.  
Code d’état HTTP : 400

 ** ResourceConflictException **   
La ressource existe déjà ou une autre opération est en cours.  
Code d’état HTTP : 409

 ** 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. Pour plus d’informations, consultez [Quotas Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Code d’état HTTP : 429

## consultez aussi
<a name="API_CreateFunction_SeeAlso"></a>

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 :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunction) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunction) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunction) 
+  [AWSSDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunction) 
+  [Kit AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) 
+  [Kit AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunction) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunction)