Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erfassen Sie einen externen Alarmstatus in AWS IoT SiteWise
<a name="ingest-external-alarm-state"></a>

Externe Alarme sind Alarme, die Sie außerhalb von auswerten AWS IoT SiteWise. Sie können externe Alarme verwenden, wenn Sie über eine Datenquelle verfügen, die den Alarmstatus meldet und in die Sie Daten aufnehmen möchten AWS IoT SiteWise.

Für die Eigenschaften des Alarmstatus ist ein bestimmtes Format für die Datenwerte des Alarmstatus erforderlich. Jeder Datenwert muss ein JSON-Objekt sein, das in eine Zeichenfolge serialisiert ist. Anschließend nehmen Sie die serialisierte Zeichenfolge als Zeichenkettenwert auf. Weitere Informationen finden Sie unter [Eigenschaften des Alarmstatus](industrial-alarms.md#alarm-state-properties).

**Example Beispiel für einen Datenwert für den Alarmstatus (nicht serialisiert)**  

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

**Example Beispiel für einen Datenwert für den Alarmstatus (serialisiert)**  

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

**Anmerkung**  
Wenn Ihre Datenquelle keine Daten in diesem Format melden kann oder Sie Ihre Daten nicht in dieses Format konvertieren können, bevor Sie sie aufnehmen, können Sie sich dafür entscheiden, keine Alarm-Eigenschaft zu verwenden. Stattdessen können Sie die Daten beispielsweise als Messeigenschaft mit dem Datentyp Zeichenfolge aufnehmen. Weitere Informationen erhalten Sie unter [Definieren Sie Datenströme von Geräten (Messungen)](measurements.md) und [Daten aufnehmen in AWS IoT SiteWise](industrial-data-ingestion.md).

# Ordnen Sie externe Alarmstatus-Streams zu AWS IoT SiteWise
<a name="connect-alarm-data-streams"></a>

Sie können Eigenschaftsaliase definieren, um Ihre Datenströme Ihren Alarmzustandseigenschaften zuzuordnen. Auf diese Weise können Sie beim Aufnehmen oder Abrufen von Daten auf einfache Weise eine Eigenschaft für den Alarmstatus identifizieren. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter. [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md)

**Topics**
+ [Ordnen Sie externe Alarmstatus-Streams zu (Konsole)](#connect-alarm-data-stream-console)
+ [Ordnen Sie externe Alarmstatus-Streams zu (AWS CLI)](#connect-alarm-data-stream-cli)

## Ordnen Sie externe Alarmstatus-Streams zu (Konsole)
<a name="connect-alarm-data-stream-console"></a>

Sie können Eigenschaftsaliase definieren, um Ihre Datenströme Ihren Alarmzustandseigenschaften zuzuordnen. Auf diese Weise können Sie beim Aufnehmen oder Abrufen von Daten auf einfache Weise eine Eigenschaft für den Alarmstatus identifizieren. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter. [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md)

Sie können die AWS IoT SiteWise Konsole verwenden, um einen Alias für eine Alarmstatuseigenschaft festzulegen.

**Um einen Eigenschaftsalias für eine Alarmstatuseigenschaft festzulegen (Konsole)**

1. <a name="sitewise-open-console"></a>Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>Wählen Sie im linken Navigationsbereich **Komponenten** aus.

1. Wählen Sie die Komponente aus, für die Sie einen Eigenschaftenalias festlegen möchten.
**Tipp**  <a name="sitewise-expand-asset-hierarchy"></a>
Sie können eine Komponentenhierarchie mithilfe des Pfeilsymbols erweitern, um nach Ihrer Komponente zu suchen.

1. Wählen Sie **Bearbeiten** aus.

1. Scrollen Sie zu **Alarme** und erweitern Sie den Bereich.

1. Geben Sie unter **Externe Alarme** den Alias im Feld **Eigenschaftsalias — *optional*** ein.

1. Wählen Sie **Speichern**.

## Ordnen Sie externe Alarmstatus-Streams zu (AWS CLI)
<a name="connect-alarm-data-stream-cli"></a>

Sie können Eigenschaftsaliase definieren, um Ihre Datenströme Ihren Alarmzustandseigenschaften zuzuordnen. Auf diese Weise können Sie beim Aufnehmen oder Abrufen von Daten auf einfache Weise eine Eigenschaft für den Alarmstatus identifizieren. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter. [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md)

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um einen Alias für eine Alarmstatuseigenschaft festzulegen.

Um dieses Verfahren abzuschließen, müssen Sie die `assetId` Ihrer Komponenten und die `propertyId` Ihrer Eigenschaft kennen. Sie können auch die externe ID verwenden. Wenn Sie ein Asset erstellt haben und es nicht kennen`assetId`, verwenden Sie die [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API, um alle Assets für ein bestimmtes Modell aufzulisten. Verwenden Sie den [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Vorgang, um die Eigenschaften Ihres Assets einschließlich der Immobilien anzuzeigen IDs.

**Anmerkung**  
Die [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Antwort enthält die Liste der zusammengesetzten Anlagenmodelle für den Vermögenswert. Jeder Alarm ist ein zusammengesetztes Modell. Um das zu finden`propertyId`, suchen Sie das zusammengesetzte Modell für den Alarm und suchen Sie dann die `AWS/ALARM_STATE` Eigenschaft in diesem zusammengesetzten Modell.

Weitere Hinweise zum Festlegen des Eigenschaftsalias finden Sie unter[Aktualisieren Sie den Alias einer Asset-Eigenschaft](update-data-streams-method.md).

# Daten zum Alarmstatus aufnehmen in AWS IoT SiteWise
<a name="ingest-alarm-state-data"></a>

Bei den Eigenschaften des Alarmstatus wird der Alarmstatus als serialisierte JSON-Zeichenfolge erwartet. Um den Alarmstatus in einen externen Alarm zu übernehmen AWS IoT SiteWise, nehmen Sie diese serialisierte Zeichenfolge als Zeichenkettenwert mit Zeitstempel auf. Das folgende Beispiel zeigt einen Statusdatenwert für einen aktiven Alarm.

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

Um eine Eigenschaft für den Alarmstatus zu identifizieren, können Sie eine der folgenden Optionen angeben:
+ Das `assetId` Ende `propertyId` der Alarm-Eigenschaft, an die Sie Daten senden.
+ Das`propertyAlias`, was ein Datenstream-Alias ist (z. B.`/company/windfarm/3/turbine/7/temperature/high`). Um diese Option verwenden zu können, müssen Sie zuerst den Alias Ihrer Alarm-Eigenschaft festlegen. Informationen zum Festlegen von Eigenschaftsaliasnamen für Eigenschaften des Alarmstatus finden Sie unter[Ordnen Sie externe Alarmstatus-Streams zu AWS IoT SiteWise](connect-alarm-data-streams.md).

Die folgende [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)Beispiel-API-Payload zeigt, wie der Status eines externen Alarms formatiert wird. Dieser externe Alarm meldet, wenn der Wert der Umdrehungen pro Minute (U/min) einer Windturbine zu hoch ist.

**Example Beispiel für eine BatchPutAssetPropertyValue Payload für Alarmzustandsdaten**  

```
{
    "entries": [
      {
        "entryId": "unique entry ID",
        "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
        "propertyValues": [
          {
            "value": {
              "stringValue": "{\"stateName\":\"Active\"}"
            },
            "timestamp": {
              "timeInSeconds": 1607550262
            }
          }
        ]
      }
    ]
  }
```
Weitere Hinweise zur Verwendung der `BatchPutAssetPropertyValue` API zum Erfassen von Daten finden Sie unter. [Daten aufnehmen mit AWS IoT SiteWise APIs](ingest-api.md)  
Weitere Hinweise zu anderen Möglichkeiten der Datenaufnahme finden Sie unter. [Daten aufnehmen in AWS IoT SiteWise](industrial-data-ingestion.md)