Senden Sie Traffic APIs über Ihren benutzerdefinierten Domainnamen in API Gateway an Sie - Amazon API Gateway

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Senden Sie Traffic APIs über Ihren benutzerdefinierten Domainnamen in API Gateway an Sie

Wenn Sie den Routing-Modus für Ihren benutzerdefinierten Domainnamen konfigurieren, legen Sie fest, wie eingehender Datenverkehr an Ihren weitergeleitet wird APIs. Sie senden Traffic APIs mithilfe von Routing-Regeln, API-Zuordnungen oder Routing-Regeln und API-Zuordnungen an Sie. Im folgenden Abschnitt wird erklärt, wann Sie Routing-Regeln und API-Zuordnungen verwenden und wie Sie den Routing-Modus für Ihren benutzerdefinierten Domainnamen festlegen.

Wann sollten Routing-Regeln verwendet werden

Wenn Sie Routing-Regeln verwenden, leiten Sie eingehende Anfragen, die bestimmte Bedingungen erfüllen, an bestimmte APIs REST-Phasen weiter. Beispielsweise kann eine Regel eine Anfrage an die production Phase Ihrer users REST-API weiterleiten, wenn sie den Header version:v1 und den Basispfad enthält/users. Verwenden Sie Routing-Regeln, um erweiterte dynamische Routing-Topologien zu erstellen, die Anwendungsfälle wie A/B-Tests oder die zunehmende Nutzung neuer Versionen von Ihrem unterstützen. APIs

Wir empfehlen, dass Sie bei der Weiterleitung von Traffic an eine REST-API Routing-Regeln für Ihren benutzerdefinierten Domainnamen verwenden. Sie können alle API-Zuordnungen mithilfe von Routing-Regeln neu erstellen. Weitere Informationen finden Sie unter Erstellen Sie eine API-Zuordnung mithilfe von Routing-Regeln neu.

Für REST APIs können Sie Routing-Regeln und API-Zuordnungen auch zusammen verwenden. Wenn Sie Routing-Regeln und API-Zuordnungen zusammen verwenden, wertet API Gateway immer die Routing-Regeln aus, bevor es API-Zuordnungen auswertet. Verwenden Sie Routing-Regeln und API-Zuordnungen zusammen, um Ihre aktuellen benutzerdefinierten Domainnamen zu migrieren oder Routing-Regeln zu erkunden.

Überlegungen zu Routing-Regeln

Die folgenden Überlegungen können sich auf Ihre Verwendung von Routingregeln auswirken:

  • WebSocket oder HTTP APIs werden nicht als Ziel APIs für Routing-Regeln unterstützt.

  • Wenn Ihr benutzerdefinierter Domainname API-Zuordnungen sowohl zu REST als auch zu HTTP enthält APIs, werden Routing-Regeln nicht unterstützt.

  • Sie können eine Routing-Regel für eine private benutzerdefinierte Domain zu einer privaten REST-API erstellen. Sie können eine Routing-Regel für eine öffentliche benutzerdefinierte Domain zu einer regionalen oder Edge-optimierten API erstellen.

  • Sie können keine Routing-Regel für eine öffentliche benutzerdefinierte Domain zu einer privaten API erstellen. Sie können keine Routing-Regel für einen privaten benutzerdefinierten Domainnamen zu einer öffentlichen API erstellen.

Wählen Sie zwischen Routing-Regeln und API-Zuordnungen

Wir empfehlen, wenn möglich, Routing-Regeln zu verwenden. Verwenden Sie API-Zuordnungen nur, um Traffic an ein HTTP oder WebSocket eine API zu senden.