

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

# 定义资产模型层次结构
<a name="define-asset-hierarchies"></a>

您可以定义资产模型层次结构，以便在工业运营中的资产模型之间创建逻辑关联。例如，您可以定义由陆上和海上风电场组成的风电场。陆上风电场包含涡轮机和陆上位置。海上风电场包含涡轮机和海上位置。

![Amazon IoT SiteWise 资产模型之间的风电场层次结构。](http://docs.amazonaws.cn/iot-sitewise/latest/userguide/images/asset-model-hierarchies.png)


当您通过层次将子资产模型与父资产模型关联时，父资产模型的指标可以从子资产模式的指标输入数据。您可以使用资产模型层次结构和指标来计算统计信息，从而提供对整个操作或部分操作的见解。有关更多信息，请参阅 [聚合来自属性和其他资产（指标）的数据](metrics.md)。

每个层次结构定义父资产模型和子资产模型之间的关系。在父资产模型中，您可以为同一个子资产模型定义多个层次结构。例如，如果您的风电场中有两种不同类型的风力涡轮机，其中所有风力涡轮机都由相同的资产模型表示，则可以为每种类型定义一个层次结构。然后，您可以在风电场模型中定义指标，以计算每种风力涡轮机的独立和组合统计数据。

一个父资产模型可以与多个子资产模型相关联。例如，如果您的陆上风电场和海上风电场由两种不同的资产模型表示，则可以将这些资产模型与相同的父风电场资产模型关联起来。

子资产模型也可以与多个父资产模型相关联。例如，如果您有两种不同类型的风电场，其中所有风力涡轮机都由相同的资产模型表示，则可以将风力涡轮机资产模型与不同的风电场资产模型相关联。

**注意**  
定义资产模型层次结构时，子资产模型必须是 `ACTIVE` 或具有之前的 `ACTIVE` 版本。有关更多信息，请参阅 [资产和模型状态](asset-and-model-states.md)。

定义分层资产模型并创建资产后，您可以关联资产以完成父子关系。有关更多信息，请参阅[在中为资产模型创建资产 Amazon IoT SiteWise](create-assets.md)和[关联资产和取消关联资产](add-associated-assets.md)。

**Topics**
+ [定义资产模型层次结构（控制台）](#define-asset-hierarchies-console)
+ [定义资产层次结构（Amazon CLI）](#define-asset-hierarchies-cli)

## 定义资产模型层次结构（控制台）
<a name="define-asset-hierarchies-console"></a>

在 Amazon IoT SiteWise 控制台中为资产模型定义层次结构时，需要指定以下参数：
+ **层次结构名称** – 层次结构的名称，如 **Wind Turbines**。
+ **层次模型** – 子资产模型。
+ **层次结构外部 ID**（可选）- 这是用户定义的 ID。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》**中的 [使用外部引用对象 IDs](object-ids.md#external-id-references)。

有关更多信息，请参阅 [创建资产模型（控制台）](create-asset-models.md#create-asset-model-console)。

## 定义资产层次结构（Amazon CLI）
<a name="define-asset-hierarchies-cli"></a>

使用 Amazon IoT SiteWise API 为资产模型定义层次结构时，需要指定以下参数：
+ `name` – 层次结构的名称，如 **Wind Turbines**。
+ `childAssetModelId` – 层次结构的子资产模型的 ID 或外部 ID。您可以使用该[ListAssetModels](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_ListAssetModels.html)操作来查找现有资产模型的 ID。

**Example 层次结构定义示例**  
以下示例演示一个表示风电场与风力涡轮机的关系的资产模型层次结构。此对象就是一个示例[AssetModelHierarchy](https://docs.amazonaws.cn/iot-sitewise/latest/APIReference/API_AssetModelHierarchy.html)。有关更多信息，请参阅 [创建资产模型（Amazon CLI）](create-asset-models.md#create-asset-model-cli)。  

```
{
  {{...}}
  "assetModelHierarchies": [
    {
      "name": "{{Wind Turbines}}",
      "childAssetModelId": "{{a1b2c3d4-5678-90ab-cdef-11111EXAMPLE}}"
    },
  ]
}
```