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

# 在中使用标签 AWS IoT SiteWise
<a name="tag-basics"></a>

使用标签按用途、所有者、环境或用例的任何其他分类对 AWS IoT SiteWise 资源进行分类。在您具有同一类型的许多资源时，可以根据特定资源的标签快速识别该资源。

每个标签都由您指定的一个键和一个可选值组成。例如，您可以为资产模型建立一系列标签，以便根据它们支持的工业流程对其进行跟踪。建议为您管理的每种资源开发一组量身定制的标签键。使用一组连续的标签键，管理资源时会更加轻松。

## 用 tag AWS 管理控制台
<a name="tags-console"></a>

中的**标签编辑器** AWS 管理控制台 提供了一种集中、统一的方式，供您为来自所有 AWS 服务的资源创建和管理标签。有关更多信息，请参阅《标签* AWS 资源和标签编辑器用户指南》中的标签编辑器*[入门](https://docs.aws.amazon.com/tag-editor/latest/userguide/gettingstarted.html)。

## 使用 AWS IoT SiteWise API 进行标记
<a name="tags-api"></a>

 AWS IoT SiteWise API 还使用标签。在创建标签之前，请注意标签限制。有关更多信息，请参阅 *AWS 一般参考*中的[标签命名和使用惯例](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions)。
+ 要在创建资源时添加标签，请在资源的 `tags` 属性中定义这些标签。
+ 要向现有资源添加标签或更新标签值，请使用[TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)操作。
+ 要从资源中移除标签，请使用[UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)操作。
+ 要检索与资源关联的标签，请使用[ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)操作，或者描述资源并检查其`tags`属性。

下表列出了您可以使用 AWS IoT SiteWise API 标记的资源及其对应的`Create`和`Describe`操作。


**可标记的资源 AWS IoT SiteWise**  

| 资源 | 创建操作 | 描述操作 | 
| --- | --- | --- | 
| 资产模型或组件模型 | [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) | [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) | 
| 资产 | [CreateAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAsset.html) | [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) | 
| SiteWise 边缘网关 | [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) | [DescribeGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeGateway.html) | 
| 门户 | [CreatePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreatePortal.html) | [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html) | 
| Project | [CreateProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateProject.html) | [DescribeProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeProject.html) | 
| 控制面板 | [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html) | [DescribeDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeDashboard.html) | 
| 访问政策 | [CreateAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAccessPolicy.html) | [DescribeAccessPolicy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAccessPolicy.html) | 
| 时间序列 | [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) | [DescribeTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeTimeSeries.html) | 

对于`[BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)`，在创建资产模型和资产 AWS IoT SiteWise 之前，您可以配置要将工业数据发送到的数据源。 AWS IoT SiteWise 自动创建数据流以接收来自您的设备的原始数据流。有关更多信息，请参阅[管理数据摄取](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/data-streams.html)。

使用以下操作可查看和管理支持标记的资源的标签：
+ [TagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TagResource.html)— 向资源添加标签，或更新现有标签的值。
+ [ListTagsForResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListTagsForResource.html)— 列出资源的标签。
+ [UntagResource](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UntagResource.html)— 从资源中移除标签。

随时在资源中添加或删除标签。要更新现有标签键的值，请将具有相同键和所需的新值的新标签添加到该资源。此操作会将旧值替换为新值。虽然可以将空字符串指定为标签值，但无法分配空值。

删除资源也会移除与其关联的所有标签。