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.
UpdateAlias
Met à jour la configuration d’un alias de la fonction Lambda.
Syntaxe de la demande
PUT /2015-03-31/functions/FunctionName/aliases/Name HTTP/1.1
Content-type: application/json
{
"Description": "string",
"FunctionVersion": "string",
"RevisionId": "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 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
-
- Name
-
Nom de l’alias.
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 128.
Modèle :
(?!^[0-9]+$)([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 : non
- RevisionId
-
Ne mettez à jour l’alias que si l’ID de révision correspond à l’ID spécifié. Utilisez cette option pour éviter de modifier un alias qui a changé depuis la dernière lecture.
Type : chaîne
Obligatoire : non
- RoutingConfig
-
La configuration de routage de l’alias.
Type : objet AliasRoutingConfiguration
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
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 200.
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
- PreconditionFailedException
-
La valeur RevisionId fournie ne correspond pas à la dernière version de RevisionId la fonction ou de l'alias Lambda. Appelez l'opération
GetFunctionou l'GetAliasAPI pour récupérer la dernière version RevisionId de votre ressource.Code d’état HTTP : 412
- 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 :
