Voraussetzungen Erstellen einer Lambda-Funktion mit der Konsole Aufrufen der Lambda-Funktion mithilfe der Konsole Bereinigen Zusätzliche Ressourcen und nächste Schritte

Erste Schritte mit Lambda

für Ihre ersten Schritte mit Lambda verwenden Sie die Lambda-Konsole, um eine Funktion zu erstellen. In wenigen Minuten können Sie eine Funktion erstellen und bereitstellen und sie in der Konsole testen.

Bei der Durchführung des Tutorials lernen Sie einige grundlegende Lambda-Konzepte kennen, z. B. wie Sie Argumente an Ihre Funktion mithilfe des Lambda-Ereignisobjekts übergeben. Außerdem erfahren Sie, wie Sie Protokollausgaben Ihrer Funktion zurückgeben und wie Sie die Aufrufprotokolle Ihrer Funktion in CloudWatch Logs anzeigen.

Der Einfachheit halber erstellen Sie Ihre Funktion entweder mit der Python- oder Node.js-Laufzeit. Mit diesen interpretierten Sprachen können Sie Funktionscode direkt im integrierten Code-Editor der Konsole bearbeiten. Bei kompilierten Sprachen wie Java und C# müssen Sie ein Bereitstellungspaket auf Ihrem lokalen Build-Rechner erstellen und es in Lambda hochladen. Weitere Informationen zum Bereitstellen von Funktionen in Lambda mithilfe anderer Laufzeiten finden Sie unter den Links im Abschnitt Zusätzliche Ressourcen und nächste Schritte.

Tipp

Weitere Informationen zum Erstellen von Serverless-Lösungen finden Sie im Serverless-Benutzerhandbuch.

Voraussetzungen

Wenn Sie kein AWS-Konto haben, führen Sie die folgenden Schritte zum Erstellen durch.

Anmeldung für ein AWS-Konto

Öffnen Sie https://portal.aws.amazon.com/billing/signup.
Folgen Sie den Online-Anweisungen.

Bei der Anmeldung müssen Sie auch einen Telefonanruf entgegennehmen und einen Verifizierungscode über die Telefontasten eingeben.

Wenn Sie sich für ein AWS-Konto anmelden, wird ein Root-Benutzer des AWS-Kontos erstellt. Der Stammbenutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Methode zur Gewährleistung der Sicherheit sollten Sie den administrativen Zugriff einem administrativen Benutzer zuweisen und nur den Root-Benutzer verwenden, um Aufgaben auszuführen, die einen Root-Benutzerzugriff erfordern.

AWS sendet Ihnen eine Bestätigungs-E-Mail, sobald die Registrierung abgeschlossen ist. Sie können jederzeit Ihre aktuelle Kontoaktivität anzeigen und Ihr Konto verwalten. Rufen Sie dazu https://aws.amazon.com/ auf und klicken Sie auf Mein Konto.

Nachdem Sie sich für ein AWS-Konto registriert haben, erstellen Sie einen Administratorbenutzer, damit Sie nicht den Root-Benutzer für alltägliche Aufgaben verwenden.

Schützen Ihres Root-Benutzer des AWS-Kontos

Melden Sie sich bei der AWS Management Console als Kontobesitzer an, indem Sie Stammbenutzer auswählen und Ihre AWS-Konto-E-Mail-Adresse eingeben. Geben Sie auf der nächsten Seite Ihr Passwort ein.

Hilfe bei der Anmeldung mit dem Root-Benutzer finden Sie unter Anmelden als Root-Benutzer im Benutzerhandbuch zu AWS-Anmeldung.
Aktivieren Sie die Multi-Faktor-Authentifizierung (MFA) für den Root-Benutzer.

Anweisungen dazu finden Sie unter Aktivieren eines virtuellen MFA-Geräts für den Root-Benutzer Ihres AWS-Konto (Konsole) im IAM-Benutzerhandbuch.

