Markieren Ihrer Amazon EC2-Ressourcen - Amazon Elastic Compute Cloud

Markieren Ihrer Amazon EC2-Ressourcen

Zur einfacheren Verwaltung von Instances, Abbildern und anderen Amazon EC2-Ressourcen können Sie den einzelnen Ressourcen bei Bedarf eigene Metadaten in Form von Tags zuweisen. In diesem Thema werden Tags und deren Erstellung beschrieben.

Warnung

Tag-Schlüssel und ihre Werte werden von vielen verschiedenen API-Aufrufen zurückgegeben. Die Zugriffsverweigerung von DescribeTags verweigert nicht automtisch den Zugriff auf Tags, die von anderen APIs zurückgegeben wurden. Als bewährte Vorgehensweise empfehlen wir Ihnen, keine sensiblen Daten in Ihre Tags aufzunehmen.

Grundlagen zu Tags

Ein Tag ist eine Markierung, die Sie einer AWS-Ressource zuordnen. Jeder Tag besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen.

Mit Tags können Sie AWS-Ressourcen auf unterschiedliche Weise kategorisieren (z. B. nach Zweck, Eigentümer oder Umgebung). Dies ist hilfreich, wenn Sie viele Ressourcen desselben Typs haben. In diesem Fall können Sie schnell bestimmte Ressourcen basierend auf den zugewiesenen Tags bestimmen. Sie können zum Beispiel eine Reihe von Tags für die Amazon EC2-Instances in Ihrem Konto definieren, um die Eigentümer der einzelnen Instances und die Stack-Ebene nachzuverfolgen.

Das folgende Diagramm veranschaulicht, wie Markieren funktioniert. In diesem Beispiel wurden jeder Instance zwei Tags zugewiesen: ein Tag mit dem Schlüssel Owner und ein Tag mit dem Schlüssel Stack. Jedes Tag verfügt außerdem über einen zugewiesenen Wert.


					Tag-Beispiel

Wir empfehlen die Verwendung von Tag-Schlüsseln, die die Anforderungen der jeweiligen Ressourcentypen erfüllen. Eine Anzahl einheitlicher Tag-Schlüssel vereinfacht das Verwalten der Ressourcen. Sie können die Ressourcen auf Grundlage der hinzugefügten Tags filtern und danach suchen. Weitere Informationen zum Implementieren einer effektiven Ressourcen-Tagging-Strategie finden Sie im AWS-Whitepaper Bewährte Methoden zum Tagging.

Tags haben keine semantische Bedeutung für Amazon EC2 und werden ausschließlich als Zeichenfolgen interpretiert. Außerdem werden Tags nicht automatisch Ihren Ressourcen zugewiesen. Sie können Tag-Schlüssel und Werte bearbeiten und Tags jederzeit von einer Ressource entfernen. Sie können den Wert eines Tags zwar auf eine leere Zeichenfolge, jedoch nicht Null festlegen. Wenn Sie ein Tag mit demselben Schlüssel wie ein vorhandenes Tag für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben. Wenn Sie eine Ressource löschen, werden alle Tags der Ressource ebenfalls gelöscht.

Sie können mit der AWS Management Console, AWS CLI und Amazon EC2-API mit Tags arbeiten.

Wenn Sie AWS Identity and Access Management (IAM) verwenden, können Sie steuern, welche Benutzer in Ihrem AWS-Konto Tags erstellen, bearbeiten oder löschen dürfen. Weitere Informationen finden Sie unter Identity and Access Management für Amazon EC2.

Markieren Ihrer Ressourcen

Sie können die meisten Amazon EC2-Ressourcen markieren, die bereits in Ihrem Konto bestehen. In der Tabelle unten werden die Ressourcen aufgeführt, die das Markieren unterstützen.

