Tagging von Streams in Amazon Kinesis Data Streams

Sie können den Streams, die Sie in Amazon Kinesis Data Streams erstellen, eigene Metadaten in Form von Tags zuweisen. Ein Tag ist ein Schlüssel-Wert-Paar, das Sie für einen Stream definieren. Die Verwendung von Tags ist ein einfacher, aber effizienter Weg, um AWS-Ressourcen zu verwalten und Daten, einschließlich Fakturierungsdaten, zu organisieren.

Grundlagen zu Tags

Sie verwenden die Kinesis-Data-Streams-Konsole, AWS CLI oder die Kinesis-Data-Streams-API, um die folgenden Aufgaben auszuführen:

• Hinzufügen von Tags zu einem Stream

• Auflisten der Tags für Ihre Streams

• Entfernen von Tags von einem Stream

Sie können Tags verwenden, um Ihre Streams zu kategorisieren. Sie können Streams beispielsweise nach Zweck, Inhaber oder Umgebung kategorisieren. Da Sie für jeden Tag den Schlüssel und Wert definieren, können Sie eine auf benutzerdefinierte Reihe von Kategorien anlegen, die Ihren jeweiligen Anforderungen gerecht wird. Sie könnten zum Beispiel eine Reihe von Tags definieren, mit der Sie Streams nach Inhaber und zugehöriger Anwendung nachverfolgen können. Im Folgenden finden Sie einige Beispiele für Tags:

• Projekt: Projektname

• Inhaber: Name

• Zweck: Belastungstest

• Anwendung: Anwendungsname

• Umgebung: Produktion

Kosten mithilfe von Tags verfolgen

Sie können Tags verwenden, um Ihre AWS-Kosten zu kategorisieren und zu verfolgen. Wenn Sie Tags auf AWS-Ressourcen anwenden, einschließlich Streams, enthält der AWS-Kostenzuordnungsbericht mit Tags aggregierte Nutzungs- und Kostendaten. Sie können Tags anwenden, die geschäftliche Kategorien (wie Kostenstellen, Anwendungsnamen oder Eigentümer) darstellen, um die Kosten für mehrere Services zu organisieren. Weitere Informationen finden Sie unter Verwenden von Kostenzuordnungs-Tags für benutzerdefinierte Fakturierungsberichte im AWS Billing-Benutzerhandbuch.

Tag-Einschränkungen

Für Tags gelten die folgenden Einschränkungen.

Grundlegende Einschränkungen

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

• Bei Tag-Schlüsseln und -Werten wird zwischen Groß- und Kleinschreibung unterschieden.

• Sie können Tags für einen gelöschten Stream nicht ändern oder bearbeiten.

Einschränkungen für Tag-Schlüssel

• Jeder Tag-Schlüssel muss einmalig sein. Wenn Sie einen Tag mit einem Schlüssel hinzufügen, der bereits verwendet wird, wird das vorhandene Schlüssel-Wert-Paar durch den neuen Tag überschrieben.

• Sie können einen Tag-Schlüssel nicht mit aws: beginnen, da dieses Präfix für die Verwendung durch AWS reserviert ist. AWS erstellt in Ihrem Namen Tags, die mit diesem Präfix beginnen, Sie können diese jedoch nicht bearbeiten oder löschen.

• Tag-Schlüssel müssen zwischen 1 und 128 Unicode-Zeichen lang sein.

• Tag-Schlüssel müssen die folgenden Zeichen enthalten: Unicode-Zeichen, Ziffern, Leerzeichen sowie die folgenden Sonderzeichen: _ . / = + - @.

Einschränkungen für den Tag-Wert

• Tag-Werte müssen zwischen 0 und 255 Unicode-Zeichen lang sein.

• Tag-Werte können leer sein. Ansonsten müssen sie die folgenden Zeichen enthalten: Unicode-Zeichen, Ziffern, Leerzeichen und eines der folgenden Sonderzeichen: _ . / = + - @.

Taggen von Streams mithilfe der Kinesis-Data-Streams-Konsole

Sie können Tags mithilfe der Kinesis-Data-Streams-Konsole hinzufügen, auflisten und entfernen.

Anzeigen der Tags für einen Stream

1. Öffnen Sie die Kinesis-Data-Streams-Konsole. Erweitern Sie in der Navigationsleiste die Regionsauswahl und wählen Sie eine Region aus.

2. Wählen Sie auf der Seite Stream List (Stream-Liste) einen Stream aus.

3. Klicken Sie auf der Seite Stream Details (Stream-Details) auf die Registerkarte Tags.

Hinzufügen eines Tags zu einem Stream

1. Öffnen Sie die Kinesis-Data-Streams-Konsole. Erweitern Sie in der Navigationsleiste die Regionsauswahl und wählen Sie eine Region aus.

2. Wählen Sie auf der Seite Stream List (Stream-Liste) einen Stream aus.

3. Klicken Sie auf der Seite Stream Details (Stream-Details) auf die Registerkarte Tags.

4. Geben Sie den Tag-Schlüssel in das Feld Key (Schlüssel) ein oder geben Sie optional einen Tag-Wert im Feld Value (Wert) an und klicken Sie dann auf Add Tag (Tag hinzufügen).

   Wenn die Schaltfläche Add Tag (Tag hinzufügen) nicht aktiviert ist, entspricht entweder der angegebene Tag-Schlüssel oder Tag-Wert nicht den Tag-Einschränkungen. Weitere Informationen finden Sie unter Tag-Einschränkungen.

5. Um Ihr neues Tag in der Liste auf der Registerkarte Tags anzuzeigen, klicken Sie auf das Aktualisierungssymbol.

Entfernen eines Tags von einem Stream

1. Öffnen Sie die Kinesis-Data-Streams-Konsole. Erweitern Sie in der Navigationsleiste die Regionsauswahl und wählen Sie eine Region aus.

2. Wählen Sie auf der Seite „Stream List” einen Stream aus.

3. Klicken Sie auf der Seite „Stream Details (Stream-Details)” auf die Registerkarte Tags und anschließend auf der Symbol Remove (Entfernen) für den Tag.

4. Klicken Sie im Dialogfeld Delete Tag (Tag löschen) auf Yes, Delete (Ja, löschen).

Tagging von Streams mithilfe der AWS CLI

Sie können Tags mithilfe der AWS CLI hinzufügen, auflisten und entfernen. Beispiele finden Sie in der folgenden Dokumentation.

add-tags-to-stream

Fügt Tags für den angegebenen Stream hinzu oder aktualisiert diese.

list-tags-for-stream

Listet die Tags für den angegebenen Stream auf.

remove-tags-from-stream

Entfernt Tags von dem angegebenen Stream.

Taggen von Streams mithilfe der Kinesis-Data-Streams-API

Sie können Tags mithilfe der Kinesis-Data-Streams-API hinzufügen, auflisten und entfernen. Beispiele finden Sie in der folgenden Dokumentation:

AddTagsToStream

Fügt Tags für den angegebenen Stream hinzu oder aktualisiert diese.

ListTagsForStream

Listet die Tags für den angegebenen Stream auf.

RemoveTagsFromStream

Entfernt Tags von dem angegebenen Stream.