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'actifs
<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 de ressource. 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 à la fois à une interface. 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 de ressource 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 Link**.

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 à lier**.

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

1. Passez en revue les mappages de propriétés et choisissez **Interface de liaison.**

------
#### [ 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"
```

------