Wählen Sie Ihre Cookie-Einstellungen aus

Wir verwenden essentielle Cookies und ähnliche Tools, die für die Bereitstellung unserer Website und Services erforderlich sind. Wir verwenden Performance-Cookies, um anonyme Statistiken zu sammeln, damit wir verstehen können, wie Kunden unsere Website nutzen, und Verbesserungen vornehmen können. Essentielle Cookies können nicht deaktiviert werden, aber Sie können auf „Anpassen“ oder „Ablehnen“ klicken, um Performance-Cookies abzulehnen.

Wenn Sie damit einverstanden sind, verwenden AWS und zugelassene Drittanbieter auch Cookies, um nützliche Features der Website bereitzustellen, Ihre Präferenzen zu speichern und relevante Inhalte, einschließlich relevanter Werbung, anzuzeigen. Um alle nicht notwendigen Cookies zu akzeptieren oder abzulehnen, klicken Sie auf „Akzeptieren“ oder „Ablehnen“. Um detailliertere Entscheidungen zu treffen, klicken Sie auf „Anpassen“.

Ordnen Sie API-Stufen einem benutzerdefinierten Domainnamen zu für WebSocket APIs

Fokusmodus
Ordnen Sie API-Stufen einem benutzerdefinierten Domainnamen zu für WebSocket APIs - 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.

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. Nachdem Sie einen Domainnamen erstellt und DNS-Einträge konfiguriert haben, verwenden Sie API-Zuordnungen, um Traffic APIs über Ihren benutzerdefinierten Domainnamen an Sie zu senden.

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 wss://api.example.com/orders abbilden.

Bevor Sie eine API-Zuweisung 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.

Einschränkungen

  • Bei einer API-Zuordnung müssen sich der benutzerdefinierte Domainname und der zugeordnete Domainname im APIs selben Konto befinden. AWS

  • 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.

  • Sie können nicht demselben benutzerdefinierten Domainnamen wie eine HTTP-API oder REST-API zuordnen. WebSocket APIs

  • 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 Management Console
So erstellen Sie eine API-Zuweisung
  1. Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan.

  2. Wählen Sie benutzerdefinierte Domain-Namen aus.

  3. Wählen Sie einen benutzerdefinierten Domain-Namen aus, den Sie bereits erstellt haben.

  4. Wählen Sie API-Mappings aus.

  5. Wählen Sie API-Zuordnungen konfigurieren aus.

  6. Wählen Sie Neue Zuordnung hinzufügen aus.

  7. Geben Sie eine API, eine Phase und optional einen Pfad ein.

  8. Wählen Sie Save (Speichern) aus.

AWS CLI

Mit dem folgenden create-api-mapping-Befehl wird ein API-Mapping erstellt. In diesem Beispiel sendet API Gateway Anforderungen an api.example.com/v1 an die angegebene API und Phase.

aws apigatewayv2 create-api-mapping \ --domain-name api.example.com \ --api-mapping-key v1 \ --api-id a1b2c3d4 \ --stage test
AWS CloudFormation

Im folgenden AWS CloudFormation Beispiel wird eine API-Zuordnung erstellt.

MyApiMapping: Type: 'AWS::ApiGatewayV2::ApiMapping' Properties: DomainName: api.example.com ApiMappingKey: 'v1' ApiId: !Ref MyApi Stage: !Ref MyStage
So erstellen Sie eine API-Zuweisung
  1. Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan.

  2. Wählen Sie benutzerdefinierte Domain-Namen aus.

  3. Wählen Sie einen benutzerdefinierten Domain-Namen aus, den Sie bereits erstellt haben.

  4. Wählen Sie API-Mappings aus.

  5. Wählen Sie API-Zuordnungen konfigurieren aus.

  6. Wählen Sie Neue Zuordnung hinzufügen aus.

  7. Geben Sie eine API, eine Phase und optional einen Pfad ein.

  8. Wählen Sie Save (Speichern) aus.

DatenschutzNutzungsbedingungen für die WebsiteCookie-Einstellungen
© 2025, Amazon Web Services, Inc. oder Tochtergesellschaften. Alle Rechte vorbehalten.