Wenn Sie die Amazon EC2-Konsole verwenden, können Sie auf der Registerkarte Tags auf dem entsprechenden Ressourcenbildschirm Tags auf Ressourcen anwenden. Oder verwenden Sie den Bildschirm Tags. Auf bestimmten Ressourcenbildschirmen können Sie Tags beim Erstellen einer Ressource angeben, z. B. ein Tag mit einem Schlüssel von Name und einem benutzerdefinierten Wert. In den meisten Fällen wendet die Konsole Tags direkt nach dem Erstellen der Ressource an und nicht während des Erstellens. Die Konsole strukturiert Ressourcen gemäß dem Name-Tag. Allerdings hat das Tag keine semantische Bedeutung für den Amazon EC2-Dienst.

Wenn Sie die Amazon EC2-API, AWS CLI oder eine AWS SDK verwenden, verwenden Sie die CreateTags EC2 API-Aktion, um Tags auf bestehende Ressourcen anzuwenden. Zudem können Sie mit einigen Aktionen zur Ressourcenerstellung Tags beim Erstellen einer Ressource angeben. Wenn Tags nicht während der Ressourcenerstellung angewendet werden können, wird die Ressourcenerstellung rückgängig gemacht. Auf diese Weise werden Ressourcen entweder mit Tags oder überhaupt nicht erstellt und keine Ressourcen verbleiben ohne Tags. Indem Sie Ressourcen zum Erstellungszeitpunkt markieren, müssen Sie anschließend keine benutzerdefinierten Skripts ausführen.

In der folgenden Tabelle werden die markierbaren Amazon EC2-Ressourcen und die bei der Erstellung über die Amazon EC2-API, die AWS CLI oder ein AWS-SDK markierbaren Ressourcen beschrieben.

Markierungsunterstützung für Amazon EC2-Ressourcen
Ressource Unterstützt Tags Unterstützt Markierung bei der Erstellung

AFI

Ja

Ja

AMI

Ja

Nein

Bundle Task

Nein

Nein

Kapazitätsreservierung

Ja

Ja

Client-VPN-Endpunkt

Ja

Ja

Client-VPN-Route

Nein

Nein

Kunden-Gateway

Ja

Nein

Dedicated Host

Ja

Ja

Dedicated Host-Reservierung

Ja

Nein

DHCP-Option

Ja

Nein

EBS Snapshot

Ja

Ja

EBS-Volume

Ja

Ja

EC2-Flotte

Ja

Ja

Internet-Gateway nur für ausgehenden Verkehr

Ja

Nein

Elastic IP-Adresse

Ja

Nein

Elastic Graphics Accelerator

Ja

Nein

Instance

Ja

Ja

Instance-Speicher-Volume

Internet-Gateway

Ja

Nein

IP-Adresspool (BYOIP)

Ja

Nein

Schlüsselpaar

Ja

Ja

Startvorlage

Ja

Ja

Startvorlagenversion

Nein

Nein

Lokales Gateway

Ja

Nein

Routing-Tabelle für das lokale Gateway

Ja

Nein

Virtuelle Schnittstelle des lokalen Gateways

Ja

Nein

Virtuelle Schnittstellengruppe des lokalen Gateways

Ja

Nein

VPC-Zuordnung der Routing-Tabelle für das lokale Gateway

Ja

Nein

Zuordnung der virtuellen Schnittstellengruppe der Routing-Tabelle für das lokale Gateway

Ja

Nein

NAT-Gateway

Ja

Ja

Netzwerk-ACL

Ja

Nein

Netzwerkschnittstelle

Ja

Nein

Platzierungsgruppe

Ja

Ja

Reserved Instance

Ja

Nein

Reserved Instance-Angebot

Nein

Nein
Routing-Tabelle

Ja

Nein

Spot-Flottenanforderung

Ja

Ja

Spot-Instance-Anfrage

Ja

Nein

Sicherheitsgruppe

Ja

Nein

Subnetz

Ja

Nein
Traffic Mirror-Filter Ja Ja
Traffic Mirror-Sitzung Ja Ja
Traffic Mirror-Ziel Ja Ja

Transit-Gateway

Ja

Ja

Routing-Tabelle für Transit-Gateway

