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)