UpdateAlias - AWS Lambda
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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 appelé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 appelé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

InvalidParameterValueException

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

Code d'état HTTP : 400

PreconditionFailedException

Le RevisionId fourni ne correspond pas au dernier RevisionId pour la fonction ou l’alias Lambda. Appelez l'opération d'API GetFunction ou GetAlias pour récupérer le dernier RevisionId d'une 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

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 :