Testen von Lambda-Funktionen mit Hilfe der Konsole - AWS Lambda
Aufrufen von Funktionen mit TestereignissenPrivate Testereignisse erstellenFreigabefähige Testereignisse erstellenLöschen von freigabefähigen Test-Ereignisschemas

Testen von Lambda-Funktionen mit Hilfe der Konsole

Sie können Ihre Lambda-Funktion in der Konsole testen, indem Sie Ihre Funktion mit einem Testereignis aufrufen. Ein Testereignis ist eine JSON-Eingabe für Ihre Funktion. Wenn Ihre Funktion keine Eingabe erfordert, kann das Ereignis ein leeres Dokument ({}) sein.

Wenn Sie einen Test in der Konsole ausführen, ruft Lambda Ihre Funktion synchron mit dem Testereignis auf. Die Funktionslaufzeit konvertiert das Ereignis-JSON in ein Objekt und übergibt es zur Verarbeitung an die Handler-Methode Ihres Codes.

Erstellen Sie ein Testereignis

Bevor Sie in der Konsole testen können, müssen Sie ein privates oder gemeinsam nutzbares Testereignis erstellen.

Aufrufen von Funktionen mit Testereignissen

So testen Sie eine Funktion

  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

  2. Klicken Sie auf den Namen der Funktion, die Sie testen möchten.

  3. Wählen Sie die Registerkarte Test.

  4. Wählen Sie unter Test event (Testereignis) die Option Create new event (Neues Ereignis erstellen) oder Edit saved event (Gespeichertes Ereignis bearbeiten) und dann das gespeicherte Ereignis aus, das Sie verwenden möchten.

  5. Optional — wählen Sie ein Template (Vorlage) für den Event-JSON.

  6. Wählen Sie Test aus.

  7. Erweitern Sie unter Execution result (Ausführungsergebnis) die Option Details, um die Testergebnisse anzuzeigen.

Um Ihre Funktion aufzurufen, ohne Ihr Testereignis zu speichern, wählen Sie Test (Testen) vor dem Speichern aus. Dadurch wird ein nicht gespeichertes Testereignis erstellt, das Lambda nur für die Dauer der Sitzung beibehält.

Für die Laufzeiten Node.js, Python und Ruby können Sie auf der Registerkarte Code auch auf Ihre gespeicherten und nicht gespeicherten Testereignisse zugreifen. Verwenden Sie den Abschnitt TESTEREIGNISSE, um Tests zu erstellen, zu bearbeiten und auszuführen.

Private Testereignisse erstellen

Private Testereignisse stehen nur dem Ereignisersteller zur Verfügung und benötigen keine zusätzlichen Berechtigungen zur Verwendung. Sie können bis zu 10 Testereignisse pro Funktion erstellen und speichern.

So erstellen Sie ein privates Testereignis

  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

  2. Klicken Sie auf den Namen der Funktion, die Sie testen möchten.

  3. Wählen Sie die Registerkarte Test.

  4. Erledigen Sie unter Testereignis Folgendes:

    1. Wählen Sie eine Vorlage.

    2. Geben Sie einen Namen für den Test an.

    3. Geben Sie im Texteingabefeld das JSON-Testereignis ein.

    4. Unter Ereignisfreigabeeinstellungen wählen Sie Privat aus.

  5. Wählen Sie Änderungen speichern aus.

Für die Laufzeiten von Node.js, Python und Ruby können Sie auf der Registerkarte Code auch Testereignisse erstellen. Verwenden Sie den Abschnitt TESTEREIGNISSE, um Tests zu erstellen, zu bearbeiten und auszuführen.

Freigabefähige Testereignisse erstellen

Freigabefähige Ereignisse sind Testereignisse, die Sie für andere Benutzer desselben AWS-Kontos freigeben können. Sie können die freigabefähigen Testereignisse anderer Benutzer bearbeiten und Ihre Funktion damit aufrufen.

Lambda speichert freigabefähige Testereignisse als Schemas in einer Amazon-EventBridge-(CloudWatch Events)-Schemaregistry namens lambda-testevent-schemas. Da Lambda diese Registry verwendet, um gemeinsam genutzte Testereignisse zu speichern und aufzurufen, empfehlen wir Ihnen nicht, diese Registry zu bearbeiten oder eine Registry mit dem Namen lambda-testevent-schemas zu erstellen.

Um freigabefähige Testereignisse anzeigen, freigeben und bearbeiten zu können, benötigen Sie Berechtigungen für alle folgenden EventBridge (CloudWatch Events)-API-Operationen:

Beachten Sie, dass das Speichern von Änderungen an einem freigabefähigen Testereignis dieses Ereignis überschreibt.

Wenn Sie keine freigabefähigen Testereignisse erstellen, bearbeiten oder anzeigen können, überprüfen Sie, ob Ihr Konto über die erforderlichen Berechtigungen für diese Operationen verfügt. Wenn Sie über die erforderlichen Berechtigungen verfügen, aber immer noch nicht auf freigabefähige Testereignisse zugreifen können, suchen Sie nach ressourcenbasierten Richtlinien, die möglicherweise den Zugriff auf die EventBridge (CloudWatch Events)-Registry einschränken.

So erstellen Sie ein freigabefähiges Testereignis

  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

  2. Klicken Sie auf den Namen der Funktion, die Sie testen möchten.

  3. Wählen Sie die Registerkarte Test.

  4. Erledigen Sie unter Testereignis Folgendes:

    1. Wählen Sie eine Vorlage.

    2. Geben Sie einen Namen für den Test an.

    3. Geben Sie im Texteingabefeld das JSON-Testereignis ein.

    4. Wählen Sie unter Event sharing settings (Ereignisfreigabeeinstellungen) Shareable (Freigabefähig) aus.

  5. Wählen Sie Änderungen speichern aus.

Verwenden Sie gemeinsam nutzbare Testereignisse mit AWS Serverless Application Model.

Sie können AWS SAM verwenden, um gemeinsam nutzbare Testereignisse aufzurufen. Siehe sam remote test-event im Entwicklerhandbuch für AWS Serverless Application Model

Löschen von freigabefähigen Test-Ereignisschemas

Wenn Sie freigabefähige Testereignisse löschen, entfernt Lambda sie aus der lambda-testevent-schemas-Registry. Wenn Sie das letzte freigabefähige Testereignis aus der Registry entfernen, löscht Lambda die Registry.

Wenn Sie die Funktion löschen, löscht Lambda keine verknüpften freigabefähigen Testereignisschemas. Sie müssen diese Ressourcen mit der EventBridge (CloudWatch Events)-Konsole manuell bereinigen.