API-Zuweisung mithilfe von Routing-Regeln neu erstellen

Um den Routingmodus auf ROUTING_RULE_THEN_ einzustellen API_MAPPING

1. Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan.

2. Wählen Sie Benutzerdefinierte Domainnamen im Hauptnavigationsbereich aus.

3. Wählen Sie Ihren benutzerdefinierten Domainnamen aus.

4. Wählen Sie unter Domänendetails die Option Bearbeiten aus.

5. Wählen Sie für den Routing-Modus ROUTING_RULE_THEN_. API_MAPPING

6. Wählen Sie Speichern aus.

So erstellen Sie die Routing-Regel

1. Wählen Sie auf der Registerkarte Routing-Details die Option Routing-Regel hinzufügen aus.

2. Wählen Sie Neue Bedingung hinzufügen und dann Pfad aus.

3. Geben Sie unter Pfad den Wert orders/v2/items/categories/5 ein.

4. Wählen Sie für Leerzeichen des Basispfads entfernen die Option Aktiv aus.

5. Wählen Sie für Ziel-API Ihre Ziel-API aus.

6. Wählen Sie für Zielstufe Ihre Zielstufe aus.

7. Wählen Sie Weiter aus.

8. Geben Sie unter „Priorität“ eine Priorität ein.

   Auch wenn Sie Ihre bestehende API-Zuweisung beibehalten, verwendet API Gateway immer die neue Routing-Regel, da Routing-Regeln stets Vorrang vor API-Zuweisungen haben.

9. Wählen Sie Änderungen speichern aus.

So aktualisieren Sie Ihre Zugriffsprotokolle

1. Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan.

2. Wählen Sie Ihre API aus.

3. Klicken Sie im Hauptnavigationsbereich auf Stufen.

4. Wählen Sie unter Protokolle und Ablaufverfolgung die Option Bearbeiten aus.

   Wenn Sie keine Protokollgruppe haben, siehe Einrichten der CloudWatch-Protokollierung für eine REST-API in API Gateway.

5. Fügen Sie $context.customDomain.routingRuleIdMatched Ihrem Protokollformat hinzu.

   Diese Protokollgruppe zeichnet die Routing-Regel-ID auf, die API Gateway verwendet hat, um Datenverkehr an Ihre API zu senden. Weitere Informationen finden Sie unter Ich kann nicht sagen, wie API Gateway Traffic an meinen gesendet hat APIs.

6. Wählen Sie Speichern aus.

1. Verwenden Sie den folgenden update-domain-nameBefehl, um den Domainnamen api.example.com zu aktualisieren, um den Routing-Modus zu verwendenROUTING_RULE_THEN_API_MAPPING.

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

2. Verwenden Sie den folgenden create-routing-ruleBefehl, um eine neue Routing-Regel zu erstellen, um die API-Zuordnung https://api.example.com/orders/v2/items/categories/5 neu zu erstellen.

   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. Verwenden Sie den folgenden Befehl update-stage, um das Format der Zugriffsprotokolle so zu aktualisieren, dass die Variable $context.customDomain.routingRuleIdMatched enthalten ist. Diese Variable zeichnet die Routing-Regel-ID auf, die API Gateway verwendet hat, um Datenverkehr an Ihre API zu senden. Sie verwenden dieses Protokoll als Bestätigung, dass API Gateway Ihre Routing-Regel verwendet, um Datenverkehr an Ihre API zu senden. Weitere Informationen finden Sie unter Ich kann nicht sagen, wie API Gateway Traffic an meinen gesendet hat 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'"

   Wenn Sie keine Protokollgruppe haben, siehe Einrichten der CloudWatch-Protokollierung für eine REST-API in API Gateway.

4. Verwenden Sie den folgenden curl-Befehl, um Ihren benutzerdefinierten Domainnamen mit dem Basispfad orders/v2/items/categories/5 aufzurufen.

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

5. Verwenden Sie den folgenden filter-log-eventsBefehl, um die Protokollereignisse aus der Protokollgruppe abzurufenaccess-log-group-orders, die die Routingregel-ID abc123 enthalten.

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

   Damit wird bestätigt, dass API Gateway die Routing-Regel verwendet hat, um den Datenverkehr an Ihre API zu senden.