本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
为 Amazon AppStream 2.0 资源添加标签
AWS 允许您以标签的形式为您的 AWS 资源分配元数据。您可以使用这些标签来帮助管理您的 AppStream 2.0 映像生成器、映像、实例集和堆栈,还可以组织数据,包括账单数据。
您可以:
-
按不同方式对资源进行逻辑分组 (例如按用途、拥有者或环境)。
这在您有许多相同类型的资源时会非常有用。
-
根据您分配到资源的标签来快速识别特定资源
-
确定和控制 AWS 成本
例如,您可以确定和分组处于不同环境(例如,开发或生产)中或分配到不同业务部门(例如 HR 或市场营销)的 AppStream 2.0 实例集。然后,您可以在明细级别跟踪这些实例集的相关 AWS 成本。要执行此操作,请注册以获取包含标签键值的 Amazon Web Services 账户账单。有关设置带有标签的成本分配报告的更多信息,请参阅《AWS Billing 用户指南》中的月度成本分配报告。
目录
标签基本知识
与其他 AWS 服务标签类似,标签由一个键值对组成。要为资源添加标签,您需要为每个标签指定一个键 和一个值。键可以是一个常规类别(例如“项目”、“拥有者”或“环境”)并有特定的关联值,您可以在多个资源之间共享相同的键和值。您可以在创建 AppStream 2.0 资源之后立即添加标签,也可以在以后添加。如果您删除资源,则删除时该资源上的标签也将被删除。不过,其他具有相同标签键的 AppStream 2.0 和 AWS 资源不受影响。
您可以修改标签的键和值,还可以随时删除资源的标签。您可以将标签的值设置为空字符串,但是不能将标签的名称设置为空值。如果您添加的标签的值与该实例上现有标签的值相同,新的值就会覆盖旧值。如果删除资源,资源的所有标签也会被删除。
注意
如果您计划设置月度成本分配报告来跟踪 AppStream 2.0 资源的 AWS 成本,请记住,对于在某个月续订的资源,添加到现有 AppStream 2.0 资源的标签将在接下来的第一个月开始显示在您的成本分配报告中。
标签限制
每个 AppStream 2.0 资源的最大标签数是 50。
最大键长度为 128 个 Unicode 字符 (采用 UTF-8 格式)。
最大值长度为 256 个 Unicode 字符 (采用 UTF-8 格式)。
标签键和值区分大小写。
请勿在标签名称或值中使用“aws:”前缀,因为它是保留供 AWS 使用的系统标签。您无法编辑或删除带此前缀的标签名称或值。具有此前缀的标签不计入每个资源的标签数限制。
通常允许使用的字符包括:可用 UTF-8 格式表示的字母、数字和空格,以及以下特殊字符:+ - = . _ : / @。
虽然您可以跨多个资源共享相同的键和值,但不能在同一资源上有重复的键。
-
您可以在创建资源期间为资源添加标签。您还可以添加、编辑和删除已创建的资源的标签。
在 AppStream 2.0 控制台中创建资源时添加标签
当您在 AppStream 2.0 控制台中创建资源时,可以添加一个或多个标签来管理资源。有关更多信息,请参阅以下主题:
映像生成器 – 启动映像生成器来安装和配置流应用程序,步骤 4
映像 – 步骤 6:完成映像的创建,步骤 1
实例集 – 创建实例集,步骤 3
堆栈 – 创建堆栈,步骤 2
在 AppStream 2.0 控制台中添加、编辑和删除现有资源的标签
您可以使用 AppStream 2.0 控制台为现有资源添加、编辑和删除标签。
为现有 AppStream 2.0 资源添加、编辑或删除标签
打开 AppStream 2.0 控制台,网址为 https://console.aws.amazon.com/appstream2
。 -
从导航栏中,选择包含要添加、编辑或删除标签的资源的区域。
-
在导航窗格中,选择资源类型。资源类型可以是映像生成器、映像、实例集或堆栈。
-
从资源列表中选择资源。
选择 Tags、Add/Edit Tags,然后执行下列一个或多个操作:
要添加标签,请选择添加标签,然后键入各个标签的键和值。
要编辑标签,请根据需要修改标签的键和值。
要删除标签,请选择该标签的删除图标 (X)。
选择 Save(保存)。
使用 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 | |
添加新映像生成器的一个或多个标签 | create-imagebuilder | |
添加新堆栈的一个或多个标签 |
您可以使用以下 AppStream 2.0 操作添加、编辑、删除或列出现有资源的标签:
任务 | AWS CLI | API 操作 |
---|---|---|
添加或覆盖资源的一个或多个标签 | tag-resource | |
删除资源的一个或多个标签 | untag-resource | |
列出资源的一个或多个标签 |
当您使用 AppStream 2.0 API、AWS SDK 或 AWS CLI 操作来添加、编辑、删除或列出现有 AppStream 2.0 资源的标签时,请使用 Amazon 资源名称 (ARN) 来指定资源。ARN 唯一地标识某个 AWS 资源,并使用以下常规语法。
arn:aws:appstream:region
:account
:resourceType
/resourceName
区域
-
在其中创建资源的 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"
}
}