

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

# 在 中擷取警示狀態資料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)。