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

# Perbarui model komposit khusus (komponen)
<a name="update-custom-composite-models"></a>

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

**Topics**
+ [Perbarui komponen (konsol)](#update-custom-composite-model-console)
+ [Perbarui model komposit khusus (AWS CLI)](#update-custom-composite-model-cli)

## Perbarui komponen (konsol)
<a name="update-custom-composite-model-console"></a>

Anda dapat menggunakan AWS IoT SiteWise konsol untuk memperbarui komponen.

**Untuk memperbarui komponen (konsol)**

1. <a name="sitewise-open-console"></a>Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. <a name="sitewise-choose-models"></a>Di panel navigasi, pilih **Model**.

1. Pilih model aset di mana komponennya berada.

1. Pada tab **Properties**, pilih **Components**.

1. Pilih komponen yang ingin Anda perbarui.

1. Pilih **Edit**.

1. 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)](attributes.md).
   + Ubah salah satu **definisi Pengukuran**. Anda tidak dapat mengubah **tipe Data** pengukuran yang ada. Untuk informasi selengkapnya, lihat [Tentukan aliran data dari peralatan (pengukuran)](measurements.md).
   + Ubah salah satu **definisi Transform**. Untuk informasi selengkapnya, lihat [Mengubah data (mengubah)](transforms.md).
   + 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)](metrics.md).

1. Pilih **Simpan**.

## Perbarui model komposit khusus (AWS CLI)
<a name="update-custom-composite-model-cli"></a>

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

Untuk memperbarui nama atau deskripsi, gunakan [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)operasi. 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 sama`name`, lakukan hal berikut:  
Kirim `UpdateAssetModelCompositeModel` permintaan dengan seluruh properti yang ada dihapus.
Kirim `UpdateAssetModelCompositeModel` permintaan kedua yang mencakup properti baru. Properti aset baru akan `name` sama dengan yang sebelumnya dan AWS IoT SiteWise akan menghasilkan unik baru`id`.

**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 model komposit khusus untuk diperbarui, dan *asset-model-id* dengan model aset yang terkait dengan model komposit khusus. Untuk informasi selengkapnya, silakan 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
      ```

   1.  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](model-active-version.md) untuk detail. 

   1. 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
      ```

   1. Untuk informasi lebih lanjut, lihat [DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html)operasi.

1. Buat file bernama`update-custom-composite-model.json`, lalu salin respons perintah sebelumnya ke dalam file.

1. Hapus setiap pasangan kunci-nilai dari objek JSON `update-custom-composite-model.json` kecuali untuk bidang berikut:
   + `assetModelCompositeModelName`
   + `assetModelCompositeModelDescription`(jika ada)
   + `assetModelCompositeModelProperties`(jika ada)

1. Pada `update-custom-composite-model.json`, lakukan langkah-langkah berikut:
   + Ubah nilai`assetModelCompositeModelName`.
   + Tambah atau hapus`assetModelCompositeModelDescription`, atau ubah nilainya.
   + Hanya untuk model komposit kustom sebaris: Ubah, tambahkan, atau hapus properti model aset apa pun di`assetModelCompositeModelProperties`.

   Untuk informasi selengkapnya tentang format yang diperlukan untuk file ini, lihat sintaks permintaan untuk [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html).

1. Jalankan perintah berikut untuk memperbarui model komposit kustom dengan definisi yang disimpan di`update-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](opt-locking-for-model.md).