Einen Administratorbenutzer erstellen

Weisen Sie einem Administratorbenutzer in AWS IAM Identity Center (successor to AWS Single Sign-On) Administratorzugriff für Ihre täglichen administrativen Aufgaben zu.

Anleitungen dazu finden Sie unter Erste Schritte im AWS IAM Identity Center (successor to AWS Single Sign-On)-Benutzerhandbuch.

Als Administratorbenutzer anmelden

Um sich mit Ihrem IAM-Identity-Center-Benutzer anzumelden, verwenden Sie die Anmelde-URL, die an Ihre E-Mail-Adresse gesendet wurde, als Sie den IAM-Identity-Center-Benutzer erstellt haben.

Hilfe bei der Anmeldung mit einem IAM-Identity-Center-Benutzer finden Sie unter Anmelden beim AWS-Zugangsportal im Benutzerhandbuch zu AWS-Anmeldung.

Erstellen einer Lambda-Funktion mit der Konsole

In diesem Beispiel besitzt Ihre Funktion ein JSON-Objekt, das zwei ganzzahlige Werte mit der Bezeichnung "length" und "width" enthält. Die Funktion multipliziert diese Werte, um eine Fläche zu berechnen, und gibt diese als JSON-Zeichenfolge zurück.

Ihre Funktion gibt auch den berechneten Bereich zusammen mit dem Namen ihrer CloudWatch-Protokollgruppe aus. Später im Tutorial erfahren Sie, wie Sie mit CloudWatch Logs Aufzeichnungen über den Aufruf Ihrer Funktionen anzeigen.

Um Ihre Funktion zu erstellen, erstellen Sie zunächst mit der Konsole eine grundlegende Hello-World-Funktion. Im folgenden Schritt fügen Sie dann Ihren eigenen Funktionscode hinzu.

So erstellen Sie eine Hello-World-Lambda-Funktion mit der Konsole

Öffnen Sie die Seite Funktionen der Lambda-Konsole.
Wählen Sie Create function (Funktion erstellen).
Wählen Sie Verfassen von Grund auf aus.
Geben Sie im Bereich Grundlegende Informationen als Funktionsname myLambdaFunction ein.
Wählen Sie als Laufzeit entweder Node.js 18.x oder Python 3.11
Belassen Sie die Architektur auf x86_64 und wählen Sie Funktion erstellen.

Lambda erstellt eine Funktion, die die Nachricht Hello from Lambda! zurückgibt. Lambda erstellt außerdem eine Ausführungsrolle für Ihre Funktion. Eine Ausführungsrolle ist eine AWS Identity and Access Management (IAM)-Rolle, die einer Lambda-Funktion die Berechtigung zum Zugriff auf AWS-Services und Ressourcen gewährt. Für Ihre Funktion gewährt die von Lambda erstellte Rolle grundlegende Berechtigungen zum Schreiben in CloudWatch Logs.

Sie verwenden nun den integrierten Code-Editor der Konsole, um den von Lambda erstellten Hello-World-Code durch Ihren eigenen Funktionscode zu ersetzen.

Node.js

So ändern Sie den Code in der Konsole

Wählen Sie die Registerkarte Code (Code).

Im integrierten Code-Editor der Konsole sollten Sie den von Lambda erstellten Funktionscode sehen. Wenn die Registerkarte index.mjs im Code-Editor nicht angezeigt wird, wählen Sie index.mjs im Datei-Explorer aus, wie im folgenden Diagramm gezeigt.

Fügen Sie den folgenden Code in die Registerkarte index.mjs ein und ersetzen Sie den von Lambda erstellten Code.


export const handler = async (event, context) => {
  
  const length = event.length;
  const width = event.width;
  var area = calculateArea(length, width);
  console.log(`The area is ${area}`);
        
  console.log('CloudWatch log group: ', context.logGroupName);
  
  const data = {
    "area": area,
  };
    return JSON.stringify(data);
    
  function calculateArea(length, width) {
    return length * width;
  }
};

