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.
PutRuntimeManagementConfig
Définit la configuration de gestion de l’environnement d’exécution pour la version d’une fonction. Pour plus d’informations, consultez Mises à jour de l’environnement d’exécution (français non garanti).
Syntaxe de la demande
PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json
{
"RuntimeVersionArn": "string",
"UpdateRuntimeOn": "string"
}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 –
my-function. -
ARN de fonction –
arn:aws:lambda:us-west-2:123456789012:function:my-function. -
ARN partiel –
123456789012: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
-
- Qualifier
-
Spécifiez une version de la fonction. Il peut s’agir de
$LATESTou d’un numéro de version publié. Si aucune valeur n’est spécifiée, la configuration de la version$LATESTest renvoyée.Contraintes de longueur : longueur minimum de 1. Longueur maximum de 128.
Modèle :
(|[a-zA-Z0-9$_-]+)
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- RuntimeVersionArn
-
L’ARN de la version de l’environnement d’exécution que vous voulez que la fonction utilise.
Note
Ceci n’est requis que si vous utilisez le mode manuel de mise à jour de l’environnement d’exécution.
Type : chaîne
Contraintes de longueur : longueur minimale de 26. Longueur maximale de 2048.
Modèle :
^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$Obligatoire : non
- UpdateRuntimeOn
-
Spécifiez le mode de mise à jour de l’environnement d’exécution.
-
Auto (par défaut) – Mettre automatiquement à jour vers la version de l’environnement d’exécution la plus récente et la plus sécurisée à l’aide d’un déploiement de la version de l’environnement d’exécution en deux phases. Il s’agit du meilleur choix pour la plupart des clients afin de s’assurer qu’ils bénéficient toujours des mises à jour de l’environnement d’exécution.
-
Mise à jour de fonction – Lambda met à jour l’environnement d’exécution de votre fonction vers la version la plus récente et la plus sécurisée lorsque vous mettez à jour votre fonction. Cette approche synchronise les mises à jour de l’environnement d’exécution avec les déploiements de la fonction, ce qui vous donne le contrôle sur le moment où les mises à jour sont appliquées et vous permet de détecter et d’atténuer rapidement les rares incompatibilités liées aux mises à jour. Lorsque vous utilisez ce paramètre, vous devez régulièrement mettre à jour vos fonctions pour conserver leur durée d'exécution up-to-date.
-
Manuel – Vous spécifiez une version de l’environnement d’exécution dans la configuration de votre fonction. La fonction utilisera cette version de l’environnement d’exécution indéfiniment. Dans les rares cas où une nouvelle version de l’environnement d’exécution est incompatible avec une fonction existante, cela vous permet de revenir à une version antérieure de l’environnement d’exécution. Pour plus d’informations, consultez Restauration d’une version de l’environnement d’exécution (français non garanti).
Type : chaîne
Valeurs valides :
Auto | Manual | FunctionUpdateObligatoire : oui
-
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"FunctionArn": "string",
"RuntimeVersionArn": "string",
"UpdateRuntimeOn": "string"
}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.
- FunctionArn
-
L’ARN de la fonction
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-_]+))? - RuntimeVersionArn
-
L’ARN de l’environnement d’exécution que la fonction est configurée pour utiliser. Si le mode de mise à jour de l’environnement d’exécution est manuel, l’ARN est renvoyé, sinon
nullest renvoyé.Type : chaîne
Contraintes de longueur : longueur minimale de 26. Longueur maximale de 2048.
Modèle :
^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$ - UpdateRuntimeOn
-
Le mode de mise à jour de l’environnement d’exécution.
Type : chaîne
Valeurs valides :
Auto | Manual | FunctionUpdate
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 :
