CreateAlias - AWS Lambda

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

Crée un alias 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

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

La demande utilise les paramètres URI suivants.

FunctionName

Nom de la fonction Lambda.

Formats de nom
  • Nom de fonctionMyFunction.

  • ARN de fonctionarn:aws:lambda:us-west-2:123456789012:function:MyFunction.

  • ARN partiel123456789012: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

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

Description

Description de l’alias.

Type : chaîne

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

Obligatoire : non

FunctionVersion

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

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

La configuration de routage de l’alias.

Type : objet AliasRoutingConfiguration

Obligatoire : non

Syntaxe de la réponse

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

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

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

Description de l’alias.

Type : chaîne

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

FunctionVersion

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

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

Identifiant unique qui change lorsque vous mettez à jour l’alias.

Type : chaîne

RoutingConfig

La configuration de routage de l’alias.

Type : objet AliasRoutingConfiguration

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

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.

Code d’état HTTP : 429

consultez 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 :