Recréation d’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. Sous 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 condition, puis Chemin.

3. Sous Chemin, saisissez orders/v2/items/categories/5.

4. Sous Chemin de base de la bande, choisissez Actif.

5. Sous API cible, choisissez votre API cible.

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

7. Choisissez Suivant.

8. Sous Priorité, saisissez une priorité.

   Même si vous conservez votre mappage d’API, 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. Sous Journaux et traçage, choisissez Modifier.

   Si vous n’avez pas de groupe de journaux, consultez Configuration de la journalisation CloudWatch pour les API REST dans API Gateway.

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

   Ce groupe de journaux enregistre l’ID de la règle de routage utilisée par API Gateway pour envoyer le trafic à 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 qu’il inclut la variable $context.customDomain.routingRuleIdMatched. Cette variable enregistre l’ID de la règle de routage utilisée par API Gateway pour envoyer le trafic à votre API. Vous allez utilisez ce journal pour vérifier qu’API Gateway utilise votre règle de routage pour envoyer le trafic à 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, consultez Configuration de la journalisation CloudWatch pour les API REST dans API Gateway.

4. Utilisez l’exemple de commande curl suivant pour invoquer votre nom de domaine personnalisé à l’aide du chemin de base orders/v2/items/categories/5.

   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

   Vous avez la confirmation qu’API Gateway a utilisé la règle de routage pour envoyer le trafic à votre API.