Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Agregat properti aset kueri di AWS IoT SiteWise
<a name="aggregates"></a>

AWS IoT SiteWise secara otomatis menghitung nilai properti aset agregat, yang merupakan sekumpulan metrik dasar yang dihitung selama beberapa interval waktu. AWS IoT SiteWise menghitung agregat berikut setiap menit, jam, dan hari untuk properti aset Anda:
+ **rata-rata** — Rata-rata (mean) dari nilai properti selama interval waktu.
+ **count** — Jumlah titik data untuk properti selama interval waktu.
+ **maksimum** — Maksimum nilai properti selama interval waktu.
+ **minimum** — Minimal nilai properti selama interval waktu.
+ **standar deviasi** — Standar deviasi nilai properti selama interval waktu.
+ **jumlah** — Jumlah nilai properti selama interval waktu.

Untuk properti non-numerik, seperti string dan Boolean, hanya menghitung agregat AWS IoT SiteWise hitungan.

Anda juga dapat menghitung metrik kustom untuk data aset Anda. Dengan properti metrik, Anda menentukan agregasi yang spesifik untuk operasi Anda. Properti metrik menawarkan fungsi agregasi tambahan dan interval waktu yang tidak dihitung sebelumnya untuk API. AWS IoT SiteWise Untuk informasi selengkapnya, lihat [Data agregat dari properti dan aset lainnya (metrik)](metrics.md).

**Topics**
+ [Agregat untuk properti aset (API)](#aggregates-api)
+ [Agregat untuk properti aset ()AWS CLI](#aggregates-cli)

## Agregat untuk properti aset (API)
<a name="aggregates-api"></a>

Gunakan AWS IoT SiteWise API untuk mendapatkan agregat untuk properti aset.

Gunakan [GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)operasi untuk menanyakan agregat properti aset.

Untuk mengidentifikasi properti aset, tentukan salah satu dari berikut ini:
+ Properti `propertyId` aset yang dikirimkan ke data. `assetId`
+ The`propertyAlias`, yang merupakan alias aliran data (misalnya,`/company/windfarm/3/turbine/7/temperature`). Untuk menggunakan opsi ini, Anda harus terlebih dahulu menetapkan alias properti aset Anda. Untuk mengatur alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).

Anda harus melewati parameter yang diperlukan berikut:
+ `aggregateTypes`— Daftar agregat untuk diambil. Anda dapat menentukan salah satu dari`AVERAGE`,`COUNT`,`MAXIMUM`,`MINIMUM`,`STANDARD_DEVIATION`, dan`SUM`.
+ `resolution`— Interval waktu untuk mengambil metrik: `1m` (1 menit), `15m` (15 menit), `1h` (1 jam), atau `1d` (1 hari).
+ `startDate`— Awal eksklusif dari rentang dari mana untuk menanyakan data historis, dinyatakan dalam detik dalam waktu zaman Unix.
+ `endDate`— Akhir inklusif dari rentang dari mana untuk menanyakan data historis, dinyatakan dalam detik dalam waktu zaman Unix.

Anda juga dapat meneruskan salah satu parameter berikut untuk menyempurnakan hasil Anda:
+ `maxResults`— Jumlah maksimum hasil untuk dikembalikan dalam satu permintaan. Default untuk hasil. `20`
+ `nextToken`— Token pagination dikembalikan dari panggilan sebelumnya dari operasi ini.
+ `timeOrdering`— Urutan untuk diterapkan pada nilai yang dikembalikan: `ASCENDING` atau`DESCENDING`.
+ `qualities`— Kualitas untuk memfilter hasil dengan:`GOOD`,`BAD`, atau`UNCERTAIN`.

**catatan**  
[GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)Operasi mengembalikan TQV dengan format yang berbeda dari operasi lain yang dijelaskan dalam bagian ini. `value`Struktur berisi bidang untuk masing-masing permintaan. `aggregateTypes` `timestamp`Berisi waktu agregasi terjadi, dalam detik dalam waktu epoch Unix.

## Agregat untuk properti aset ()AWS CLI
<a name="aggregates-cli"></a>

**Untuk menanyakan agregat untuk properti aset ()AWS CLI**

1. Jalankan perintah berikut untuk mendapatkan agregat untuk properti aset. Perintah ini menanyakan rata-rata dan jumlah dengan resolusi 1 jam untuk interval 1 jam tertentu. Ganti *asset-id* dengan ID aset dan *property-id* dengan ID properti. Ganti parameter dengan agregat dan interval untuk kueri.

   ```
   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
   ```

   Operasi mengembalikan respons yang berisi TQVs historis properti dalam format berikut. Respons hanya mencakup agregat yang diminta.

   ```
   {
     "aggregatedValues": [
       {
         "timestamp": Number,
         "quality": "String",
         "value": {
           "average": Number,
           "count": Number,
           "maximum": Number,
           "minimum": Number,
           "standardDeviation": Number,
           "sum": Number
         }
       }
     ],
     "nextToken": "String"
   }
   ```

1. Jika ada lebih banyak entri nilai, Anda dapat meneruskan token pagination dari `nextToken` bidang ke panggilan berikutnya ke operasi. [GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)

**catatan**  
 Jika rentang kueri berisi `null` nilai TQVs, lihat [AssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetPropertyValue.html)API. Semua statistik kecuali hitungan, menghasilkan `null` respons, mirip dengan statistik untuk String TQVs. Jika rentang kueri Anda berisi `Double.NaN` tipe ganda TQVs, semua perhitungan kecuali hitungan akan menghasilkan a`Double.NaN`.