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.
Sie verwenden API-Mappings, um API-Stufen mit einem benutzerdefinierten Domain-Namen zu verbinden. Dadurch wird Traffic APIs über Ihren benutzerdefinierten Domainnamen an Sie gesendet.
Ein API-Mapping gibt eine API, eine Phase und optional einen Pfad an, die für das Mapping verwendet werden sollen. Sie können beispielsweise die production-Phase einer API in https://api.example.com/orders abbilden.
Sie können HTTP-API- und REST-API--Stufen demselben benutzerdefinierten Domain-Namen zuweisen.
Bevor Sie ein API-Mapping erstellen, benötigen Sie eine API, eine Phase und einen benutzerdefinierten Domain-Namen. Weitere Informationen zum Erstellen eines benutzerdefinierten Domain-Namens finden Sie unter Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway.
Weiterleiten von API-Anforderungen
Sie können API-Mappings mit mehreren Ebenen konfigurieren, z. B. orders/v1/items und orders/v2/items.
Anmerkung
Sie brauchen einen regionalen benutzerdefinierten Domainnamen mit der Sicherheitsrichtlinie TLS 1.2, um API-Mappings mit mehreren Ebenen zu konfigurieren.
Bei API-Mappings mit mehreren Ebenen leitet API Gateway Anfragen an das API-Mapping weiter, die den längsten Übereinstimmungspfad hat. API Gateway berücksichtigt nur die für API-Mappings konfigurierten Pfade und keine API-Routen, um die aufzurufende API auszuwählen. Wenn kein Pfad mit der Anforderung übereinstimmt, sendet API Gateway die Anforderung an die API, die Sie dem leeren Pfad zugeordnet habe (none).
Bei benutzerdefinierten Domain-Namen, die API-Mappings mit mehreren Ebenen verwenden, leitet API Gateway Anfragen an das API-Mapping weiter, die den längsten Übereinstimmungspräfix hat.
Betrachten Sie beispielsweise einen benutzerdefinierten Domain-Namen https://api.example.com mit den folgenden API-Mappings:
-
(none)API 1 zugewiesen. -
ordersAPI 2 zugewiesen. -
orders/v1/itemsAPI 3 zugewiesen. -
orders/v2/itemsAPI 4 zugewiesen. -
orders/v2/items/categoriesAPI 5 zugewiesen.
| Anfrage | Ausgewählte API | Erklärung |
|---|---|---|
|
|
|
Die Anforderung stimmt genau mit diesem API-Mapping überein. |
|
|
|
Die Anforderung stimmt genau mit diesem API-Mapping überein. |
|
|
|
Die Anforderung stimmt genau mit diesem API-Mapping überein. |
|
|
|
API Gateway wählt das Mapping aus, das den längsten Übereinstimmungspfad hat. Das |
|
|
|
API Gateway wählt das Mapping aus, das den längsten Übereinstimmungspfad hat. |
|
|
|
API Gateway verwendet das leere Mapping als Catch-All. |
|
|
|
API Gateway wählt das Mapping aus, das den längsten Übereinstimmungspräfix hat. Bei einem benutzerdefinierten Domain-Namen, der mit einstufigen Mappings konfiguriert ist, z. B. nur |
Einschränkungen
-
Bei einer API-Zuordnung APIs müssen sich der benutzerdefinierte Domainname und der zugeordnete Domainname im selben AWS Konto befinden.
-
API-Mappings dürfen nur Buchstaben, Zahlen und die folgenden Zeichen enthalten:
$-_.+!*'()/. -
Die maximale Länge für den Pfad in eines API-Mappings beträgt 300 Zeichen.
-
Es können 200 API-Zuweisungen mit mehreren Ebenen für jeden Domainnamen vorhanden sein.
-
Sie können HTTP APIs nur mit der Sicherheitsrichtlinie TLS 1.2 einem regionalen benutzerdefinierten Domainnamen zuordnen.
-
Sie können nicht demselben benutzerdefinierten Domainnamen wie eine HTTP-API oder REST-API zuordnen. WebSocket APIs
-
Sie müssen den Ressourceneintrag Ihres DNS-Anbieters erstellen oder aktualisieren, um ihn dem API-Endpunkt zuzuordnen, nachdem Sie Ihre API-Zuweisungen erstellt haben.
-
Wenn Sie mehrstufige API-Zuweisungen erstellen, konvertiert API Gateway alle Header-Namen in Kleinbuchstaben.
Ein API-Mapping erstellen
Um ein API-Mapping zu erstellen, müssen Sie zuerst einen benutzerdefinierten Domain-Namen, eine API und eine Phase erstellen. Informationen zum Erstellen eines benutzerdefinierten Domain-Namens finden Sie unter Einrichten eines regionalen benutzerdefinierten Domainnamens in API Gateway.
AWS Serverless Application Model Vorlagen, die alle Ressourcen erstellen, finden Sie beispielsweise unter Sessions With SAM
Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan
. Wählen Sie Benutzerdefinierten Domänennamen im Hauptnavigationsbereich aus.
-
Wählen Sie einen benutzerdefinierten Domänennamen aus.
-
Klicken Sie in der Registerkarte API-Zuweisungen auf API-Zuweisungen konfigurieren.
-
Geben Sie die API, die Stufe und den Pfad für die Zuweisung an.
-
Wählen Sie Save (Speichern) aus.
