Appliquer une interface à un modèle d'actifs - AWS IoT SiteWise

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

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 et choisissez Models dans le volet de navigation.

  2. Sélectionnez le modèle de ressource auquel vous souhaitez appliquer une interface.

  3. Choisissez Lier le modèle d'actif dans la section Lier les modèles d'actifs. Cela ouvre la page de l'interface Link.

  4. 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.

  5. 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.

  6. 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'PutAssetModelInterfaceRelationshipopé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'DescribeAssetModelInterfaceRelationshipopé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'ListInterfaceRelationshipsopé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'DeleteAssetModelInterfaceRelationshipopé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"