使用亚马逊 WorkSpaces 应用程序 API、AWS软件开发工具包或 AWS CLI 处理标签 - Amazon WorkSpaces 应用程序

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用亚马逊 WorkSpaces 应用程序 API、AWS软件开发工具包或 AWS CLI 处理标签

如果您使用的是 WorkSpaces 应用程序 API、S AWS DK 或AWS命令行界面 (AWSCLI)，则可以在创建新资源时使用以下带有tags参数的 WorkSpaces 应用程序操作来添加标签。

注意

您可以在标签键和值中使用空格。要在使用 AWS CLI 时表示空格，请使用 “\ s”（不带引号）。

Task AWS CLI API 操作
添加新实例集的一个或多个标签 create-fleet

CreateFleet
添加新映像生成器的一个或多个标签 create-imagebuilder

CreateImageBuilder
添加新堆栈的一个或多个标签

create-stack

CreateStack

您可以使用以下 WorkSpaces 应用程序操作为现有资源添加、编辑、移除或列出标签：

Task AWS CLI API 操作
添加或覆盖资源的一个或多个标签 tag-resource

TagResource
删除资源的一个或多个标签 untag-resource

UntagResource
列出资源的一个或多个标签

list-tags-for-resource

ListTagsForResource

当您使用 WorkSpaces 应用程序 API、AWS软件开发工具包或 AWS CLI 操作为现有 WorkSpaces 应用程序资源添加、编辑、移除或列出标签时，请使用其亚马逊资源名称 (ARN) 指定该资源。ARN 唯一标识AWS资源并使用以下通用语法。

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

创建资源的AWS区域（例如，us-east-1）。

account

不带连字符的 AWS 账户 ID（例如，123456789012）。

resourceType

资源的类型。您可以标记以下 WorkSpaces 应用程序资源类型：image-builder、imagefleet、和stack。

resourceName

资源的名称。

例如，您可以使用 CLI d es cribe-fleets AWS 命令获取 WorkSpaces 应用程序队列的 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"
    }
}