Ingérez des données à l'aide du AWS IoT SiteWise API - 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.

Ingérez des données à l'aide du AWS IoT SiteWise API

Utilisez le AWS IoT SiteWise API pour envoyer des données industrielles horodatées aux attributs et aux propriétés de mesure de vos actifs. APIAccepte une charge utile contenant des structures timestamp-quality-value (TQV).

Utilisez cette BatchPutAssetPropertyValueopération pour télécharger vos données. Grâce à cette opération, vous pouvez télécharger plusieurs entrées de données à la fois pour collecter des données provenant de plusieurs appareils et les envoyer en une seule demande.

Important

L'BatchPutAssetPropertyValueopération est soumise aux quotas suivants :

  • Jusqu'à 10 entrées par demande.

  • Jusqu'à 10 valeurs de propriété (points de TQV données) par entrée.

  • AWS IoT SiteWise rejette toutes les données dont l'horodatage date de plus de 7 jours dans le passé ou de plus de 10 minutes dans le futur.

Pour plus d'informations sur ces quotas, voir BatchPutAssetPropertyValuela AWS IoT SiteWise APIréférence.

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.

L'exemple suivant montre comment envoyer les relevés de température et de rotations par minute (RPM) d'une éolienne à partir d'une charge utile stockée dans un JSON fichier.

aws iotsitewise batch-put-asset-property-value --cli-input-json file://batch-put-payload.json

L'exemple de charge utile dans batch-put-payload.json comporte le contenu suivant.

{
  "entries": [
    {
      "entryId": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/temperature",
      "propertyValues": [
        {
          "value": {
            "integerValue": 38
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    },
    {
      "entryId": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/rpm",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 15.09
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          },
          "quality": "GOOD"
        }
      ]
    }
  ]
}

Chaque entrée de la charge utile contient un entryId que vous pouvez définir sous la forme d'une chaîne unique. Si des entrées de demande échouent, chaque erreur contiendra l'entryId de la demande correspondante afin que vous sachiez quelles demandes réessayer.

Chaque structure de la liste des propertyValues est une structure timestamp-quality-value (TQV) qui contient a valuetimestamp, a et éventuellement quality a.

  • value— Structure contenant l'un des champs suivants, selon le type de propriété définie :

    • booleanValue

    • doubleValue

    • integerValue

    • stringValue

  • timestamp— Une structure qui contient l'heure actuelle d'Unix en secondes,. timeInSeconds Vous pouvez également définir la offsetInNanos clé dans la timestamp structure si vous disposez de données temporellement précises. AWS IoT SiteWise rejette tous les points de données dont l'horodatage date de plus de 7 jours dans le passé ou de moins de 10 minutes dans le futur.

  • quality— (Facultatif) L'une des chaînes de qualité suivantes :

    • GOOD— (Par défaut) Les données ne sont affectées par aucun problème.

    • BAD— Les données sont affectées par un problème tel qu'une défaillance du capteur.

    • UNCERTAIN— Les données sont affectées par un problème tel que l'imprécision du capteur.

    Pour plus d'informations sur la gestion de AWS IoT SiteWise la qualité des données dans les calculs, consultez la section Qualité des données dans les expressions de formule.