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

# 在中定义资产模型的警报 AWS IoT SiteWise
<a name="define-alarms"></a>

资产模型可推动您的工业数据和警报实现标准化。您可以在资产模型上规定警报定义，以标准化基于资产模型的所有资产的警报。

您可以使用*组合资产模型*来定义资产模型上的警报。复合资产模型是在另一种资产模型上标准化一组特定属性的资产模型。复合资产模型可确保资产模型上存在某些属性。警报具有类型、状态和（可选）源属性，因此警报复合模型强制这些属性存在。

每个复合模型都有一个类型，用于定义复合模型的属性。警报复合模型定义警报类型、警报状态和（可选）警报源的属性。当您使用复合模型从资产模型创建资产时，该资产将包括复合模型中的属性以及您在资产模型中指定的属性。

复合模型中的每个属性都必须具有用于标识其复合模型类型的名称。复合模型属性支持具有复杂数据类型的属性。这些属性具有 `STRUCT` 数据类型和 `dataTypeSpec` 特征，用于指定属性的复杂数据类型。复杂数据类型属性包含序列化为字符串的 JSON 数据。

警报复合模型具有以下属性。对于此类复合模型，每个属性都必须具有标识该属性的名称。

**警报类型**  
警报的类型。指定下列项之一：  
+ `IOT_EVENTS`— AWS IoT Events 警报。 AWS IoT SiteWise 向发送数据 AWS IoT Events 以评估此警报的状态。必须指定警报源属性才能为此 AWS IoT Events 警报定义定义定义定义的警报模型。
**注意**  
终止支持通知： AWS 已终止对的支持 AWS IoT Events。有关更多信息，请参阅[AWS IoT Events 终止支持](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html)。
+ `EXTERNAL` – 外部警报。您摄取警报状态作为测量值。
属性名称：`AWS/ALARM_TYPE`  
属性类型：[属性](attributes.md)  
数据类型：`STRING`

**警报状态**  
警报状态的时间序列数据。这是一个序列化为字符串的对象，其中包含警报的状态和其他信息。有关更多信息，请参阅 [警报状态属性](industrial-alarms.md#alarm-state-properties)。  
属性名称：`AWS/ALARM_STATE`  
属性类型：[测量值](measurements.md)  
数据类型：`STRUCT`  
数据结构类型：`AWS/ALARM_STATE`

**警报源**  
（可选）评估警报状态的资源的 Amazon 资源名称（ARN）。对于 AWS IoT Events 警报，这是警报模型的 ARN。  
属性名称：`AWS/ALARM_SOURCE`  
属性类型：[属性](attributes.md)  
数据类型：`STRING`

**Example 警报复合模型示例**  
以下资产模型表示带有警报以监控其温度的锅炉。 AWS IoT SiteWise 将温度数据发送到 AWS IoT Events 以检测警报。  

```
{
  "assetModelName": "Boiler",
  "assetModelDescription": "A boiler that alarms when its temperature exceeds its limit.",
  "assetModelProperties": [
    {
      "name": "Temperature",
      "dataType": "DOUBLE",
      "unit": "Celsius",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "High Temperature",
      "dataType": "DOUBLE",
      "unit": "Celsius",
      "type": {
        "attribute": {
          "defaultValue": "105.0"
        }
      }
    }
  ],
  "assetModelCompositeModels": [
    {
      "name": "BoilerTemperatureHighAlarm",
      "type": "AWS/ALARM",
      "properties": [
        {
          "name": "AWS/ALARM_TYPE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "IOT_EVENTS"
            }
          }
        },
        {
          "name": "AWS/ALARM_STATE",
          "dataType": "STRUCT",
          "dataTypeSpec": "AWS/ALARM_STATE",
          "type": {
            "measurement": {}
          }
        },
        {
          "name": "AWS/ALARM_SOURCE",
          "dataType": "STRING",
          "type": {
            "attribute": {}
          }
        }
      ]
    }
  ]
}
```

**Topics**
+ [中的警报通知要求 AWS IoT SiteWise](iot-events-alarm-notification-requirements.md)
+ [为以下 AWS IoT Events 对象定义警报 AWS IoT SiteWise](define-iot-events-alarms.md)
+ [在中定义外部警报 AWS IoT SiteWise](define-external-alarms.md)