Wählen Sie Bereitstellen aus, um den Code Ihrer Funktion zu aktualisieren. Wenn Lambda die Änderungen bereitgestellt hat, zeigt die Konsole ein Banner an, das Sie über die erfolgreiche Aktualisierung Ihrer Funktion informiert.

Den Funktionscode verstehen

Bevor Sie zum nächsten Schritt übergehen, sollten Sie sich einen Moment Zeit nehmen, um den Funktionscode zu betrachten und einige wichtige Lambda-Konzepte zu verstehen.

Der Lambda-Handler:

Ihre Lambda-Funktion enthält eine Node.js-Funktion mit dem Namen handler. Eine Lambda-Funktion in Node.js kann mehr als eine Node.js-Funktion enthalten, aber die Handler-Funktion ist immer der Einstiegspunkt in Ihren Code. Wenn Ihre Funktion aufgerufen wird, führt Lambda diese Methode aus.

Wenn Sie Ihre Hello-World-Funktion über die Konsole erstellt haben, hat Lambda den Namen der Handler-Methode für Ihre Funktion automatisch auf handler festgelegt. Achten Sie darauf, den Namen dieser Node.js-Funktion nicht zu bearbeiten. Andernfalls kann Lambda Ihren Code nicht ausführen, wenn Sie Ihre Funktion aufrufen.

Weitere Informationen zum Lambda-Handler in Node.js finden Sie unter AWS Lambda-Funktions-Handler in Node.js.
Das Lambda-Ereignisobjekt:

Die Funktion handler besitzt zwei Argumente, event und context. Ein Ereignis in Lambda ist ein JSON-formatiertes Dokument, das Daten enthält, die von Ihrer Funktion verarbeitet werden sollen.

Wenn Ihre Funktion von einem anderen AWS-Service aufgerufen wird, enthält das Ereignisobjekt Informationen über das Ereignis, das den Aufruf verursacht hat. Wenn beispielsweise ein Amazon Simple Storage Service (Amazon S3)-Bucket beim Hochladen eines Objekts Ihre Funktion aufruft, enthält das Ereignis den Namen des Amazon-S3-Buckets und den Objektschlüssel.

In diesem Beispiel erstellen Sie ein Ereignis in der Konsole, indem Sie ein JSON-formatiertes Dokument mit zwei Schlüssel-Wert-Paaren eingeben.
Das Lambda-Kontextobjekt:

Das zweite Argument, das Ihre Funktion besitzt, ist context. Lambda übergibt das Kontextobjekt automatisch an Ihre Funktion. Das Kontextobjekt enthält Informationen über den Aufruf der Funktion und die Ausführungsumgebung.

Mit dem Kontextobjekt können Sie zu Überwachungszwecken Informationen über den Aufruf Ihrer Funktion ausgeben. In diesem Beispiel verwendet Ihre Funktion den logGroupName-Parameter, um den Namen ihrer CloudWatch-Protokollgruppe auszugeben.

Weitere Informationen zum Lambda-Kontextobjekt in Node.js finden Sie unter AWS Lambda-Context-Objekt in Node.js.
Protokollierung in Lambda:

Mit Node.js können Sie Konsolenmethoden wie console.log und console.error verwenden, um Informationen an das Protokoll Ihrer Funktion zu senden. Der Beispielcode verwendet console.log-Anweisungen zur Ausgabe des berechneten Bereichs und des Namens der CloudWatch-Logs-Gruppe der Funktion. Sie können auch jede Protokollierungsbibliothek verwenden, die in stdout oder stderr schreibt.

Weitere Informationen hierzu finden Sie unter AWS Lambda-Funktionsprotokollierung in Node.js. Informationen zum Protokollieren in anderen Laufzeiten finden Sie auf den Seiten „Erstellen mit“ für die Laufzeiten, an denen Sie interessiert sind.

