

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 Ihrer WorkSpaces Amazon-Anwendungsressourcen
<a name="tagging-basic"></a>

AWS ermöglicht es Ihnen, Ihren AWS Ressourcen Metadaten in Form von Tags zuzuweisen. Sie können diese Tags verwenden, um die Image-Builder, Images, Flotten und Stacks Ihrer WorkSpaces Anwendungen zu verwalten und Daten, einschließlich Rechnungsdaten, zu organisieren. 

Sie können:
+ Logische Gruppierung von Ressourcen auf verschiedene Arten (z. B. nach Zweck, Eigentümer oder Umgebung).

  Dies ist nützlich, wenn Sie viele Ressourcen desselben Typs haben.
+ Eine spezifische Ressource basierend auf den Tags, die Sie ihr zugeordnet haben, schnell erkennen
+  AWS Kosten identifizieren und kontrollieren

Sie können beispielsweise WorkSpaces Anwendungsflotten identifizieren und gruppieren, die sich in unterschiedlichen Umgebungen befinden (z. B. Entwicklung oder Produktion) oder die verschiedenen Geschäftsbereichen (wie Personalabteilung oder Marketing) zugewiesen sind. Anschließend können Sie die damit verbundenen AWS Kosten für diese Flotten detailliert verfolgen. Dazu müssen Sie sich registrieren, um Ihre Amazon-Web-Services-Kontorechnung mit Tag-Schlüsselwerten zu erhalten. Weitere Informationen zum Einrichten eines Kostenzuordnungsberichts mit Tags finden Sie unter [Monatlicher Kostenzuordnungsbericht](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) im *AWS Billing -Benutzerhandbuch*. 

**Topics**
+ [Grundlagen des Markierens](tagging-introduction.md)
+ [Tag-Einschränkungen](tag-restrictions.md)
+ [Hinzufügen von Tags während der Ressourcenerstellung](basic-tagging-resource-creation-console.md)
+ [Hinzufügen, Bearbeiten und Löschen von Tags](basic-tagging-console.md)
+ [Verwenden der API, des SDK oder der CLI](basic-tagging-API-SDK-CLI.md)

# Tagging-Grundlagen für Amazon-Anwendungen WorkSpaces
<a name="tagging-introduction"></a>

Tags bestehen aus einem Schlüssel-Wert-Paar, ähnlich wie andere AWS Service-Tags. Geben Sie zum Markieren einer Ressource einen *Schlüssel* und einen *Wert* für jedes Tag an. Ein Schlüssel kann eine allgemeine Kategorie sein, wie zum Beispiel „Projekt“, „Eigentümer“ oder „Umgebung“, mit spezifischen zugehörigen Werten, und Sie können denselben Schlüssel und Wert an mehrere Ressourcen weitergeben. Sie können eine WorkSpaces Anwendungsressource sofort nach ihrer Erstellung oder zu einem späteren Zeitpunkt taggen. Wenn Sie eine Ressource löschen, werden die Tags beim Löschen von dieser Ressource entfernt. Andere WorkSpaces Anwendungen und AWS Ressourcen, die denselben Tagschlüssel haben, sind jedoch nicht betroffen.

Sie können Tag (Markierung)-Schlüssel und -Werte bearbeiten und Tags (Markierungen) jederzeit von einer Ressource entfernen. Sie können den Wert eines Tags zwar auf eine leere Zeichenfolge, nicht aber den Namen eines Tags auf Null setzen. Wenn Sie ein Tag (Markierung) mit demselben Schlüssel wie ein vorhandener Tag (Markierung) für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben. Wenn Sie eine Ressource löschen, werden alle Tags (Markierungen) der Ressource ebenfalls gelöscht. 

**Anmerkung**  
Wenn Sie planen, einen monatlichen Kostenzuordnungsbericht einzurichten, um die AWS Kosten für WorkSpaces Anwendungsressourcen nachzuverfolgen, denken Sie daran, dass Tags, die zu vorhandenen WorkSpaces Anwendungsressourcen hinzugefügt wurden, am ersten Tag des Folgemonats in Ihrem Kostenzuordnungsbericht für Ressourcen erscheinen, die in diesem Monat erneuert werden. 

