View a markdown version of this page

Verwendung von Tags für Zuordnungen von Ereignisquellen - AWS Lambda
Erforderliche Berechtigungen zum Arbeiten mit TagsVerwendung von Tags mit der KonsoleVerwenden von Tags mit AWS CLI

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.

Verwendung von Tags für Zuordnungen von Ereignisquellen

Sie können Zuordnungen von Ereignisquellen taggen, um Ihre Ressourcen zu organisieren und zu verwalten. Tags sind frei formulierte Schlüssel-Wert-Paare, die mit Ihren Ressourcen verknüpft sind und von AWS-Services unterstützt werden. Weitere Informationen zu Anwendungsfällen für Tags finden Sie unter Allgemeine Tagging-Strategien im AWS Tagging-Ressourcen- und Tag-Editor-Handbuch.

Zuordnungen von Ereignisquellen sind mit Funktionen verknüpft, die ihre eigenen Tags haben können. Zuordnungen von Ereignisquellen erben nicht automatisch Tags von Funktionen. Sie können die AWS Lambda API verwenden, um Tags anzuzeigen und zu aktualisieren. Sie können Tags auch anzeigen und aktualisieren, während Sie eine bestimmte Ereignisquellenzuordnung in der Lambda-Konsole verwalten, einschließlich solcher, die den Bereitstellungsmodus für Amazon SQS verwenden.

Erforderliche Berechtigungen zum Arbeiten mit Tags

Um einer AWS Identity and Access Management -(IAM)-Identität (Benutzer, Gruppe oder Rolle) das Lesen oder Setzen von Tags auf einer Ressource zu ermöglichen, gewähren Sie ihr die entsprechenden Berechtigungen:

  • lambda: ListTags — Wenn eine Ressource über Tags verfügt, gewähren Sie diese Berechtigung jedem, der sie aufrufen muss. ListTags Für Funktionen mit Tags ist diese Berechtigung auch für GetFunction erforderlich.

  • lambda: TagResource — Erteilen Sie diese Berechtigung jedem, der beim Erstellen eines Tags aufrufen TagResource oder ein Tag ausführen muss.

Erwägen Sie optional, auch die Lambda: UntagResource -Berechtigung zu gewähren, um UntagResource Aufrufe der Ressource zuzulassen.

Weitere Informationen finden Sie unter Identity-based IAM-Richtlinien für Lambda.

Verwendung von Tags mit der Lambda-Konsole

Sie können die Lambda-Konsole verwenden, um Ereignisquellenzuordnungen mit Tags zu erstellen, Tags zu vorhandenen Ereignisquellenzuordnungen hinzuzufügen und Ereignisquellenzuordnungen nach Tag zu filtern, einschließlich der Zuordnungen, die im Bereitstellungsmodus für Amazon SQS konfiguriert wurden.

Wenn Sie einen Auslöser für unterstützte Stream- und Warteschlangen-basierte Dienste über die Lambda-Konsole hinzufügen, erstellt Lambda automatisch eine Zuordnung von Ereignisquellen. Weitere Informationen zu diesen Ereignisquellen finden Sie unter Wie Lambda Datensätze aus Stream- und warteschlangenbasierten Ereignisquellen verarbeitet. Um eine Ereignisquellenzuordnung in der Konsole zu erstellen, benötigen Sie die folgenden Voraussetzungen:

  • Eine -Funktion

  • Eine Ereignisquelle von einem betroffenen Dienst.

Sie können die Tags als Teil derselben Benutzeroberfläche hinzufügen, die Sie zum Erstellen oder Aktualisieren von Triggern verwenden.

So fügen Sie ein Tag hinzu, wenn Sie eine Zuordnung von Ereignisquellen erstellen

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

  2. Wählen Sie den Namen Ihrer Funktion aus.

  3. Wählen Sie unter Function overview (Funktionsübersicht) die Option Add trigger (Trigger hinzufügen).

  4. Wählen Sie unter Auslöserkonfiguration in der Dropdownliste den Namen des Dienstes aus, aus dem Ihre Ereignisquelle stammt.

  5. Geben Sie die Kernkonfiguration für Ihre Ereignisquelle an. Weitere Informationen zur Konfiguration Ihrer Ereignisquelle finden Sie im Abschnitt für den entsprechenden Dienst unter Lambda mit Ereignissen aus anderen aufrufen AWS service.

  6. Wählen Sie unter Konfiguration der Zuordnung von Ereignisquellen die Option Zusätzliche Einstellungen aus.

  7. Wählen Sie unter Tags die Option Neuen Tag hinzufügen aus

  8. Geben Sie im Feld Schlüssel Ihren Tag-Schlüssel ein. Informationen zu Tagging-Einschränkungen finden Sie unter Einschränkungen und Anforderungen für Tag-Benennungen im AWS Tagging-Ressourcen- und Tag-Editor-Handbuch.

  9. Wählen Sie Hinzufügen aus.

