Applicare un'interfaccia a un modello di asset

Quando si applica un'interfaccia a un modello di asset, si associano le proprietà e le gerarchie del modello di asset alle relative controparti di interfaccia. Per le proprietà di 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. Vai alla AWS IoT SiteWise console e scegli Modelli dal pannello di navigazione.

2. Seleziona il modello di asset a cui desideri applicare un'interfaccia.

3. Scegliete Link asset model nella sezione Link asset models. 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 Property mappings, mappate ogni proprietà dell'interfaccia a 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. Esamina le mappature delle proprietà e scegli l'interfaccia Link.

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"