アセットの関連付けと関連付け解除

アセットのモデルで子アセットモデルの階層が定義されている場合は、子アセットをアセットに関連付けることができます。親アセットは、関連するアセットのデータにアクセスし、集計できます。階層アセットモデルの詳細については、「アセットモデルの階層を定義する」を参照してください。

アセットの関連付けと関連付け解除 (コンソール)

AWS IoT SiteWise コンソールを使用して、アセットの関連付けと関連付け解除を行うことができます。

アセットを関連付けるには (コンソール)

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

2. ナビゲーションペインで [Assets (アセット) ] を選択します。

3. 子アセットを関連付ける親アセットを選択します。

   ヒント

   矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。

4. [編集] を選択します。

5. [このアセットに関連付けられているアセット] で、[関連付けられたアセットの追加] を選択します。

   

6. [階層] で、親アセットと子アセットの関係を定義する階層を選択します。

7. [アセット] で、関連付ける子アセットを選択します。

8. [保存] を選択します。

アセットの関連付けを解除するには (コンソール)

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

2. ナビゲーションペインで [Assets (アセット) ] を選択します。

3. 子アセットの関連付けを解除する親アセットを選択します。

   ヒント

   矢印アイコンを選択して、アセット階層を展開してアセットを検索できます。

4. [編集] を選択します。

5. [このアセットに関連付けられているアセット] の [関連付けを削除] を選択します。

   

6. [保存] を選択します。

アセットの関連付けと関連付け解除 (AWS CLI)

AWS Command Line Interface （AWS CLI) を使用して、アセットの関連付けと関連付け解除を行うことができます。

このステップでは、子アセットモデルとの関係を定義する親アセットモデル内の階層 (hierarchyId) の ID を知る必要があります。DescribeAsset オペレーションを使用して、レスポンス内の階層 ID を検索します。

階層 ID を検索するには

• 次のコマンドを実行して、親アセットを記述します。parent-asset-id を親アセットの ID または外部 ID に置き換えます。

  aws iotsitewise describe-asset --asset-id parent-asset-id

  このオペレーションは、アセットの詳細を含むレスポンスを返します。レスポンスには、次の構造を持つ assetHierarchies リストが含まれています。

  {
    ...
    "assetHierarchies": [
      {
        "id": "String",
        "name": "String"
      }
    ],
    ...
  }

  階層 ID は、アセット階層のリスト内の階層の id の値です。

階層 ID を取得したら、アセットをその階層に関連付けるか、関連付けを解除できます。

子アセットを親アセットに関連付けるには、AssociateAssets オペレーションを使用します。子アセットを親アセットとの関連付けから解除するには、DisassociateAssets オペレーションを使用します。次のパラメータを指定します。これらのパラメータは、両方のオペレーションで同じです。

• assetId – 親アセットの ID または外部 ID。

• hierarchyId - 親アセットの階層 ID または外部 ID。

• childAssetId – 子アセットの ID または外部 ID。

アセットを関連付けるには (AWS CLI)

• 子アセットを親アセットに関連付けるには、次のコマンドを実行します。parent-asset-id、hierarchy-id、および child-asset-id をそれぞれの ID に置き換えます。

  aws iotsitewise associate-assets \
    --asset-id parent-asset-id \
    --hierarchy-id hierarchy-id \
    --child-asset-id child-asset-id

アセットの関連付けを解除するには (AWS CLI)

• 子アセットを親アセットとの関連付けから解除するには、次のコマンドを実行します。parent-asset-id、hierarchy-id、および child-asset-id をそれぞれの ID に置き換えます。

  aws iotsitewise disassociate-assets \
    --asset-id parent-asset-id \
    --hierarchy-id hierarchy-id \
    --child-asset-id child-asset-id