Comment collecter les ID de requête étendue d'API Gateway ?

Résolution

Pour collecter des ID de requêtes étendues, vérifiez les enregistrements du journal d'accès, les enregistrements du journal d'exécution ou les en-têtes de réponse HTTP.

Configurer la journalisation

Si vous n'avez pas configuré la journalisation pour votre API, consultez les sections Configurer la journalisation pour les API HTTP dans API Gateway et Configurer la journalisation CloudWatch pour les API REST dans API Gateway.

Remarque : Vous devez activer la journalisation des accès pour capturer les ID de requêtes étendues. Les journaux d'accès peuvent capturer les requêtes qui n'atteignent pas la journalisation d'exécution.

Vérifier les enregistrements du journal d'accès

Lorsque vous consultez les enregistrements de votre journal d'accès, vous pouvez voir qui a accédé à votre API et comment. Pour obtenir les ID de requêtes dans les journaux d'accès, incluez la variable de contexte context.extendedRequestId lorsque vous personnalisez le contenu de vos journaux.

Vérifier les enregistrements du journal d'exécution

Vous pouvez vérifier les ID de requêtes étendues dans les journaux d'exécution gérés par API Gateway.

Les ID de requêtes étendues apparaissent dans l'un des formats suivants :

• Format du groupe de journaux : API-Gateway-Execution-Logs_{rest-api-id}/{stage_name}
• Format de l'ID de requête étendue : « XxxXXXxx= »

Vérifier les en-têtes de réponse HTTP

Vous pouvez trouver des ID de requêtes étendues dans les en-têtes de réponse d'API.

Par exemple, vous exécutez la commande curl suivante avec l'indicateur détaillé (-v) :

curl -v GET https://your-api-id.execute-api.region.amazonaws.com/stage/resource

Vous recevez l'en-tête suivant dans la réponse :

x-amz-apigw-id: XxxXXXxx=