Aplicar una interfaz a un modelo de activos

Al aplicar una interfaz a un modelo de activos, se asignan las propiedades y jerarquías del modelo de activos a sus homólogos de la interfaz. En el caso de las propiedades de interfaz no mapeadas, las propiedades correspondientes se crean automáticamente en el modelo de activos. Tras la vinculación, el servicio evita cambios en el modelo de activos que puedan infringir los estándares de la interfaz.

Puede añadir un modelo de activos a una interfaz a la vez. Sin embargo, se pueden vincular varios modelos de activos a una sola interfaz.

Console

1. Navegue hasta la AWS IoT SiteWise consola y elija Modelos en el panel de navegación.

2. Seleccione el modelo de activo al que desee aplicar una interfaz.

3. Elija Vincular el modelo de activos en la sección Vincular modelos de activos. Aparece la página de la interfaz de enlace.

4. En la sección Modelos e interfaces de activos, seleccione un modelo de activos en el menú desplegable Seleccione un modelo para vincular.

5. En la sección Asignaciones de propiedades, asigne cada propiedad de la interfaz a una propiedad del modelo de activos existente o cree una nueva propiedad. AWS IoT SiteWise vincula automáticamente las propiedades con nombres coincidentes en el modelo de activos y la interfaz.

6. Revise las asignaciones de propiedades y elija Interfaz de enlace.

AWS CLI

Para aplicar una interfaz a un modelo de activos, utilice la PutAssetModelInterfaceRelationship operación:

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

Para recuperar información sobre una relación de interfaz, utilice la DescribeAssetModelInterfaceRelationship operación:

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

Para enumerar todos los modelos de activos a los que se les ha aplicado una interfaz específica, utilice la ListInterfaceRelationships operación:

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

Para eliminar una relación de interfaz, utilice la DeleteAssetModelInterfaceRelationship operación:

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