Verwenden von Tags für Ereignisquellenzuordnungen - AWS Lambda

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.

Verwenden von Tags für Ereignisquellenzuordnungen

Sie können Zuordnungen von Ereignisquellen taggen, um Ihre Ressourcen zu organisieren und zu verwalten. Bei Tags handelt es sich um frei formbare Schlüssel-Wert-Paare, die Ihren Ressourcen zugeordnet sind und von allen Diensten unterstützt werden. AWS Weitere Informationen zu Anwendungsfällen für Tags finden Sie unter Allgemeine Tagging-Strategien im Tagging AWS Resources and Tag Editor Guide.

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 verwenden, um Tags anzuzeigen und AWS Lambda API zu aktualisieren. Sie können Tags auch anzeigen und aktualisieren, während Sie eine bestimmte Ereignisquellenzuordnung in der Lambda-Konsole verwalten.

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 für eine Ressource zu ermöglichen, gewähren Sie ihr die entsprechenden Berechtigungen:

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

  • lambda: TagResource —Erteilen Sie diese Berechtigung jedem, der bei create ein Tag aufrufen TagResource oder ausführen muss.

Weitere Informationen finden Sie unter Identitätsbasierte 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.

Wenn Sie mithilfe der Lambda-Konsole einen Trigger für unterstützte stream- und warteschlangenbasierte Dienste hinzufügen, erstellt Lambda automatisch eine Ereignisquellenzuordnung. 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.

Um ein Tag hinzuzufügen, wenn Sie eine Ereignisquellenzuordnung 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 Trigger-Konfiguration 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 unterLambda mit Ereignissen aus anderen Diensten aufrufen AWS.

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

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

  8. Geben Sie im Feld Schlüssel Ihren Tag-Schlüssel ein. Informationen zu den Einschränkungen beim Taggen finden Sie unter Beschränkungen und Anforderungen für die Benennung von Tags im Leitfaden AWS Tagging-Ressourcen und Tag-Editor.

  9. Wählen Sie Hinzufügen aus.

So fügen Sie Stichwörter zu einer vorhandenen Zuordnung von Ereignisquellen hinzu
  1. Öffnen Sie die Zuordnungen der Ereignisquellen in der Lambda-Konsole.

  2. Wählen Sie aus der Ressourcenliste die Zuordnung UUIDfür die Ereignisquelle aus, die Ihrer Funktion und Ihrer Ereignisquelle entspricht. ARN

  3. Wählen Sie in der Registerkartenliste unter dem Bereich Allgemeine Konfiguration die Option Tags aus.

  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 den Einschränkungen beim Taggen finden Sie unter Beschränkungen und Anforderungen für die Benennung von Tags im Leitfaden AWS Tagging-Ressourcen und Tag-Editor.

  7. Wählen Sie Save (Speichern) aus.

So filtern Sie Zuordnungen von Ereignisquellen nach Tag
  1. Öffnen Sie die Zuordnungen der Ereignisquellen in der Lambda-Konsole.

  2. Wählen Sie das Suchfeld aus.

  3. Wählen Sie in der Drop-down-Liste Ihren Tag-Schlüssel unter der Unterüberschrift Tags aus.

  4. Wählen Sie Verwenden: „Tag-Name“, um alle mit diesem Schlüssel markierten Zuordnungen von Ereignisquellen zu sehen, oder wählen Sie einen Operator, um weiter nach Wert zu filtern.

  5. Wählen Sie Ihren Tag-Wert aus, um nach einer Kombination aus Tag-Schlüssel und Tag-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 dem Lambda können Sie Tags zu vorhandenen Lambda-Ressourcen hinzufügen und entfernen, einschließlich Zuordnungen von Ereignisquellen. API Sie können auch Tags hinzufügen, wenn Sie eine Ereignisquellenzuordnung erstellen, sodass Sie eine Ressource während ihres gesamten Lebenszyklus mit Tags versehen können.

Aktualisieren von Tags mit dem Lambda-Tag APIs

Mit den UntagResourceAPIOperationen und können Sie Tags für unterstützte Lambda-Ressourcen hinzufügen TagResourceund entfernen.

Sie können diese Operationen mit dem AWS CLI aufrufen. Verwenden Sie den tag-resource Befehl, um einer vorhandenen Ressource Tags hinzuzufügen. In diesem Beispiel werden zwei Tags hinzugefügt, eines mit dem Schlüssel Department und eins mit dem Schlüssel CostCenter.

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 entfernt Department.

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 Ereignisquellenzuordnung

Verwenden Sie die CreateEventSourceMappingAPIOperation, um eine neue Lambda-Ereignisquellenzuordnung mit Tags zu erstellen. Geben Sie den Parameter Tags an. Sie können diese Operation mit dem create-event-source-mapping AWS CLI Befehl und der --tags Option aufrufen. Weitere Informationen zu dem CLI Befehl finden Sie create-event-source-mappingin der AWS CLI Befehlsreferenz.

Bevor Sie den Tags Parameter with verwendenCreateEventSourceMapping, stellen Sie sicher, dass Ihre Rolle neben den üblichen Berechtigungen, die für diesen Vorgang erforderlich sind, auch die Berechtigung besitzt, Ressourcen zu taggen. Weitere Informationen zu Berechtigungen für das Tagging finden Sie unterErforderliche Berechtigungen zum Arbeiten mit Tags.

Tags mit dem Lambda-Tag anzeigen APIs

Verwenden Sie den ListTags API Vorgang, um die Tags anzuzeigen, die auf eine bestimmte Lambda-Ressource angewendet werden. Weitere Informationen finden Sie unter ListTags.

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

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

Ressourcen nach Tag filtern

Sie können den AWS Resource Groups Tagging API GetResourcesAPIVorgang 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 get-resources finden Sie unter get-resources in der AWS CLIBefehlsreferenz.