为 AWS IoT 1-Click 资源添加标签 - AWS IoT 1-Click

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

为 AWS IoT 1-Click 资源添加标签

为了帮助您管理 AWS IoT 1-Click 资源,您可以选择使用标签将自己的元数据分配给任何基于 ARN 的资源。本章介绍标签并说明如何创建标签。

有关标签的基本知识

标签可让您按各种标准(例如用途、所有者或环境)对 AWS IoT 1-Click 资源进行分类。这在您拥有许多同类型资源时很有用-您可以根据分配给资源的标签快速搜索和识别特定资源。每个标签都包含您定义的一个键和一个可选值。例如,您可以为特定经理或账户拥有的多个按钮定义一组标签。您可以根据添加的标签搜索和筛选资源。我们建议您针对每类资源设计一组标签,以满足您的需要。使用一组连续的标签键,管理资源时会更加轻松。有关更多信息,请参阅 AWS 标记策略

您还可以使用标签对成本进行分类和跟踪。当您将标签应用于资源时,AWS 将以逗号分隔值 (CSV) 文件格式生成一份成本分配报告,其中包括按标签汇总的使用率和成本。您可以设置代表业务类别 (例如成本中心、应用程序名称或所有者) 的标签,以便整理多种服务的成本。有关使用成本分配标签的更多信息,请参阅使用成本分配标签中的AWS Billing and Cost Management 用户指南

为便于使用,您可以使用 AWS 管理控制台中的标签编辑器,此编辑器提供了一种用于创建和管理标签的集中而统一的方法。有关更多信息,请参阅 。使用标签编辑器AWS 管理控制台入门

您还可以使用 AWS CLI 和 AWS IoT 1-Click 设备和项目 API 处理标签。您可以在创建 AWS IoT 1-Click 项目和设备时使用标签字段:

您可以使用以下命令添加、修改或删除现有资源的标签:

AWS IoT 1-Click项目 API(使用项目 ARN) AWS IoT 1-Click设备 API(使用设备 ARN)
TagResource 标签

请参阅 TagResource (POST)、TagListTagsForResource (GET) 和 UntagResource (DELETE)。

ListTagsForResource
UntagResource

您可以修改标签的密钥和值,还可以随时删除资源的标签。您可以将标签的值设为空的字符串,但是不能将其设为空值。如果您添加的标签的值与该实例上现有标签的值相同,新的值就会覆盖旧值。如果删除资源,则所有与资源相关的标签都将被删除。

标签限制

下面是适用于标签的基本限制:

  • 每个资源的标签数上限 – 50

  • 最大密钥长度 — 127 个 Unicode 字符 (采用 UTF-8 格式)

  • 最大值长度 — 255 个 Unicode 字符 (采用 UTF-8 格式)

  • 标签键和值区分大小写。

  • 请勿在标签名称或值中使用 aws: 前缀,因为它专为 AWS 使用预留。您无法编辑或删除带此前缀的标签名称或值。具有此前缀的标签不计入每个资源的标签数限制。

  • 如果您的标记方案针对多个服务和资源使用,请记得其他服务可能对允许使用的字符有限制。通常允许使用的字符包括:可以用 UTF-8 格式表示的字母、空格和数字以及特殊字符 + - = . _ : / @