

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.

# Kennzeichnen Sie Ihre Amazon Kinesis Data Streams Streams-Ressourcen
<a name="tagging"></a>

*Sie können Streams und erweiterten Fan-Out-Consumern, die Sie in Amazon Kinesis Data Streams erstellen, Ihre eigenen 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 eine einfache und dennoch leistungsstarke Möglichkeit, AWS Ressourcen zu verwalten und Daten, einschließlich Rechnungsdaten, zu organisieren.

**Topics**
+ [Lesen Sie die Grundlagen von Stichwörtern](#tagging-basics)
+ [Verfolgen Sie die Kosten mithilfe von Tagging](#tagging-billing)
+ [Verstehen Sie die Einschränkungen von Tags](#tagging-restrictions)
+ [Taggen Sie Streams mit der Kinesis Data Streams Streams-Konsole](#tagging-console)
+ [Taggen Sie Streams mit dem AWS CLI](#tagging-cli)
+ [Taggen von Streams mithilfe der Kinesis Data Streams APIs](#tagging-api)
+ [Taggen Sie Verbraucher mit dem AWS CLI](#tagging-consumers-cli)
+ [Taggen Sie Verbraucher, die Kinesis Data Streams verwenden APIs](#tagging-consumers-api)

## Lesen Sie die Grundlagen von Stichwörtern
<a name="tagging-basics"></a>

Zu den Kinesis Data Streams Streams-Ressourcen, die Sie taggen können, gehören Datenstreams und erweiterte Fan-Out-Nutzer. Sie verwenden die Kinesis Data Streams Streams-Konsole oder die Kinesis Data Streams Streams-API AWS CLI, um die folgenden Aufgaben auszuführen:
+ Erstellen Sie eine Ressource mit Tags
+ Fügen Sie einer Ressource Tags hinzu
+ Listet die Tags für Ihre Ressourcen auf
+ Entfernen Sie Tags aus einer Ressource

**Anmerkung**  
Mit der Kinesis Data Streams Streams-Konsole können Sie keine Tags auf erweiterte Fan-Out-Nutzer anwenden. Verwenden AWS CLI Sie unsere Kinesis Data Streams Streams-API, um Tags auf Verbraucher anzuwenden. 

Sie können mit Tags auch Ihre -Ressourcen kategorisieren. Sie können Ressourcen 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önnen beispielsweise eine Reihe von Tags definieren, mit deren Hilfe Sie Ressourcen nach Eigentümer 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 

**Wichtig**  
Um beim Erstellen eines Streams Tags hinzuzufügen, müssen Sie die `kinesis:AddTagsToStream` Berechtigungen `kinesis:CreateStream` und für diesen Stream angeben. Sie **können die `kinesis:TagResource` Berechtigung zum Markieren von Streams nicht verwenden**, während Sie sie erstellen.
Um bei der Registrierung als Verbraucher Tags hinzuzufügen, müssen Sie die `kinesis:RegisterStreamConsumer` Berechtigungen `kinesis:TagResource` und angeben.

## Verfolgen Sie die Kosten mithilfe von Tagging
<a name="tagging-billing"></a>

Sie können Tags verwenden, um Ihre AWS Kosten zu kategorisieren und nachzuverfolgen. Wenn Sie Tags auf Ihre Kinesis Data Streams Streams-Ressourcen anwenden, enthält Ihr AWS Kostenzuordnungsbericht die Nutzung und die Kosten, die nach Tags zusammengefasst sind. Sie können Tags verwenden, die Geschäftskategorien wie Kostenstellen, Anwendungsnamen oder Eigentümer repräsentieren, um Ihre Kosten für mehrere Services zu organisieren. Weitere Informationen finden Sie unter [Verwenden von Kostenzuordnungs-Tags für benutzerdefinierte Fakturierungsberichte](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) im *AWS Billing -Benutzerhandbuch*.

## Verstehen Sie die Einschränkungen von Tags
<a name="tagging-restrictions"></a>

Für Tags gelten die folgenden Einschränkungen:

**Grundlegende Einschränkungen**
+ Die maximale Anzahl von Tags pro Ressource beträgt 50.
+ Bei Tag-Schlüsseln und -Werten wird zwischen Groß- und Kleinschreibung unterschieden.
+ Sie können Tags für eine gelöschte Ressource 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 beginnen`aws:`, da dieses Präfix für die Verwendung durch reserviert ist AWS. AWS erstellt in Ihrem Namen Tags, die mit diesem Präfix beginnen, aber Sie können sie 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 Sie Streams mit der Kinesis Data Streams Streams-Konsole
<a name="tagging-console"></a>

Mit der Kinesis Data Streams Streams-Konsole können Sie Tags zu Ihren Streams hinzufügen, aktualisieren, auflisten und entfernen.

**Anzeigen der Tags für einen Stream**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Kinesis-Konsole unter [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis).

1. **Wählen Sie im linken Navigationsbereich Datenstreams aus.**

1. Wählen Sie auf der Seite **Datenstreams** den Stream aus, den Sie taggen möchten.

1. Wählen Sie auf der Seite mit den Stream-Details die Option **Konfiguration** aus.

1. Sehen Sie sich im Abschnitt „**Tags**“ die Tags an, die auf den Stream angewendet wurden.

**Um einen Datenstream mit einem Tag zu erstellen**

1. Öffnen Sie die Kinesis-Data-Streams-Konsole.

1. Wählen Sie im linken Navigationsbereich **Datenströme** aus.

1. Klicken Sie auf **Create data stream (Daten-Stream erstellen)**.

1. Geben Sie auf der Seite **Datenstream erstellen** einen Namen für Ihren Datenstream ein.

1. Wählen Sie für die **Kapazität des Datenstreams** entweder den Modus **On-Demand-Kapazität** oder den Modus **Bereitgestellte** Kapazität aus.

   Weitere Informationen zu den Kapazitätsmodi finden Sie unter[Wählen Sie den richtigen Modus zum Streamen](how-do-i-size-a-stream.md).

1. Gehen Sie im Abschnitt **Tags** wie folgt vor:

   1. Wählen Sie **Neues Tag hinzufügen** aus.

   1. Geben Sie unter **Schlüssel** das Tag ein und geben Sie optional einen Wert in das Feld **Wert** ein.

      Wenn Sie einen Fehler sehen, entspricht entweder der angegebene Tag-Schlüssel oder der Wert nicht den Tag-Einschränkungen. Weitere Informationen finden Sie unter [Verstehen Sie die Einschränkungen von Tags](#tagging-restrictions).

1. Klicken Sie auf **Create data stream (Daten-Stream erstellen)**.

**Um ein Tag in einem Stream hinzuzufügen oder zu aktualisieren**

1. Öffnen Sie die Kinesis-Data-Streams-Konsole.

1. Wählen Sie im linken Navigationsbereich **Datenstreams** aus.

1. Wählen Sie auf der Seite **Datenstreams** den Stream aus, zu dem Sie Tags hinzufügen oder aktualisieren möchten.

1. Wählen Sie auf der Seite mit den Stream-Details die Option **Konfiguration** aus.

1. Wählen Sie im Abschnitt **Tags (Markierungen)** die Option **Manage tags (Tags (Markierungen) verwalten)**.

1. Führen Sie unter **Tags** einen der folgenden Schritte aus:
   + Um ein neues Tag hinzuzufügen, wählen Sie **Neues Tag hinzufügen** aus und geben Sie dann die **Schlüssel** - und **Wertdaten** des Tags ein. Wiederholen Sie diesen Schritt, bis Sie alle Tags hinzugefügt haben.

     Die maximale Anzahl von Tags, die Sie für jeden Stream hinzufügen können, ist 50.
   + Um ein vorhandenes Tag zu aktualisieren, geben Sie einen neuen Tag-Wert in das Feld **Wert** des **Schlüssels** dieses Tags ein.

   Wenn Sie einen Fehler sehen, entspricht entweder der angegebene Tag-Schlüssel oder der Wert nicht den Tag-Einschränkungen. Weitere Informationen finden Sie unter [Verstehen Sie die Einschränkungen von Tags](#tagging-restrictions).

1. Wählen Sie **Änderungen speichern ** aus.

**Entfernen eines Tags von einem Stream**

1. Öffnen Sie die Kinesis-Data-Streams-Konsole.

1. Wählen Sie im linken Navigationsbereich **Datenstreams** aus.

1. Wählen Sie auf der Seite **Datenstreams** den Stream aus, aus dem Sie Tags entfernen möchten.

1. Wählen Sie auf der Seite mit den Stream-Details die Option **Konfiguration** aus.

1. Wählen Sie im Abschnitt **Tags (Markierungen)** die Option **Manage tags (Tags (Markierungen) verwalten)**.

1. Suchen Sie das ****Tag-Schlüssel-Wert-Paar****, das Sie entfernen möchten. Wählen Sie dann **Entfernen** aus.

1. Wählen Sie **Änderungen speichern ** aus.

## Taggen Sie Streams mit dem AWS CLI
<a name="tagging-cli"></a>

Mit dem können Sie Tags zu Ihren Streams hinzufügen, auflisten und entfernen AWS CLI. Beispiele finden Sie in der folgenden Dokumentation.

 [Stream erstellen](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)   
Erzeugt einen Stream mit Tags.

 [add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)   
Fügt Tags für den angegebenen Stream hinzu oder aktualisiert diese.

 [list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)  
Listet die Tags für den angegebenen Stream auf.

 [remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)  
Entfernt Tags von dem angegebenen Stream.

## Taggen von Streams mithilfe der Kinesis Data Streams APIs
<a name="tagging-api"></a>

Mit den Kinesis Data Streams können Sie Tags zu Ihren Streams hinzufügen, auflisten und entfernen. APIs Beispiele finden Sie in der folgenden Dokumentation:

 [CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)   
Erzeugt einen Stream mit Tags.

 [AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)   
Fügt Tags für den angegebenen Stream hinzu oder aktualisiert diese.

 [ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)  
Listet die Tags für den angegebenen Stream auf.

 [RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)  
Entfernt Tags von dem angegebenen Stream.

## Taggen Sie Verbraucher mit dem AWS CLI
<a name="tagging-consumers-cli"></a>

Sie können Tags für Ihre Verbraucher hinzufügen, auflisten und entfernen, indem Sie die verwenden AWS CLI. Beispiele finden Sie in der folgenden Dokumentation:

[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)  
Registriert einen Verbraucher für einen Kinesis-Datenstrom mit Tags. 

[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)  
Fügt Tags für die angegebene Kinesis-Ressource hinzu oder aktualisiert sie.

[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)  
Listet die Tags für die angegebene Kinesis-Ressource auf.

[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)  
Entfernt Tags aus der angegebenen Kinesis-Ressource.

## Taggen Sie Verbraucher, die Kinesis Data Streams verwenden APIs
<a name="tagging-consumers-api"></a>

Mit den Kinesis Data Streams APIs können Sie Tags für Ihre Verbraucher hinzufügen, auflisten und entfernen. Beispiele finden Sie in der folgenden Dokumentation:

[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)  
Registriert einen Verbraucher für einen Kinesis-Datenstrom mit Tags.

[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)  
Fügt Tags für die angegebene Kinesis-Ressource hinzu oder aktualisiert sie.

[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)  
Listet die Tags für die angegebene Kinesis-Ressource auf.

[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)  
Entfernt Tags aus der angegebenen Kinesis-Ressource.