Perbarui model aset dan model komponen - AWS IoT SiteWise
Memperbarui model aset atau komponen (konsol)Memperbarui model aset atau komponen (AWS CLI)

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

Perbarui model aset dan model komponen

Gunakan AWS IoT SiteWise konsol atau API untuk memperbarui model aset atau model komponen.

Anda tidak dapat mengubah tipe atau tipe data properti yang ada, atau jendela metrik yang ada. Anda juga tidak dapat mengubah jenis model dari model aset ke model komponen, atau sebaliknya.

penting

  • Jika Anda menghapus properti dari model aset atau model komponen, AWS IoT SiteWise menghapus semua data sebelumnya untuk properti tersebut. Untuk model komponen, ini memengaruhi semua model aset yang menggunakan model komponen tersebut, jadi berhati-hatilah untuk memahami seberapa luas perubahan Anda dapat diterapkan.

  • Jika Anda menghapus definisi hierarki dari model aset, AWS IoT SiteWise lepaskan semua aset dalam hierarki tersebut.

Saat Anda memperbarui model aset, setiap aset berdasarkan model tersebut mencerminkan perubahan apa pun yang Anda buat pada model yang mendasarinya. Sampai perubahan menyebar, setiap aset memiliki UPDATING negara. Anda harus menunggu sampai aset tersebut kembali ke ACTIVE negara sebelum Anda berinteraksi dengan mereka. Selama waktu ini, status model aset yang diperbarui akan menjadiPROPAGATING.

Saat Anda memperbarui model komponen, setiap model aset yang menggabungkan model komponen tersebut mencerminkan perubahan. Sampai perubahan model komponen menyebar, setiap model aset yang terpengaruh memiliki UPDATING status, diikuti oleh PROPAGATING saat memperbarui aset terkait, seperti yang dijelaskan dalam paragraf sebelumnya. Anda harus menunggu sampai model aset tersebut kembali ke ACTIVE keadaan sebelum Anda berinteraksi dengannya. Selama waktu ini, status model komponen yang diperbarui akan menjadiPROPAGATING.

Untuk informasi selengkapnya, lihat Status aset dan model.

Memperbarui model aset atau komponen (konsol)

Anda dapat menggunakan AWS IoT SiteWise konsol untuk memperbarui model aset atau model komponen.

Untuk memperbarui model aset atau model komponen (konsol)

  1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

  2. Di panel navigasi, pilih Model.

  3. Pilih model aset atau model komponen yang akan diperbarui.

  4. Pilih Edit.

  5. Pada halaman Edit model, lakukan salah satu hal berikut:

  6. Pilih Simpan.

catatan

Permintaan pembaruan yang dibuat di konsol ditolak, jika pengguna lain berhasil memperbarui model aset sejak Anda terakhir membuka halaman Edit model. Konsol meminta pengguna untuk Menyegarkan halaman Edit model, untuk mengambil model yang diperbarui. Anda harus melakukan pembaruan lagi, dan coba lagi penyimpanan Anda. Lihat Penguncian optimis untuk penulisan model aset untuk detail selengkapnya.

Memperbarui model aset atau komponen (AWS CLI)

Gunakan AWS Command Line Interface (AWS CLI) untuk memperbarui model aset atau model komponen.

Gunakan UpdateAssetModelAPIuntuk memperbarui nama, deskripsi, dan properti model aset atau model komponen. Hanya untuk model aset, Anda dapat memperbarui hierarki. Tentukan parameter berikut:

  • assetModelId— ID aset. Ini adalah ID aktual dalam UUID format, atau externalId:myExternalId jika memilikinya. Untuk informasi selengkapnya, lihat Referensi objek dengan eksternal IDs di AWS IoT SiteWise Panduan Pengguna.

Tentukan model yang diperbarui dalam muatan. Untuk mempelajari tentang format yang diharapkan dari model aset atau model komponen, lihatBuat model aset.

Awas

