View a markdown version of this page

Fragen Sie historische Eigenschaftswerte von Anlagen in ab AWS IoT SiteWise - AWS IoT SiteWise

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.

Fragen Sie historische Eigenschaftswerte von Anlagen in ab AWS IoT SiteWise

Sie können die AWS IoT SiteWise GetAssetPropertyValueHistory API-Operation verwenden, um die historischen Werte einer Asset-Eigenschaft abzufragen.

Um eine Asset-Eigenschaft zu identifizieren, geben Sie eine der folgenden Optionen an:

  • Das assetId Ende propertyId der Asset-Eigenschaft, an die Daten gesendet werden.

  • ThepropertyAlias, bei dem es sich um einen Datenstream-Alias handelt (z. B./company/windfarm/3/turbine/7/temperature). Um diese Option verwenden zu können, müssen Sie zuerst den Alias der Komponenteneigenschaft festlegen. Informationen zum Festlegen von Eigenschaftsaliasen finden Sie unterDatenströme verwalten für AWS IoT SiteWise.

Übergeben Sie die folgenden Parameter, um Ihre Ergebnisse zu verfeinern:

  • startDate— Der exklusive Beginn des Bereichs, ab dem historische Daten abgefragt werden sollen, ausgedrückt in Sekunden in Unix-Epochenzeit.

  • endDate— Das inklusive Ende des Bereichs, ab dem historische Daten abgefragt werden sollen, ausgedrückt in Sekunden in Unix-Epochenzeit.

  • maxResults— Die maximale Anzahl von Ergebnissen, die in einer Anfrage zurückgegeben werden sollen. Standardmäßig sind 20 Ergebnisse.

  • nextToken— Ein Paginierungstoken, das von einem früheren Aufruf dieser Operation zurückgegeben wurde.

  • timeOrdering— Die Reihenfolge, die auf die zurückgegebenen Werte angewendet werden soll: ASCENDING oderDESCENDING.

  • qualities— Die Qualität, nach der die Ergebnisse gefiltert werden GOOD sollen:BAD, oderUNCERTAIN.

Um den Werteverlauf für eine Anlageneigenschaft abzufragen (AWS CLI)

  1. Führen Sie den folgenden Befehl aus, um den Wertverlauf für die Komponenteneigenschaft abzurufen. Dieser Befehl fragt den Verlauf der Eigenschaft über ein bestimmtes 10-Minuten-Intervall ab. asset-idErsetzen Sie durch die ID des Assets und property-id durch die ID der Eigenschaft. Ersetzen Sie die Datumsparameter durch das abzufragende Intervall.

    aws iotsitewise get-asset-property-value-history \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575216600

    Der Vorgang gibt eine Antwort zurück, die die historischen TQVs der Eigenschaft im folgenden Format enthält:

    {
  "assetPropertyValueHistory": [
    {
      "value": {
        "booleanValue": Boolean,
        "doubleValue": Number,
        "integerValue": Number,
        "stringValue": "String",
        "nullValue": {
            "valueType": "String"
        }
      },
      "timestamp": {
        "timeInSeconds": Number,
        "offsetInNanos": Number
      },
      "quality": "String"
    }
  ],
  "nextToken": "String"
}

  2. Wenn mehrere Werteinträge vorhanden sind, können Sie das Paginierungstoken aus dem nextToken Feld an einen nachfolgenden Aufruf der GetAssetPropertyValueHistory Operation übergeben.