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.
Utilisation du point de terminaison de métadonnées Lambda
Avec le point de terminaison de métadonnées Lambda, vos fonctions peuvent découvrir dans quelle zone de disponibilité (AZ) elles s'exécutent. Vous pouvez l'utiliser pour optimiser la latence en acheminant vers des ressources de même zone de zone de disponibilité, telles que les points de terminaison ElastiCache Amazon et Amazon RDS, et pour implémenter des modèles de résilience. AZ-aware
Le point de terminaison renvoie les métadonnées dans un format JSON simple via une API HTTP localhost au sein de l'environnement d'exécution et est accessible à la fois aux environnements d'exécution et aux extensions.
Prise en main
Powertools for AWS Lambda fournit un utilitaire permettant d'accéder au point de terminaison des métadonnées Lambda en Python TypeScript, Java et .NET. L'utilitaire met en cache la réponse après le premier appel et gère automatiquement l'invalidation SnapStart du cache.
Utilisez l'utilitaire de métadonnées Powertools for AWS Lambda ou appelez directement le point de terminaison des métadonnées
Comprendre les identifiants des zones de disponibilité
Les identifiants AZ (par exempleuse1-az1) font toujours référence au même emplacement physique sur tous les AWS comptes, tandis que les noms AZ (par exempleus-east-1a) peuvent correspondre à une infrastructure physique différente dans chaque AWS
compte dans certaines régions. Pour plus d'informations, consultez la section AZ IDs pour la cohérence entre comptes.
Conversion d'un ID AZ en nom AZ :
Pour convertir un ID AZ en nom AZ, utilisez l'API Amazon EC2. DescribeAvailabilityZones Pour utiliser cette API, ajoutez l'ec2:DescribeAvailabilityZonesautorisation au rôle d'exécution de votre fonction.
Référence des API
Variables d’environnement
Lambda définit automatiquement les variables d'environnement suivantes dans chaque environnement d'exécution :
-
AWS_LAMBDA_METADATA_API— L'adresse du serveur de métadonnées au format{ipv4_address}:{port}(par exemple,169.254.100.1:9001). -
AWS_LAMBDA_METADATA_TOKEN— Un jeton d'authentification unique pour l'environnement d'exécution actuel. Lambda génère ce jeton automatiquement lors de l'initialisation. Incluez-le dans toutes les demandes d'API de métadonnées.
Endpoint
GET http://${AWS_LAMBDA_METADATA_API}/2026-01-15/metadata/execution-environment
Demande
En-têtes obligatoires :
-
Authorization— La valeur du jeton de la variable d'AWS_LAMBDA_METADATA_TOKENenvironnement avec le schéma Bearer :Bearer <token>. Cette authentification basée sur des jetons fournit une protection approfondie contre les vulnérabilités liées à la falsification des Server-Side requêtes (SSRF). Chaque environnement d'exécution reçoit un jeton unique généré aléatoirement lors de l'initialisation.
Réponse
État : 200 OK
Content-Type: application/json
Cache-Control: private, max-age=43200, immutable
La réponse est immuable dans un environnement d'exécution. Les clients doivent mettre en cache la réponse et respecter le Cache-Control TTL. Pour les SnapStart fonctions, le TTL est réduit lors de l'initialisation afin que les clients actualisent les métadonnées après la restauration lorsque l'environnement d'exécution peut se trouver dans une autre zone de disponibilité. Si vous utilisez Powertools, la mise en cache et l' SnapStart invalidation sont gérées automatiquement.
Corps de texte:
{ "AvailabilityZoneID": "use1-az1" }
Le AvailabilityZoneID champ contient l'identifiant unique de la zone de disponibilité dans laquelle s'exécute l'environnement d'exécution.
Des champs supplémentaires pourraient être ajoutés à la réponse lors de futures mises à jour. Les clients doivent ignorer les champs inconnus et ne pas échouer si de nouveaux champs apparaissent.
Réponses d’erreur
-
401 Non autorisé — L'
Authorizationen-tête est manquant ou contient un jeton non valide. Vérifiez que vous êtes en train de réussirBearer ${AWS_LAMBDA_METADATA_TOKEN}. -
405 Méthode non autorisée — La méthode de demande ne l'est pas
GET. -
500 Erreur interne du serveur — erreur Server-side de traitement.