UpdateAssetModelAPIMenimpa model yang ada dengan model yang Anda berikan di payload. Untuk menghindari penghapusan properti atau hierarki model Anda, Anda harus menyertakan properti IDs dan definisinya dalam payload model yang diperbarui. Untuk mempelajari cara menanyakan struktur model yang ada, lihat DescribeAssetModeloperasinya.

catatan

Prosedur berikut hanya dapat memperbarui model komposit tipeAWS/ALARM. Jika Anda ingin memperbarui model CUSTOM komposit, gunakan UpdateAssetModelCompositeModelsebagai gantinya. Untuk informasi selengkapnya, lihat Perbarui model komposit khusus (komponen).

Untuk memperbarui model aset atau model komponen (AWS CLI)

  1. Jalankan perintah berikut untuk mengambil definisi model yang ada. Ganti asset-model-id dengan ID atau ID eksternal dari model aset atau model komponen untuk diperbarui.

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id

    Perintah di atas mengembalikan definisi model yang sesuai dengan versi terbaru model.

    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. Jalankan perintah berikut untuk mengambil definisi model aktif:

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

    Operasi mengembalikan respons yang berisi detail model. Responsnya memiliki struktur sebagai berikut.

    {
    "assetModelId": "String",
    "assetModelArn": "String",
    "assetModelName": "String",
    "assetModelDescription": "String",
    "assetModelProperties": Array of AssetModelProperty,
    "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
    "assetModelCompositeModels": Array of AssetModelCompositeModel,
    "assetModelCompositeModelSummaries": Array of AssetModelCompositeModelSummary,
    "assetModelCreationDate": "String",
    "assetModelLastUpdateDate": "String",
    "assetModelStatus": {
      "state": "String",
      "error": {
        "code": "String",
        "message": "String"
      },
    "assetModelType": "String"
    },
    "assetModelVersion": "String",
    "eTag": "String"
}

    Untuk informasi lebih lanjut, lihat DescribeAssetModeloperasi.

  2. Buat file bernama update-asset-model.json dan salin respons perintah sebelumnya ke dalam file.

  3. Hapus pasangan kunci-nilai berikut dari JSON objek di: update-asset-model.json

    • assetModelId

    • assetModelArn

    • assetModelCompositeModelSummaries

    • assetModelCreationDate

    • assetModelLastUpdateDate

    • assetModelStatus

    • assetModelType

    • assetModelVersion

    • eTag

    UpdateAssetModelOperasi mengharapkan muatan dengan struktur berikut:

    {
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
  "assetModelCompositeModels": Array of AssetModelCompositeModel
}

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

    • Ubah nama model aset (assetModelName).

    • Mengubah, menambah, atau menghapus deskripsi model aset (assetModelDescription).

    • Mengubah, menambah, atau menghapus properti model aset (assetModelProperties). Anda tidak dapat mengubah properti dataType yang ada atau metrik window yang ada. Untuk informasi selengkapnya, lihat Tentukan properti data.

    • Mengubah, menambah, atau menghapus salah satu hierarki model aset (assetModelHierarchies). Anda tidak dapat mengubah hierarki childAssetModelId yang ada. Untuk informasi selengkapnya, lihat Tentukan hierarki model aset.

    • Mengubah, menambah, atau menghapus salah satu model komposit model aset tipe AWS/ALARM (assetModelCompositeModels). Alarm memantau properti lain sehingga Anda dapat mengidentifikasi kapan peralatan atau proses memerlukan perhatian. Setiap definisi alarm adalah model komposit yang menstandarisasi serangkaian properti yang digunakan alarm. Untuk informasi selengkapnya, silakan lihat Pantau data dengan alarm dan Tentukan alarm pada model aset.

  5. Jalankan perintah berikut untuk memperbarui model aset dengan definisi yang disimpan diupdate-asset-model.json. Ganti asset-model-id dengan ID model aset:

    aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://model-payload.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.