Ingiera datos mediante el AWS IoT SiteWise API - AWS IoT SiteWise

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ingiera datos mediante el AWS IoT SiteWise API

AWS IoT SiteWise APIUtilícela para enviar datos industriales con fecha y hora a las propiedades de medición y atributos de sus activos. APIAcepta una carga útil que contiene estructuras (). timestamp-quality-value TQV

Utilice la BatchPutAssetPropertyValueoperación para cargar sus datos. Con esta operación, puede cargar varias entradas de datos a la vez para recopilar datos de varios dispositivos y enviarlos todos en una sola solicitud.

importante

La BatchPutAssetPropertyValueoperación está sujeta a las siguientes cuotas:

  • Hasta 10 entradas por solicitud.

  • Hasta 10 valores de propiedad (puntos TQV de datos) por entrada.

  • AWS IoT SiteWise rechaza cualquier dato con una marca de tiempo fechada en más de 7 días o más de 10 minutos en el futuro.

Para obtener más información sobre estas cuotas, consulte BatchPutAssetPropertyValuela AWS IoT SiteWise API Referencia.

Para identificar una propiedad de un activo, especifique una de las siguientes opciones:

  • El assetId extremo propertyId de la propiedad del activo a la que se envían los datos.

  • El propertyAlias, que es un alias de flujo de datos (por ejemplo, /company/windfarm/3/turbine/7/temperature). Para utilizar esta opción, primero debe establecer el alias de la propiedad del activo. Para establecer los alias de las propiedades, consulteAsigne flujos de datos industriales a propiedades de activos.

El siguiente ejemplo muestra cómo enviar las lecturas de temperatura y rotación por minuto (RPM) de una turbina eólica desde una carga útil almacenada en un archivo. JSON

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

La carga de ejemplo en batch-put-payload.json contiene el siguiente contenido.

{
  "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"
        }
      ]
    }
  ]
}

Cada entrada de la carga contiene un entryId que puede definir como una única cadena. Si la entrada de la solicitud no se realiza correctamente, cada error contendrá el entryId de la solicitud correspondiente para que sepa qué solicitudes deben volver a intentarse.

Cada estructura de la lista de propertyValues es una estructura timestamp-quality-value (TQV) que contiene avalue, a y, opcionalmentetimestamp, a. quality

  • value: una estructura que contiene uno de los siguientes campos, en función del tipo de propiedad que se establezca:

    • booleanValue

    • doubleValue

    • integerValue

    • stringValue

  • timestamp: una estructura que contiene el tiempo en segundos en formato de tiempo Unix, timeInSeconds. También puede establecer la offsetInNanos clave en la timestamp estructura si dispone de datos precisos en el momento. AWS IoT SiteWise rechaza cualquier punto de datos con marcas de tiempo anteriores a 7 días o posteriores a 10 minutos en el futuro.

  • quality: (opcional) una de las siguientes cadenas de calidad:

    • GOOD: (predeterminado) los datos no se ven afectados por ningún problema.

    • BAD: los datos se ven afectados por un problema, como un fallo del sensor.

    • UNCERTAIN: los datos se ven afectados por un problema, como la falta de precisión de un sensor.

    Para obtener más información sobre cómo se AWS IoT SiteWise gestiona la calidad de los datos en los cálculos, consulte Calidad de los datos en las expresiones de fórmulas.