# Tag-Einschränkungen für WorkSpaces Amazon-Anwendungen
<a name="tag-restrictions"></a>
+ Die maximale Anzahl von Tags pro WorkSpaces Anwendungsressource beträgt 50.
+ Die maximale Länge von Schlüsseln beträgt 128 Unicode-Zeichen in UTF-8.
+ Die maximale Länge eines Werts beträgt 256 Unicode-Zeichen in UTF-8.
+ Bei Tag-Schlüsseln und -Werten wird zwischen Groß- und Kleinschreibung unterschieden.
+ Verwenden Sie nicht das Präfix „aws:“ in Ihren Tag-Namen oder -Werten, da es sich um ein System-Tag handelt, das für die AWS Verwendung reserviert ist. Sie können Tag-Namen oder Werte mit diesem Präfix nicht bearbeiten oder löschen. Tags mit diesem Präfix werden nicht als Ihre Tags pro Ressourcenlimit angerechnet.
+ Generell sind die folgenden Zeichen zulässig: Buchstaben, Zahlen und Leerstellen, die in UTF-8 darstellbar sind, sowie die folgenden Sonderzeichen: \$1 - = . \$1 : / @.
+ Sie können zwar den gleichen Schlüssel und Wert an mehrere Ressourcen weitergeben, aber keine doppelten Schlüssel für dieselbe Ressource verwenden.
+ Sie können Tags für Ressourcen im Rahmen der Ressourcenerstellung hinzufügen. Sie können außerdem bereits erstellten Ressourcen Tags hinzufügen und diese bearbeiten oder löschen.

# Hinzufügen von Tags während der Ressourcenerstellung in der Amazon WorkSpaces Applications Console
<a name="basic-tagging-resource-creation-console"></a>

Wenn Sie eine Ressource in der WorkSpaces Anwendungskonsole erstellen, können Sie ein oder mehrere Tags hinzufügen, um die Ressource zu verwalten. Weitere Informationen finden Sie unter den folgenden Themen:
+ Image Builder – [Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen](tutorial-image-builder-create.md), Schritt 4
+ Abbildungen – [Schritt 6: Beenden Sie das Erstellen Ihres Abbilds](tutorial-image-builder.md#tutorial-image-builder-finish-create-image), Schritt 1
+ Flotten – [Eine Flotte in Amazon WorkSpaces Applications erstellen](set-up-stacks-fleets-create.md), Schritt 3
+ Stacks – [Erstellen Sie einen Stack in Amazon WorkSpaces Applications](set-up-stacks-fleets-install.md), Schritt 2

# Hinzufügen, Bearbeiten und Löschen von Tags für bestehende Ressourcen in der Amazon WorkSpaces Applications Console
<a name="basic-tagging-console"></a>

Mithilfe der WorkSpaces Anwendungskonsole können Sie Tags für vorhandene Ressourcen hinzufügen, bearbeiten und löschen. 

**Um Tags für eine bestehende WorkSpaces Anwendungsressource hinzuzufügen, zu bearbeiten oder zu löschen**

1. Öffnen Sie die WorkSpaces Anwendungskonsole zu [https://console.aws.amazon.com/appstream2/Hause](https://console.aws.amazon.com/appstream2/home).

1. Wählen Sie in der Navigationsleiste die Region aus, die die Ressource enthält, für die Sie Tags hinzufügen, bearbeiten oder löschen möchten. 

1. Wählen Sie im Navigationsbereich den Ressourcentyp aus. Der Ressourcentyp kann ein Image Builder, ein Image, eine Flotte oder ein Stack sein.

1. Wählen Sie die Ressource aus der Liste aus. 

1. Wählen Sie **Tags**, **Tags hinzufügen/bearbeiten**, und führen Sie dann einen oder mehrere der folgenden Schritte aus:
   + Wählen Sie **Tag hinzufügen** aus und geben Sie anschließend den Schlüssel sowie den Wert für die einzelnen Tags an, um ein Tag hinzuzufügen.
   + Um ein Tag zu bearbeiten, ändern Sie Schlüssel und Wert für das Tag nach Bedarf ab.
   + Um ein Tag zu löschen, wählen Sie das Symbol **Delete** (X) für das Tag.

1. Wählen Sie **Speichern**.

# Arbeiten mit Tags mithilfe der Amazon WorkSpaces Applications API, eines AWS SDK oder der AWS CLI
<a name="basic-tagging-API-SDK-CLI"></a>

Wenn Sie die WorkSpaces Anwendungs-API, ein AWS SDK oder die AWS Befehlszeilenschnittstelle (AWS CLI) verwenden, können Sie die folgenden WorkSpaces Anwendungsoperationen mit dem `tags` Parameter verwenden, um beim Erstellen neuer Ressourcen Tags hinzuzufügen. 

**Anmerkung**  
Sie können Leerzeichen in Tag-Schlüsseln und -Werten verwenden. Um bei der Verwendung der AWS CLI ein Leerzeichen anzugeben, verwenden Sie „\$1 s“ (ohne Anführungszeichen).


| Aufgabe | AWS CLI | API-Operation | 
| --- | --- | --- | 
| Hinzufügen einzelner oder mehrerer Tags für eine neue Flotte | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html)  |  [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags)  | 
| Hinzufügen einzelner oder mehrerer Tags für einen neuen Image Builder | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) |  [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags)  | 
| Hinzufügen einzelner oder mehrerer Tags für einen neuen Stack |  [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html)  |  [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags)  | 

