

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

# Versi model aset
<a name="model-active-version"></a>

 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.

1. **Versi aktif —** Definisi terbaru berhasil diproses, dan status model adalah`ACTIVE`.

 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 `UPDATING``PROPAGATING`, versi terbaru mengembalikan definisi model aset yang belum disebarkan ke asetnya. Dalam hal ini, Anda harus mengambil versi aktif dari model aset kepada pelanggan. 

**Topics**
+ [Mengambil versi aktif dari model aset atau model komponen (konsol)](#active-console)
+ [Mengambil versi aktif dari model aset atau model komponen ()AWS CLI](#active-cli)

## Mengambil versi aktif dari model aset atau model komponen (konsol)
<a name="active-console"></a>

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. <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 untuk mengambil versi aktifnya.

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

   1.  Jika model dalam status sementara`UPDATING`, atau `FAILED` status`PROPAGATING`, temukan **Lihat versi aktif** di bawah **Status di panel** **Detail**. 

## Mengambil versi aktif dari model aset atau model komponen ()AWS CLI
<a name="active-cli"></a>

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](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operasi dengan `assetModelVersion` parameter.

**Tip**  
 AWS CLI Mendefinisikan model komponen sebagai jenis model aset. Oleh karena itu, Anda menggunakan [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operasi yang sama untuk kedua jenis model. `assetModelType`Bidang dalam respons menunjukkan apakah itu an `ASSET_MODEL` atau a`COMPONENT_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 model aset atau model komponen. ID eksternal adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat [Referensi objek dengan eksternal IDs](object-ids.md#external-id-references) 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"
  }
  ```