Ingest alarm state data in Amazon IoT SiteWise - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Ingest alarm state data in Amazon IoT SiteWise

Alarm state properties expect alarm state as a serialized JSON string. To ingest alarm state to an external alarm in Amazon IoT SiteWise, you ingest this serialized string as a timestamped string value. The following example demonstrates a state data value for an active alarm.

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

To identify an alarm state property, you can specify one of the following:

  • The assetId and propertyId of the alarm property that you're sending data to.

  • The propertyAlias, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature/high). To use this option, you must first set your alarm property's alias. To learn how to set property aliases for alarm state properties, see Map external alarm state streams in Amazon IoT SiteWise.

The following example BatchPutAssetPropertyValue API payload demonstrates how to format the state of an external alarm. This external alarm reports when a wind turbine's rotations per minute (RPM) reading is too high.

Example BatchPutAssetPropertyValue payload for alarm state data
{
    "entries": [
      {
        "entryId": "unique entry ID",
        "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
        "propertyValues": [
          {
            "value": {
              "stringValue": "{\"stateName\":\"Active\"}"
            },
            "timestamp": {
              "timeInSeconds": 1607550262
            }
          }
        ]
      }
    ]
  }

For more information about how to use the BatchPutAssetPropertyValue API to ingest data, see Ingest data with Amazon IoT SiteWise APIs.

For more information about other ways to ingest data, see Ingest data to Amazon IoT SiteWise.