

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Wenden Sie eine Schnittstelle auf ein Asset-Modell an
<a name="interfaces-link-asset-model"></a>

Wenn Sie eine Schnittstelle auf ein Anlagenmodell anwenden, ordnen Sie die Eigenschaften und Hierarchien des Anlagenmodells den entsprechenden Schnittstellen zu. Für Schnittstelleneigenschaften, die nicht zugeordnet wurden, werden die entsprechenden Eigenschaften automatisch im Asset-Modell erstellt. Nach der Verknüpfung verhindert der Service Änderungen am Asset-Modell, die gegen Schnittstellenstandards verstoßen würden.

Sie können einer Schnittstelle jeweils ein Asset-Modell hinzufügen. Es können jedoch mehrere Asset-Modelle mit einer einzigen Schnittstelle verknüpft werden.

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

1. Navigieren Sie zur [AWS IoT SiteWise Konsole](https://console.aws.amazon.com/iotsitewise/) und wählen Sie im Navigationsbereich **Modelle** aus.

1. Wählen Sie das Asset-Modell aus, auf das Sie eine Schnittstelle anwenden möchten.

1. Wählen Sie im Abschnitt ****Asset-Modelle verknüpfen die Option Asset-Modell**** verknüpfen aus. Daraufhin wird die Seite **Link-Schnittstelle** geöffnet.

1. Wählen Sie im Abschnitt **Asset-Modelle und Schnittstellen** ein Asset-Modell aus dem Drop-down-Menü **Select a model to link** aus.

1. Ordnen Sie im Abschnitt **Eigenschaftszuordnungen** jede Schnittstelleneigenschaft einer vorhandenen Objektmodelleigenschaft zu oder erstellen Sie eine neue Eigenschaft. AWS IoT SiteWise verknüpft automatisch Eigenschaften mit übereinstimmenden Namen im Objektmodell und in der Benutzeroberfläche.

1. Überprüfen Sie die Eigenschaftszuordnungen und wählen Sie Schnittstelle **verknüpfen**.

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

Gehen Sie wie folgt vor, um eine Schnittstelle auf ein Asset-Modell anzuwenden: `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"      
      }
    ]
  }'
```

Verwenden Sie die folgende `DescribeAssetModelInterfaceRelationship` Operation, um Informationen über eine Schnittstellenbeziehung abzurufen:

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

Verwenden Sie die folgende `ListInterfaceRelationships` Operation, um alle Asset-Modelle aufzulisten, auf die eine bestimmte Schnittstelle angewendet wurde:

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

Verwenden Sie die folgende `DeleteAssetModelInterfaceRelationship` Operation, um eine Schnittstellenbeziehung zu löschen:

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

------