Consulte los valores históricos de las propiedades de los activos - 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.

Consulte los valores históricos de las propiedades de los activos

Puede utilizar la AWS IoT SiteWise API GetAssetPropertyValueHistoryoperación para consultar los valores históricos de una propiedad de activo.

Para identificar una propiedad de 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.

Pase los siguientes parámetros para refinar los resultados:

  • startDate: el inicio inclusivo del rango del cual se consultan los datos históricos, expresado en segundos en tiempo epoch de Unix.

  • endDate: el final inclusivo del rango del cual se consultan los datos históricos, expresado en segundos en tiempo epoch de Unix.

  • maxResults: el número máximo de resultados por devolver en una petición. Predeterminado a 20 resultados.

  • nextToken: un token de paginación devuelto por una llamada anterior de esta operación.

  • timeOrdering: el orden por aplicar a los valores devueltos: ASCENDING o DESCENDING.

  • qualities: calidad para filtrar los resultados: GOOD, BAD, o UNCERTAIN.

Para consultar el historial de valores de una propiedad de activo (AWS CLI)

  1. Ejecute el siguiente comando para obtener el historial de valores de la propiedad del activo. Este comando consulta el historial de la propiedad durante un intervalo específico de 10 minutos. Reemplazar asset-id con el ID del activo y property-id con el identificador de la propiedad. Reemplace los parámetros de fecha por el intervalo que desea consultar.

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

    La operación devuelve una respuesta que contiene el historial TQVs de la propiedad en el siguiente formato:

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

  2. Si existen más entradas de valores, puede pasar el token de paginación del nextToken campo a una llamada posterior a la GetAssetPropertyValueHistoryoperación.