アセットモデルとコンポーネントモデルを更新する

AWS IoT SiteWise コンソールに移動します。

ナビゲーションペインで、[モデル] を選択します。

更新するアセットモデルまたはコンポーネントモデルを選択します。

[編集] を選択します。

[モデルの編集] ページで、次のいずれかの操作を行います。

• [モデルの詳細] で、モデルの [名前] を変更します。

• 任意の [属性定義] を変更します。既存の属性の [データ型] は変更できません。詳細については、「静的データ (属性) を定義する」を参照してください。

• [測定の定義] を変更します。既存の測定値の [データ型] は変更できません。詳細については、「機器からのデータストリームを定義する (測定値）」を参照してください。

• 任意の [定義を変換する] を変更します。詳細については、「変換データ (変換）」を参照してください。

• [メトリクスの定義] を変更します。既存のメトリクスの [時間間隔] は変更できません。詳細については、「プロパティやその他のアセット (メトリクス) からのデータを集約する」を参照してください。

• （アセットモデルのみ) 階層定義 のいずれかを変更します。既存の階層の [階層モデル] を変更することはできません。詳細については、「アセットモデル階層の定義」を参照してください。

[Save] を選択します。

既存のモデル定義を取得するには、次のコマンドを実行します。置換 asset-model-id 更新するアセットモデルまたはコンポーネントモデルの ID または外部 ID を持つ 。

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

上記のコマンドは、モデルの最新バージョンに対応するモデル定義を返します。

アセットモデルが FAILED状態にあるユースケースでは、アクティブなバージョンに対応する有効なモデル定義を取得して、更新リクエストを構築します。詳細については、「アセットモデルバージョン」を参照してください。次のコマンドを実行して、アクティブなモデル定義を取得します。

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

オペレーションは、モデルの詳細を含むレスポンスを返します。このレスポンスには以下の構造が含まれます。

{
    "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"
}

詳細については、「 DescribeAssetModelオペレーション」を参照してください。

update-asset-model.json という名前のファイルを作成し、前のコマンドのレスポンスをファイルにコピーします。

の JSON オブジェクトから次のキーと値のペアを削除しますupdate-asset-model.json。

UpdateAssetModel オペレーションには、次の構造を持つペイロードが必要です。

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

update-asset-model.json で、次のいずれかを行ってください。

• アセットモデルの名前を変更します (assetModelName)。

• アセットモデルの説明を変更、追加、または削除します (assetModelDescription)。

• アセットモデルのプロパティを変更、追加、または削除します (assetModelProperties)。既存のプロパティの dataType、または既存のメトリクスの window を変更することはできません。詳細については、「データプロパティを定義する」を参照してください。

• アセットモデルの階層を変更、追加、または削除します (assetModelHierarchies)。既存の階層の childAssetModelId は変更できません。詳細については、「アセットモデル階層の定義」を参照してください。

• アセットモデルのタイプ AWS/ALARM () の複合モデルを変更、追加、または削除しますassetModelCompositeModels。アラームは、他のプロパティをモニタリングし、機器やプロセスに注意が必要な時期を特定することができます。各アラーム定義は、アラームが使用する一連のプロパティを標準化した複合モデルです。詳細については、「アラームでデータをモニタリングする」および「アセットモデルにアラームを定義する」を参照してください。

次のコマンドを実行して、update-asset-model.json に保存されている定義でアセットモデルを更新します。置換 asset-model-id アセットモデルの ID を指定：

aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://model-payload.json