Ja

Ja

VPC-Verbindung für Transmit-Gateway

Ja

Ja

Virtuelles Privates Gateway

Ja

Nein

VPC

Ja

Nein

VPC-Endpunkt

Ja

Ja

VPC-Endpunktservice

Ja

Ja

VPC-Endpunktservice-Konfiguration

Ja

Ja

VPC-Flow-Protokoll

Ja

Ja

VPC-Peering-Verbindung

Ja

Nein

VPN-Verbindung

Ja

Nein

Sie können Instances und Volumes bei der Erstellung mit dem Amazon EC2 Launch Instances Wizard in der Amazon EC2-Konsole mit Tags versehen. Sie können Ihre EBS-Volumes bei der Erstellung über den Bildschirm Volumes oder EBS-Snapshots über den Bildschirm Snapshots mit Tags versehen. Verwenden Sie alternativ die ressourcenschaffenden Amazon EC2-APIs (z. B. RunInstances), um Tags bei der Erstellung Ihrer Ressource anzuwenden.

Sie können Tag-basierte Berechtigungen auf Ressourcenebene in Ihren IAM-Richtlinien auf die Amazon EC2 API-Aktionen anwenden, die das Tagging bei der Erstellung unterstützen, um eine granulare Kontrolle über die Benutzer und Gruppen zu implementieren, die Ressourcen bei der Erstellung mit Tags versehen können. Ihre Ressourcen sind ab Erstellung ordnungsgemäß geschützt. Tags werden direkt auf Ihre Ressourcen angewendet. Daher treten alle Tag-basierten Berechtigungen auf Ressourcenebene, die die Verwendung von Ressourcen steuern, direkt in Kraft. Ihre Ressourcen können nachverfolgt und genauer erfasst werden. Sie können das Markieren neuer Ressourcen gewährleisten und steuern, welche Tag-Schlüssel und Werte für Ihre Ressourcen festgelegt sind.

Sie können ebenfalls Berechtigungen auf Ressourcenebene auf die CreateTags- und DeleteTags-Amazon EC2-API-Aktionen in den IAM-Richtlinien anwenden, um die Tag-Schlüssel und -Werte zu steuern, die für Ihre bestehenden Ressourcen festgelegt sind. Weitere Informationen finden Sie unter Beispiel: Markieren von Ressourcen.

Weitere Informationen zum Markieren von Ressourcen für die Fakturierung finden Sie unter Verwendung von Kostenzuordnungs-Tags im Benutzerhandbuch für AWS Billing and Cost Management.

Tag-Einschränkungen

Die folgenden grundlegenden Einschränkungen gelten für Tags:

  • Die maximale Anzahl an Tags pro Ressource beträgt 50.

  • Jeder Tag muss für jede Ressource eindeutig sein. Jeder Tag kann nur einen Wert haben.

  • Maximale Schlüssellänge: 128 Unicode-Zeichen in UTF-8

  • Maximale Wertlänge: 256 Unicode-Zeichen in UTF-8

  • EC2 lässt beliebige Zeichen in seinen Tags zu. Allerdings kann es in anderen Services mehr Einschränkungen geben. Erlaubte Zeichen in Services sind: Buchstaben, Zahlen und Leerzeichen, die in UTF-8 darstellbar sind, und die folgenden Sonderzeichen: + - = . _ : / @.

  • Bei Tag-Schlüsseln und -Werten muss die Groß-/Kleinschreibung beachtet werden.

  • Das Präfix aws: ist zur Verwendung in AWS reserviert. Wenn das Tag über einen Tag-Schlüssel mit diesem Präfix verfügt, können Sie den Schlüssel oder Wert des Tags nicht bearbeiten oder löschen. Tags mit dem Präfix aws: werden nicht als Ihre Tags pro Ressourcenlimit angerechnet.

