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. # Endpunkte für Lambda-Webfunktionen Ein Endpunkt ist eine untergeordnete Ressource einer Webfunktion, die einen Netzwerkeingangspunkt für HTTP-Verkehr bereitstellt. Jeder Endpunkt enthält einen eindeutigen Domainnamen mit TLS und einen Authentifizierungstyp. Es verfügt auch über Einstellungen für geografische Reichweite, Skalierung, Drosselung und Datenverkehrs-Routing. Eine Webfunktion kann bis zu 10 Endpunkte mit jeweils unabhängiger Konfiguration haben. In den folgenden Abschnitten werden Endpunkttypen, Domainnamen, Authentifizierung und Replikation erläutert. Informationen zu Einstellungen für Skalierung und Drosselung finden Sie unter. [Skalierungsverhalten für Lambda Web Functions](web-functions-scaling.md) Informationen zu den Modi für die automatische Bereitstellung und zum Routing des Datenverkehrs finden Sie unter[Bereitstellungsmuster](web-functions-deployment.md). ## Endpunkttypen Der Endpunkttyp bestimmt, wie Lambda Ihre Webfunktion bereitstellt AWS-Regionen und wie der Datenverkehr dorthin geleitet wird. Sie wählen den Endpunkttyp aus, wenn Sie den Endpunkt erstellen. Der Endpunkttyp kann nach der Erstellung nicht geändert werden. **HomeRegion** Führt Ihre Webfunktion in einer einzigen aus AWS-Region. Lambda bedient Anfragen aus der Region, in der Sie den Endpunkt erstellt haben. Lambda weist dem Endpunkt einen einzelnen regionalen Domainnamen zu. Verwenden Sie dies **HomeRegion**für Anwendungen, für die keine Verfügbarkeit in mehreren Regionen erforderlich ist, oder wenn Sie mit der einfachsten Konfiguration beginnen möchten. **MultiRegion** Führt Ihre Webfunktion in mehreren AWS-Regionen Schritten aus. Sie geben die Zielregionen an, wenn Sie den Endpunkt erstellen. Lambda fügt die Heimatregion automatisch hinzu. Der Endpunkt muss mindestens eine weitere Region enthalten. Um den Verkehr an eine Revision weiterzuleiten, legen Sie die Revisionsgewichte des Endpunkts fest. Lambda repliziert dann Ihren Code und Ihre Konfiguration automatisch in alle angegebenen Regionen. Lambda weist einen einzigen globalen Domainnamen zu. Es verwendet latenzbasiertes Routing, um jede Anfrage an die Region zu senden, die normalerweise die niedrigste Latenz für den Anrufer bietet. Lambda führt kein auf Integrität basierendes Failover durch. Sie verwalten die Webfunktion von einer einzigen Heimatregion aus. Lambda kümmert sich um die Replikation in die anderen Regionen. Clients stellen eine Verbindung zu einem Domainnamen her. Wird **MultiRegion**für globale Anwendungen verwendet, die eine geringe Latenz für Benutzer an mehreren geografischen Standorten benötigen. **PerRegion** Führt Ihre Webfunktion in mehreren aus AWS-Regionen, mit einem separaten regionalen Domainnamen in jeder Region. Sie geben die Zielregionen an, wenn Sie den Endpunkt erstellen. Lambda fügt die Heimatregion automatisch hinzu. Der Endpunkt muss mindestens eine weitere Region enthalten. Lambda richtet den Endpunkt in jeder angegebenen Region automatisch ein. Jede Region hat ihren eigenen unabhängigen Domainnamen. Im **MultiRegion**Gegensatz dazu führt Lambda kein automatisches latenzbasiertes Routing durch. Sie verwalten, wie der Verkehr die einzelnen regionalen Domänen erreicht, z. B. mit Ihrer eigenen Route-53-Routing-Richtlinie oder einer Verteilung. CloudFront Verwenden Sie diese Option, **PerRegion**wenn Sie die Kontrolle über die Routing-Entscheidungen pro Region benötigen, z. B. um geografische Einschränkungen, benutzerdefinierte Failover-Logik oder Region-specific Verkehrsrichtlinien zu implementieren. Die Regionen und der Endpunkttyp können nach der Erstellung nicht aktualisiert werden. Um diese zu ändern, erstellen Sie einen neuen Endpunkt mit der gewünschten Konfiguration, migrieren Sie den Datenverkehr auf den Domainnamen des neuen Endpunkts und löschen Sie dann den alten Endpunkt. Einzelheiten darüber, wie Lambda Ihre Webfunktion regionsübergreifend repliziert und den Verkehr weiterleitet, finden Sie unter. [Multi-Region Einsatz](web-functions-endpoint-replication.md) ## Domainname Lambda weist jedem Endpunkt einen eindeutigen Domainnamen zu, wenn Sie ihn erstellen. Clients senden HTTPS-Anfragen an diese Domain, um Ihre Webfunktion aufzurufen. Die Domain unterstützt HTTPS und Lambda verwaltet das TLS-Zertifikat für die Domain. Sie erstellen, erneuern oder verwalten Zertifikate nicht selbst. Das Format des Domainnamens hängt vom Endpunkttyp ab: + **HomeRegion**und **PerRegion**— Jede Region hat eine Domain im folgenden Format: ``` {{domain-id}}.{{shard-id}}.lambda-web.{{region}}.on.aws ``` Beispiel: `bcdfghjklmnpqrst.b7t.lambda-web.ap-northeast-3.on.aws` + **MultiRegion**— Eine einzige globale Domain im Format: ``` {{domain-id}}.lambda-web.global.on.aws ``` Beispiel: `bcdfghjklmn.lambda-web.global.on.aws` Lambda verwendet latenzbasiertes Routing, um für jeden Client eine Region auszuwählen. Sie können den Domainnamen aus der `GetWebFunctionEndpoint` Antwort oder von der Lambda-Konsole abrufen, nachdem der Endpunkt den Status **Aktiv** erreicht hat. **Anmerkung** Webfunktions-Endpunkte unterstützen das direkte Anhängen eines benutzerdefinierten Domainnamens nicht. Clients, die die Domäne des Endpunkts aufrufen, müssen den Lambda-allocated Domainnamen verwenden. Um Traffic auf Ihrer eigenen Domain bereitzustellen, stellen Sie eine CloudFront Amazon-Distribution vor den Endpunkt und verwenden Sie den Lambda-allocated Domainnamen als Ursprung. ## Authentifizierungstyp Die `authType` Einstellung steuert, ob Lambda eingehende HTTP-Anfragen authentifiziert, bevor sie an Ihre Anwendung weitergeleitet werden. Sie können diese Einstellung auf einem vorhandenen Endpunkt aktualisieren. **ApplicationManaged** Lambda authentifiziert eingehende Anfragen nicht. Alle HTTP-Anfragen werden direkt an Ihre Anwendung weitergeleitet. Sie sind für die Authentifizierung in Ihrem Anwendungscode verantwortlich. **IamAuth** Lambda validiert die Signatur jeder Anfrage. Signieren Sie Anfragen mit AWS Signature Version 4 (Sigv4) für **PerRegion**Domains **HomeRegion**und mit Signature Version 4a (SigV4a) für eine globale Domain. **MultiRegion** Nur Anrufer mit der entsprechenden `lambda:InvokeWebFunctionEndpoint` Berechtigung können den Endpunkt aufrufen. Vollständige Informationen zur Authentifizierung, einschließlich CloudFront Integrations- und ressourcenbasierter Richtlinien, finden Sie unter. [Endpunktzugriffskontrolle mit Lambda Web Function](web-functions-endpoint-access-control.md) ## Auto-deployment Modus Die `autoDeploymentMode` Einstellung steuert, ob Lambda bei jeder Bereitstellung Ihrer Anwendung den Datenverkehr automatisch an neue Versionen weiterleitet. Sie können diese Einstellung auf einem vorhandenen Endpunkt aktualisieren. Wenn Sie `autoDeploymentMode` in einer API-Anfrage weglassen, wird standardmäßig auf. `Disabled` Die Lambda-Konsole und die `aws lambda-web deploy` Befehlsverwendung `LatestRevision` für neue `HomeRegion` Endpunkte. `LatestRevision`wird nur für `HomeRegion` Endgeräte unterstützt, weshalb Endpunkte immer `MultiRegion` verwendet `PerRegion` werden. `Disabled` Geben Sie bei Verwendung `Disabled` `revisionWeights` die Gesamtzahl von 100 an. **LatestRevision** Lambda leitet automatisch 100% des Datenverkehrs an die neueste aktive Version weiter. Wird für Entwicklungs- und Staging-Umgebungen verwendet. LatestRevision Der Modus ist nur für **HomeRegion**Endpoints verfügbar. **Deaktiviert** Lambda ändert das Traffic-Routing nicht, wenn Sie eine neue Revision erstellen. Sie steuern das Routing manuell mit Revisionsgewichten. Wird für Produktionsumgebungen verwendet. Der deaktivierte Modus ist für alle Endpunkttypen verfügbar. **MultiRegion**und **PerRegion**Endgeräte verwenden immer den deaktivierten Modus. Einzelheiten zu Bereitstellungsmustern, Rollback und Moduswechselverhalten finden Sie unter. [Bereitstellungsmuster](web-functions-deployment.md) ## Skalierung und Drosselung Jeder Endpunkt verfügt über Skalierungs- und Drosselungseinstellungen, die die Kapazität steuern. Sie können diese Einstellungen auf einem vorhandenen Endpunkt mit aktualisieren. `update-web-function-endpoint` Lassen Sie den aktuellen Wert `--throttle-config` weg `--scaling-config` oder behalten Sie ihn bei, oder übergeben Sie ein leeres Objekt (`'{}'`), um einen zuvor festgelegten Wert zu löschen. Um eine Ratenbegrenzung aufzuheben, übergeben Sie ein leeres `--throttle-config` Objekt. Ein `rateLimit` Wert von 0 blockiert den gesamten Verkehr. + **`maxEnvironments`** – Optional. Die maximale Anzahl von Ausführungsumgebungen für den Endpunkt in jeder Region. Wenn nicht festgelegt, wird der Endpunkt nach Bedarf innerhalb der Kontokontingente skaliert. + **`rateLimit`**— Maximale Anzahl von Anfragen pro Sekunde. Diese Einstellung ist optional. Wenn es nicht festgelegt ist, wird der Endpunkt durch das Kontingent für die Anforderungsrate pro Endpunkt von 10.000 RPS und durch die Kontokontingente begrenzt. Das Ratenlimit gilt für den gesamten Endpunkt und für alle Ausführungsumgebungen. Es handelt sich nicht um ein Limit pro Umgebung. Für **MultiRegion**PerRegion****Endgeräte setzt jede Region das Limit unabhängig voneinander durch. Überschüssige Anfragen erhalten HTTP 429. Einzelheiten dazu, wie diese Einstellungen mit der Parallelität auf Revisionsebene interagieren, sowie Anleitungen zur Auswahl von Werten finden Sie unter. [Skalierungsverhalten für Lambda Web Functions](web-functions-scaling.md) ## Endgeräte erstellen und verwalten ### Erstellen eines Endpunkts **Um einen HomeRegion Endpunkt zu erstellen (AWS CLI)** + ``` aws lambda-web create-web-function-endpoint \ --function-name {{my-web-app}} \ --endpoint-name {{my-endpoint}} \ --endpoint-type HomeRegion \ --auth-type ApplicationManaged \ --auto-deployment-mode LatestRevision ``` **Um einen MultiRegion Endpunkt zu erstellen (AWS CLI)** + ``` aws lambda-web create-web-function-endpoint \ --function-name {{my-web-app}} \ --endpoint-name {{my-global-endpoint}} \ --endpoint-type MultiRegion \ --regions {{us-east-1}} {{eu-west-1}} {{ap-northeast-1}} \ --auth-type ApplicationManaged \ --revision-weights '[{"revisionId": "{{rev-a1b2c}}", "weight": 100}]' ``` MultiRegion und PerRegion Endpunkte erfordern Revisionsgewichte, da die **LatestRevision**automatische Bereitstellung für sie nicht verfügbar ist. Weitere Informationen finden Sie unter [Bereitstellungsmuster](web-functions-deployment.md). ### Auflisten von Endpunkten ``` aws lambda-web list-web-function-endpoints \ --function-name {{my-web-app}} ``` Die Antwort umfasst den Namen, den Typ, den Domänennamen, den Status und die Konfiguration jedes Endpunkts. ### Endpunktdetails abrufen ``` aws lambda-web get-web-function-endpoint \ --function-name {{my-web-app}} \ --endpoint-name {{my-endpoint}} ``` Die Antwort umfasst den Domainnamen, den Status, den Authentifizierungstyp, den automatischen Bereitstellungsmodus, die Skalierungseinstellungen, die Revisionsgewichte `MultiRegion` und (für `PerRegion` Endpunkte) den Status und den Aktualisierungsstatus jeder Region im `regionalEndpoints` Feld. ### Aktualisierung eines Endpunkts Sie können die folgenden Eigenschaften auf einem vorhandenen Endpunkt aktualisieren: + `description` + `authType` + `autoDeploymentMode` + `revisionWeights` + `scalingConfig` + `throttleConfig` Sie *können die folgenden Eigenschaften nicht* aktualisieren. Um diese zu ändern, erstellen Sie einen neuen Endpunkt mit der gewünschten Konfiguration, migrieren Sie den Datenverkehr auf den Domainnamen des neuen Endpunkts und löschen Sie dann den alten Endpunkt. + `endpointType` (HomeRegion, MultiRegion, PerRegion) + `regions`(die Zielregionen des Endpunkts) ### Löschen eines Endpunkts ``` aws lambda-web delete-web-function-endpoint \ --function-name {{my-web-app}} \ --endpoint-name {{my-endpoint}} ``` Wenn Sie einen Endpunkt löschen, wechselt er in den Status **Löschen**. Lambda beendet die Weiterleitung neuer Anfragen an den Endpunkt und zieht seinen Domainnamen zurück. Für einen `PerRegion` Endpunkt stellt Lambda den Domainnamen in jeder Region zurück. Lambda weist die Domainnamen eines gelöschten Endpunkts in keinem Konto einem anderen Endpunkt zu. Lambda leitet Anfragen während des Fluges ab. Es ermöglicht die Fertigstellung von Anfragen, die bereits in Bearbeitung sind, und lehnt neue Anfragen an die Domainnamen des Endpunkts ab. Für `MultiRegion` `PerRegion` Endpunkte entfernt Lambda den Endpunkt aus allen Regionen. Nach Abschluss des Löschvorgangs entfernt Lambda den Endpunkt dauerhaft. Durch das Löschen eines Endpunkts werden weder die Webfunktion noch ihre Revisionen gelöscht. Revisionen stehen weiterhin für die Verwendung durch andere Endpunkte zur Verfügung.