本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
在中使用标签 Amazon IoT SiteWise
使用标签按用途、所有者、环境或用例的任何其他分类对 Amazon IoT SiteWise 资源进行分类。在您具有同一类型的许多资源时，可以根据特定资源的标签快速识别该资源。
每个标签都由您指定的一个键和一个可选值组成。例如，您可以为资产模型建立一系列标签，以便根据它们支持的工业流程对其进行跟踪。建议为您管理的每种资源开发一组量身定制的标签键。使用一组连续的标签键，管理资源时会更加轻松。
用 tag Amazon Web Services Management Console
中的标签编辑器 Amazon Web Services Management Console 提供了一种集中、统一的方式，供您为来自所有 Amazon 服务的资源创建和管理标签。有关更多信息，请参阅《标签 Amazon 资源和标签编辑器用户指南》中的标签编辑器入门。
使用 Amazon IoT SiteWise API 进行标记
Amazon IoT SiteWise API 还使用标签。在创建标签之前，请注意标签限制。有关更多信息，请参阅 Amazon Web Services 一般参考中的标签命名和使用惯例。
-
要在创建资源时添加标签，请在资源的
tags属性中定义这些标签。 -
要向现有资源添加标签或更新标签值，请使用TagResource操作。
-
要从资源中移除标签，请使用UntagResource操作。
-
要检索与资源关联的标签，请使用ListTagsForResource操作，或者描述资源并检查其
tags属性。
下表列出了您可以使用 Amazon IoT SiteWise API 标记的资源及其对应的Create和Describe操作。
| 资源 | 创建操作 | 描述操作 |
|---|---|---|
| 资产模型或组件模型 | CreateAssetModel | DescribeAssetModel |
| 资产 | CreateAsset | DescribeAsset |
| SiteWise 边缘网关 | CreateGateway | DescribeGateway |
| 门户 | CreatePortal | DescribePortal |
| Project | CreateProject | DescribeProject |
| 控制面板 | CreateDashboard | DescribeDashboard |
| 访问策略 | CreateAccessPolicy | DescribeAccessPolicy |
| 时间序列 | BatchPutAssetPropertyValue | DescribeTimeSeries |
对于BatchPutAssetPropertyValue，在创建资产模型和资产 Amazon IoT SiteWise 之前，您可以配置要将工业数据发送到的数据源。 Amazon IoT SiteWise 自动创建数据流以接收来自您的设备的原始数据流。有关更多信息，请参阅管理数据摄取。
使用以下操作可查看和管理支持标记的资源的标签：
-
TagResource— 向资源添加标签，或更新现有标签的值。
-
ListTagsForResource— 列出资源的标签。
-
UntagResource— 从资源中移除标签。
随时在资源中添加或删除标签。要更新现有标签键的值，请将具有相同键和所需的新值的新标签添加到该资源。此操作会将旧值替换为新值。虽然可以将空字符串指定为标签值，但无法分配空值。
删除资源也会移除与其关联的所有标签。