Consulte valores históricos de propriedades de ativos - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Consulte valores históricos de propriedades de ativos

Você pode usar a AWS IoT SiteWise API GetAssetPropertyValueHistoryoperação para consultar os valores históricos de uma propriedade do ativo.

Para identificar uma propriedade do ativo, especifique uma das seguintes opções:

  • O assetId fim propertyId da propriedade do ativo para a qual os dados são enviados.

  • O propertyAlias, que é um alias de fluxo de dados (por exemplo, /company/windfarm/3/turbine/7/temperature). Para usar esta opção, primeiro você deve definir o apelido da propriedade do seu ativo. Para definir aliases de propriedades, consulteMapeie fluxos de dados industriais para propriedades de ativos.

Passe os seguintes parâmetros para refinar seus resultados:

  • startDate — O início exclusivo do intervalo a partir do qual é possível consultar dados históricos, expressos em segundos, em tempo Unix epoch.

  • endDate — O final inclusivo do intervalo a partir do qual a consulta de dados históricos é feita, expresso em segundos, no tempo Unix epoch.

  • maxResults – O número máximo de resultados a serem retornados em uma solicitação. Remete ao padrão de 20 resultados.

  • nextToken – Um token de paginação retornado de uma chamada anterior a essa operação.

  • timeOrdering — A ordem a ser aplicada aos valores retornados: ASCENDING ou DESCENDING.

  • qualities – A qualidade sob a qual pautar e filtrar os resultados: GOOD, BAD, ou UNCERTAIN.

Para consultar o histórico de valores de uma propriedade do ativo (AWS CLI)

  1. Execute o seguinte comando para obter o histórico de valores da propriedade de ativo: Esse comando consulta o histórico da propriedade em um intervalo específico de 10 minutos. Substituir asset-id com o ID do ativo e property-id com o ID da propriedade. Substitua os parâmetros de data pelo intervalo a ser consultado.

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

    A operação retorna uma resposta que contém o histórico TQVs da propriedade no seguinte formato:

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

  2. Se existirem mais entradas de valor, você poderá passar o token de paginação do nextToken campo para uma chamada subsequente para a GetAssetPropertyValueHistoryoperação.