

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Appliquer une interface à un modèle d'actif
<a name="interfaces-link-asset-model"></a>

Lorsque vous appliquez une interface à un modèle d'actif, vous mappez les propriétés et les hiérarchies du modèle d'actif à leurs homologues d'interface. Pour les propriétés d'interface non mappées, les propriétés correspondantes sont automatiquement créées dans le modèle d'actif. Une fois la liaison établie, le service empêche toute modification du modèle d'actif susceptible de violer les normes d'interface.

Vous pouvez ajouter un modèle d'actif à une interface à la fois. Cependant, plusieurs modèles d'actifs peuvent être liés à une seule interface.

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

1. Accédez à la [AWS IoT SiteWise console ](https://console.aws.amazon.com/iotsitewise/) et choisissez ** Modèles dans le volet ** de navigation.

1. Sélectionnez le modèle d'actif auquel vous souhaitez appliquer une interface.

1. Choisissez ** Lier le modèle d'actif ** dans la ** section ** Lier les modèles d'actifs. Cela ouvre la ** page de l'interface des ** liens.

1. Dans la ** section Modèles ** d'actifs et interfaces, sélectionnez un modèle d'actif dans le menu ** déroulant ** Sélectionnez un modèle pour créer un lien.

1. Dans la ** section Mappages de ** propriétés, associez chaque propriété d'interface à une propriété de modèle d'actif existante ou créez une nouvelle propriété. AWS IoT SiteWise associe automatiquement les propriétés aux noms correspondants dans le modèle d'actif et l'interface.

1. Passez en revue les mappages de propriétés et choisissez ** Link interface. **

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

Pour appliquer une interface à un modèle d'actif, utilisez l'`PutAssetModelInterfaceRelationship`opération suivante :

```
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}}"      
      }
    ]
  }'
```

Pour récupérer des informations sur une relation d'interface, utilisez l'`DescribeAssetModelInterfaceRelationship`opération suivante :

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

Pour répertorier tous les modèles d'actifs auxquels une interface spécifique est appliquée, utilisez l'`ListInterfaceRelationships`opération suivante :

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

Pour supprimer une relation d'interface, utilisez l'`DeleteAssetModelInterfaceRelationship`opération suivante :

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

------