Sie können Ressourcen nicht allein auf Grundlage ihrer Tags beenden, anhalten oder löschen. Sie müssen den Ressourcenbezeichner angeben. Um Snapshots zu löschen, die Sie mit dem Tag-Schlüssel DeleteMe markiert haben, müssen Sie die DeleteSnapshots-Aktion mit den Ressourcenbezeichnern der Snapshots verwenden, z. B. snap-1234567890abcdef0.

Sie können öffentliche oder gemeinsame Ressourcen markieren, aber die zugewiesenen Tags sind nur für Ihr AWS-Konto und nicht die anderen Kontos verfügbar, die sich die Ressource teilen.

Sie können nicht alle Ressourcen markieren. Weitere Informationen finden Sie unter Markierungsunterstützung für Amazon EC2-Ressourcen.

Markieren von Ressourcen für die Fakturierung

Sie können Tags auch zum Strukturieren Ihrer AWS-Kontorechnung verwenden, um Ihre eigene Kostenstruktur einzubeziehen. Dazu müssen Sie sich registrieren, um Ihre AWS-Kontorechnung mit Tag-Schlüsselwerten zu erhalten. Weitere Informationen zum Einrichten eines Kostenzuordnungsberichts mit Tags finden Sie unter Der monatliche Kostenzuordnungsbericht im Benutzerhandbuch für AWS Billing and Cost Management. Um die Kosten kombinierter Ressourcen anzuzeigen, können Sie Ihre Fakturierungsinformationen nach Ressourcen mit gleichen Tag-Schlüsselwerten strukturieren. Beispielsweise können Sie mehrere Ressourcen mit einem bestimmten Anwendungsnamen markieren und dann Ihre Fakturierungsinformationen so organisieren, dass Sie die Gesamtkosten dieser Anwendung über mehrere Services hinweg sehen können. Weitere Informationen finden Sie unter Verwendung von Kostenzuordnungs-Tags im Benutzerhandbuch für AWS Billing and Cost Management.

Anmerkung

Wenn Sie die Berichterstellung gerade erst aktiviert haben, werden die Daten für den aktuellen Monat nach 24 Stunden bereitgestellt.

Kostenzuordnungs-Tags dienen der Anzeige, welche Ressourcen zu Ihrer Nutzung und Ihren Kosten beitragen. Das Löschen oder Deaktivieren der Ressourcen führt nicht zwangsläufig zur Kostensenkung. Beispiel: Snapshot-Daten, auf die von einem anderen Snapshot verwiesen wird, werden selbst dann beibehalten, wenn der Snapshot gelöscht wird, der die ursprünglichen Daten enthält. Weitere Informationen finden Sie unter Amazon Elastic Block Store-Volumes und -Snapshots im Benutzerhandbuch für AWS Billing and Cost Management.

Anmerkung

Elastic IP-Adressen, die mit Tags versehen sind, erscheinen nicht in Ihrem Kostenzuordnungsbericht.

Arbeiten mit Tags in der Konsole

Mit der Amazon EC2-Konsole sehen Sie, welche Tags in all Ihren Amazon EC2-Ressourcen in derselben Region verwendet werden. Sie können Tags nach Ressource und nach Ressourcentyp anzeigen. Außerdem können Sie anzeigen, wie viele Elemente jedes Ressourcentyps einem angegebenen Tag zugeordnet sind. Sie können auch die Amazon EC2-Konsole verwenden, um Tags jeweils einer oder mehreren Ressourcen gleichzeitig hinzuzufügen oder diese zu entfernen.

Ausführlichere Informationen zur Verwendung von Filtern zur Anzeige von Ressourcen finden Sie unter Auflisten und Filtern Ihrer Ressourcen.

Der Tag-Editor in der AWS Management Console ist benutzerfreundlich und am besten dazu geeignet, Tags zentral und einheitlich zu erstellen und zu verwalten. Weitere Informationen finden Sie unter Arbeiten mit dem Tag Editor im Erste Schritte mit der AWS Management Console.

Anzeigen von Tags

Sie können Tags auf zwei verschiedene Arten in der Amazon EC2-Konsole anzeigen. Sie können die Tags für einzelne oder alle Ressourcen anzeigen.

