View a markdown version of this page

Endpunkte für Lambda-Webfunktionen - AWS Lambda
EndpunkttypenDomainnameAuthentifizierungstypAuto-deployment ModusSkalierung und DrosselungEndgeräte erstellen und verwalten

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 Informationen zu den Modi für die automatische Bereitstellung und zum Routing des Datenverkehrs finden Sie unterBereitstellungsmuster.

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 HomeRegionfü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 MultiRegionfü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 MultiRegionGegensatz 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, PerRegionwenn 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

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:

  • HomeRegionund 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 PerRegionDomains HomeRegionund 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

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. LatestRevisionwird 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 HomeRegionEndpoints 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. MultiRegionund PerRegionEndgeräte verwenden immer den deaktivierten Modus.

Einzelheiten zu Bereitstellungsmustern, Rollback und Moduswechselverhalten finden Sie unter. Bereitstellungsmuster

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 MultiRegionPerRegionEndgerä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

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 LatestRevisionautomatische Bereitstellung für sie nicht verfügbar ist. Weitere Informationen finden Sie unter Bereitstellungsmuster.

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.