View a markdown version of this page

Recherchez les valeurs historiques des propriétés des actifs dans AWS IoT SiteWise - AWS IoT SiteWise

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Recherchez les valeurs historiques des propriétés des actifs dans AWS IoT SiteWise

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

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

  • Fin assetId 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é, consultezGérez les flux de données pour AWS IoT SiteWise.

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

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

  • endDate— L'extrémité inclusive de la plage à partir de laquelle interroger les données historiques, exprimée en secondes en heure d'époque Unix.

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

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

  • timeOrdering— L'ordre à appliquer aux valeurs renvoyées : ASCENDING ouDESCENDING.

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

Pour interroger 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 par l'ID de la ressource et property-id par l'ID 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 les TQV historiques de la propriété au format suivant :

    {
  "assetPropertyValueHistory": [
    {
      "value": {
        "booleanValue": Boolean,
        "doubleValue": Number,
        "integerValue": Number,
        "stringValue": "String",
        "nullValue": {
            "valueType": "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.