Anzeigen von Tags für einzelne Ressourcen

Wenn Sie eine ressourcenspezifische Seite in der Amazon EC2-Konsole auswählen, wird eine Liste der Ressourcen angezeigt. Beispiel: Wenn Sie im Navigationsbereich Instances auswählen, wird eine Liste der Amazon EC2-Instances in der Konsole angezeigt. Wenn Sie eine Ressource aus einer der Listen (beispielsweise eine Instance) auswählen und die Ressource Tags unterstützt, können Sie deren Tags anzeigen und verwalten. Auf den meisten Ressourcenseiten können Sie die Tags im Detailbereich auf der Registerkarte Tags anzeigen.

Sie können der Ressourcenliste eine Spalte hinzufügen, die alle Werte für Tags mit demselben Schlüssel anzeigt. Anhand der Spalte können Sie die Ressourcenliste nach Tag sortieren und filtern. Sie können der Ressourcenliste auf zwei Arten eine neue Spalte hinzufügen, um die Tags anzuzeigen.

  • Wählen Sie auf der Registerkarte Tags Show Column aus. Der Konsole wird eine neue Spalte hinzugefügt.

  • Klicken Sie auf das Zahnrädchensymbol Show/Hide Columns (Spalten ein-/ausblenden) und wählen Sie im Dialogfeld Show/Hide Columns (Spalten ein-/ausblenden) unter Your Tag Keys den Tag-Schlüssel aus.

Anzeigen von Tags für alle Ressourcen

Sie können Tags in allen Ressourcen durch Auswahl von Tags im Navigationsbereich in der Amazon EC2-Konsole anzeigen. Im folgenden Bild wird der Bereich Tags angezeigt, in dem alle vom Ressourcentyp verwendeten Tags aufgeführt werden.


						Der Bereich „Tags“ in der Amazon EC2-Konsole

Hinzufügen und Löschen von Tags für einzelne Ressourcen

Sie können Tags für einzelne Ressourcen direkt auf der Seite der Ressource verwalten.

Hinzufügen eines Tags zu einer einzelnen Ressource

  1. Öffnen Sie die Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie auf der Navigationsleiste die Region aus, die Ihren Anforderungen entspricht. Die Auswahl ist wichtig, da nur bestimmte Amazon EC2-Ressourcen zwischen Regionen geteilt werden können. Weitere Informationen finden Sie unter Ressourcenstandorte.

  3. Wählen Sie im Navigationsbereich einen Ressourcentyp aus (z. B. Instances).

  4. Wählen Sie die Ressource aus der Ressourcenliste aus und wählen Tags, Add/Edit Tags aus.

  5. Geben Sie im Dialogfeld Add/Edit Tags (Tags hinzufügen-bearbeiten) Schlüssel und Wert für jedes Tag an und klicken Sie auf Save (Speichern).

Löschen von Tags von einer einzelnen Ressource

  1. Öffnen Sie die Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie auf der Navigationsleiste die Region aus, die Ihren Anforderungen entspricht. Die Auswahl ist wichtig, da nur bestimmte Amazon EC2-Ressourcen zwischen Regionen geteilt werden können. Weitere Informationen finden Sie unter Ressourcenstandorte.

  3. Wählen Sie im Navigationsbereich einen Ressourcentyp aus (z. B. Instances).

  4. Wählen Sie die Ressource aus der Ressourcenliste aus und wählen Tags aus.

  5. Klicken Sie auf Add/Edit Tags (Tags hinzufügen-bearbeiten), wählen Sie das Symbol Remove (Entfernen) für das Tag aus und klicken Sie auf Save (Speichern).

Hinzufügen und Löschen von Tags zu einer Gruppe von Ressourcen

