Ingerir datos mediante la API AWS IoT SiteWise

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

Utilice la BatchPutAssetPropertyValueoperación para cargar los 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 de datos TQV) 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, consulta la referencia BatchPutAssetPropertyValuede la AWS IoT SiteWise API.

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, consulteAsignación de flujos de datos industriales a propiedades de activos.

El siguiente ejemplo muestra cómo enviar lecturas de temperatura y rotaciones 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.