資產模型版本 - AWS IoT SiteWise
擷取資產模型或元件模型的作用中版本 (主控台)擷取資產模型或元件模型的現行版本 (AWS CLI)

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

資產模型版本

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

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

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

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

  1. 最新版本 — 接受做為建立或更新請求一部分的最新定義。

  2. 使用中版本 — 已成功處理最新定義，且模型狀態為ACTIVE。

依預設，在資產模型或元件模型上呼叫描述時，APIs會傳回模型最新版本的詳細資訊。在某些情況下，需要資產模型或元件模型的作用中版本。請參閱下面的示例場景：

  • 使用無效定義的更新作業會將資產模型置於FAILED狀態。您必須擷取資產模型的作用中版本，並建立參照此有效定義的另一個更新請求，以回復變更。

  • AWS IoT SiteWise 存在的應用程式，客戶可以在其中檢視資產及其對應的資產模型。當使用者參照與特定資產對應的資產模型定義，且資產模型處於暫時性或FAILED狀態時 UPDATINGPROPAGATING，最新版本會傳回尚未傳播至其資產的資產模型定義。在此情況下，您必須擷取資產模型的作用中版本給客戶。

擷取資產模型或元件模型的作用中版本 (主控台)

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

提示

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

若要擷取資產模型或元件模型的作用中版本 (主控台)

  1. 導覽至 AWS IoT SiteWise 主控台。

  2. 在導覽窗格中，選擇 Models (模型)。

  3. 選擇要擷取其使用中版本的模型。

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

    2. 如果模型處於暫時狀態、或FAILED狀態 UPDATINGPROPAGATING，請在「詳細資訊」面板中的「狀態」下找到「查看使用中版本」。

擷取資產模型或元件模型的現行版本 (AWS CLI)

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

若要擷取資產模型或元件模型的作用中版本，請搭配assetModelVersion參數使用此DescribeAssetModel作業。

提示

將元件模型 AWS CLI 定義為資產模型類型。因此，兩種類型的模型都使用相同的DescribeAssetModel操作。響應中的assetModelType字段表示它是一個ASSET_MODEL還是COMPONENT_MODEL。

若要擷取資產模型或元件模型的現行版本 (AWS CLI)

  • 執行下列指令來描述模型。Replace (取代) asset-model-id 具有資產模型或元件模型的 ID 或外部 ID。外部 ID 是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部參考物件 IDs。

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

    作業會傳回含有模型詳細資訊的回應。響應包含具有以下結構的assetModelStatus對象。

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