Hinzufügen von Tags zu einer Gruppe von Ressourcen

  1. Öffnen Sie die Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie auf der Navigationsleiste die Region aus, die Ihren Anforderungen entspricht. Die Auswahl ist wichtig, da nur bestimmte Amazon EC2-Ressourcen zwischen Regionen geteilt werden können. Weitere Informationen finden Sie unter Ressourcenstandorte.

  3. Wählen Sie im Navigationsbereich Tags aus.

  4. Wählen Sie oben im Inhaltsbereich Manage Tags aus.

  5. Wählen Sie für Filter den Ressourcentyp (z. B. Instances) zum Hinzufügen von Tags aus.

  6. Aktivieren Sie in der Ressourcenliste das Kontrollkästchen neben jeder Ressource, der Tags hinzugefügt werden sollen.

  7. Geben Sie unter Add Tag für Key (Schlüssel) und Value (Wert) Tag-Schlüssel und -Wert ein und klicken Sie auf Add Tag.

    Anmerkung

    Wenn Sie ein neues Tag mit demselben Tag-Schlüssel wie ein bestehendes Tag hinzufügen, wird das bestehende Tag vom neuen überschrieben.

Entfernen eines Tags von einer Gruppe von Ressourcen

  1. Öffnen Sie die Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie auf der Navigationsleiste die Region aus, die Ihren Anforderungen entspricht. Die Auswahl ist wichtig, da nur bestimmte Amazon EC2-Ressourcen zwischen Regionen geteilt werden können. Weitere Informationen finden Sie unter Ressourcenstandorte.

  3. Wählen Sie im Navigationsbereich Tags, Manage Tags aus.

  4. Um die verwendeten Tags anzuzeigen, klicken Sie auf das Zahnrädchensymbol Show/Hide Columns (Spalten ein-/ausblenden) und wählen Sie im Dialogfeld Show/Hide Columns (Spalten ein-/ausblenden) die anzuzeigenden Tag-Schlüssel aus. Klicken Sie anschließend auf Close (Schließen).

  5. Wählen Sie für Filter den Ressourcentyp (z. B. Instances) aus, von dem Tags entfernt werden sollen.

  6. Aktivieren Sie in der Ressourcenliste das Kontrollkästchen neben den Ressourcen, von denen Tags entfernt werden sollen.

  7. Geben Sie unter Remove Tag für Key (Schlüssel) den Namen des Tags ein und klicken Sie auf Remove Tag.

Hinzufügen eines Tags beim Starten einer Instance

Hinzufügen eines Tags mithilfe des Startassistenten

  1. Wählen Sie auf der Navigationsleiste die Region für die Instance aus. Die Auswahl ist wichtig, da nur bestimmte Amazon EC2-Ressourcen zwischen Regionen geteilt werden können. Wählen Sie die Region aus, die Ihren Anforderungen entspricht. Weitere Informationen finden Sie unter Ressourcenstandorte.

  2. Wählen Sie Launch Instance aus.

  3. Auf der Seite Choose an Amazon Machine Image (AMI) (ein Amazon-Computerabbild (AMI) auswählen) wird eine Liste an Basiskonfigurationen anzeigt, die als Amazon Machine Images (AMIs) (Amazon-Computerabbilder (AMIs)) bezeichnet werden. Wählen Sie das zu verwendende AMI und anschließend Select (Auswählen) aus. Weitere Informationen zum Auswählen eines AMI finden Sie unter Suchen eines Linux-AMI.

  4. Konfigurieren Sie auf der Seite Configure Instance Details die erforderlichen Instance-Einstellungen und klicken Sie anschließend auf Next: Add Storage.

  5. Auf der Seite Add Storage (Speicher hinzufügen) können Sie zusätzliche Speichervolumes für Ihre Instance angeben. Klicken Sie anschließend auf Next: Add Tags.

  6. Auf der Seite Add Tags können Sie Tags für die Instance, die Volumes oder beides angeben. Klicken Sie auf Add another tag (Eine weiteres Tag hinzufügen), um der Instance mehrere Tags hinzuzufügen. Wählen Sie Next: Configure Security Group, wenn Sie bereit sind.

  7. Wählen Sie auf der Seite Configure Security Group eine Ihrer bestehenden Sicherheitsgruppen aus oder erstellen Sie eine neue Sicherheitsgruppe mithilfe des Assistenten. Klicken Sie abschließend auf Review and Launch.

  8. Überprüfen Sie die Einstellungen. Wenn Sie mit Ihren Einstellungen zufrieden sind, klicken Sie auf Launch. Wählen Sie ein bestehendes Schlüsselpaar aus, aktivieren Sie das Kontrollkästchen zur Bestätigung und klicken Sie abschließend auf Launch Instances.

