View a markdown version of this page

Interroga i valori storici delle proprietà degli asset in AWS IoT SiteWise - AWS IoT SiteWise

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Interroga i valori storici delle proprietà degli asset in AWS IoT SiteWise

È possibile utilizzare l'GetAssetPropertyValueHistoryoperazione AWS IoT SiteWise API per interrogare i valori storici di una proprietà dell'asset.

Per identificare una proprietà dell'asset, specificate una delle seguenti opzioni:

  • La assetId fine propertyId della proprietà dell'asset a cui vengono inviati i dati.

  • ThepropertyAlias, che è un alias del flusso di dati (ad esempio,/company/windfarm/3/turbine/7/temperature). Per utilizzare questa opzione, è necessario prima impostare l'alias della proprietà dell'asset. Per impostare gli alias delle proprietà, vedere. Gestisci i flussi di dati per AWS IoT SiteWise

Passate i seguenti parametri per perfezionare i risultati:

  • startDate— L'inizio esclusivo dell'intervallo da cui interrogare i dati storici, espresso in secondi in epoca Unix.

  • endDate— La fine inclusiva dell'intervallo da cui interrogare i dati storici, espressa in secondi in epoca Unix.

  • maxResults— Il numero massimo di risultati da restituire in una richiesta. Il valore predefinito è «risultati». 20

  • nextToken— Un token di paginazione restituito da una precedente chiamata di questa operazione.

  • timeOrdering— L'ordine da applicare ai valori restituiti: ASCENDING o. DESCENDING

  • qualities— La qualità per filtrare i risultati in base a:GOOD,BAD, oUNCERTAIN.

Per interrogare la cronologia dei valori di una proprietà dell'asset (AWS CLI)

  1. Esegui il comando seguente per ottenere la cronologia dei valori per la proprietà di asset. Questo comando esegue una query per la cronologia della proprietà su un intervallo di 10 minuti. Sostituisci asset-id con l'ID dell'asset e property-id con l'ID della proprietà. Sostituisci i parametri di data con l'intervallo per la query.

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

    L'operazione restituisce una risposta che contiene i TQV storici della proprietà nel seguente formato:

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

  2. Se esistono più voci di valore, è possibile passare il token di paginazione dal nextToken campo a una successiva chiamata all'operazione. GetAssetPropertyValueHistory