使用 Amazon AppStream 2.0 API、AWS SDK 或 AWS CLI 处理标签 - Amazon AppStream 2.0

使用 Amazon AppStream 2.0 API、AWS SDK 或 AWS CLI 处理标签

如果使用 AppStream 2.0 API、AWS SDK 或 AWS 命令行界面（AWS CLI），您可以在创建新的资源时使用以下 AppStream 2.0 操作和 tags 参数添加标签。

注意

您可以在标签键和值中使用空格。要在使用 AWS CLI 时指示空格，请使用“\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 SDK 或 AWS CLI 操作来添加、编辑、删除或列出现有 AppStream 2.0 资源的标签时，请使用 Amazon 资源名称（ARN）来指定资源。ARN 唯一地标识某个 AWS 资源，并使用以下常规语法。

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

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

账户

AWS 账户 ID，不包含连字符（例如，123456789012）。

{resourceType}

资源的类型。您可为以下 AppStream 2.0 资源类型添加标签：image-builder、image、fleet 和 stack。

resourceName

资源的名称。

例如，您可以使用 AWS CLI describe-fleets 命令来获取 AppStream 2.0 实例集的 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"
    }
}