Filtern von Ressourcenlisten nach Tag

Sie können Ihre Ressourcenliste auf Grundlage einer oder mehrerer Tag-Schlüssel und -Werte filtern.

Filtern einer Ressourcenliste nach Tag

  1. Blenden Sie eine Spalte für das Tag wie folgt ein:

    1. Wählen Sie eine Ressource aus.

    2. Wählen Sie im Detailbereich Tags aus.

    3. Wählen Sie das Tag in der Liste aus und wählen Sie Show Column aus.

  2. Klicken Sie oben rechts in der Spalte für das Tag auf das Filtersymbol, um die Filterliste anzuzeigen.

  3. Wählen Sie die Tag-Werte aus und klicken Sie anschließend auf Apply Filter, um die Ergebnisliste zu filtern.

    Anmerkung

    Weitere Informationen zu Filtern finden Sie unter Auflisten und Filtern Ihrer Ressourcen.

Arbeiten mit Tags mittels CLI oder API

Mit den folgenden Befehlen können Sie Tags für Ihre Ressourcen hinzufügen, aktualisieren, auflisten und löschen. In der zugehörigen Dokumentation finden sich Beispiele.

Aufgabe AWS CLI AWS-Tools für Windows PowerShell API-Aktion

Fügen Sie einen oder mehrere Tags hinzu oder überschreiben Sie sie.

create-tags

New-EC2Tag

CreateTags

Löschen Sie ein oder mehrere Tags.

delete-tags

Remove-EC2Tag

DeleteTags

Beschreiben Sie ein oder mehrere Tags.

describe-tags

Get-EC2Tag

DescribeTags

Sie können auch eine Liste von Ressourcen nach ihren Tags filtern. Das folgende Beispiel zeigt, wie Sie Instances, die Tags verwenden, mit dem Befehl describe-instances filtern können.

Anmerkung

Wie Sie JSON-formatierte Parameter an der Befehlszeile eingeben, unterscheidet sich je nach Betriebssystem. Linux, macOS oder Unix und Windows PowerShell fügen die JSON-Datenstruktur zwischen einfache Anführungszeichen (') ein. Lassen Sie die einfachen Anführungszeichen weg, wenn Sie Befehle auf der Windows-Befehlszeile ausführen. Weitere Informationen finden Sie unter Angeben von Parameterwerten für die AWS-Befehlszeilenschnittstelle.

Beispiel 1: Beschreiben von Instances mit dem angegebenen Tag-Schlüssel

Der folgende Befehl beschreibt die Instances mit einem Stack-Tag, ungeachtet des Tag-Werts.

aws ec2 describe-instances --filters Name=tag-key,Values=Stack

Beispiel 2: Beschreiben von Instances mit dem angegebenen Tag

Der folgende Befehl beschreibt die Instances mit dem Tag „Stack=production“.

aws ec2 describe-instances --filters Name=tag:Stack,Values=production

Beispiel 3: Beschreiben von Instances mit dem angegebenen Tag-Wert

Der folgende Befehl beschreibt die Instances mit einem Tag mit dem Wert „production“, ungeachtet des Tag-Schlüssel.

aws ec2 describe-instances --filters Name=tag-value,Values=production

Mit einigen Aktionen zur Ressourcenerstellung können Sie Tags beim Erstellen der Ressource angeben. Die folgenden Aktionen unterstützen das Markieren bei der Erstellung.

Aufgabe AWS CLI AWS-Tools für Windows PowerShell API-Aktion

Starten Sie eine oder mehrere Instances.

run-instances

New-EC2Instance

RunInstances

Erstellen Sie ein EBS-Volume.

create-volume

New-EC2Volume

CreateVolume

In den folgenden Beispielen wird gezeigt, wie Sie Tags beim Erstellen von Ressourcen anwenden.

Beispiel 4: Starten einer Instance und Anwenden von Tags auf Instance und Volume

Der folgende Befehl startet eine Instance und wendet ein Tag mit einem Schlüssel von webserver und dem Wert von production auf die Instance an. Der folgende Befehl wendet ein Tag mit einem Schlüssel von cost-center und einem Wert von cc123 auf ein erstelltes EBS-Volume an (in diesem Fall das Root-Volume).

aws ec2 run-instances --image-id ami-abc12345 --count 1 --instance-type t2.micro --key-name MyKeyPair --subnet-id subnet-6e7f829e --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]'