So fügen Sie Tags zu einer bestehenden Zuordnung von Ereignisquellen hinzu

  1. Öffnen Sie die Zuordnungen von Ereignisquellen in der Lambda-Konsole.

  2. Wählen Sie aus der Ressourcenliste die UUID für die Zuordnung von Ereignisquellen aus, die Ihrem Funktions- und Ereignisquellen-ARN entspricht.

  3. Wählen Sie in der Registerkartenliste unter dem Konfigurationsbereich Allgemein die Option Tags.

  4. Wählen Sie Tags verwalten aus.

  5. Wählen Sie Neues Tag hinzufügen aus.

  6. Geben Sie im Feld Schlüssel Ihren Tag-Schlüssel ein. Informationen zu Tagging-Einschränkungen finden Sie unter Einschränkungen und Anforderungen für Tag-Benennungen im Handbuch zu AWS Tagging-Ressourcen und zum Tag-Editor.

  7. Wählen Sie Speichern.

So filtern Sie Zuordnungen von Ereignisquellen nach Tag

  1. Öffnen Sie die Zuordnungen von Ereignisquellen in der Lambda-Konsole.

  2. Wählen Sie das Suchfeld.

  3. Wählen Sie in der Dropdown-Liste Ihren Tagschlüssel unter der Tag-Unterüberschrift aus.

  4. Wählen Sie Verwenden: „Tag-Name“, um alle Zuordnungen von Ereignisquellen zu sehen, die mit dieser Taste gekennzeichnet sind oder wählen Sie einen Operator, um weiter nach Werten zu filtern.

  5. Wählen Sie Ihren Tag-Wert aus, um nach einer Kombination aus Tag-Schlüssel und -Wert zu filtern.

Das Suchfeld unterstützt auch die Suche nach Tag-Schlüsseln. Geben Sie den Namen eines Schlüssels ein, um ihn in der Liste zu finden.

Verwenden von Tags mit AWS CLI

Mit der Lambda-API können Sie Tags zu vorhandenen Lambda-Ressourcen, einschließlich Zuordnungen von Ereignisquellen, hinzufügen und entfernen. Sie können auch Tags hinzufügen, wenn Sie eine Ereignisquellenzuordnung erstellen, damit eine Ressource während ihres gesamten Lebenszyklus mit Tags versehen bleibt.

Aktualisierung von Tags mit den Lambda-Tag-APIs

Über die UntagResource API-Operationen und können Sie Tags für unterstützte Lambda-Ressourcen hinzufügen TagResource und entfernen.

Sie können diese Operationen mit der Taste AWS CLI aufrufen. Um Tags einer vorhandenen Ressource hinzuzufügen, verwenden Sie den folgenden tag-resource-Befehl. In diesem Beispiel werden zwei Tags hinzugefügt, eines mit dem Schlüssel Department und eines mit dem SchlüsselCostCenter.

aws lambda tag-resource \
--resource arn:aws:lambda:us-east-2:123456789012:resource-type:my-resource \
--tags Department=Marketing,CostCenter=1234ABCD

Mit dem Befehl untag-resource können Sie Tags entfernen. In diesem Beispiel wird das Tag mit dem Schlüssel entferntDepartment.

aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier \
--tag-keys Department

Hinzufügen von Tags beim Erstellen einer Zuordnung von Ereignisquellen

Verwenden Sie die CreateEventSourceMapping API-Operation, um eine neue Lambda-Ereignisquellenzuordnung mit Tags zu erstellen. Geben Sie den Parameter Tags an. Sie können diesen Vorgang mit dem create-event-source-mapping AWS CLI Befehl und der --tags Option aufrufen. Weitere Informationen über diesen CLI-Befehl finden Sie unter create-event-source-mapping in der AWS CLI -Befehlsreferenz.

Vergewissern Sie sich vor der Verwendung des Tags-Parameters mit CreateEventSourceMapping, dass Ihre Rolle neben den üblichen Berechtigungen, die für diesen Vorgang erforderlich sind, auch die Berechtigung hat, Ressourcen zu taggen. Weitere Informationen zu den Berechtigungen für das Tagging finden Sie unter Erforderliche Berechtigungen zum Arbeiten mit Tags.

Anzeigen von Tags mit den Lambda-Tag-APIs

Um die Tags anzuzeigen, die auf eine bestimmte Lambda-Ressource angewendet werden, verwenden Sie die ListTags-API-Operation. Weitere Informationen finden Sie unter ListTags.

Sie können diesen Vorgang mit dem list-tags AWS CLI Befehl aufrufen, indem Sie einen ARN (Amazon Resource Name) angeben.

aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier

Filtern von Ressourcen nach Tag

Sie können den AWS Resource Groups Tagging API GetResources API-Vorgang verwenden, um Ihre Ressourcen nach Tags zu filtern. Die GetResources-Operation empfängt bis zu 10 Filter, wobei jeder Filter einen Tag-Schlüssel und bis zu 10 Tag-Werte enthält. Sie stellen GetResources mit einem ResourceType zur Verfügung, um nach bestimmten Ressourcentypen zu filtern.

Sie können diesen Vorgang mit dem get-resources AWS CLI Befehl aufrufen. Beispiele für die Verwendung von get-resources finden Sie unter get-resources in der AWS -CLI-Befehlsreferenz.