Verwenden von Tags für Lambda-Funktionen - 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 Lambda-Funktionen

Sie können Funktionen 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.

Tags gelten für die Funktionsebene, nicht für Versionen oder Aliase. Tags sind nicht Teil der versionsspezifischen Konfiguration, die einen Snapshot davon AWS Lambda erstellt, wann Sie eine Version veröffentlichen. Sie können Lambda verwendenAPI, um Tags anzuzeigen und zu aktualisieren. Sie können Tags auch anzeigen und aktualisieren, während Sie eine bestimmte Funktion 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, erteilen 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 Funktionen mit Tags zu erstellen, Tags zu vorhandenen Funktionen hinzuzufügen und Funktionen nach von Ihnen hinzugefügten Tags zu filtern.

Hinzufügen von Tags beim Erstellen einer Funktion
  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

  2. Wählen Sie Funktion erstellen aus.

  3. Klicken Sie auf Ohne Vorgabe erstellen oder Container-Image.

  4. Richten Sie unter Grundinformationen Ihre Funktion ein. Weitere Informationen zur Konfiguration von Funktionen finden Sie unterAWS Lambda Funktionen konfigurieren.

  5. Erweitern Sie Advanced settings (Erweiterte Einstellungen) und wählen Sie dann Enable tags (Tags aktivieren) aus.

  6. Wählen Sie Add new tag (Neues Tag hinzufügen) und geben Sie dann einen Key (Schlüssel) und einen optionalen Value (Wert) ein. Wiederholen Sie diesen Schritt, um weitere Tags hinzuzufügen.

  7. Wählen Sie Funktion erstellen aus.

Hinzufügen von Tags zu einer bestehenden Funktion
  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

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

  3. Wählen Sie Configuraton (Konfiguration) und dann Tags aus.

  4. Wählen Sie unter Tags die Option Manage tags (Tags verwalten) aus.

  5. Wählen Sie Add new tag (Neues Tag hinzufügen) und geben Sie dann einen Key (Schlüssel) und einen optionalen Value (Wert) ein. Wiederholen Sie diesen Schritt, um weitere Tags hinzuzufügen.

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

So filtern Sie Funktionen mit Tags
  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

  2. Wählen Sie das Suchfeld, um eine Liste der Funktionseigenschaften und Tag-Tasten anzuzeigen.

  3. Wählen Sie eine Tag-Taste, um eine Liste der Werte anzuzeigen, die in der aktuellen AWS Region verwendet werden.

  4. Wählen Sie Verwenden: „Tag-Name“, um alle Funktionen 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.

Die Suchleiste unterstützt auch die Suche nach Tag-Schlüsseln. Geben Sie tag ein, um nur eine Liste der Tag-Schlüssel anzuzeigen, oder geben Sie den Namen eines Schlüssels ein, um ihn in der Liste zu suchen.

Verwenden von Tags mit dem AWS CLI

Mit dem Lambda können Sie Tags zu vorhandenen Lambda-Ressourcen, einschließlich Funktionen, hinzufügen und entfernen. API Sie können bei der Erstellung einer Funktion auch Tags hinzufügen, 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 Funktion

Verwenden Sie die CreateFunctionAPIOperation, um eine neue Lambda-Funktion mit Tags zu erstellen. Geben Sie den Parameter Tags an. Sie können diese Operation mit dem create-function CLI Befehl und der Option --tags aufrufen. Bevor Sie den Parameter tags mit verwenden, stellen Sie sicherCreateFunction, 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. In diesem Beispiel werden zwei Tags hinzugefügt, eines mit dem Schlüssel Department und eins mit dem Schlüssel CostCenter.

aws lambda create-function --function-name my-function --handler index.js --runtime nodejs20.x \ --role arn:aws:iam::123456789012:role/lambda-role \ --tags Department=Marketing,CostCenter=1234ABCD

Anzeigen von Tags in einer Funktion

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

Sie können die Tags anzeigen, die mit dem GetFunctionAPIVorgang auf eine bestimmte Ressource angewendet wurden. Eine vergleichbare Funktionalität ist für andere Ressourcentypen nicht verfügbar.

Sie können diese Operation mit dem get-function CLI folgenden Befehl aufrufen:

aws lambda get-function --function-name my-function

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.