Python

So ändern Sie den Code in der Konsole

Wählen Sie die Registerkarte Code (Code).

Im integrierten Code-Editor der Konsole sollten Sie den von Lambda erstellten Funktionscode sehen. Wenn die Registerkarte lambda_function.py im Code-Editor nicht angezeigt wird, wählen Sie lambda_function.py im Datei-Explorer aus, wie im folgenden Diagramm dargestellt.

Fügen Sie den folgenden Code in die Registerkarte lambda_function.py ein und ersetzen Sie den von Lambda erstellten Code.


import json
import logging

logger = logging.getLogger()
logger.setLevel(logging.INFO)

def lambda_handler(event, context):
    
    # Get the length and width parameters from the event object. The 
    # runtime converts the event object to a Python dictionary
    length=event['length']
    width=event['width']
    
    area = calculate_area(length, width)
    print(f"The area is {area}")
        
    logger.info(f"CloudWatch logs group: {context.log_group_name}")
    
    # return the calculated area as a JSON string
    data = {"area": area}
    return json.dumps(data)
    
def calculate_area(length, width):
    return length*width

Wählen Sie Bereitstellen aus, um den Code Ihrer Funktion zu aktualisieren. Wenn Lambda die Änderungen bereitgestellt hat, zeigt die Konsole ein Banner an, das Sie über die erfolgreiche Aktualisierung Ihrer Funktion informiert.

Den Funktionscode verstehen

Bevor Sie zum nächsten Schritt übergehen, sollten Sie sich einen Moment Zeit nehmen, um den Funktionscode zu betrachten und einige wichtige Lambda-Konzepte zu verstehen.

Der Lambda-Handler:

Ihre Lambda-Funktion enthält eine Python-Funktion mit dem Namen lambda_handler. Eine Lambda-Funktion in Python kann mehr als eine Python-Funktion enthalten, aber die Handler-Funktion ist immer der Einstiegspunkt in Ihren Code. Wenn Ihre Funktion aufgerufen wird, führt Lambda diese Methode aus.

Wenn Sie Ihre Hello-World-Funktion über die Konsole erstellt haben, hat Lambda den Namen der Handler-Methode für Ihre Funktion automatisch auf lambda_handler festgelegt. Achten Sie darauf, den Namen dieser Python-Funktion nicht zu bearbeiten. Andernfalls kann Lambda Ihren Code nicht ausführen, wenn Sie Ihre Funktion aufrufen.

Weitere Informationen zum Lambda-Handler in Python finden Sie unter Lambda-Funktions-Handler in Python.
Das Lambda-Ereignisobjekt:

Die Funktion lambda_handler besitzt zwei Argumente, event und context. Ein Ereignis in Lambda ist ein JSON-formatiertes Dokument, das Daten enthält, die von Ihrer Funktion verarbeitet werden sollen.

Wenn Ihre Funktion von einem anderen AWS-Service aufgerufen wird, enthält das Ereignisobjekt Informationen über das Ereignis, das den Aufruf verursacht hat. Wenn beispielsweise ein Amazon Simple Storage Service (Amazon S3)-Bucket beim Hochladen eines Objekts Ihre Funktion aufruft, enthält das Ereignis den Namen des Amazon-S3-Buckets und den Objektschlüssel.

In diesem Beispiel erstellen Sie ein Ereignis in der Konsole, indem Sie ein JSON-formatiertes Dokument mit zwei Schlüssel-Wert-Paaren eingeben.
Das Lambda-Kontextobjekt:

Das zweite Argument, das Ihre Funktion besitzt, ist context. Lambda übergibt das Kontextobjekt automatisch an Ihre Funktion. Das Kontextobjekt enthält Informationen über den Aufruf der Funktion und die Ausführungsumgebung.

