本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 中定義資產模型的警示 AWS IoT SiteWise
<a name="define-alarms"></a>

資產模型可推動工業資料和警示的標準化。您可以在資產模型上定義警示定義，以根據資產模型標準化所有資產的警示。

您可以使用*複合資產模型*來定義資產模型的警示。複合資產模型是資產模型，可標準化另一個資產模型上的特定屬性集。複合資產模型可確保資產模型上存在特定屬性。警示具有類型、狀態和 （選用） 來源屬性，因此警示複合模型會強制執行這些屬性存在。

每個複合資產模型都有定義該複合模型屬性的類型。警示複合模型會定義警示類型、警示狀態和 （選用） 警示來源的屬性。當您從具有複合模型的資產模型建立資產時，資產會包含複合模型的屬性，以及您在資產模型中指定的屬性。

複合模型中的每個屬性都必須具有識別其複合模型類型的名稱。複合模型屬性支援具有複雜資料類型的屬性。這些屬性具有`STRUCT`資料類型和`dataTypeSpec`特徵，可指定屬性的複雜資料類型。複雜資料類型屬性包含序列化為字串的 JSON 資料。

警示複合模型具有下列屬性。每個屬性都必須具有識別此類型複合模型的名稱。

**警示類型**  
警示的類型。請指定下列其中一項：  
+ `IOT_EVENTS` – AWS IoT Events alarm. AWS IoT SiteWise sends data to 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 Resource Name (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)