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.

# CreateAlias
<a name="API_CreateAlias"></a>

Crée un [alias](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) pour une version de fonction Lambda. Utilisez des alias pour fournir aux clients un identifiant de fonction que vous pouvez mettre à jour pour invoquer une version différente.

Vous pouvez également mapper un alias pour fractionner des demandes d’invocation entre deux versions. Utilisez le paramètre `RoutingConfig` pour spécifier une deuxième version et le pourcentage de demandes d’invocation qu’il reçoit.

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

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

{
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

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

La demande utilise les paramètres URI suivants.

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

**Formats de nom**
+  **Nom de fonction** – `MyFunction`.
+  **ARN de fonction** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`.
+  **ARN partiel** – `123456789012:function:MyFunction`.
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 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

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

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

 ** [Description](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Description"></a>
Description de l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.  
Obligatoire : non

 ** [FunctionVersion](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-FunctionVersion"></a>
Version de fonction invoquée par l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.  
Modèle : `(\$LATEST|[0-9]+)`   
Obligatoire : oui

 ** [Name](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-Name"></a>
Nom de l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 128.  
Modèle : `(?!^[0-9]+$)([a-zA-Z0-9-_]+)`   
Obligatoire : oui

 ** [RoutingConfig](#API_CreateAlias_RequestSyntax) **   <a name="lambda-CreateAlias-request-RoutingConfig"></a>
La [configuration de routage](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html#configuring-alias-routing) de l’alias.  
Type : objet [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)  
Obligatoire : non

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

```
HTTP/1.1 201
Content-type: application/json

{
   "AliasArn": "string",
   "Description": "string",
   "FunctionVersion": "string",
   "Name": "string",
   "RevisionId": "string",
   "RoutingConfig": { 
      "AdditionalVersionWeights": { 
         "string" : number 
      }
   }
}
```

## Eléments de réponse
<a name="API_CreateAlias_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.

 ** [AliasArn](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-AliasArn"></a>
Amazon Resource Name (ARN) de l’alias.  
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-_]+))?` 

 ** [Description](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Description"></a>
Description de l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.

 ** [FunctionVersion](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-FunctionVersion"></a>
Version de fonction invoquée par l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.  
Modèle : `(\$LATEST|[0-9]+)` 

 ** [Name](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-Name"></a>
Nom de l’alias.  
Type : chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 128.  
Modèle : `(?!^[0-9]+$)([a-zA-Z0-9-_]+)` 

 ** [RevisionId](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RevisionId"></a>
Identifiant unique qui change lorsque vous mettez à jour l’alias.  
Type : chaîne

 ** [RoutingConfig](#API_CreateAlias_ResponseSyntax) **   <a name="lambda-CreateAlias-response-RoutingConfig"></a>
La [configuration de routage](https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) de l’alias.  
Type : objet [AliasRoutingConfiguration](API_AliasRoutingConfiguration.md)

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

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

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