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.

Points de terminaison de la fonction Web Lambda

Un point de terminaison est une ressource enfant d'une fonction Web qui fournit un point d'entrée réseau pour le trafic HTTP. Chaque point de terminaison inclut un nom de domaine unique avec TLS et un type d'authentification. Il comporte également des paramètres relatifs à la portée géographique, à la mise à l'échelle, à la régulation et au routage du trafic. Une fonction Web peut avoir jusqu'à 10 points de terminaison, chacun ayant une configuration indépendante.

Les sections suivantes décrivent les types de points de terminaison, les noms de domaine, l'authentification et la réplication. Pour plus d'informations sur les paramètres de mise à l'échelle et de limitation, consultez. Comportement de dimensionnement pour les fonctions Web Lambda Pour plus d'informations sur les modes de déploiement automatique et le routage du trafic, consultezModèles de déploiement.

Types de point de terminaison

Le type de point de terminaison détermine la manière dont Lambda déploie votre fonction Web Régions AWS et la manière dont le trafic y est acheminé. Vous choisissez le type de point de terminaison lorsque vous créez le point de terminaison. Le type de point de terminaison ne peut pas être modifié après sa création.

Les régions et le type de point de terminaison ne peuvent pas être mis à jour après leur création. Pour les modifier, créez un nouveau point de terminaison avec la configuration que vous souhaitez, migrez le trafic vers le nom de domaine du nouveau point de terminaison, puis supprimez l'ancien point de terminaison.

Pour plus de détails sur la façon dont Lambda réplique votre fonction Web entre les régions et achemine le trafic, consultez. Multi-Region déploiement

Nom de domaine

Lambda attribue un nom de domaine unique à chaque point de terminaison lorsque vous le créez. Les clients envoient des requêtes HTTPS à ce domaine pour appeler votre fonction Web. Le domaine prend en charge le protocole HTTPS et Lambda gère le certificat TLS du domaine. Vous ne créez, ne renouvelez pas ou ne gérez pas les certificats vous-même.

Le format du nom de domaine dépend du type de point de terminaison :

Vous pouvez récupérer le nom de domaine à partir de la GetWebFunctionEndpoint réponse ou de la console Lambda une fois que le point de terminaison a atteint l'état actif.

Type d’authentification

Le authType paramètre contrôle si Lambda authentifie les requêtes HTTP entrantes avant de les transmettre à votre application. Vous pouvez mettre à jour ce paramètre sur un point de terminaison existant.

Pour plus de détails sur l'authentification, y compris CloudFront l'intégration et les politiques basées sur les ressources, consultez. Contrôle d'accès aux terminaux Lambda Web Function

Auto-deployment mode

Le autoDeploymentMode paramètre contrôle si Lambda achemine automatiquement le trafic vers les nouvelles révisions chaque fois que vous déployez votre application. Vous pouvez mettre à jour ce paramètre sur un point de terminaison existant.

Si vous omettez de le faire autoDeploymentMode dans une demande d'API, la valeur par défaut est. Disabled La console Lambda et l'utilisation des aws lambda-web deploy commandes LatestRevision pour les nouveaux HomeRegion points de terminaison. LatestRevisionn'est pris en charge que pour les HomeRegion points de terminaison, donc MultiRegion et les PerRegion points de terminaison l'utilisent toujours. Disabled Lors de l'utilisationDisabled, spécifiez revisionWeights ce total de 100.

Pour plus de détails sur les modèles de déploiement, les annulations et le comportement de changement de mode, consultezModèles de déploiement.

Mise à l'échelle et régulation

Chaque point de terminaison possède des paramètres de dimensionnement et de limitation qui contrôlent la capacité. Vous pouvez mettre à jour ces paramètres sur un terminal existant avecupdate-web-function-endpoint. Omettez --scaling-config ou --throttle-config conservez sa valeur actuelle, ou transmettez un objet vide ('{}') pour effacer une valeur précédemment définie. Pour supprimer une limite de débit, transmettez un --throttle-config objet vide. A rateLimit de 0 bloque tout le trafic.

Pour plus de détails sur la façon dont ces paramètres interagissent avec la simultanéité au niveau de la révision et pour obtenir des conseils sur le choix des valeurs, voir. Comportement de dimensionnement pour les fonctions Web Lambda

Création et gestion de points de terminaison

Création d’un point de terminaison

Répertorier les points de terminaison

aws lambda-web list-web-function-endpoints \
    --function-name my-web-app

La réponse inclut le nom, le type, le nom de domaine, l'état et la configuration de chaque point de terminaison.

Obtenir des informations sur les terminaux

aws lambda-web get-web-function-endpoint \
    --function-name my-web-app \
    --endpoint-name my-endpoint

La réponse inclut le nom de domaine, l'état, le type d'authentification, le mode de déploiement automatique, les paramètres de dimensionnement, les pondérations de révision et (pour MultiRegion et les PerRegion points de terminaison) l'état de chaque région et le statut de mise à jour sur le regionalEndpoints terrain.

Mise à jour d'un terminal

Vous pouvez mettre à jour les propriétés suivantes sur un point de terminaison existant :

Vous ne pouvez pas mettre à jour les propriétés suivantes. Pour les modifier, créez un nouveau point de terminaison avec la configuration que vous souhaitez, migrez le trafic vers le nom de domaine du nouveau point de terminaison, puis supprimez l'ancien point de terminaison.

Suppression d'un point de terminaison

aws lambda-web delete-web-function-endpoint \
    --function-name my-web-app \
    --endpoint-name my-endpoint

Lorsque vous supprimez un point de terminaison, il passe à l'état Suppression. Lambda arrête de router les nouvelles demandes vers le point de terminaison et retire son nom de domaine. Pour un PerRegion point de terminaison, Lambda retire le nom de domaine dans chaque région. Lambda n'attribue jamais les noms de domaine d'un point de terminaison supprimé à un autre point de terminaison dans aucun compte. Lambda draine les demandes en vol. Il permet aux demandes déjà en cours de se terminer et rejette les nouvelles demandes adressées aux noms de domaine du point de terminaison. Pour les points MultiRegion de PerRegion terminaison et les points de terminaison, Lambda supprime le point de terminaison de toutes les régions. Une fois la suppression terminée, Lambda supprime définitivement le point de terminaison.

La suppression d'un point de terminaison n'entraîne pas la suppression de la fonction Web ni de ses révisions. Les révisions restent disponibles pour être utilisées par d'autres points de terminaison.