Aplicar uma interface a um modelo de ativo - AWS IoT SiteWise

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

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 e escolha Modelos no painel de navegação.

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

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

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

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

  6. 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"