

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

# 标记您的托管集成资源
<a name="tagging-iot"></a>

为了帮助您管理和组织资源，您可以选择以标签的形式为每个资源分配自己的元数据。本部分介绍标签并说明如何创建标签。

## 标签基本知识
<a name="tagging-iot-basics"></a>

您可以使用标签以不同的方式（例如，按用途、所有者或环境）对托管集成资源进行分类。这在您具有相同类型的许多资源时会很有用 - 您可以根据分配给资源的标签快速识别资源。每个标签都包含您定义的一个键和一个可选值。例如，您可以为事物类型定义一组标签来帮助您按类型跟踪设备。我们建议您为每类资源创建一组可满足您的需求的标签键。使用一组连续的标签键，管理 资源时会更加轻松。

您可以根据添加或应用的标签搜索和筛选资源。您还可以使用标签控制对资源的访问，如 [在 IAM 策略中使用标签](tagging-iot-iam.md) 中所述。

为便于使用， AWS 管理控制台中的标签编辑器为创建和管理标签提供了一种集中、统一的方式。有关更多信息，请参阅 “[使用 AWS 管理控制台” ](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) 中的 “[使用标签编辑器” ](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/getting-started.html)。

您还可以使用 AWS CLI 和托管集成 API 处理标签。在创建标签时，您可以使用以下命令中的`Tags`字段将标签与托管事物、配置配置文件、凭据储物柜和无线 (OTA) 任务关联起来：
+ [CreateManagedThing](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateManagedThing.html)
+ [CreateProvisioningProfile](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateProvisioningProfile.html)
+ [CreateCredentialLocker](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateCredentialLocker.html)
+ [CreateOtaTask](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateOtaTask.html)
+ [CreateAccountAssociation](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_CreateAccountAssociation.html)

您可以使用以下命令为支持标记的现有资源添加、修改或删除标签：
+ [TagResource](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_TagResource)
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_ListTagsForResource)
+ [UntagResource](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_UntagResource)

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

### 标签限制
<a name="tagging-iot-restrict"></a>

下面是适用于 标签的基本限制：
+ 每个资源的最大标签数 - 50
+ 最大密钥长度 — 包含 127 个 Unicode 字符 UTF-8
+ 最大值长度 — 255 个 Unicode 字符 UTF-8
+ 标签键和值区分大小写。
+ 请勿在标签名称或值中使用 `aws:` 前缀。它是留待 AWS 使用的。您无法编辑或删除带此前缀的标签名称或值。具有此前缀的标签不计入每个资源的标签数限制。
+ 如果在多个服务和资源中使用您的标记方案，请记住，其他服务可能对允许使用的字符有限制。允许使用的字符包括字母、空格和可表示的数字 UTF-8，以及以下特殊字符：\+-=. \_:/@。