Versi model aset - AWS IoT SiteWise

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

Versi model aset

AWS IoT SiteWise mendukung pemrosesan asinkron untuk membuat dan memperbarui operasi pada model aset dan model komponen. Ini juga memperbarui status model.

AWS IoT SiteWise menyebarkan perubahan model yang valid dalam membuat dan memperbarui permintaan ke sumber daya dependennya (dari model aset ke aset, atau dari model komponen ke model aset). Kemudian menempatkan model di ACTIVE negara bagian.

Jika definisi model yang diberikan tidak valid, AWS IoT SiteWise tempatkan model dalam keadaan. FAILED Perubahan tidak disebarkan ke sumber daya dependen. Sumber daya dependen mengacu pada definisi model terakhir yang disebarkan ketika model berada dalam ACTIVE keadaan.

Berdasarkan informasi di atas, definisi model memiliki dua jenis versi model:

  1. Versi terbaru — Definisi terbaru diterima sebagai bagian dari permintaan membuat atau memperbarui.

  2. Versi aktif — Definisi terbaru berhasil diproses, dan status model adalahACTIVE.

Secara default, detail versi terbaru model dikembalikan ketika describe APIs dipanggil pada model aset atau model komponen. Ada skenario di mana versi aktif dari model aset atau model komponen diperlukan. Lihat contoh skenario di bawah ini:

  • Operasi pembaruan dengan definisi yang tidak valid menempatkan model aset Anda dalam keadaan. FAILED Anda harus mengembalikan perubahan dengan mengambil versi aktif model aset, dan membuat permintaan pembaruan lain yang mengacu pada definisi yang valid ini.

  • Aplikasi AWS IoT SiteWise ada di mana pelanggan dapat melihat aset dan model aset yang sesuai. Ketika pengguna merujuk definisi model aset yang sesuai dengan aset tertentu, dan model aset dalam FAILED keadaan sementara UPDATINGPROPAGATING, versi terbaru mengembalikan definisi model aset yang belum disebarkan ke asetnya. Dalam hal ini, Anda harus mengambil versi aktif dari model aset kepada pelanggan.

Mengambil versi aktif dari model aset atau model komponen (konsol)

Ikuti prosedur ini untuk mengambil versi aktif model aset atau model komponen di AWS IoT SiteWise konsol.

Tip

Model aset dan model komponen keduanya tercantum di bawah Model di panel navigasi. Panel Detail dari model aset atau model komponen yang dipilih menunjukkan jenisnya.

Untuk mengambil versi aktif dari model aset atau model komponen (konsol)
  1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

  2. Di panel navigasi, pilih Model.

  3. Pilih model untuk mengambil versi aktifnya.

    1. Jika model dalam ACTIVE keadaan, Anda melihat versi aktifnya.

    2. Jika model dalam status sementaraUPDATING, atau FAILED statusPROPAGATING, temukan Lihat versi aktif di bawah Status di panel Detail.

Mengambil versi aktif dari model aset atau model komponen ()AWS CLI

Gunakan AWS CLI untuk mengambil versi aktif dari model aset atau model komponen.

Untuk mengambil versi aktif dari model aset atau model komponen, gunakan DescribeAssetModeloperasi dengan assetModelVersion parameter.

Tip

AWS CLI Mendefinisikan model komponen sebagai jenis model aset. Oleh karena itu, Anda menggunakan DescribeAssetModeloperasi yang sama untuk kedua jenis model. assetModelTypeBidang dalam respons menunjukkan apakah itu an ASSET_MODEL atau aCOMPONENT_MODEL.

Untuk mengambil versi aktif dari model aset atau model komponen ()AWS CLI
  • Jalankan perintah berikut untuk menggambarkan model. Ganti asset-model-id dengan ID atau ID eksternal dari model aset atau model komponen. ID eksternal adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Referensi objek dengan eksternal IDs di AWS IoT SiteWise Panduan Pengguna.

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

    Operasi mengembalikan respons dengan detail model. Respons berisi assetModelStatus objek dengan struktur berikut.

    { ... "assetModelName": "string", "assetModelProperties": [ ... ], ..., "assetModelVersion": "string" }