Markieren von Amazon-AppStream-2.0-Ressourcen

AWS ermöglicht Ihnen die Zuweisung von Metadaten zu Ihren AWS-Ressourcen in Form von Tags. Sie können diese Tags verwenden, um Ihre Image Builder, Abbildungen, Flotten und Stapel in AppStream 2.0 zu verwalten und um Daten zu organisieren, einschließlich Fakturierungsdaten.

Sie haben folgende Möglichkeiten:

• 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

• Identifizieren und Kontrollieren von AWS-Kosten

Sie können beispielsweise AppStream-2.0-Flotten identifizieren und gruppieren, die sich in verschiedenen Umgebungen befinden (z. B. Entwicklung oder Produktion), oder die unterschiedlichen Geschäftseinheiten zugeordnet sind (z. B. HR oder Marketing). Sie können dann die zugehörigen AWS-Kosten für diese Flotten detailliert nachverfolgen. 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 im AWS Billing-Benutzerhandbuch.

Grundlagen des Markierens

Tags bestehen aus einem Schlüssel-Wert-Paar, ähnlich wie bei anderen AWS-Services-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 AppStream-2.0-Ressource sofort nach dem Erstellen oder später markieren. Wenn Sie eine Ressource löschen, werden die Tags beim Löschen von dieser Ressource entfernt. Andere AppStream-2.0- und AWS-Ressourcen mit denselben Tag-Schlüssel werden dadurch jedoch nicht beeinträchtigt.

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 einen monatlichen Kostenzuordnungsbericht einrichten wollen, um AWS-Kosten für AppStream-2.0-Ressourcen nachzuverfolgen, sollten Sie bedenken, dass Tags, die vorhandenen AppStream-2.0-Ressourcen hinzugefügt wurden, in Ihrem monatlichen Kostenzuordnungsbericht am Ersten des Folgemonats für Ressourcen erscheinen, die in diesem Monat verlängert werden.

Tag-Einschränkungen

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

• Die maximale Schlüssellänge beträgt 128 Unicode-Zeichen in UTF-8.

• Die maximale Wertelänge beträgt 256 Unicode-Zeichen in UTF-8.

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

• Verwenden Sie für Tag-Namen oder Werte nicht das Präfix „aws:“, da es sich dabei 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: + - = . _ : / @.

• 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 bei der Ressourcenerstellung in der AppStream-2.0-Konsole

Wenn Sie eine Ressource in der AppStream-2.0-Konsole erstellen, können Sie einzelne oder mehrere Tags zum Verwalten der Ressource hinzufügen. Weitere Informationen finden Sie unter den folgenden Themen:

• Image Builder – Starten eines Image Builder zum Installieren und Konfigurieren von Streaming-Anwendungen, Schritt 4

• Abbildungen – Schritt 6: Beenden Sie das Erstellen Ihres Abbilds, Schritt 1

• Flotten – Erstellen einer Flotte, Schritt 3

• Stacks – Erstellen eines Stacks, Schritt 2

Hinzufügen, Bearbeiten und Löschen von Tags für vorhandene Ressourcen in der AppStream-2.0-Konsole

Sie können Tags für vorhandene Ressourcen mit Hilfe der AppStream-2.0-Konsole hinzufügen, bearbeiten und löschen.

So fügen Sie einer vorhandenen AppStream-2.0-Ressource Tags hinzu, bearbeiten diese oder löschen sie

1. Öffnen Sie die AppStream-2.0-Konsole unter https://console.aws.amazon.com/appstream2.

2. 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.

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

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

5. Wählen Sie Tags, Add/Edit Tags, 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.

6. Wählen Sie Save (Speichern).

Arbeiten mit Tags unter Verwendung der AppStream-2.0-API, eines AWS SDK oder der AWS-CLI

Wenn Sie die AppStream-2.0-API, ein AWS SDK oder die AWS-Befehlszeilenschnittstelle (AWS-CLI) verwenden, können Sie die folgenden AppStream-2.0-Operationen mit dem Parameter tags verwenden, um beim Erstellen von Ressourcen Tags hinzuzufügen.

Anmerkung

Sie können Leerzeichen in Tag-Schlüsseln und -Werten verwenden. Sie haben auch bei Verwendung der AWS-CLI die Möglichkeit, ein Leerzeichen anzugeben, indem Sie „\s“ (ohne die Anführungszeichen) eingeben.

Aufgabe	AWS CLI	API-Operation
Hinzufügen einzelner oder mehrerer Tags für eine neue Flotte	create-fleet	CreateFleet
Hinzufügen einzelner oder mehrerer Tags für einen neuen Image Builder	create-imagebuilder	CreateImageBuilder
Hinzufügen einzelner oder mehrerer Tags für einen neuen Stack	create-stack	CreateStack

Sie können die folgenden AppStream-2.0-Operationen verwenden, um vorhandenen Ressourcen Tags hinzuzufügen bzw. diese Tags 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	TagResource
Entfernen einzelner oder mehrerer Tags für eine Ressource	untag-resource	UntagResource
Auflisten einzelner oder mehrerer Tags für eine Ressource	list-tags-for-resource	ListTagsForResource

Wenn Sie die AppStream-2.0-API, ein AWS SDK oder AWS-CLI-Aktionen verwenden, um einer vorhandenen AppStream-2.0-Ressource Tags hinzuzufügen bzw. diese zu bearbeiten, zu entfernen oder aufzulisten, geben Sie die Ressource über den Amazon-Ressourcennamen (ARN) an. Ein ARN kennzeichnet 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).

Konto

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

RessourcenTyp

Der Typ der Ressource. Sie können die folgenden AppStream-2.0-Ressourcentypen markieren: image-builder, image, fleet und stack.

RessourcenNamen

Der Name der Ressource.

Beispielsweise können Sie den ARN für eine AppStream-2.0-Flotte mit dem AWS-CLI-Befehl describe-fleets erhalten. 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 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"
    }
}