View a markdown version of this page

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 permintaan pembuatan dan pembaruan ke sumber daya dependen (dari model aset ke aset, atau dari model komponen ke model aset). Kemudian menempatkan model dalam ACTIVE keadaan.

Jika definisi model yang diberikan tidak valid, AWS IoT SiteWise menempatkan model dalam FAILED status. 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 modelnya adalahACTIVE.

Secara default, detail versi terbaru model dikembalikan saat API deskripsi 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 FAILED status. Anda harus mengembalikan perubahan dengan mengambil versi aktif model aset, dan membuat permintaan pembaruan lain yang mengacu pada definisi yang valid ini.

  • Ada aplikasi di AWS IoT SiteWise mana pelanggan dapat melihat aset dan model aset yang sesuai. Ketika pengguna merujuk definisi model aset yang sesuai dengan aset tertentu, dan model aset berada dalam FAILED keadaan sementara, UPDATINGPROPAGATING, atau status, 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 dari 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 berada dalam status sementara,UPDATING, atauPROPAGATING, FAILED cari Lihat versi aktif di bawah Status di panel Detail.

Ambil 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 DescribeAssetModel operasi dengan assetModelVersion parameter.

Tip

Men AWS CLI definisikan model komponen sebagai jenis model aset. Oleh karena itu, Anda menggunakan DescribeAssetModel operasi yang sama untuk kedua jenis model. Bid assetModelType ang 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 ID eksternal 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" }