翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# インターフェイスをアセットモデルに適用する
<a name="interfaces-link-asset-model"></a>

アセットモデルにインターフェイスを適用するときは、アセットモデルのプロパティと階層をインターフェイスの対応するものにマッピングします。マッピングされていないインターフェイスプロパティの場合、対応するプロパティがアセットモデルに自動的に作成されます。リンク後、サービスはインターフェイス標準に違反するアセットモデルの変更を防止します。

インターフェイスには、一度に 1 つのアセットモデルを追加できます。ただし、複数のアセットモデルを 1 つのインターフェイスにリンクできます。

------
#### [ Console ]

1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動し、ナビゲーションペインから**モデル**を選択します。

1. インターフェイスを適用するアセットモデルを選択します。

1. **「アセットモデルのリンク**」セクションの**「アセットモデルのリンク**」を選択します。これにより、**リンクインターフェイス**ページが表示されます。

1. **アセットモデルとインターフェイス**セクションで、**リンクするモデルを選択するドロップダウンメニューからアセットモデル**を選択します。

1. **プロパティマッピング**セクションで、各インターフェイスプロパティを既存のアセットモデルプロパティにマッピングするか、新しいプロパティを作成します。 AWS IoT SiteWise は、アセットモデルとインターフェイス内の一致する名前でプロパティを自動的にリンクします。

1. プロパティマッピングを確認し、**リンクインターフェイス**を選択します。

------
#### [ AWS CLI ]

インターフェイスをアセットモデルに適用するには、 `PutAssetModelInterfaceRelationship`オペレーションを使用します。

```
aws iotsitewise put-asset-model-interface-relationship \
  --asset-model-id "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ 
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" \
  --property-mapping-configuration '{
    "createMissingProperty": true,
    "matchByPropertyName": true,   
    "overrides": [
      {
        "assetModelPropertyId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
        "interfaceAssetModelPropertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"      
      }
    ]
  }'
```

インターフェイス関係に関する情報を取得するには、 `DescribeAssetModelInterfaceRelationship`オペレーションを使用します。

```
aws iotsitewise describe-asset-model-interface-relationship \
  --asset-model-id "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
```

特定のインターフェイスが適用されているすべてのアセットモデルを一覧表示するには、 `ListInterfaceRelationships`オペレーションを使用します。

```
aws iotsitewise list-interface-relationships \
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" \
  --max-results 10
```

インターフェイス関係を削除するには、 `DeleteAssetModelInterfaceRelationship`オペレーションを使用します。

```
aws iotsitewise delete-asset-model-interface-relationship \
  --asset-model-id "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
```

------