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.

Lambda-Funktion erstellen und verwalten URLs

Eine Funktion URL ist ein dedizierter HTTP (S) -Endpunkt für Ihre Lambda-Funktion. Sie können eine Funktion URL über die Lambda-Konsole oder das API Lambda erstellen und konfigurieren. Wenn Sie eine Funktion erstellenURL, generiert Lambda automatisch einen eindeutigen URL Endpunkt für Sie. Sobald Sie eine Funktion erstellt habenURL, ändert sich ihr URL Endpunkt nie. URLFunktionsendpunkte haben das folgende Format:

https://<url-id>.lambda-url.<region>.on.aws

Function URLs ist Dual-Stack-fähig und unterstützt und. IPv4 IPv6 Nachdem Sie eine Funktion URL für Ihre Funktion konfiguriert haben, können Sie Ihre Funktion über ihren HTTP (S) -Endpunkt über einen Webbrowser, Curl, Postman oder einen beliebigen Client aufrufen. HTTP

Die Lambda-Funktion URLs verwendet ressourcenbasierte Richtlinien für Sicherheit und Zugriffskontrolle. Die Funktion unterstützt URLs auch ursprungsübergreifende Konfigurationsoptionen für die gemeinsame Nutzung von Ressourcen ()CORS.

Sie können die Funktion URLs auf jeden Funktionsalias oder auf die $LATEST unveröffentlichte Funktionsversion anwenden. Sie können eine Funktion URL keiner anderen Funktionsversion hinzufügen.

Der folgende Abschnitt zeigt, wie Sie eine Funktion URL mithilfe der Lambda-Konsole AWS CLI, und -Vorlage erstellen und AWS CloudFormation verwalten

Eine Funktion URL (Konsole) erstellen

Gehen Sie wie folgt vor, um eine Funktion URL mithilfe der Konsole zu erstellen.

Eine Funktion erstellen URL (AWS CLI)

Führen Sie den folgenden Befehl aus, um mit der AWS Command Line Interface (AWS CLI) eine Funktion URL für eine bestehende Lambda-Funktion zu erstellen:

aws lambda create-function-url-config \
    --function-name my-function \
    --qualifier prod \ // optional
    --auth-type AWS_IAM
    --cors-config {AllowOrigins="https://example.com"} // optional

Dadurch wird dem prod Qualifier für URL die Funktion eine Funktion hinzugefügt. my-function Weitere Informationen zu diesen Konfigurationsparametern finden Sie CreateFunctionUrlConfigin der API Referenz.

Eine Funktion URL zu einer CloudFormation Vorlage hinzufügen

Verwenden Sie die folgende Syntax, um Ihrer AWS CloudFormation Vorlage eine AWS::Lambda::Url Ressource hinzuzufügen:

JSON

{
  "Type" : "AWS::Lambda::Url",
  "Properties" : {
      "AuthType" : String,
      "Cors" : Cors,
      "Qualifier" : String,
      "TargetFunctionArn" : String
    }
}

YAML

Type: AWS::Lambda::Url
Properties: 
  AuthType: String
  Cors: 
    Cors
  Qualifier: String
  TargetFunctionArn: String

Parameter

Quellenübergreifende gemeinsame Nutzung von Ressourcen () CORS

Um zu definieren, wie verschiedene Quellen auf Ihre Funktion zugreifen könnenURL, verwenden Sie Cross-Origin Resource Sharing () CORS. Wir empfehlen die KonfigurationCORS, wenn Sie Ihre Funktion URL von einer anderen Domain aus aufrufen möchten. Lambda unterstützt die folgenden CORS Header für die Funktion. URLs

Wenn Sie URL mit der Lambda-Konsole oder der eine Funktion konfigurieren CORS AWS CLI, fügt Lambda über die Funktion automatisch die CORS Header zu allen Antworten hinzu. URL Alternativ können Sie Ihrer Funktionsantwort manuell CORS Header hinzufügen. Bei widersprüchlichen Headern hängt das erwartete Verhalten von der Art der Anfrage ab:

Im Allgemeinen empfehlen wir, alle CORS Einstellungen der Funktion zu konfigurierenURL, anstatt CORS Header manuell in der Funktionsantwort zu senden.

Drosselungsfunktion URLs

Die Drosselungsrate begrenzt die Geschwindigkeit, mit der Ihre Funktion Anfragen verarbeitet. Dies ist in vielen Situationen nützlich, z. B. um zu verhindern, dass Ihre Funktion nachgelagerte Ressourcen überlastet, oder beim Verarbeiten eines plötzlichen Anstiegs der Anfragen.

Sie können die Rate der Anfragen, die Ihre Lambda-Funktion über eine Funktion verarbeitet, drosseln, URL indem Sie reservierte Parallelität konfigurieren. Reservierte Gleichzeitigkeit begrenzt die Anzahl der maximalen gleichzeitigen Aufrufe für Ihre Funktion. Die maximale Anforderungsrate pro Sekunde (RPS) Ihrer Funktion entspricht dem Zehnfachen der konfigurierten reservierten Parallelität. Wenn Sie Ihre Funktion beispielsweise mit einer reservierten Parallelität von 100 konfigurieren, RPS beträgt der Höchstwert 1.000.

Immer wenn die Parallelität Ihrer Funktion die reservierte Parallelität überschreitet, gibt Ihre Funktion einen URL HTTP 429 Statuscode zurück. Wenn Ihre Funktion aufgrund Ihrer konfigurierten reservierten Parallelität eine Anforderung empfängt, die das 10-fache RPS Maximum überschreitet, erhalten Sie ebenfalls eine Fehlermeldung. HTTP 429 Weitere Hinweise zur reservierten Gleichzeitigkeit finden Sie unter Reservierte Parallelität für eine Funktion konfigurieren.

Funktion wird deaktiviert URLs

In einem Notfall möchten Sie möglicherweise den gesamten Datenverkehr zu Ihrer Funktion URL zurückweisen. Um Ihre Funktion zu deaktivierenURL, setzen Sie die reservierte Parallelität auf Null. Dadurch werden alle Anfragen an Ihre Funktion gedrosseltURL, was zu Statusantworten führt. HTTP 429 Um Ihre Funktion wieder zu aktivierenURL, löschen Sie die reservierte Parallelitätskonfiguration oder setzen Sie die Konfiguration auf einen Wert größer als Null.

Funktion wird gelöscht URLs

Wenn Sie eine Funktion löschenURL, können Sie sie nicht wiederherstellen. Das Erstellen einer neuen Funktion URL führt zu einer anderen URL Adresse.