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

# 在 中擷取外部警示狀態 AWS IoT SiteWise
<a name="ingest-external-alarm-state"></a>

外部警示是您在 外部評估的警示 AWS IoT SiteWise。當您的資料來源報告您想要擷取的警示狀態時，您可以使用外部警示 AWS IoT SiteWise。

警示狀態屬性需要警示狀態資料值的特定格式。每個資料值必須是序列化為字串的 JSON 物件。然後，您將序列化字串擷取為字串值。如需詳細資訊，請參閱[警示狀態屬性](industrial-alarms.md#alarm-state-properties)。

**Example 警示狀態資料值範例 （未序列化）**  

```
{
  "stateName": "Active"
}
```

**Example 警示狀態資料值範例 （序列化）**  

```
{\"stateName\":\"Active\"}
```

**注意**  
如果您的資料來源無法以此格式報告資料，或者您無法在擷取資料之前將資料轉換為此格式，您可以選擇不使用警示屬性。反之，您可以將資料擷取為具有字串資料類型的測量屬性。如需詳細資訊，請參閱[從設備定義資料串流 （度量）](measurements.md)及[將資料擷取至 AWS IoT SiteWise](industrial-data-ingestion.md)。

# 在 中映射外部警示狀態串流 AWS IoT SiteWise
<a name="connect-alarm-data-streams"></a>

您可以定義屬性別名，將資料串流映射至警示狀態屬性。這可協助您在擷取或擷取資料時輕鬆識別警示狀態屬性。如需屬性別名的詳細資訊，請參閱 [管理 的資料串流 AWS IoT SiteWise](manage-data-streams.md)。

**Topics**
+ [映射外部警示狀態串流 （主控台）](#connect-alarm-data-stream-console)
+ [映射外部警示狀態串流 (AWS CLI)](#connect-alarm-data-stream-cli)

## 映射外部警示狀態串流 （主控台）
<a name="connect-alarm-data-stream-console"></a>

您可以定義屬性別名，將資料串流映射至警示狀態屬性。這可協助您在擷取或擷取資料時輕鬆識別警示狀態屬性。如需屬性別名的詳細資訊，請參閱 [管理 的資料串流 AWS IoT SiteWise](manage-data-streams.md)。

您可以使用 AWS IoT SiteWise 主控台來設定警示狀態屬性的別名。

**設定警示狀態屬性的屬性別名 （主控台）**

1. <a name="sitewise-open-console"></a>導覽至 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. <a name="sitewise-choose-assets"></a>在導覽窗格中，選擇 **Assets (資產)**。

1. 選擇您要為其設定屬性別名的資產。
**提示**  <a name="sitewise-expand-asset-hierarchy"></a>
您可以選擇箭頭圖示來展開資產階層，以尋找您的資產。

1. 選擇**編輯**。

1. 捲動至**警示**並展開 區段。

1. 在**外部警示**下，在**屬性別名中輸入別名 – *選用***。

1. 選擇**儲存**。

## 映射外部警示狀態串流 (AWS CLI)
<a name="connect-alarm-data-stream-cli"></a>

您可以定義屬性別名，將資料串流映射至警示狀態屬性。這可協助您在擷取或擷取資料時輕鬆識別警示狀態屬性。如需屬性別名的詳細資訊，請參閱 [管理 的資料串流 AWS IoT SiteWise](manage-data-streams.md)。

您可以使用 AWS Command Line Interface (AWS CLI) 來設定警示狀態屬性的別名。

您必須知道資產的 `assetId` 和財產的 `propertyId`，才能完成此程序。您也可以使用外部 ID。如果您建立資產但不知道其 `assetId`，請使用 [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html) API 列出特定模型的所有資產。使用 [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 操作來檢視資產的屬性，包括屬性 IDs。

**注意**  
[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html) 回應包含資產的複合資產模型清單。每個警示都是複合模型。若要尋找 `propertyId`，請尋找警示的複合模型，然後在該複合模型中尋找 `AWS/ALARM_STATE` 屬性。

如需如何設定屬性別名的詳細資訊，請參閱 [更新資產屬性別名](update-data-streams-method.md)。

# 在 中擷取警示狀態資料 AWS IoT SiteWise
<a name="ingest-alarm-state-data"></a>

警示狀態屬性預期警示狀態為序列化 JSON 字串。若要將警示狀態擷取至 中的外部警示 AWS IoT SiteWise，您可以將此序列化字串擷取為時間戳記字串值。下列範例示範作用中警示的狀態資料值。

```
{\"stateName\":\"Active\"}
```

若要識別警示狀態屬性，您可以指定下列其中一項：
+ 您要傳送資料的警示屬性`propertyId`的 `assetId`和 。
+ `propertyAlias`，這是資料串流別名 （例如 `/company/windfarm/3/turbine/7/temperature/high`)。若要使用此選項，您必須先設定警示屬性的別名。若要了解如何設定警示狀態屬性的屬性別名，請參閱 [在 中映射外部警示狀態串流 AWS IoT SiteWise](connect-alarm-data-streams.md)。

下列範例 [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) API 承載示範如何格式化外部警示的狀態。此外部警示會在風力發電機每分鐘旋轉 (RPM) 讀數過高時回報。

**Example 警示狀態資料的範例 BatchPutAssetPropertyValue 承載**  

```
{
    "entries": [
      {
        "entryId": "unique entry ID",
        "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
        "propertyValues": [
          {
            "value": {
              "stringValue": "{\"stateName\":\"Active\"}"
            },
            "timestamp": {
              "timeInSeconds": 1607550262
            }
          }
        ]
      }
    ]
  }
```
如需如何使用 `BatchPutAssetPropertyValue` API 擷取資料的詳細資訊，請參閱 [使用 AWS IoT SiteWise APIs 擷取資料](ingest-api.md)。  
如需其他擷取資料方式的詳細資訊，請參閱 [將資料擷取至 AWS IoT SiteWise](industrial-data-ingestion.md)。