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

# 在中定义外部警报 Amazon IoT SiteWise
<a name="define-external-alarms"></a>

外部警报包含您在 Amazon IoT SiteWise外部检测到的警报状态。

## 定义外部警报（控制台）
<a name="define-external-alarm-console"></a>

您可以使用 Amazon IoT SiteWise 控制台在现有资产模型上定义外部警报。要在新资产模型上定义外部警报，请创建资产模型，然后完成以下步骤。有关更多信息，请参阅 [在中创建资产模型 Amazon IoT SiteWise](create-asset-models.md)。

**在资产模型上定义警报**

1. <a name="sitewise-open-console"></a>导航至 [Amazon IoT SiteWise 控制台](https://console.amazonaws.cn/iotsitewise/)。

1. <a name="sitewise-choose-models"></a>在导航窗格中，选择**模型**。

1. 选择要为其定义警报的资产模型。

1. 选择**警报定义**选项卡。

1. 选择**添加警报**。

1. 在**警报类型选项**中，选择**外部警报**。

1. 输入警报的名称。

1. （可选）输入警报的描述。

1. 选择**添加警报**。

## 定义外部警报（CLI）
<a name="define-external-alarm-cli"></a>

您可以使用在新资产模型或现有资产模型上定义外部警报。 Amazon CLI 

要向资产模型添加外部警报，请向资产模型添加警报复合模型。外部警报复合模型指定 `EXTERNAL` 类型，但不指定警报源属性。以下复合警报示例定义了外部温度警报。

```
{
  {{...}}
  "assetModelCompositeModels": [
    {
      "name": "BoilerTemperatureHighAlarm",
      "type": "AWS/ALARM",
      "properties": [
        {
          "name": "AWS/ALARM_TYPE",
          "dataType": "STRING",
          "type": {
            "attribute": {
              "defaultValue": "EXTERNAL"
            }
          }
        },
        {
          "name": "AWS/ALARM_STATE",
          "dataType": "STRUCT",
          "dataTypeSpec": "AWS/ALARM_STATE",
          "type": {
            "measurement": {}
          }
        }
      ]
    }
  ]
}
```

有关如何向新的或现有的资产模型添加复合模型的更多信息，请参阅以下内容：
+ [创建资产模型（Amazon CLI）](create-asset-models.md#create-asset-model-cli)
+ [更新资产模型、组件模型或接口 (Amazon CLI)](update-asset-models.md#update-asset-model-cli)

定义外部警报后，您可以根据资产模型将警报状态推送到资产。有关更多信息，请参阅 [摄取外部警报状态 Amazon IoT SiteWise](ingest-external-alarm-state.md)。