Arbeiten mit Tags mithilfe der Amazon AppStream 2.0-API, eines AWS SDK oder einer AWS CLI - Amazon AppStream 2.0

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.

Arbeiten mit Tags mithilfe der Amazon AppStream 2.0-API, eines AWS SDK oder einer 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 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 „\ s“ (ohne Anführungszeichen).

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

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 Tags für eine bestehende AppStream 2.0-Ressource 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 AppStream 2.0-Ressourcentypen taggen:image-builder, imagefleet, und. stack

resourceName

Der Name der Ressource.

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