Sie können die folgenden WorkSpaces Anwendungsoperationen verwenden, um Tags für vorhandene Ressourcen hinzuzufügen, zu bearbeiten, zu entfernen oder aufzulisten: 


| Aufgabe | AWS CLI | API-Operation | 
| --- | --- | --- | 
| Hinzufügen oder Überschreiben einzelner oder mehrerer Tags für eine Ressource | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html)  |  [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html)  | 
| Entfernen einzelner oder mehrerer Tags für eine Ressource | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) |  [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html)  | 
| Auflisten einzelner oder mehrerer Tags für eine Ressource |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html)  |  [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html)  | 

Wenn Sie die WorkSpaces Anwendungs-API, ein AWS SDK oder AWS CLI-Aktionen verwenden, um Tags für eine bestehende WorkSpaces Anwendungsressource hinzuzufügen, zu bearbeiten, zu entfernen oder aufzulisten, geben Sie die Ressource mit ihrem Amazon-Ressourcennamen (ARN) an. Ein ARN identifiziert eine AWS Ressource eindeutig und verwendet die folgende allgemeine Syntax.

```
arn:aws:appstream:region:account:resourceType/resourceName
```

***region***  
Die AWS Region, in der die Ressource erstellt wurde (z. B.`us-east-1`).

***account***  
Die AWS-Konto ID ohne Bindestriche (z. B.`123456789012`).

***resourceType***  
Der Typ der Ressource. Sie können die folgenden Ressourcentypen WorkSpaces für Anwendungen taggen:`image-builder`, `image``fleet`, und. `stack`

***resourceName***  
Der Name der Ressource.

Sie können beispielsweise den ARN für eine WorkSpaces Anwendungsflotte mit dem CLI-Befehl AWS [describe-fleets](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html) abrufen. Kopieren Sie den folgenden Befehl.

```
aws appstream describe-fleets
```

Für eine Umgebung mit einer einzelnen Flotte mit dem Namen `TestFleet` würde der ARN für diese Ressource in der JSON-Ausgabe ähnlich wie folgt aussehen: 

```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```

Nachdem Sie den ARN für diese Ressource erhalten haben, können Sie mit dem Befehl [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) zwei Tags hinzufügen: 

```
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT
```

Das erste Tag, `Environment=Test`, gibt an, dass sich die Flotte in einer Testumgebung befindet. Das zweite Tag, `Department=IT`, gibt an, dass sich die Flotte in der IT-Abteilung befindet. 

Mit dem folgenden Befehl können Sie die beiden Tags auflisten, die Sie der Flotte hinzugefügt haben.

```
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet
```

Für dieses Beispiel sieht die JSON-Ausgabe wie folgt aus: 

```
{
    "Tags": {
       "Environment" : "Test",
       "Department" : "IT"
    }
}
```