Perbarui nilai atribut - AWS IoT SiteWise

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

Perbarui nilai atribut

Aset mewarisi atribut model aset mereka, termasuk nilai default atribut. Dalam beberapa kasus, Anda akan ingin menyimpan atribut default model aset, seperti untuk properti produsen aset. Dalam kasus lain, Anda akan ingin memperbarui atribut yang diwariskan, seperti untuk lintang dan bujur aset.

Updating an attribute value (console)

Anda dapat menggunakan AWS IoT SiteWise konsol untuk memperbarui nilai properti aset atribut.

Untuk memperbarui nilai atribut (konsol)

  1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

  2. Di panel navigasi, pilih Aset.

  3. Pilih aset yang ingin Anda perbarui atributnya.

    Tip

    Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.

  4. Pilih Edit.

  5. Temukan atribut yang akan diperbarui, lalu masukkan nilai barunya.

    AWS IoT SiteWise Tangkapan layar halaman “Edit aset” dengan nilai atribut yang disorot.

  6. Pilih Simpan.

Updating an attribute value (AWS CLI)

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk memperbarui nilai atribut.

Anda harus mengetahui aset assetId dan properti Anda propertyId untuk menyelesaikan prosedur ini. Anda juga dapat menggunakan ID eksternal. Jika Anda membuat aset dan tidak mengetahuinyaassetId, gunakan ListAssetsAPIuntuk mencantumkan semua aset untuk model tertentu. Gunakan DescribeAssetoperasi untuk melihat properti aset Anda termasuk propertiIDs.

Gunakan BatchPutAssetPropertyValueoperasi untuk menetapkan nilai atribut ke aset Anda. Anda dapat menggunakan operasi ini untuk mengatur beberapa atribut sekaligus. Payload operasi ini berisi daftar entri, dan setiap entri berisi ID aset, ID properti, dan nilai atribut.

Untuk memperbarui nilai atribut (AWS CLI)

  1. Buat file bernama batch-put-payload.json dan salin JSON objek berikut ke dalam file. Contoh payload ini menunjukkan cara mengatur lintang dan bujur turbin angin. PerbaruiIDs, nilai, dan stempel waktu untuk memodifikasi payload untuk kasus penggunaan Anda.

    {
  "entries": [
    {
      "entryId": "windfarm3-turbine7-latitude",
      "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
      "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 47.6204
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    },
    {
      "entryId": "windfarm3-turbine7-longitude",
      "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
      "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
      "propertyValues": [
        {
          "value": {
            "doubleValue": 122.3491
          },
          "timestamp": {
            "timeInSeconds": 1575691200
          }
        }
      ]
    }
  ]
}

    • 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.

    • Untuk menetapkan nilai atribut, Anda dapat menyertakan satu timestamp-quality-value (TQV) struktur dalam daftar propertyValues untuk setiap properti atribut. Struktur ini harus berisi yang baru value dan yang saat initimestamp.

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

        • booleanValue

        • doubleValue

        • integerValue

        • stringValue

      • timestamp— Struktur yang berisi waktu epoch Unix saat ini dalam hitungan detik,. timeInSeconds AWS IoT SiteWise menolak setiap titik data dengan stempel waktu yang ada lebih dari 7 hari di masa lalu atau lebih baru dari 5 menit di masa depan.

    Untuk informasi lebih lanjut tentang cara menyiapkan muatan BatchPutAssetPropertyValue, lihatMenelan data menggunakan AWS IoT SiteWise API.

  2. Jalankan perintah berikut untuk mengirim nilai atribut ke AWS IoT SiteWise:

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