Mit dem Kontextobjekt können Sie zu Überwachungszwecken Informationen über den Aufruf Ihrer Funktion ausgeben. In diesem Beispiel verwendet Ihre Funktion den log_group_name-Parameter, um den Namen ihrer CloudWatch-Protokollgruppe auszugeben.

Weitere Informationen zum Lambda-Kontextobjekt in Python finden Sie unter AWS Lambda-Context-Objekt in Python.
Protokollierung in Lambda:

Mit Python können Sie entweder eine print-Anweisung oder eine Python-Protokollbibliothek verwenden, um Informationen an das Protokoll Ihrer Funktion zu senden. Um den Unterschied in der Erfassung zu veranschaulichen, werden im Beispielcode beide Methoden verwendet. In einer Produktionsanwendung empfehlen wir die Verwendung einer Protokollierungsbibliothek.

Weitere Informationen hierzu finden Sie unter AWS Lambda-Funktionsprotokollierung in Python. Informationen zum Protokollieren in anderen Laufzeiten finden Sie auf den Seiten „Erstellen mit“ für die Laufzeiten, an denen Sie interessiert sind.

Aufrufen der Lambda-Funktion mithilfe der Konsole

Um Ihre Funktion über die Lambda-Konsole aufzurufen, erstellen Sie zunächst ein Testereignis, das Sie an Ihre Funktion senden. Beim Ereignis handelt es sich um ein JSON-formatiertes Dokument, das zwei Schlüssel-Wert-Paare mit den Schlüsseln "length" und "width". enthält.

So erstellen Sie das Testereignis

Wählen Sie im Bereich Codequelle die Option Testen aus.
Wählen Sie Neues Ereignis erstellen.
Geben Sie für Ereignisname myTestEvent ein.
Ersetzen Sie im Bereich JSON-Ereignis die Standardwerte, indem Sie Folgendes einfügen:
```
{
  "length": 6,
  "width": 7
}
```
Wählen Sie Save (Speichern).

Sie testen nun Ihre Funktion und verwenden die Lambda-Konsole und CloudWatch Logs, um Aufzeichnungen des Aufrufs Ihrer Funktion anzuzeigen.

So testen Sie Ihre Funktion und zeigen die Aufrufdatensätze in der Konsole an

Wählen Sie im Bereich Codequelle die Option Testen aus. Wenn die Ausführung Ihrer Funktion abgeschlossen ist, werden die Antwort- und Funktionsprotokolle auf der Registerkarte Ausführungsergebnisse angezeigt. Sie sollten Ergebnisse ähnlich den folgenden sehen.

In diesem Beispiel haben Sie Ihren Code mithilfe des Test-Features der Konsole aufgerufen. Dies bedeutet, dass Sie die Ausführungsergebnisse Ihrer Funktion direkt in der Konsole anzeigen können. Wenn Ihre Funktion außerhalb der Konsole aufgerufen wird, müssen Sie CloudWatch Logs verwenden.

So zeigen Sie die Aufrufdatensätze Ihrer Funktion in CloudWatch Logs an

Öffnen Sie in der CloudWatch-Konsole die Seite Protokollgruppen.
Wählen Sie die Protokollgruppe für Ihre Funktion (/aws/lambda/myLambdaFunction) aus. Dies ist der Name der Protokollgruppe, den Ihre Funktion an die Konsole ausgegeben hat.

Wählen Sie auf der Registerkarte Protokollstreams den Protokollstream für den Aufruf Ihrer Funktion aus.

Die Ausgabe sollte folgendermaßen oder ähnlich aussehen:

Bereinigen

Wenn Sie mit der Beispielfunktion fertig sind, löschen Sie sie. Sie können auch die Protokollgruppe löschen, in der die Protokolle der Funktion gespeichert sind, sowie die von der Konsole erstellte Ausführungsrolle.

So löschen Sie eine Lambda-Funktion

