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.

Über die Registerkarte Code können Sie auch auf Ihre gespeicherten und ungespeicherten Testereignisse zugreifen. Wählen Sie von dort Test (Testen) und anschließend Ihr Testereignis aus.

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.

Sie können auch neue Testereignisse auf der Registerkarte Code erstellen. Wählen Sie von dort Test aus, dann Testereignis konfigurieren.

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 gemeinsam nutzbare Testereignisse als Schemata in einer Amazon EventBridge (CloudWatch Events)-Schemaregistrierung mit dem Namen 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 anzuzeigen, freizugeben und zu bearbeiten, müssen Sie über Berechtigungen für alle folgenden EventBridge (CloudWatch Ereignisse) Schemaregistrierungs-API-Operationen verfügen:

• schemas.CreateRegistry

• schemas.CreateSchema

• schemas.DeleteSchema

• schemas.DeleteSchemaVersion

• schemas.DescribeRegistry

• schemas.DescribeSchema

• schemas.GetDiscoveredSchema

• schemas.ListSchemaVersions

• schemas.UpdateSchema

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 den Zugriff auf die EventBridge (CloudWatch Events)-Registrierung einschränken könnten.

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 manuell über die EventBridge (CloudWatch Events)-Konsole bereinigen.