翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
カスタム複合モデル (コンポーネント) の更新
を使用して AWS IoT SiteWise APIカスタム複合モデルを更新するか、 AWS IoT SiteWise コンソールを使用してコンポーネントを更新できます。
コンポーネントを更新する (コンソール)
AWS IoT SiteWise コンソールを使用してコンポーネントを更新できます。
コンポーネントを更新するには (コンソール)
AWS IoT SiteWise コンソール
に移動します。 ナビゲーションペインで、[モデル] を選択します。
-
コンポーネントがあるアセットモデルを選択します。
-
プロパティ タブで、コンポーネント を選択します。
-
更新するコンポーネントを選択します。
-
[編集] を選択します。
-
「コンポーネントの編集」ページで、次のいずれかの操作を行います。
-
[モデルの詳細] で、モデルの [名前] を変更します。
-
任意の [属性定義] を変更します。既存の属性の [データ型] は変更できません。詳細については、「静的データ (属性) を定義する」を参照してください。
-
[測定の定義] を変更します。既存の測定値の [データ型] は変更できません。詳細については、「機器からのデータストリームを定義する (測定値)」を参照してください。
-
任意の [定義を変換する] を変更します。詳細については、「変換データ (変換)」を参照してください。
-
[メトリクスの定義] を変更します。既存のメトリクスの [時間間隔] は変更できません。詳細については、「プロパティやその他のアセット (メトリクス) からのデータを集約する」を参照してください。
-
-
[Save] を選択します。
カスタム複合モデルを更新する (AWS CLI)
AWS Command Line Interface (AWS CLI) を使用して、カスタム複合モデルを更新します。
名前または説明を更新するには、 UpdateAssetModelCompositeModelオペレーションを使用します。インラインカスタム複合モデルのみ、プロパティを更新することもできます。 component-model-based カスタム複合モデルのプロパティは、参照されるコンポーネントモデルが関連するプロパティを提供するため、更新できません。
重要
カスタム複合モデルからプロパティを削除すると、 はそのプロパティの以前のデータをすべて AWS IoT SiteWise 削除します。既存のプロパティの型またはデータ型を変更することはできません。
既存の複合モデルプロパティを同じ を持つ新しいモデルプロパティに置き換えるにはname
、次の手順を実行します。
既存のプロパティ全体を削除して
UpdateAssetModelCompositeModel
リクエストを送信します。新しいプロパティを含む 2 番目の
UpdateAssetModelCompositeModel
リクエストを送信します。新しいアセットプロパティは、前のアセットプロパティname
と同じ を持ち AWS IoT SiteWise 、新しい一意の を生成しますid
。
カスタム複合モデルを更新するには (AWS CLI)
-
既存の複合モデル定義を取得するには、次のコマンドを実行します。置換
composite-model-id
更新するカスタム複合モデルの ID または外部 ID、およびasset-model-id
カスタム複合モデルが関連付けられているアセットモデル。詳細については、AWS IoT SiteWise ユーザーガイドをご参照ください。-
以下のコマンドを実行します。
aws iotsitewise describe-asset-model-composite-model \ --asset-model-composite-model-id
composite-model-id
\ --asset-model-idasset-model-id
-
上記のコマンドは、関連付けられたモデルの最新バージョンに対応する複合モデル定義を返します。アセットモデルが
FAILED
状態にあるユースケースでは、アクティブなバージョンに対応する有効なモデル定義を取得して、更新リクエストを構築します。詳細については、「アセットモデルバージョン」を参照してください。 -
次のコマンドを実行して、アクティブなモデル定義を取得します。
aws iotsitewise describe-asset-model-composite-model \ --asset-model-composite-model-id
composite-model-id
\ --asset-model-idasset-model-id
\ --asset-model-version ACTIVE -
詳細については、「 DescribeAssetModelCompositeModelオペレーション」を参照してください。
-
-
というファイルを作成し
update-custom-composite-model.json
、前のコマンドのレスポンスを ファイルにコピーします。 -
以下のフィールド
update-custom-composite-model.json
を除き、 のJSONオブジェクトからすべてのキーと値のペアを削除します。assetModelCompositeModelName
assetModelCompositeModelDescription
(存在する場合)assetModelCompositeModelProperties
(存在する場合)
-
update-custom-composite-model.json
で、次のいずれかを行ってください。の値を変更します
assetModelCompositeModelName
。を追加または削除するか
assetModelCompositeModelDescription
、その値を変更します。インラインカスタム複合モデルのみ: のアセットモデルのプロパティを変更、追加、または削除します
assetModelCompositeModelProperties
。
このファイルに必要な形式の詳細については、 のリクエスト構文を参照してくださいUpdateAssetModelCompositeModel。
-
次のコマンドを実行して、 に保存されている定義でカスタム複合モデルを更新します
update-custom-composite-model.json
。置換composite-model-id
複合モデルの ID を指定し、asset-model-id
は、そのアセットモデルの ID で指定します。aws iotsitewise update-asset-model-composite-model \ --asset-model-composite-model-id
composite-model-id
\ --asset-model-idasset-model-id
\ --cli-input-json file://update-custom-composite-model.json
重要
複数のユーザーがアセットモデルを同時に更新すると、ユーザーの変更は他のユーザーによって誤って上書きされる可能性があります。これを防ぐには、条件付き更新リクエストを定義する必要があります。「アセットモデルの書き込みに対する楽観的ロック」を参照してください。