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

# Kueri nilai properti aset historis di AWS IoT SiteWise
<a name="historical-values"></a>

Anda dapat menggunakan [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)operasi AWS IoT SiteWise API untuk menanyakan nilai historis 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).

Lulus parameter berikut untuk menyempurnakan hasil Anda:
+ `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.
+ `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`.

**Untuk menanyakan riwayat nilai untuk properti aset (AWS CLI)**

1. Jalankan perintah berikut untuk mendapatkan riwayat nilai untuk properti aset. Perintah ini menanyakan riwayat properti selama interval 10 menit tertentu. Ganti *asset-id* dengan ID aset dan *property-id* dengan ID properti. Ganti parameter tanggal dengan interval untuk kueri.

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

   Operasi mengembalikan respons yang berisi TQVs historis properti dalam format berikut:

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

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