Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Interroga gli aggregati delle proprietà degli asset in AWS IoT SiteWise
AWS IoT SiteWise calcola automaticamente i valori aggregati delle proprietà degli asset, che sono un insieme di metriche di base calcolate su più intervalli di tempo. AWS IoT SiteWise calcola i seguenti aggregati ogni minuto, ora e giorno per le proprietà degli asset:
+ **media**: la media (media) dei valori di una proprietà in un intervallo di tempo.
+ **count**: il numero di punti dati per una proprietà in un intervallo di tempo.
+ **maximum** — Il massimo dei valori di una proprietà in un intervallo di tempo.
+ **minimo** — Il minimo dei valori di una proprietà in un intervallo di tempo.
+ **deviazione standard**: la deviazione standard dei valori di una proprietà in un intervallo di tempo.
+ **sum** — La somma dei valori di una proprietà in un intervallo di tempo.
Per le proprietà non numeriche, come stringhe e valori booleani, calcola solo l'aggregato di conteggio. AWS IoT SiteWise
Puoi anche calcolare parametri personalizzati per i dati di asset. Con le proprietà metriche, definisci aggregazioni specifiche per la tua operazione. Le proprietà metriche offrono funzioni di aggregazione e intervalli di tempo aggiuntivi che non sono precalcolati per l'API. AWS IoT SiteWise Per ulteriori informazioni, consulta [Aggrega i dati provenienti da proprietà e altre risorse (metriche)](metrics.md).
**Topics**
+ [Aggregati per una proprietà di asset (API)](#aggregates-api)
+ [Aggregati per una proprietà di asset ()AWS CLI](#aggregates-cli)
## Aggregati per una proprietà di asset (API)
Utilizza l' AWS IoT SiteWise API per ottenere aggregati per una proprietà di asset.
Utilizzate l'[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)operazione per interrogare gli aggregati di una proprietà di un asset.
Per identificare la proprietà di un asset, specificate una delle seguenti opzioni:
+ La proprietà `assetId` e `propertyId` della risorsa a cui vengono inviati i dati.
+ Il`propertyAlias`, che è un alias del flusso di dati (ad esempio,`/company/windfarm/3/turbine/7/temperature`). Per utilizzare questa opzione, è necessario prima impostare l'alias della proprietà dell'asset. Per impostare gli alias delle proprietà, vedere. [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md)
È necessario passare i seguenti parametri obbligatori:
+ `aggregateTypes`— L'elenco degli aggregati da recuperare. Puoi specificare uno qualsiasi di `AVERAGE`, `COUNT`, `MAXIMUM`, `MINIMUM`, `STANDARD_DEVIATION` e `SUM`.
+ `resolution`— L'intervallo di tempo per il quale recuperare la metrica: `1m` (1 minuto), (15 minuti), `15m` (1 ora) o `1h` `1d` (1 giorno).
+ `startDate`— L'inizio esclusivo dell'intervallo da cui interrogare i dati storici, espresso in secondi nell'epoca Unix.
+ `endDate`— La fine inclusiva dell'intervallo da cui interrogare i dati storici, espressa in secondi nell'epoca Unix.
È anche possibile passare uno dei seguenti parametri per perfezionare i risultati:
+ `maxResults`— Il numero massimo di risultati da restituire in una richiesta. I valori predefiniti sono i risultati. `20`
+ `nextToken`— Un token di impaginazione restituito da una precedente chiamata di questa operazione.
+ `timeOrdering`— L'ordine da applicare ai valori restituiti: `ASCENDING` o. `DESCENDING`
+ `qualities`— La qualità per filtrare i risultati in base a: `GOOD``BAD`, o`UNCERTAIN`.
**Nota**
L'[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)operazione restituisce un TQV con un formato diverso rispetto alle altre operazioni descritte in questa sezione. La struttura di `value` annovera un campo per ogni `aggregateTypes` incluso nella richiesta. `timestamp` contiene l'orario in cui si è verificata l'aggregazione, in secondi nel formato epoca (Unix epoch).
## Aggregati per una proprietà di asset ()AWS CLI
**Per interrogare gli aggregati per una proprietà di un asset ()AWS CLI**
1. Esegui il comando seguente per ottenere aggregati per la proprietà di asset. Questo comando esegue la query per la media e la somma con una risoluzione di 1 ora per uno specifico intervallo di 1 ora. Sostituisci {{asset-id}} con l'ID della risorsa e {{property-id}} con l'ID della proprietà. Sostituisci i parametri con gli aggregati e l'intervallo per la query.
```
aws iotsitewise get-asset-property-aggregates \
--asset-id {{asset-id}} \
--property-id {{property-id}} \
--start-date {{1575216000}} \
--end-date {{1575219600}} \
--aggregate-types {{AVERAGE SUM}} \
--resolution {{1h}}
```
L'operazione restituisce una risposta che contiene lo storico TQVs della proprietà nel formato seguente. La risposta include solo gli aggregati richiesti.
```
{
"aggregatedValues": [
{
"timestamp": {{Number}},
"quality": "{{String}}",
"value": {
"average": {{Number}},
"count": {{Number}},
"maximum": {{Number}},
"minimum": {{Number}},
"standardDeviation": {{Number}},
"sum": {{Number}}
}
}
],
"nextToken": "{{String}}"
}
```
1. Se esistono più valori, è possibile passare il token di impaginazione dal `nextToken` campo a una successiva chiamata all'[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)operazione.
**Nota**
Se l'intervallo di query contiene un `null` valore TQVs, consulta [AssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetPropertyValue.html)API. Tutte le statistiche, ad eccezione del conteggio, danno come risultato una `null` risposta simile alle statistiche di String TQVs. Se l'intervallo di query contiene `Double.NaN` un tipo doppio TQVs, tutti i calcoli tranne il conteggio daranno come risultato un`Double.NaN`.