Perbarui model komposit khusus (komponen)

Anda dapat menggunakan AWS IoT SiteWise API untuk memperbarui model komposit khusus, atau AWS IoT SiteWise konsol untuk memperbarui komponen.

Perbarui komponen (konsol)

Anda dapat menggunakan AWS IoT SiteWise konsol untuk memperbarui komponen.

Untuk memperbarui komponen (konsol)

1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

2. Di panel navigasi, pilih Model.

3. Pilih model aset di mana komponennya berada.

4. Pada tab Properties, pilih Components.

5. Pilih komponen yang ingin Anda perbarui.

6. Pilih Edit.

7. Pada halaman Edit komponen, lakukan salah satu hal berikut:

   • Dalam detail Model, ubah Nama model.

   • Ubah salah satu definisi Atribut. Anda tidak dapat mengubah tipe Data dari atribut yang ada. Untuk informasi selengkapnya, lihat Tentukan data statis (atribut).

   • Ubah salah satu definisi Pengukuran. Anda tidak dapat mengubah tipe Data pengukuran yang ada. Untuk informasi selengkapnya, lihat Tentukan aliran data dari peralatan (pengukuran).

   • Ubah salah satu definisi Transform. Untuk informasi selengkapnya, lihat Mengubah data (mengubah).

   • Ubah salah satu definisi Metrik. Anda tidak dapat mengubah Interval waktu metrik yang ada. Untuk informasi selengkapnya, lihat Data agregat dari properti dan aset lainnya (metrik).

8. Pilih Simpan.

Perbarui model komposit khusus (AWS CLI)

Gunakan AWS Command Line Interface (AWS CLI) untuk memperbarui model komposit kustom.

Untuk memperbarui nama atau deskripsi, gunakan UpdateAssetModelCompositeModeloperasi. Hanya untuk model komposit khusus sebaris, Anda juga dapat memperbarui properti. Anda tidak dapat memperbarui properti model komposit component-model-based kustom, karena model komponen yang direferensikan menyediakan properti terkait.

penting

Jika Anda menghapus properti dari model komposit kustom, AWS IoT SiteWise menghapus semua data sebelumnya untuk properti tersebut. Anda tidak dapat mengubah tipe atau tipe data properti yang ada.

Untuk mengganti properti model komposit yang ada dengan yang baru dengan yang samaname, lakukan hal berikut:

1. Kirim UpdateAssetModelCompositeModel permintaan dengan seluruh properti yang ada dihapus.

2. Kirim UpdateAssetModelCompositeModel permintaan kedua yang mencakup properti baru. Properti aset baru akan name sama dengan yang sebelumnya dan AWS IoT SiteWise akan menghasilkan unik baruid.

Untuk memperbarui model komposit kustom (AWS CLI)

1. Untuk mengambil definisi model komposit yang ada, jalankan perintah berikut. Ganti composite-model-id dengan ID atau ID eksternal dari model komposit khusus untuk diperbarui, dan asset-model-id dengan model aset yang dikaitkan dengan model komposit khusus. Untuk informasi selengkapnya, lihat Panduan Pengguna AWS IoT SiteWise .

   1. Jalankan perintah di bawah ini:

      aws iotsitewise describe-asset-model-composite-model \
      --asset-model-composite-model-id composite-model-id \
      --asset-model-id asset-model-id

   2. Perintah di atas mengembalikan definisi model komposit yang sesuai dengan versi terbaru model terkait. Untuk kasus penggunaan di mana model aset berada dalam FAILED status, ambil definisi model yang valid yang sesuai dengan versi aktifnya untuk membuat permintaan pembaruan Anda. Lihat Versi model aset untuk detail.

   3. Jalankan perintah berikut untuk mengambil definisi model aktif:

      aws iotsitewise describe-asset-model-composite-model \
      --asset-model-composite-model-id composite-model-id \
      --asset-model-id asset-model-id \
      --asset-model-version ACTIVE

   4. Untuk informasi lebih lanjut, lihat DescribeAssetModelCompositeModeloperasi.

2. Buat file bernamaupdate-custom-composite-model.json, lalu salin respons perintah sebelumnya ke dalam file.

3. Hapus setiap pasangan kunci-nilai dari JSON objek di update-custom-composite-model.json kecuali untuk bidang berikut:

   • assetModelCompositeModelName

   • assetModelCompositeModelDescription(jika ada)

   • assetModelCompositeModelProperties(jika ada)

4. Pada update-custom-composite-model.json, lakukan langkah-langkah berikut:

   • Ubah nilaiassetModelCompositeModelName.

   • Tambah atau hapusassetModelCompositeModelDescription, atau ubah nilainya.

   • Hanya untuk model komposit kustom sebaris: Ubah, tambahkan, atau hapus properti model aset apa pun diassetModelCompositeModelProperties.

   Untuk informasi selengkapnya tentang format yang diperlukan untuk file ini, lihat sintaks permintaan untuk UpdateAssetModelCompositeModel.

5. Jalankan perintah berikut untuk memperbarui model komposit kustom dengan definisi yang disimpan diupdate-custom-composite-model.json. Ganti composite-model-id dengan ID model komposit, dan asset-model-id dengan ID model aset yang ada di dalamnya.

   aws iotsitewise update-asset-model-composite-model \
   --asset-model-composite-model-id composite-model-id \
   --asset-model-id asset-model-id \
   --cli-input-json file://update-custom-composite-model.json

penting

Ketika beberapa pengguna memperbarui model aset pada saat yang sama, perubahan pengguna mungkin secara tidak sengaja ditimpa oleh pengguna lain. Untuk mencegah hal ini, Anda harus menentukan permintaan pembaruan bersyarat. Lihat Penguncian optimis untuk penulisan model aset.