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 em AWS IoT SiteWise
<a name="historical-values"></a>

Você pode usar a [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)operação AWS IoT SiteWise da API para consultar os valores históricos de uma propriedade do ativo.

Para identificar uma propriedade de ativo, especifique uma das seguintes opções:
+ O `assetId` e `propertyId` da propriedade de 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 propriedade, consulte [Gerencie fluxos de dados para AWS IoT SiteWise](manage-data-streams.md).

Envie os seguintes parâmetros para refinar os 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`.

**Como consultar o histórico de valores de uma propriedade de 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. *asset-id*Substitua pela ID do ativo e *property-id* pela 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",
           "nullValue": {
               "valueType": "String"
           }
         },
         "timestamp": {
           "timeInSeconds": Number,
           "offsetInNanos": Number
         },
         "quality": "String"
       }
     ],
     "nextToken": "String"
   }
   ```

1. Se existirem mais entradas de valor, você poderá passar o token de paginação do `nextToken` campo para uma chamada subsequente para a [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)operação.