Öffnen Sie die Seite Funktionen der Lambda-Konsole.
Wählen Sie eine Funktion aus.
Wählen Sie Actions (Aktionen), Delete (Löschen) aus.
Geben Sie im Dialogfenster Delete function (Funktion löschen) den Text löschen ein und wählen Sie anschließend Delete (Löschen) aus.

So löschen Sie die Protokollgruppe

Öffnen Sie in der CloudWatch-Konsole die Seite Protokollgruppen.
Wählen Sie die Protokollgruppe der Funktion () (/aws/lambda/my-function).
Wählen Sie Actions (Aktionen), Delete log group(s) (Protokollgruppe(n) löschen) aus.
Wählen Sie im Dialogfeld Delete log group(s) (Protokollgruppe(n) löschen) die Option Delete (Löschen) aus.

So löschen Sie die Ausführungsrolle

Öffnen Sie die Seite Rollen der AWS Identity and Access Management (IAM)-Konsole.
Wählen Sie die Ausführungsrolle der Funktion aus (zum Beispiel myLambdaFunction-role-31exxmpl).
Wählen Sie Delete (Löschen).
Geben Sie im Dialogfenster Delete role (Rolle löschen) den Namen der Rolle ein und wählen Sie anschließend Delete (Löschen) aus.

Sie können das Erstellen und Bereinigen von Funktionen, Rollen und Protokollgruppen mit AWS CloudFormation und AWS Command Line Interface (AWS CLI) automatisieren.

Zusätzliche Ressourcen und nächste Schritte

Nachdem Sie mit der Konsole eine einfache Lambda-Funktion erstellt und getestet haben, führen Sie die folgenden Schritte aus:

Erfahren Sie, wie Sie Ihrem Code Abhängigkeiten hinzufügen und diesen mithilfe eines ZIP-Bereitstellungspakets bereitstellen. Wählen Sie unter den folgenden Links die Sprachen aus, die Sie interessieren.

Node.js

Siehe Bereitstellen von Node.js Lambda-Funktionen mit ZIP-Dateiarchiven

Typescript

Siehe Bereitstellen von transpilierten TypeScript-Code in Lambda mit ZIP-Dateiarchiven

Python

Siehe Arbeiten mit ZIP-Dateiarchiven und Python-Lambda-Funktionen

Ruby

Siehe Arbeiten mit ZIP-Dateiarchiven für Ruby-Lambda-Funktionen

Java

Siehe Bereitstellen von Java-Lambda-Funktionen mit ZIP- oder JAR-Dateiarchiven

Go

Siehe Bereitstellen von Lambda-Go-Funktionen mit ZIP-Dateiarchiven

C#

Siehe Bereitstellen von Lambda-C#-Funktionen mit ZIP-Dateiarchiven
Führen Sie das Tutorial Verwenden eines Amazon-S3-Auslösers zum Aufrufen einer Lambda-Funktion durch, um zu erfahren, wie Sie eine Lambda-Funktion so konfigurieren, dass sie von einem anderen AWS-Service aufgerufen wird.
Wählen Sie eines der folgenden Tutorials für ein komplexeres Beispiel für die Verwendung von Lambda mit anderen AWS-Services.
- Verwenden von Lambda mit API Gateway: Erstellen Sie eine REST-API für Amazon API Gateway, die eine Lambda-Funktion aufruft.
- Verwenden einer Lambda-Funktion für den Zugriff auf eine Amazon-RDS-Datenbank: Verwenden Sie eine Lambda-Funktion, um Daten über den RDS-Proxy in eine Datenbank des Amazon Relational Database Service (Amazon RDS) zu schreiben.
- Verwenden eines Amazon-S3-Auslösers zum Erstellen von Miniaturbildern: Verwenden Sie eine Lambda-Funktion, um bei jedem Hochladen einer Image-Datei in einen Amazon-S3-Bucket ein Miniaturbild zu erstellen.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Was ist AWS Lambda?

Lambda-Grundlagen