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. # AWS IoT SiteWise Die Aktion AWS IoT SiteWise (`iotSiteWise`) sendet Daten aus einer MQTT-Nachricht an die Asset-Eigenschaften in. AWS IoT SiteWise Sie können einem Tutorial folgen, das Ihnen zeigt, wie Sie Daten von AWS IoT Dingen aufnehmen können. *Weitere Informationen finden Sie im [Tutorial Daten AWS IoT SiteWise aus AWS IoT Dingen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-data-from-iot-things.html) aufnehmen oder im Abschnitt [Daten mithilfe von AWS IoT Kernregeln aufnehmen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/iot-rules.html) im AWS IoT SiteWise Benutzerhandbuch.* ## Voraussetzungen Diese Regelaktion hat die folgenden Anforderungen: + Eine IAM-Rolle, die die Ausführung des Vorgangs übernehmen AWS IoT kann. `iotsitewise:BatchPutAssetPropertyValue` Weitere Informationen finden Sie unter [Gewähren Sie einer AWS IoT Regel den Zugriff, den sie benötigt](iot-create-role.md). Sie können die folgende Beispiel-Vertrauensrichtlinie mit der Rolle verknüpfen. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*" } ] } ``` Um die Sicherheit zu erhöhen, können Sie in der `Condition` Eigenschaft einen Pfad zur AWS IoT SiteWise Asset-Hierarchie angeben. Das folgende Beispiel ist eine Vertrauensrichtlinie, die einen Komponentenhierarchiepfad angibt. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/root node asset ID", "/root node asset ID/*" ] } } } ] } ``` + Wenn Sie AWS IoT SiteWise mit dieser Aktion Daten an senden, müssen Ihre Daten die Anforderungen des `BatchPutAssetPropertyValue` Vorgangs erfüllen. Weitere Informationen finden Sie unter [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) in der *AWS IoT SiteWise -API-Referenz*. ## Parameters Wenn Sie mit dieser Aktion eine AWS IoT Regel erstellen, müssen Sie die folgenden Informationen angeben: `putAssetPropertyValueEntries` Eine Liste mit Werteinträgen für die Komponenteneigenschaft, die jeweils die folgenden Informationen enthalten: `propertyAlias` (Optional) Der Eigenschaftenalias, der Ihrer Komponenteneigenschaft zugeordnet ist. Geben Sie entweder einen `propertyAlias` oder sowohl eine `assetId` als auch eine `propertyId` an. Weitere Informationen zu Eigenschaftsaliasnamen finden Sie unter [Zuordnen von industriellen Datenströmen zu Komponenteneigenschaften](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html) im *AWS IoT SiteWise -Benutzerhandbuch*. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `assetId` (Optional) Die ID des AWS IoT SiteWise Assets. Geben Sie entweder einen `propertyAlias` oder sowohl eine `assetId` als auch eine `propertyId` an. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `propertyId` (Optional) Die ID der Komponenteneigenschaft. Geben Sie entweder einen `propertyAlias` oder sowohl eine `assetId` als auch eine `propertyId` an. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `entryId` (Optional) Ein eindeutiger Bezeichner für diesen Eintrag. Definieren Sie die `entryId`, um besser zu nachzuverfolgen, welche Nachricht ggf. einen Fehler verursacht hat. Standardmäßig wird eine neue UUID verwendet. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `propertyValues` Eine Liste der einzufügenden Eigenschaftswerte, die jeweils Zeitstempel, Qualität und Wert (Timestamp, Quality and Value, TQV) im folgenden Format enthalten: `timestamp` Eine Zeitstempelstruktur, die die folgenden Informationen enthält: `timeInSeconds` Eine Zeichenfolge, die die Zeit in Sekunden in der Unix-Epochenzeit enthält. Wenn Ihre Nachrichtennutzlast keinen Zeitstempel hat, können Sie [timestamp()](iot-sql-functions.md#iot-function-timestamp) verwenden, der die aktuelle Zeit in Millisekunden zurückgibt. Um diese Zeit in Sekunden zu konvertieren, können Sie die folgende Ersetzungsvorlage verwenden: **\$1\$1floor(timestamp() / 1E3)\$1**. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `offsetInNanos` (Optional) Eine Zeichenfolge, die den Zeitversatz in Nanosekunden von der Zeit in Sekunden enthält. Wenn Ihre Nachrichtennutzlast keinen Zeitstempel hat, können Sie [timestamp()](iot-sql-functions.md#iot-function-timestamp) verwenden, der die aktuelle Zeit in Millisekunden zurückgibt. Um den Nanosekunden-Zeitversatz von diesem Zeitpunkt zu berechnen, können Sie die folgende Ersetzungsvorlage verwenden: **\$1\$1(timestamp() % 1E3) \$1 1E6\$1**. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja In Bezug auf die Unix-Epochenzeit werden nur Einträge AWS IoT SiteWise akzeptiert, die einen Zeitstempel von bis zu 7 Tagen in der Vergangenheit und bis zu 5 Minuten in der future haben. `quality` (Optional) Eine Zeichenfolge, die die Qualität des Werts beschreibt. Zulässige Werte: `GOOD`, `BAD`, `UNCERTAIN`. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `value` Eine Wertestruktur, die eines der folgenden Wertfelder enthält, je nach Datentyp der Komponenteneigenschaft: `booleanValue` (Optional) Eine Zeichenfolge, die den booleschen Wert des Werteintrags enthält. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `doubleValue` (Optional) Eine Zeichenfolge, die den doppelten Wert des Werteintrags enthält. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `integerValue` (Optional) Eine Zeichenfolge, die den Ganzzahlwert des Werteintrags enthält. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `stringValue` (Optional) Der Zeichenfolgenwert des Werteintrags. Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja `roleArn` Der ARN der IAM-Rolle, die die AWS IoT Berechtigung zum Senden eines Vermögenseigenschaftswerts an AWS IoT SiteWise erteilt. Weitere Informationen finden Sie unter [Voraussetzungen](#iotsitewise-rule-action-requirements). Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein ## Beispiele Das folgende JSON-Beispiel definiert eine grundlegende SiteWise IoT-Aktion in einer AWS IoT Regel. ``` { "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "iotSiteWise": { "putAssetPropertyValueEntries": [ { "propertyAlias": "/some/property/alias", "propertyValues": [ { "timestamp": { "timeInSeconds": "${my.payload.timeInSeconds}" }, "value": { "integerValue": "${my.payload.value}" } } ] } ], "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sitewise" } } ] } } ``` Das folgende JSON-Beispiel definiert eine SiteWise IoT-Aktion in einer AWS IoT Regel. In diesem Beispiel wird das Thema als Eigenschaftsalias und die `timestamp()` Funktion verwendet. Wenn Sie beispielsweise Daten in `/company/windfarm/3/turbine/7/rpm` veröffentlichen, sendet diese Aktion die Daten an die Komponenteneigenschaft mit einem Eigenschaftsalias, der dem von Ihnen angegebenen Thema entspricht. ``` { "topicRulePayload": { "sql": "SELECT * FROM '/company/windfarm/+/turbine/+/+'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "iotSiteWise": { "putAssetPropertyValueEntries": [ { "propertyAlias": "${topic()}", "propertyValues": [ { "timestamp": { "timeInSeconds": "${floor(timestamp() / 1E3)}", "offsetInNanos": "${(timestamp() % 1E3) * 1E6}" }, "value": { "doubleValue": "${my.payload.value}" } } ] } ], "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sitewise" } } ] } } ``` ## Weitere Informationen finden Sie auch unter + [Was ist AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) im *AWS IoT SiteWise Benutzerhandbuch* + [Daten mithilfe von AWS IoT Core Regeln](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/iot-rules.html) im *AWS IoT SiteWise Benutzerhandbuch* aufnehmen + [Daten AWS IoT SiteWise aus AWS IoT Dingen](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-data-from-iot-things.html) *im Benutzerhandbuch aufnehmen AWS IoT SiteWise * + [Problembehandlung bei einer AWS IoT SiteWise Regelaktion](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshoot-rule.html) im *AWS IoT SiteWise Benutzerhandbuch*