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 de 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 ativo** 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 as propriedades aos 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 um relacionamento 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 uma relação 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"
```

------