使用 Amazon AppStream 2.0 API、 AWS SDK 或 AWS CLI 來處理標籤

如果您使用 AppStream 2.0 API、 AWS SDK 或 AWS 命令列界面 (AWS CLI)，您可以在建立新資源時使用下列 AppStream 2.0 操作搭配 tags 參數來新增標籤。

注意

您可以在標籤鍵和值內使用空格。若要在使用 CLI AWS 時指出空格，請使用 "\s" （不含引號）。

任務	AWS CLI	API 作業
為新的機群新增一或多個標籤	create-fleet	CreateFleet
為新的映像建置器新增一或多個標籤	create-imagebuilder	CreateImageBuilder
為新的堆疊新增一或多個標籤	create-stack	CreateStack

您可以使用以下 AppStream 2.0 操作來新增、編輯、移除或列出現有資源的標籤：

任務	AWS CLI	API 作業
新增或覆寫資源的一或多個標籤	tag-resource	TagResource
移除資源的一或多個標籤	untag-resource	UntagResource
列出資源的一或多個標籤	list-tags-for-resource	ListTagsForResource

當您使用 AppStream 2.0 API、 AWS 開發套件或 AWS CLI 動作來新增、編輯、移除或列出現有 AppStream 2.0 資源的標籤時，請使用其 Amazon Resource Name (ARN) 來指定資源。ARN 可唯一識別 AWS 資源，並使用下列一般語法。

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

region

建立資源 AWS 的區域 （例如 us-east-1)。

account

AWS 帳戶 ID，不含連字號 （例如 123456789012)。

resourceType

資源的類型。您可以標記下列 AppStream 2.0 資源類型：image-builder、image、fleet 和 stack。

resourceName

資源的名稱。

例如，您可以使用 CLI describe-fleets 命令取得 AppStream 2.0 AWS 機群的 ARN。複製以下命令。

aws appstream describe-fleets

針對包含單一名為 TestFleet 機群的環境，此資源的 ARN 在 JSON 輸出中看起來會如下所示。

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

在您取得此資源的 ARN 後，您可以使用 tag-resource 命令來新增兩個標籤：

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

第一個標籤 (Environment=Test) 指出機群位於測試環境。第二個標籤 (Department=IT) 則指出機群位於 IT 部門。

您可以使用以下命令來列出您新增到機群的兩個標籤。

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

針對此範例，JSON 輸出看起來會如下所示：

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