PutFunctionConcurrency - 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.

PutFunctionConcurrency

Définit le nombre maximum d’exécutions simultanées pour une fonction, et réserve de la capacité pour ce niveau de simultanéité.

Les paramètres de simultanéité s’appliquent à la fonction dans son ensemble, ce qui inclut la totalité de ses versions publiées et sa version non publiée. La réservation de simultanéité garantit que votre fonction a la capacité de traiter simultanément le nombre d’événements spécifié, et l’empêche de passer à une l’échelle au-delà de ce niveau. Utilisez GetFunction pour afficher le paramètre actuel d’une fonction.

Utilisez GetAccountSettings pour voir votre limite de simultanéité régionale. Vous pouvez réserver de la simultanéité pour autant de fonctions que vous le souhaitez, à condition de laisser au moins 100 exécutions simultanées non réservées pour les fonctions qui ne sont pas configurées avec une limite par fonction. Pour plus d’informations, consultez Capacité de mise à l’échelle d’une fonction Lambda.

Syntaxe de la demande

PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1 Content-type: application/json { "ReservedConcurrentExecutions": 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 fonctionmy-function.

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

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

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.

ReservedConcurrentExecutions

Nombre d’exécutions simultanées à réserver pour la fonction.

Type : entier

Plage valide : Valeur minimum de 0.

Obligatoire : oui

Syntaxe de la réponse

HTTP/1.1 200 Content-type: application/json { "ReservedConcurrentExecutions": 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.

ReservedConcurrentExecutions

Nombre d’exécutions simultanées réservées pour cette fonction. Pour en savoir plus, consultez Gestion de la simultanéité réservée Lambda.

Type : entier

Plage valide : Valeur minimum de 0.

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 :