Recréez un mappage d'API à l'aide de règles de routage

Pour définir le mode de routage sur ROUTING_RULE_THEN_ API_MAPPING

1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

2. Sélectionnez Noms de domaine personnalisés dans le volet de navigation principal.

3. Choisissez votre nom de domaine personnalisé.

4. Pour les détails du domaine, choisissez Modifier.

5. Pour le mode de routage, choisissez API_MAPPINGROUTING_RULE_THEN_.

6. Choisissez Enregistrer.

Pour créer la règle de routage

1. Dans l'onglet Détails du routage, choisissez Ajouter une règle de routage.

2. Choisissez Ajouter une nouvelle condition, puis Path.

3. Pour Path, entrezorders/v2/items/categories/5.

4. Pour Strip base path, choisissez Active.

5. Pour l'API cible, choisissez votre API cible.

6. Pour Étape cible, choisissez votre étape cible.

7. Choisissez Suivant.

8. Dans le champ Priorité, entrez une priorité.

   Même si vous conservez votre mappage d'API existant, API Gateway utilisera toujours la nouvelle règle de routage, car les règles de routage ont toujours la priorité sur les mappages d'API.

9. Sélectionnez Enregistrer les modifications.

Pour mettre à jour vos journaux d'accès

1. Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.

2. Choisissez votre API.

3. Dans le volet de navigation principal, choisissez Étapes.

4. Pour Journaux et suivi, choisissez Modifier.

   Si vous n'avez pas de groupe de journaux, consultezConfiguration de la CloudWatch journalisation pour REST APIs dans API Gateway.

5. Ajoutez $context.customDomain.routingRuleIdMatched à votre format de journal.

   Ce groupe de journaux enregistre l'ID de règle de routage utilisé par API Gateway pour envoyer du trafic vers votre API. Pour de plus amples informations, veuillez consulter Je ne peux pas dire comment API Gateway a envoyé du trafic à mon APIs.

6. Choisissez Enregistrer.

1. Utilisez la update-domain-namecommande suivante pour mettre à jour le nom de domaine api.example.com afin d'utiliser le mode de routageROUTING_RULE_THEN_API_MAPPING.

   aws apigatewayv2 update-domain-name \
     --domain-name 'api.example.com' \
     --routing-mode ROUTING_RULE_THEN_API_MAPPING

2. Utilisez la create-routing-rulecommande suivante pour créer une nouvelle règle de routage afin de recréer le mappage https://api.example.com/orders/v2/items/categories/5 d'API.

   aws apigatewayv2 create-routing-rule \
     --domain-name 'api.example.com' \
     --priority 50 \
     --conditions '[
     {
       "MatchBasePaths": {
         "AnyOf": [
           "orders/v2/items/categories/5"
         ]
       }
     }
   ]' \
     --actions '[
     {
       "InvokeApi": {
         "ApiId": "a1b2c3",
         "Stage": "prod",
         "StripBasePath": true
       }
     }
   ]'

3. Utilisez la commande update-stage suivante pour mettre à jour le format des journaux d'accès afin d'inclure la $context.customDomain.routingRuleIdMatched variable. Cette variable enregistre l'ID de règle de routage utilisé par API Gateway pour envoyer du trafic vers votre API. Vous utilisez ce journal pour confirmer qu'API Gateway utilise votre règle de routage pour envoyer du trafic vers votre API. Pour de plus amples informations, veuillez consulter Je ne peux pas dire comment API Gateway a envoyé du trafic à mon APIs.

   aws apigateway update-stage \
     --rest-api-id a1bc2c3 \
     --stage-name prod \
     --patch-operations "op=replace,path=/accessLogSettings/format,value='\$context.path \$context.customDomain.routingRuleIdMatched \$context.requestId \$context.extendedRequestId'"

   Si vous n'avez pas de groupe de journaux, consultezConfiguration de la CloudWatch journalisation pour REST APIs dans API Gateway.

4. Utilisez l'exemple de commande curl suivant pour appeler votre nom de domaine personnalisé avec le chemin orders/v2/items/categories/5 de base.

   curl "https://api.example.com/orders/v2/items/categories/5

5. Utilisez la filter-log-eventscommande suivante pour obtenir les événements du journal à partir du groupe de journaux access-log-group-orders contenant l'ID de règle de routageabc123.

   aws logs filter-log-events --log-group-name access-log-group-orders --filter-pattern abc123

   Cela confirme qu'API Gateway a utilisé la règle de routage pour envoyer du trafic vers votre API.