BatchPutAssetPropertyValue API - AWS IoT SiteWise

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

BatchPutAssetPropertyValue API

Gunakan BatchPutAssetPropertyValueoperasi untuk mengunggah data Anda. Dengan operasi ini, Anda dapat mengunggah beberapa entri data sekaligus untuk mengumpulkan data dari beberapa perangkat dan mengirimkan semuanya dalam satu permintaan.

penting

BatchPutAssetPropertyValueOperasi tunduk pada kuota berikut:

  • Hingga 10 entri per permintaan.

  • Hingga 10 nilai properti (titik data TQV) per entri.

  • AWS IoT SiteWise menolak data apa pun dengan stempel waktu bertanggal lebih dari 7 hari di masa lalu atau lebih dari 10 menit di masa depan.

Untuk informasi selengkapnya tentang kuota ini, lihat BatchPutAssetPropertyValuedi Referensi AWS IoT SiteWise API.

Untuk mengidentifikasi properti aset, tentukan salah satu dari berikut ini:

  • Properti propertyId aset yang dikirimkan ke data. assetId

  • ThepropertyAlias, 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, lihatMengelola aliran data untuk AWS IoT SiteWise.

Contoh berikut menunjukkan cara mengirim suhu turbin angin dan rotasi per menit (RPM) pembacaan dari muatan yang disimpan dalam file JSON.

aws iotsitewise batch-put-asset-property-value --cli-input-json file://batch-put-payload.json

Contoh payload di batch-put-payload.json memiliki konten berikut.

{
  "enablePartialEntryProcessing": true,      
  "entries": [
    {
      "entryId": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/temperature",
      "propertyValues": [
        {
          "value": {
            "integerValue": 38
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    },
    {
      "entryId": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/rpm",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 15.09
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          },
          "quality": "GOOD"
        }
      ]
    },
    {
  "entryId": "unique entry ID",
      "propertyAlias": "/company/windfarm/3/turbine/7/rpm",
      "propertyValues": [
        {
  "value": {
  "nullValue":{"valueType": "D"}
          },
          "timestamp": {
  "timeInSeconds": 1575691200
          },
          "quality": "BAD"
        }
      ]
    }
  ]
}

Menentukan enablePartialEntryProcessing sebagai true memungkinkan konsumsi semua nilai yang tidak mengakibatkan kegagalan. Perilaku bawaannya adalah false. Jika nilai tidak valid, seluruh entri gagal tertelan.

Setiap entri dalam payload berisi entryId yang dapat Anda definisikan sebagai string unik apa pun. Jika ada entri permintaan yang gagal, setiap kesalahan akan berisi permintaan entryId yang sesuai sehingga Anda tahu permintaan mana yang harus dicoba lagi.

Setiap struktur dalam daftar propertyValues adalah struktur timestamp-quality-value (TQV) yang berisi avalue, atimestamp, dan opsional a. quality

  • value— Struktur yang berisi salah satu bidang berikut, tergantung pada jenis properti yang ditetapkan:

    • booleanValue

    • doubleValue

    • integerValue

    • stringValue

    • nullValue

  • nullValue— Struktur dengan bidang berikut yang menunjukkan jenis nilai properti dengan nilai Null dan kualitas atau. BAD UNCERTAIN

    • valueType— Enum dari {"B”, “D”, “S”, “I"}

  • timestamp— Struktur yang berisi waktu epoch Unix saat ini dalam hitungan detik,. timeInSeconds Anda juga dapat mengatur offsetInNanos kunci dalam timestamp struktur jika Anda memiliki data yang tepat untuk sementara. AWS IoT SiteWise menolak setiap titik data dengan stempel waktu yang lebih tua dari 7 hari di masa lalu atau lebih baru dari 10 menit di masa depan.

  • quality— (Opsional) Salah satu string kualitas berikut:

    • GOOD— (Default) Data tidak terpengaruh oleh masalah apa pun.

    • BAD— Data dipengaruhi oleh masalah seperti kegagalan sensor.

    • UNCERTAIN— Data dipengaruhi oleh masalah seperti ketidakakuratan sensor.

    Untuk informasi selengkapnya tentang cara AWS IoT SiteWise menangani kualitas data dalam komputasi, lihat Kualitas data dalam ekspresi rumus.