

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Aplicar una interfaz a un modelo de activos
<a name="interfaces-link-asset-model"></a>

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](https://console.aws.amazon.com/iotsitewise/) y elija **Modelos** en el panel de navegación.

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

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

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

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

1. 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"
```

------