本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 資產模型版本
<a name="model-active-version"></a>

 AWS IoT SiteWise 支援非同步處理資產模型和元件模型上的建立和更新操作。它也會更新模型的狀態。

 AWS IoT SiteWise 傳播有效模型在建立中的變更，並將請求更新至其相依資源 （從資產模型到資產，或從元件模型到資產模型）。然後，它會將模型置於 `ACTIVE` 狀態。

 如果提供的模型定義無效， 會將模型 AWS IoT SiteWise 置於 `FAILED` 狀態。變更不會傳播到相依資源。相依資源是指模型處於 `ACTIVE` 狀態時傳播的最後一個模型定義。

 根據上述資訊，模型定義有兩種類型的模型版本：

1. **最新版本 –** 在建立或更新請求中接受的最新定義。

1. **作用中版本 –** 最新定義已成功處理，模型狀態為 `ACTIVE`。

 根據預設，當在資產模型或元件模型上呼叫描述 APIs時，會傳回模型最新版本的詳細資訊。在某些情況下，需要資產模型或元件模型的作用中版本。請參閱以下範例案例：
+  具有無效定義的更新操作會使您的資產模型處於 `FAILED` 狀態。您必須擷取資產模型的作用中版本，並建立參考此有效定義的另一個更新請求，以還原變更。
+  上的應用程式 AWS IoT SiteWise 存在，客戶可以在其中檢視資產及其對應的資產模型。當使用者參考對應至特定資產的資產模型定義，且資產模型處於暫時性 `UPDATING`、 `PROPAGATING`或 `FAILED` 狀態時，最新版本會傳回尚未傳播至其資產的資產模型定義。在此情況下，您必須將資產模型的作用中版本擷取給客戶。

**Topics**
+ [擷取資產模型或元件模型的作用中版本 （主控台）](#active-console)
+ [擷取資產模型或元件模型的作用中版本 (AWS CLI)](#active-cli)

## 擷取資產模型或元件模型的作用中版本 （主控台）
<a name="active-console"></a>

請依照此程序，在 AWS IoT SiteWise 主控台中擷取資產模型或元件模型的作用中版本。

**提示**  
資產模型和元件模型都列在導覽窗格中**的模型**下。所選資產模型或元件模型**的詳細資訊**面板會指出其類型。

**擷取資產模型或元件模型的作用中版本 （主控台）**

1. <a name="sitewise-open-console"></a>導覽至 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. <a name="sitewise-choose-models"></a>在導覽窗格中，選擇 **Models (模型)**。

1. 選擇模型以擷取其作用中版本。

   1.  如果模型處於 `ACTIVE` 狀態，則您正在檢視其作用中版本。

   1.  如果模型處於暫時性 `UPDATING`、 `PROPAGATING`或 `FAILED` 狀態，請在**詳細資訊**面板中的**狀態**下尋找**作用中版本**。

## 擷取資產模型或元件模型的作用中版本 (AWS CLI)
<a name="active-cli"></a>

使用 AWS CLI 擷取資產模型或元件模型的作用中版本。

若要擷取資產模型或元件模型的作用中版本，請使用 [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) 操作搭配 `assetModelVersion` 參數。

**提示**  
將元件模型 AWS CLI 定義為資產模型的類型。因此，您對這兩種類型的模型使用相同的 [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html) 操作。回應中的 `assetModelType` 欄位指出它是 `ASSET_MODEL`或 `COMPONENT_MODEL`。

**擷取資產模型或元件模型的作用中版本 (AWS CLI)**
+ 執行下列命令來描述模型。以資產模型或元件模型的 ID 或外部 ID 取代 *asset-model-id*。外部 ID 是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》**中的 [參考具有外部 IDs物件](object-ids.md#external-id-references)。

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

  操作會傳回包含模型詳細資訊的回應。回應包含具有下列結構的 `assetModelStatus` 物件。

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