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á. # Sincronização de ativos com AWS IoT SiteWise AWS IoT TwinMaker suporta sincronização de ativos (sincronização de ativos) para seus AWS IoT SiteWise ativos e modelos de ativos. Usando o tipo de AWS IoT SiteWise componente, a sincronização de ativos usa AWS IoT SiteWise ativos e modelos de ativos existentes e converte esses recursos em AWS IoT TwinMaker entidades, componentes e tipos de componentes. As seções a seguir explicam como configurar a sincronização de ativos e quais AWS IoT SiteWise ativos e modelos de ativos podem ser sincronizados com seu espaço de AWS IoT TwinMaker trabalho. **Topics** + [Usando a sincronização de ativos com AWS IoT SiteWise](tm-sw-asset-sync-use.md) + [Diferenças entre espaços de trabalho personalizados e padrão](tm-sw-default-ws-diffs.md) + [Recursos sincronizados de AWS IoT SiteWise](tm-sw-asset-sync-map.md) + [Analise o status e os erros de sincronização](tm-sw-asset-sync-ts.md) + [Excluir uma tarefa de sincronização](tm-sw-asset-sync-delete.md) + [Limites de sincronização de ativos](tm-sw-asset-sync-limits.md) # Usando a sincronização de ativos com AWS IoT SiteWise Este tópico mostra como ativar e configurar a sincronização AWS IoT SiteWise de ativos. Siga os procedimentos apropriados com base no tipo de espaço de trabalho que você está usando. **Importante** Consulte [Diferenças entre espaços de trabalho personalizados e padrão](tm-sw-default-ws-diffs.md) para obter informações sobre as diferenças entre os espaços de trabalho personalizados e padrão. **Topics** + [Usando um espaço de trabalho personalizado](tm-sw-custom-ws.md) + [Usando o Io TSite WiseDefaultWorkspace](tm-sw-default-ws.md) # Usando um espaço de trabalho personalizado Revise esses pré-requisitos antes de ativar a sincronização de ativos. ## Pré-requisitos Antes de usar AWS IoT SiteWise, o seguinte deve ser preenchido: + Você tem um AWS IoT TwinMaker espaço de trabalho. + Você tem ativos e modelos de ativos em AWS IoT SiteWise. Para obter mais informações, consulte [Criar modelos de ativos](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/create-asset-models.html). + Uma função existente do IAM com permissões de leitura para as seguintes AWS IoT SiteWise ações: + `ListAssets` + `ListAssetModels` + `DescribeAsset` + `DescribeAssetModel` + A função do IAM deve ter as seguintes permissões de gravação para AWS IoT TwinMaker: + `CreateEntity` + `UpdateEntity` + `DeleteEntity` + `CreateComponentType` + `UpdateComponentType` + `DeleteComponentType` + `ListEntities` + `GetEntity` + `ListComponentTypes` Use a seguinte função do IAM como modelo para a função necessária: ``` // trust relationships { { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "iottwinmaker.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } // permissions - replace ACCOUNT_ID, REGION, WORKSPACE_ID with actual values { "Version": "2012-10-17", "Statement": [{ "Sid": "SiteWiseAssetReadAccess", "Effect": "Allow", "Action": [ "iotsitewise:DescribeAsset" ], "Resource": [ "arn:aws:iotsitewise:REGION:ACCOUNT_ID:asset/*" ] }, { "Sid": "SiteWiseAssetModelReadAccess", "Effect": "Allow", "Action": [ "iotsitewise:DescribeAssetModel" ], "Resource": [ "arn:aws:iotsitewise:REGION:ACCOUNT_ID:asset-model/*" ] }, { "Sid": "SiteWiseAssetModelAndAssetListAccess", "Effect": "Allow", "Action": [ "iotsitewise:ListAssets", "iotsitewise:ListAssetModels" ], "Resource": [ "*" ] }, { "Sid": "TwinMakerAccess", "Effect": "Allow", "Action": [ "iottwinmaker:GetEntity", "iottwinmaker:CreateEntity", "iottwinmaker:UpdateEntity", "iottwinmaker:DeleteEntity", "iottwinmaker:ListEntities", "iottwinmaker:GetComponentType", "iottwinmaker:CreateComponentType", "iottwinmaker:UpdateComponentType", "iottwinmaker:DeleteComponentType", "iottwinmaker:ListComponentTypes" ], "Resource": [ "arn:aws:iottwinmaker:REGION:ACCOUNT_ID:workspace/WORKSPACE_ID", "arn:aws:iottwinmaker:REGION:ACCOUNT_ID:workspace/WORKSPACE_ID/*" ] } ] } ``` Use o procedimento a seguir para ativar e configurar a sincronização de ativos AWS IoT SiteWise . 1. No [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/), navegue até a página **Configurações**. 1. Abra a guia **Origens do modelo**. ![\[A página de configuração do AWS IoT TwinMaker console com a guia Fontes do modelo aberta.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/asset-sync-settings.png) 1. Escolha **Connect workspace** para vincular seu AWS IoT TwinMaker espaço de trabalho aos seus AWS IoT SiteWise ativos. **nota** Você só pode usar a sincronização de ativos com um único AWS IoT TwinMaker espaço de trabalho. Você deve desconectar a sincronização de um espaço de trabalho e conectar-se a outro espaço de trabalho se quiser sincronizar em um espaço de trabalho diferente. 1. Em seguida, navegue até o espaço de trabalho no qual você deseja usar a sincronização de ativos. 1. Escolha **Adicionar origens**. Isso abre a página **Adicionar origem do modelo de entidade**. ![\[A página de origem do modelo de entidade Adicionar.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/add-model-source.png) 1. Na página **Adicionar fonte do modelo de entidade**, confirme se o campo de origem é exibido **AWS IoT SiteWise**. Selecione o perfil do IAM que você criou como pré-requisito para **o perfil do IAM**. 1. Agora você ativou a sincronização AWS IoT SiteWise de ativos. Você deve ver um banner de confirmação ser exibido na parte superior da página **Espaço de trabalho** selecionado, confirmando que a sincronização de ativos está ativa. Agora, você também deve ver uma fonte de sincronização listada na seção **Origens do modelo de entidade**. ![\[A página do espaço de trabalho mostrando a lista de fontes do modelo de entidade.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/success-sync.png) # Usando o Io TSite WiseDefaultWorkspace Quando você opta pela [AWS IoT SiteWiseAWS IoT TwinMaker integração](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/integrate-tm.html), um espaço de trabalho padrão chamado `IoTSiteWiseDefaultWorkspace` é criado e sincronizado automaticamente com. AWS IoT SiteWise Você também pode usar a AWS IoT TwinMaker `CreateWorkspace` API para criar um espaço de trabalho chamado`IoTSiteWiseDefaultWorkspace`. ## Pré-requisitos Antes de criar`IoTSiteWiseDefaultWorkspace`, certifique-se de ter feito o seguinte: + Crie uma função AWS IoT TwinMaker vinculada ao serviço. Consulte [Usando funções vinculadas a serviços para AWS IoT TwinMaker](using-service-linked-roles.md) para obter mais informações. + Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). Revise a função ou o usuário e verifique se ele tem permissão para`iotsitewise:EnableSiteWiseIntegration`. Se necessário, adicione permissão à função ou ao usuário: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:EnableSiteWiseIntegration", "Resource": "*" } ] } ``` ------ # Diferenças entre espaços de trabalho personalizados e padrão **Importante** Novos AWS IoT SiteWise recursos, como [https://docs.aws.amazon.com//iot-sitewise/latest/userguide/custom-composite-models.html](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/custom-composite-models.html), só estão disponíveis em`IoTSiteWiseDefaultWorkspace`. Recomendamos que você use um espaço de trabalho padrão em vez de um espaço de trabalho personalizado. Ao usar o`IoTSiteWiseDefaultWorkspace`, há algumas diferenças notáveis em relação ao uso de um espaço de trabalho personalizado com sincronização de ativos. + Quando você cria um espaço de trabalho padrão, a localização do Amazon S3 e a função do IAM são opcionais. **nota** Você pode usar `UpdateWorkspace` para fornecer a localização do Amazon S3 e a função do IAM. + O `IoTSiteWiseDefaultWorkspace` não tem um limite de contagem de recursos para sincronizar AWS IoT SiteWise recursos AWS IoT TwinMaker. + Quando você sincroniza recursos de AWS IoT SiteWise, eles `SyncSource` serão`SITEWISE_MANAGED`. Isso inclui `Entities` `ComponentTypes` e. + Novos AWS IoT SiteWise recursos, como `CompositionModel` os que estão disponíveis apenas no`IoTSiteWiseDefaultWorkspace`. Existem algumas limitações específicas`IoTSiteWiseDefaultWorkspace`, elas são: + O espaço de trabalho padrão não pode ser excluído. + Para excluir recursos, você deve primeiro excluir os AWS IoT SiteWise recursos e, em seguida, os recursos correspondentes serão AWS IoT TwinMaker excluídos. # Recursos sincronizados de AWS IoT SiteWise Este tópico lista quais ativos você pode sincronizar AWS IoT SiteWise com seu AWS IoT TwinMaker espaço de trabalho. **Importante** Consulte [Diferenças entre espaços de trabalho personalizados e padrão](tm-sw-default-ws-diffs.md) para obter informações sobre as diferenças entre os espaços de trabalho personalizados e padrão. ## Espaços de trabalho personalizados e padrão Os seguintes recursos estão sincronizados e estão disponíveis nos espaços de trabalho personalizados **e** padrão: **Modelos de ativo** AWS IoT TwinMaker cria um novo tipo de componente para cada modelo de ativo em AWS IoT SiteWise. + O componente `TypeId` do modelo de ativos usará um dos seguintes padrões: + **Espaço de trabalho personalizado -** `iotsitewise.assetmodel:assetModelId` + **Espaço de trabalho padrão -** `assetModelId` + Cada propriedade no modelo de ativo é uma nova propriedade no tipo de componente, com um dos seguintes padrões de nomenclatura: + **Espaço de trabalho personalizado -** `Property_propertyId` + **Espaço de trabalho padrão -** `propertyId` O nome da propriedade em AWS IoT SiteWise é armazenado como `displayName` na definição da propriedade. + Cada hierarquia no modelo de ativo é uma nova propriedade do tipo `LIST` e `nestedType` está `RELATIONSHIP` no tipo de componente. A hierarquia é mapeada para a propriedade com um nome prefixado por um dos seguintes: + **Espaço de trabalho personalizado -** `Hierarchy_hierarchyId` + **Espaço de trabalho padrão -** `hierarchyId` **Ativo** AWS IoT TwinMaker cria uma nova entidade para cada ativo em AWS IoT SiteWise. + O `entityId` é o mesmo que o de `assetId` dentro AWS IoT SiteWise. + Essas entidades têm um único componente chamado `sitewiseBase`, que tem o tipo de componente correspondente ao modelo de ativo para esse ativo. + Quaisquer substituições de nível de ativo, como definir um apelido de propriedade ou unidade de medida, são refletidas na entidade no AWS IoT TwinMaker. ## Somente espaço de trabalho padrão Os seguintes ativos são sincronizados e estão **disponíveis somente no espaço de trabalho padrão**,. `IoTSiteWiseDefaultWorkspace` **AssetModelComponents** AWS IoT TwinMaker cria um novo tipo de componente para cada `AssetModelComponents` entrada AWS IoT SiteWise. + O componente `TypeId` do modelo de ativos usa o seguinte padrão:`assetModelId`. + Cada propriedade no modelo de ativo é uma nova propriedade no tipo de componente, com o nome da propriedade como `propertyId`. O nome da propriedade em AWS IoT SiteWise é armazenado como `displayName` na definição da propriedade. + Cada hierarquia no modelo de ativo é uma nova propriedade do tipo `LIST` e `nestedType` está `RELATIONSHIP` no tipo de componente. A hierarquia é mapeada para a propriedade com um nome prefixado por `hierarchyId`. **AssetModelCompositeModel** AWS IoT TwinMaker cria um novo tipo de componente para cada `AssetModelCompositeModel` entrada AWS IoT SiteWise. + O componente `TypeId` do modelo de ativos usa o seguinte padrão:`assetModelId_assetModelCompositeModelId`. + Cada propriedade no modelo de ativo é uma nova propriedade no tipo de componente, com o nome da propriedade como `propertyId`. O nome da propriedade em AWS IoT SiteWise é armazenado como `displayName` na definição da propriedade. **AssetCompositeModels** AWS IoT TwinMaker cria um novo componente composto para cada entrada`AssetCompositeModel`. AWS IoT SiteWise + O `componentName` é o mesmo que o de `assetModelCompositeModelId` dentro AWS IoT SiteWise. ## Recursos não sincronizados Os seguintes recursos não são sincronizados: **Ativos e modelos de ativos não sincronizados** + Os modelos de alarme serão sincronizados como CompositeModels, mas os dados correspondentes no ativo relacionados aos alarmes não serão sincronizados. + [AWS IoT SiteWise os fluxos de dados](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/manage-data-streams.html) não são sincronizados. Somente propriedades modeladas no modelo de ativo são sincronizadas. + Os valores de propriedades para atributos, medidas, transformações, agregações e cálculos de metadados, como fórmula e janela, não são sincronizados. Somente os metadados sobre as propriedades, como alias, unidade de medida e tipo de dados, são sincronizados. Os valores podem ser consultados usando a API normal do conector de AWS IoT TwinMaker dados, [ GetPropertyValueHistory](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html). ## Use entidades sincronizadas e tipos de componentes em AWS IoT TwinMaker Depois que os ativos são sincronizados AWS IoT SiteWise, os tipos de componentes sincronizados são lidos somente em. AWS IoT TwinMaker Qualquer ação de atualização ou exclusão deve ser feita em AWS IoT SiteWise, e essas alterações serão sincronizadas AWS IoT TwinMaker se o SyncJob ainda estiver ativo. As entidades sincronizadas e o componente AWS IoT SiteWise base também são lidos somente em AWS IoT TwinMaker. Você pode adicionar outros componentes não sincronizados à entidade sincronizada, desde que nenhum atributo no nível da entidade, como a descrição ou `entityName`, seja atualizado. Algumas restrições se aplicam à forma como você pode interagir com entidades sincronizadas. Você não pode criar entidades secundárias em uma entidade sincronizada na hierarquia da entidade sincronizada. Além disso, você não pode criar tipos de componentes não sincronizados que se estendam a partir de um tipo de componente sincronizado. **nota** Componentes adicionais são excluídos junto com a entidade se o ativo for excluído AWS IoT SiteWise ou se você excluir o trabalho de sincronização. Você pode usar essas entidades sincronizadas nos painéis do Grafana e adicioná-las como tags no compositor de cenas, como entidades regulares. Você também pode emitir consultas ao gráfico de conhecimento para essas entidades sincronizadas. **nota** Entidades sincronizadas sem modificação não são cobradas, mas você será cobrado por essas entidades se tiverem sido feitas alterações no AWS IoT TwinMaker. Por exemplo, se você adicionar um componente não sincronizado a uma entidade sincronizada, essa entidade agora será cobrada. AWS IoT TwinMaker Para obter mais informações, consulte [Preços do AWS IoT TwinMaker](https://aws.amazon.com//iot-twinmaker/pricing/). # Analise o status e os erros de sincronização Este tópico fornece orientação sobre como analisar erros e status de sincronização. **Importante** Consulte [Diferenças entre espaços de trabalho personalizados e padrão](tm-sw-default-ws-diffs.md) para obter informações sobre as diferenças entre os espaços de trabalho personalizados e padrão. ## Sincronizar status de tarefa Um trabalho de sincronização tem um dos status a seguir, dependendo de seu estado. + O `CREATING` estado da tarefa de sincronização significa que a tarefa está verificando as permissões e carregando dados AWS IoT SiteWise para preparar a sincronização. + O `INITIALIZING` estado da tarefa de sincronização significa que todos os recursos existentes AWS IoT SiteWise estão sincronizados com o. AWS IoT TwinMaker Essa etapa pode levar mais tempo para ser concluída se o usuário tiver um grande número de ativos e modelos de ativos no AWS IoT SiteWise. Você pode monitorar o número de recursos que foram sincronizados verificando a tarefa de sincronização no [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/) ou chamando a API `ListSyncResources`. + O estado da tarefa de sincronização `ACTIVE` significa que a etapa de inicialização foi concluída. A tarefa agora está pronta para sincronizar qualquer nova atualização do AWS IoT SiteWise. + O estado da tarefa de sincronização `ERROR` indica um erro com qualquer um dos estados anteriores. Examine a mensagem de erro. Pode haver um problema com a configuração do perfil do IAM. Se você quiser usar uma nova função do IAM, exclua a tarefa de sincronização que teve o erro e crie uma nova com a nova função. Os erros de sincronização aparecem na página de origem do modelo, que é acessada a partir da tabela **Origens do modelo de entidade** no seu espaço de trabalho. A página de origem do modelo exibe uma lista de recursos que falharam na sincronização. A maioria dos erros é repetida automaticamente pela tarefa de sincronização, mas, se o recurso exigir uma ação, ele permanecerá no estado `ERROR`. Você também pode obter uma lista de erros usando a [ ListSyncResources](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListSyncResources.html)API. Para exibir todos os erros listados para a fonte atual, use o procedimento a seguir. 1. Navegue até seu espaço de trabalho no [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/). 1. Selecione a AWS IoT SiteWise fonte listada no modal **Fontes do modelo de entidade** para abrir a página de detalhes da sincronização de ativos. ![\[A página AWS IoT SiteWise de origem mostra detalhes da sincronização de ativos, incluindo erros.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/synced-resources.png) 1. Conforme mostrado na captura de tela anterior, todos os recursos com **erros **persistentes são listados na tabela Erros. Você pode usar essa tabela para rastrear e corrigir erros relacionados a recursos específicos. Possíveis erros incluem: + Embora AWS IoT SiteWise ofereça suporte a nomes de ativos duplicados, AWS IoT TwinMaker só os suporta no `ROOT` nível, não na mesma entidade principal. Se você tiver dois ativos com o mesmo nome em uma entidade principal em AWS IoT SiteWise, um deles falhará ao sincronizar. Para corrigir esse erro, exclua um dos ativos ou mova um para outro ativo principal AWS IoT SiteWise antes de sincronizar. + Se você já tiver uma entidade com o mesmo ID do AWS IoT SiteWise ativo, esse ativo não será sincronizado até que você exclua a entidade existente. # Excluir uma tarefa de sincronização Use o procedimento a seguir para excluir uma tarefa de sincronização. **Importante** Consulte [Diferenças entre espaços de trabalho personalizados e padrão](tm-sw-default-ws-diffs.md) para obter informações sobre as diferenças entre os espaços de trabalho personalizados e padrão. 1. Navegue até o [console do AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/). 1. Abra o espaço de trabalho do qual você deseja excluir o trabalho de sincronização. 1. Em **Origens do modelo de entidade**, selecione a fonte AWS IoT SiteWise para abrir a página de detalhes da fonte. 1. Para interromper o trabalho de sincronização, escolha **Desconectar**. Confirme sua escolha de excluir totalmente a tarefa de sincronização. ![\[A caixa de diálogo Desconectar AWS IoT SiteWise sincronização tem botões para Cancelar ou Desconectar a tarefa de sincronização.\]](http://docs.aws.amazon.com/pt_br/iot-twinmaker/latest/guide/images/confirm-delete.png) Depois que uma tarefa de sincronização for excluída, você poderá criá-la novamente no mesmo espaço de trabalho ou em um espaço de trabalho diferente. Você não pode excluir um espaço de trabalho se houver algum trabalho de sincronização nesse espaço de trabalho. Exclua as tarefas de sincronização antes de excluir um espaço de trabalho. Se houver algum erro durante a exclusão da tarefa de sincronização, o trabalho de sincronização permanecerá no estado `DELETING` e será repetido automaticamente. Agora você pode excluir manualmente qualquer uma das entidades sincronizadas ou tipos de componentes se houver algum erro relacionado à exclusão de um recurso. **nota** Todos os recursos que foram sincronizados AWS IoT SiteWise são excluídos primeiro e, em seguida, o trabalho de sincronização em si é excluído. # Limites de sincronização de ativos **Importante** Consulte [Diferenças entre espaços de trabalho personalizados e padrão](tm-sw-default-ws-diffs.md) para obter informações sobre as diferenças entre os espaços de trabalho personalizados e padrão. Como as [cotas AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html) são maiores do que as [cotas AWS IoT TwinMaker](https://docs.aws.amazon.com//general/latest/gr/iot-twinmaker.html) padrão, estamos aumentando os limites a seguir para entidades e tipos de componentes sincronizados a partir de AWS IoT SiteWise. + 1000 tipos de componentes sincronizados em um espaço de trabalho, já que ele só pode sincronizar 1000 modelos de ativos de. AWS IoT SiteWise + 100.000 entidades sincronizadas em um espaço de trabalho, já que ele só pode sincronizar 100.000 ativos de. AWS IoT SiteWise + Máximo de 2.000 entidades secundárias por entidade primária. Sincroniza 2.000 ativos secundários por ativo primário. **nota** A [GetEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetEntity.html)API retorna somente as primeiras 50 entidades secundárias de uma propriedade hierárquica, mas você pode usar a [GetPropertyValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValue.html)API para paginar e recuperar a lista de todas as entidades secundárias. + 600 propriedades por componente sincronizado AWS IoT SiteWise, que podem sincronizar modelos de ativos com 600 propriedades e hierarquias totais. **nota** Esses limites são aplicáveis somente às entidades sincronizadas. Solicite um aumento de cota se precisar aumentar esses limites para recursos não sincronizados.