Sie können dieselben Tag-Schlüssel und -Werte auf beide Instances und Volumes beim Start anwenden. Der folgende Befehl startet eine Instance und wendet ein Tag mit einem Schlüssel von cost-center und einem Wert von cc123 auf die Instance und alle erstellten EBS-Volumes an.

aws ec2 run-instances --image-id ami-abc12345 --count 1 --instance-type t2.micro --key-name MyKeyPair --subnet-id subnet-6e7f829e --tag-specifications 'ResourceType=instance,Tags=[{Key=cost-center,Value=cc123}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]'

Beispiel 5: Erstellen von Volumes und Anwenden von Tags

Mit dem folgenden Befehl wird ein Volume erstellt und werden zwei Tags angewendet: purpose = production und cost-center = cc123.

aws ec2 create-volume --availability-zone us-east-1a --volume-type gp2 --size 80 --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'

Beispiel 6: Einen Tag zu einer Ressource hinzufügen

In diesem Beispiel wird das Tag Stack=production zum angegebenen Bild hinzugefügt oder ein bestehendes Tag für das AMI, in dem der Tag-Schlüssel Stack lautet, wird überschrieben. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.

aws ec2 create-tags --resources ami-78a54011 --tags Key=Stack,Value=production

Beispiel 7: Tags zu mehreren Ressourcen hinzufügen

In diesem Beispiel werden zwei Tags für ein AMI und eine Instance hinzugefügt (oder überschrieben). Eines der Tags enthält nur einen Schlüssel (webserver) ohne Wert (Wir legen den Wert auf eine leere Zeichenfolge fest). Das andere Tag besteht aus einem Schlüssel (stack) und einem Wert (Production). Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.

aws ec2 create-tags --resources ami-1a2b3c4d i-1234567890abcdef0 --tags Key=webserver,Value= Key=stack,Value=Production

Beispiel 8: Tags mit Sonderzeichen hinzufügen

In diesem Beispiel wird das Tag [Group]=test zu einer Instance hinzugefügt. Die eckigen Klammern ([ und ]) sind Sonderzeichen und müssen durch einen Backslash (\) umgangen werden.

aws ec2 create-tags --resources i-1234567890abcdef0 --tags Key=\[Group]\,Value=test

Bei Nutzung von Windows PowerShell brechen Sie die Zeichen mit einem Backslash (\) herunter, setzen Sie in doppelte Anführungszeichen (") und anschließend die gesamte Schlüssel- und Wertstruktur in einzelne Anführungszeichen (').

aws ec2 create-tags --resources i-1234567890abcdef0 --tags 'Key=\"[Group]\",Value=test'

Wenn Sie Linux oder OS X verwenden, setzen Sie die gesamte Schlüssel- und Wertstruktur in einzelne Anführungszeichen ('). Schließen Sie dann das Element mit dem Sonderzeichen in doppelte Anführungszeichen (") ein.

aws ec2 create-tags --resources i-1234567890abcdef0 --tags 'Key="[Group]",Value=test'