As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Aplicar uma interface a um modelo de ativo
<a name="interfaces-link-asset-model"></a>

Ao aplicar uma interface a um modelo de ativo, você mapeia as propriedades e hierarquias do modelo de ativo para suas contrapartes de interface. Para propriedades de interface não mapeadas, as propriedades correspondentes são criadas automaticamente no modelo de ativo. Após a vinculação, o serviço evita alterações no modelo de ativos que violariam os padrões da interface.

Você pode adicionar um modelo de ativo a uma interface por vez. No entanto, vários modelos de ativos podem ser vinculados a uma única interface.

------
#### [ Console ]

1. Navegue até o [AWS IoT SiteWise console ](https://console.aws.amazon.com/iotsitewise/) e escolha ** Modelos no painel ** de navegação.

1. Selecione o modelo de ativo ao qual você deseja aplicar uma interface.

1. Escolha ** Vincular modelo de ativos ** na ** seção ** Vincular modelos de ativos. Isso abre a ** página da interface ** Link.

1. Na ** seção Modelos e interfaces de ** ativos, selecione um modelo de ativo no menu ** suspenso ** Selecionar um modelo para vincular.

1. Na ** seção Mapeamentos de ** propriedades, mapeie cada propriedade da interface para uma propriedade de modelo de ativo existente ou crie uma nova propriedade. AWS IoT SiteWise vincula automaticamente propriedades com nomes correspondentes no modelo e na interface do ativo.

1. Revise os mapeamentos de propriedades e escolha ** Link interface. **

------
#### [ AWS CLI ]

Para aplicar uma interface a um modelo de ativo, use a `PutAssetModelInterfaceRelationship` operação:

```
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 informações sobre uma relação de interface, use a `DescribeAssetModelInterfaceRelationship` operação:

```
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 listar todos os modelos de ativos que têm uma interface específica aplicada a eles, use a `ListInterfaceRelationships` operação:

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

Para excluir um relacionamento de interface, use a `DeleteAssetModelInterfaceRelationship` operação:

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

------