View a markdown version of this page

Applica un'interfaccia a un modello di asset - AWS IoT SiteWise

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Applica un'interfaccia a un modello di asset

Quando si applica un'interfaccia a un modello di asset, si mappano le proprietà e le gerarchie del modello di asset alle relative controparti di interfaccia. Per le proprietà dell'interfaccia non mappate, le proprietà corrispondenti vengono create automaticamente nel modello di asset. Dopo il collegamento, il servizio impedisce modifiche al modello di asset che violerebbero gli standard di interfaccia.

È possibile aggiungere un modello di asset a un'interfaccia alla volta. Tuttavia, è possibile collegare più modelli di asset a un'unica interfaccia.

Console

  1. Accedi alla AWS IoT SiteWise console e scegli Modelli dal pannello di navigazione.

  2. Selezionate il modello di asset a cui desiderate applicare un'interfaccia.

  3. Scegliete Collega modello di asset nella sezione Collega modelli di asset. Viene visualizzata la pagina dell'interfaccia Link.

  4. Nella sezione Modelli e interfacce di asset, selezionate un modello di asset dal menu a discesa Seleziona un modello da collegare.

  5. Nella sezione Mappature delle proprietà, mappate ogni proprietà dell'interfaccia su una proprietà del modello di asset esistente o create una nuova proprietà. AWS IoT SiteWise collega automaticamente le proprietà con i nomi corrispondenti nel modello di asset e nell'interfaccia.

  6. Rivedete le mappature delle proprietà e scegliete Link interface.

AWS CLI

Per applicare un'interfaccia a un modello di asset, utilizzate l'PutAssetModelInterfaceRelationshipoperazione:

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

Per recuperare informazioni su una relazione di interfaccia, utilizzate l'DescribeAssetModelInterfaceRelationshipoperazione:

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

Per elencare tutti i modelli di asset a cui è applicata un'interfaccia specifica, utilizzate l'ListInterfaceRelationshipsoperazione:

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

Per eliminare una relazione di interfaccia, utilizzate l'DeleteAssetModelInterfaceRelationshipoperazione:

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