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. Mit Tags können Sie AWS-Ressourcen auf unterschiedliche Weise kategorisieren (z. B. nach Zweck, Eigentümer oder Umgebung). Dies ist nützlich, wenn Sie viele Ressourcen desselben Typs haben — In diesem Fall können Sie schnell bestimmte Ressourcen basierend auf den zugewiesenen Tags bestimmen. 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). 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

Gateway des Netzbetreibers Ja Ja

Client-VPN-Endpunkt

Ja

Ja

Client-VPN-Route

Nein

Nein

Kunden-Gateway

Ja

Ja

Dedicated Host

Ja

Ja

Dedicated Host-Reservierung

Ja

Ja

DHCP-Option

Ja

Ja

EBS Snapshot

Ja

Ja

EBS-Volume

Ja

Ja

EC2-Flotte

Ja

Ja

Internet-Gateway nur für ausgehenden Verkehr

Ja

Ja

Elastic IP-Adresse

Ja

Nein

Elastic Graphics Accelerator

Ja

Nein

Instance

Ja

Ja

Instance-Speicher-Volume

Internet-Gateway

Ja

Ja

IP-Adresspool (BYOIP)

Ja

Ja

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

Ja

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

Ja

Nein

NAT-Gateway

Ja

Ja

Netzwerk-ACL

Ja

Ja

Netzwerkschnittstelle

Ja

Ja

Platzierungsgruppe

Ja

Ja

Liste der Präfixe

Ja

Ja

Reserved Instance

Ja

Nein

Reserved Instance-Angebot

Nein

Nein
Routing-Tabelle

Ja

Ja

Spot-Flottenanforderung

Ja

Ja

Spot-Instance-Anfrage

Ja

Ja

Sicherheitsgruppe

Ja

Ja

Subnetz

Ja

Ja
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

Ja

VPC

Ja

Ja

VPC-Endpunkt

Ja

Ja

VPC-Endpunktservice

Ja

Ja

VPC-Endpunktservice-Konfiguration

Ja

Ja

VPC-Flow-Protokoll

Ja

Ja

VPC-Peering-Verbindung

Ja

Ja

VPN-Verbindung

Ja

Ja

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, werden Ihre 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 anzeigen, indem Sie die Registerkarte Tags auswählen.

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 Ihre 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 und die Registerkarte Tags aus.

  5. Wählen Sie Tags verwalten, Tag hinzufügen aus. Geben Sie den Schlüssel und den Wert für den Tag ein. Wenn Sie mit dem Hinzufügen der Tags fertig sind, wählen Sie 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 und die Registerkarte Tags aus.

  5. Wählen Sie Manage tags (Tags verwalten) aus. Wählen Sie für jedes Tag Entfernen aus. Wenn Sie mit dem Entfernen der Tags fertig sind, wählen Sie 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 unter Filter, den Ressourcentyp (z. B. Instances) aus.

  6. Aktivieren Sie in der Ressourcenliste das Kontrollkästchen neben jeder Ressource.

  7. Geben Sie unter Tag hinzufügen den Tag-Schlüssel und -Wert ein und wählen Sie Tag hinzufügen.

    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 unter Filter, den Ressourcentyp (z. B. Instances) aus.

  6. Aktivieren Sie in der Ressourcenliste das Kontrollkästchen neben den einzelnen Ressourcen.

  7. Geben Sie unter Tag entfernen den Tag-Schlüssel ein, und wählen Sie Tag entfernen.

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 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. Wählen Sie im Navigationsbereich einen Ressourcentyp aus (z. B. Instances).

  2. Wählen Sie das Suchfeld aus.

  3. Wählen Sie den Tag-Schlüssel aus der Liste aus.

  4. Wählen Sie den entsprechenden Tag-Wert aus der Liste.

  5. Wenn Sie fertig sind, entfernen Sie den Filter.

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

Arbeiten mit Tags über die Befehlszeile

Sie können Tags zu vielen EC2-Ressourcen hinzufügen, wenn Sie sie erstellen, indem Sie den Parameter Tag-Spezifikationen für den create-Befehl verwenden. Sie können die Tags für eine Ressource mit dem describe-Befehl für die Ressource anzeigen. Sie können auch Tags für vorhandene Ressourcen hinzufügen, aktualisieren oder löschen, indem Sie die folgenden Befehle verwenden.

Aufgabe AWS CLI AWS-Tools für Windows PowerShell

Hinzufügen oder Überschreiben eines oder mehrerer Tags

create-tags

New-EC2Tag

Löschen eines oder mehrerer Tags

delete-tags

Remove-EC2Tag

