Rechercher les valeurs historiques des propriétés des actifs

Vous pouvez utiliser cette AWS IoT SiteWise API GetAssetPropertyValueHistoryopération pour interroger les valeurs historiques d'une propriété d'actif.

Pour identifier une propriété d'actif, spécifiez l'une des options suivantes :

• La assetId fin propertyId de la propriété de l'actif à laquelle les données sont envoyées.

• LepropertyAlias, qui est un alias de flux de données (par exemple,/company/windfarm/3/turbine/7/temperature). Pour utiliser cette option, vous devez d'abord définir l'alias de votre propriété de ressource. Pour définir des alias de propriété, consultezMappez les flux de données industriels aux propriétés des actifs.

Passez les paramètres suivants pour affiner vos résultats :

• startDate— Le début exclusif de la plage à partir de laquelle interroger les données historiques, exprimé en secondes à l'époque Unix.

• endDate— La fin de la plage inclusive à partir de laquelle interroger les données historiques, exprimée en secondes à l'époque Unix.

• maxResults— Le nombre maximum de résultats à renvoyer en une seule demande. Par défaut, ce sont les 20 résultats.

• nextToken— Un jeton de pagination renvoyé lors d'un précédent appel de cette opération.

• timeOrdering— La commande à appliquer aux valeurs renvoyées : ASCENDING ouDESCENDING.

• qualities— La qualité permettant de filtrer les résultats par : GOODBAD, ouUNCERTAIN.

Pour consulter l'historique des valeurs d'une propriété d'actif (AWS CLI)

1. Exécutez la commande suivante pour obtenir l'historique des valeurs de la propriété de ressource. Cette commande interroge l'historique de la propriété sur un intervalle spécifique de 10 minutes. Remplacez asset-id avec l'identifiant de l'actif et property-id avec l'identifiant de la propriété. Remplacez les paramètres de date par l'intervalle à interroger.

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

   L'opération renvoie une réponse contenant l'historique TQVs de la propriété au format suivant :

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

2. S'il existe d'autres entrées de valeur, vous pouvez transmettre le jeton de pagination du nextToken champ à un appel ultérieur à l'GetAssetPropertyValueHistoryopération.