Interroga i valori storici delle proprietà degli asset

È possibile utilizzare l' AWS IoT SiteWise APIGetAssetPropertyValueHistoryoperazione per interrogare i valori storici di una proprietà di un asset.

Per identificare una proprietà di un asset, specificate una delle seguenti opzioni:

• La proprietà assetId e propertyId della risorsa a cui vengono inviati i dati.

• IlpropertyAlias, 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. Mappa i flussi di dati industriali sulle proprietà degli asset

Passa i seguenti parametri per affinare i risultati:

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

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

• maxResults— Il numero massimo di risultati da restituire in una richiesta. I valori predefiniti sono i risultati. 20

• nextToken— Un token di impaginazione 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: GOODBAD, 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. Replace (Sostituisci) asset-id con l'ID della risorsa 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 lo storico TQVs della proprietà nel seguente formato:

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

2. Se esistono più valori, è possibile passare il token di impaginazione dal nextToken campo a una successiva chiamata all'GetAssetPropertyValueHistoryoperazione.