Beschreiben eines oder mehrerer Tags

describe-tags

Get-EC2Tag

Hinzufügen von Tags bei der Ressourcenerstellung

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

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

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

Der folgende run-instance-Befehl startet eine Instance und wendet ein Tag mit dem Schlüssel webserver und dem Wert production auf die Instance an. Der Befehl wendet auch ein Tag mit dem Schlüssel cost-center und dem Wert 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: Erstellen eines Volumes und Anwenden eines Tags

Der folgende create-volume-Befehl erstellt ein Volume und wendet zwei Tags an: 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}]'

Hinzufügen von Tags zu einer vorhandenen Ressource

In den folgenden Beispielen wird veranschaulicht, wie Sie mithilfe des create-tags-Befehls Tags zu einer vorhandenen Ressource hinzufügen.

Beispiel: Hinzufügen eines Tags zu einer Ressource

Der folgende Befehl fügt das Tag Stack=production zu dem angegebenen Abbild hinzu oder überschreibt ein vorhandenes Tag für das AMI, wobei der Tag-Schlüssel Stack ist. Wird der Befehl erfolgreich ausgeführt, wird keine Ausgabe zurückgegeben.

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

Beispiel: Hinzufügen von Tags zu mehreren Ressourcen

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: Hinzufügen von Tags mit Sonderzeichen

In diesem Beispiel wird das Tag [Group]=test zu einer Instance hinzugefügt. Die eckigen Klammern ([ und ]) sind Sonderzeichen, die mit Escape-Zeichen versehen werden müssen.

Wenn Sie Linux oder OS X verwenden, um die Sonderzeichen mit Escape-Zeichen zu versehen, schließen Sie das Element mit dem Sonderzeichen in doppelte Anführungszeichen (") ein und schließen Sie dann die gesamte Schlüssel- und Wertstruktur in einfache Anführungszeichen (') ein.

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

Wenn Sie Windows verwenden, um die Sonderzeichen mit Escape-Zeichen zu versehen, schließen Sie das Element, das Sonderzeichen enthält, in doppelte Anführungszeichen (") ein und stellen Sie jedem doppelten Anführungszeichen wie folgt einen umgekehrten Schrägstrich (\) voran:

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

Wenn Sie Windows PowerShell verwenden, um die Sonderzeichen mit Escape-Zeichen zu versehen, schließen Sie den Wert, der Sonderzeichen enthält, in doppelte Anführungszeichen (") ein, stellen Sie jedem doppelten Anführungszeichen einen umgekehrten Schrägstrich (\) voran und schließen Sie dann die gesamte Schlüssel- und Wertstruktur wie folgt in einfache Anführungszeichen (') ein:

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

Beschreiben von markierten Ressourcen

Die folgenden Beispiele zeigen, wie Sie Filter mit describe-instances verwenden, um Instances mit bestimmten Tags anzuzeigen. Alle EC2-Beschreibungsbefehle verwenden diese Syntax, um nach Tag über einen einzelnen Ressourcentyp hinweg zu filtern. Alternativ können Sie den Befehl describe-tags verwenden, um über EC2-Ressourcentypen hinweg nach Tag zu filtern.

Beispiel: 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: 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: 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üssels.

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

Beispiel: Beschreiben aller EC2-Ressourcen mit dem angegebenen Tag

Der folgende Befehl beschreibt alle EC2-Ressourcen mit dem Tag Stack=Test.

aws ec2 describe-tags \ --filters Name=key,Values=Stack Name=value,Values=Test

Hinzufügen von Tags zu einer Ressource mithilfe von CloudFormation

Bei Amazon EC2-Ressourcentypen geben Sie Tags entweder mithilfe einer Tags- oder einer TagSpecifications-Eigenschaft an.

In den folgenden Beispielen wird das Tag Stack=Production mithilfe seiner Tags-Eigenschaft zu AWS::EC2::Instance hinzugefügt.

Beispiel: Tags in YAML

Tags: - Key: "Stack" Value: "Production"

Beispiel: Tags in JSON

"Tags": [ { "Key": "Stack", "Value": "Production" } ]

In den folgenden Beispielen wird das Tag Stack=Production mithilfe seiner TagSpecifications-Eigenschaft zu AWS::EC2::LaunchTemplateData hinzugefügt.

Beispiel: TagSpecifications in YAML

TagSpecifications: - ResourceType: "instance" Tags: - Key: "Stack" Value: "Production"

Beispiel: TagSpecifications in JSON

"TagSpecifications": [ { "ResourceType": "instance", "Tags": [ { "Key": "Stack", "Value": "Production" } ] } ]