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. # Sincronización de activos con AWS IoT SiteWise AWS IoT TwinMaker admite la sincronización de activos (sincronización de activos) para sus AWS IoT SiteWise activos y modelos de activos. Al usar el tipo de AWS IoT SiteWise componente, la sincronización de AWS IoT SiteWise activos toma los activos y modelos de activos existentes y los convierte en AWS IoT TwinMaker entidades, componentes y tipos de componentes. En las siguientes secciones, se explica cómo configurar la sincronización de activos y qué AWS IoT SiteWise activos y modelos de activos se pueden sincronizar con su AWS IoT TwinMaker espacio de trabajo. **Topics** + [Cómo utilizar la sincronización de activos con AWS IoT SiteWise](tm-sw-asset-sync-use.md) + [Diferencias entre los espacios de trabajo personalizados y predeterminados](tm-sw-default-ws-diffs.md) + [Recursos sincronizados desde AWS IoT SiteWise](tm-sw-asset-sync-map.md) + [Analice el estado y los errores de la sincronización](tm-sw-asset-sync-ts.md) + [Eliminar un trabajo de sincronización](tm-sw-asset-sync-delete.md) + [Límites de la sincronización de activos](tm-sw-asset-sync-limits.md) # Cómo utilizar la sincronización de activos con AWS IoT SiteWise En este tema se muestra cómo activar y configurar la sincronización AWS IoT SiteWise de activos. Siga los procedimientos adecuados en función del tipo de espacio de trabajo que utilice. **importante** Consulte [Diferencias entre los espacios de trabajo personalizados y predeterminados](tm-sw-default-ws-diffs.md) para obtener información sobre las diferencias entre los espacios de trabajo personalizados y predeterminados. **Topics** + [Uso de un espacio de trabajo personalizado](tm-sw-custom-ws.md) + [Uso del Io TSite WiseDefaultWorkspace](tm-sw-default-ws.md) # Uso de un espacio de trabajo personalizado Revise estos requisitos previos antes de activar la sincronización de activos. ## Requisitos previos Antes de usarlo AWS IoT SiteWise, debes completar lo siguiente: + Tienes un AWS IoT TwinMaker espacio de trabajo. + Tienes activos y modelos de activos AWS IoT SiteWise. Para obtener más información, consulte [Creación de modelos de activos](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/create-asset-models.html). + Un rol de IAM existente con permisos de lectura para las siguientes AWS IoT SiteWise acciones: + `ListAssets` + `ListAssetModels` + `DescribeAsset` + `DescribeAssetModel` + El rol de IAM debe tener los siguientes permisos de escritura para: AWS IoT TwinMaker + `CreateEntity` + `UpdateEntity` + `DeleteEntity` + `CreateComponentType` + `UpdateComponentType` + `DeleteComponentType` + `ListEntities` + `GetEntity` + `ListComponentTypes` Utilice la siguiente función de IAM como plantilla para la función requerida: ``` // 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/*" ] } ] } ``` Utilice el siguiente procedimiento para activar y configurar la sincronización de activos de AWS IoT SiteWise . 1. En la [consola de AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/), vaya a la página **Ajustes**. 1. Abra la pestaña **Orígenes de modelos**. ![\[La página de configuración de la AWS IoT TwinMaker consola con la pestaña Fuentes del modelo abierta.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/asset-sync-settings.png) 1. Elija **Connect workspace** para vincular su AWS IoT TwinMaker espacio de trabajo a sus AWS IoT SiteWise activos. **nota** Solo puedes usar la sincronización de activos con un único AWS IoT TwinMaker espacio de trabajo. Debe desconectar la sincronización de un espacio de trabajo y conectarse a otro si desea sincronizar otro espacio de trabajo. 1. A continuación, vaya al espacio de trabajo en el que desea usar la sincronización de activos. 1. Seleccione **Add sources** (Agregar orígenes). Se abrirá la página **Agregar un origen de modelo de la entidad**. ![\[La página de origen para añadir un modelo de entidad.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/add-model-source.png) 1. En la página **Agregar un origen del modelo de la entidad**, confirme que en el campo origen se muestre **AWS IoT SiteWise**. Seleccione el rol de IAM que creó como requisito previo para el **rol de IAM**. 1. Ya has activado la sincronización AWS IoT SiteWise de activos. Debería ver un banner de confirmación en la parte superior de la página del **Espacio de trabajo** seleccionado para confirmar que la sincronización de activos está activa. También debería ver el origen de la sincronización en la sección **Orígenes del modelo de la entidad**. ![\[La página del espacio de trabajo que muestra la lista de fuentes del modelo de entidad.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/success-sync.png) # Uso del Io TSite WiseDefaultWorkspace Al optar por la [AWS IoT SiteWiseAWS IoT TwinMaker integración](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/integrate-tm.html), se crea un espacio de trabajo predeterminado denominado y `IoTSiteWiseDefaultWorkspace` se sincroniza automáticamente con AWS IoT SiteWiseél. También puedes usar la AWS IoT TwinMaker `CreateWorkspace` API para crear un espacio de trabajo con el nombre`IoTSiteWiseDefaultWorkspace`. ## Requisitos previos Antes de crear`IoTSiteWiseDefaultWorkspace`, asegúrate de haber hecho lo siguiente: + Cree un rol AWS IoT TwinMaker vinculado a un servicio. Para obtener más información, consulte [Uso de funciones vinculadas a servicios para AWS IoT TwinMaker](using-service-linked-roles.md). + Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). Revise el rol o el usuario y compruebe que tiene permiso para hacerlo. `iotsitewise:EnableSiteWiseIntegration` Si es necesario, añada permiso al rol o al usuario: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:EnableSiteWiseIntegration", "Resource": "*" } ] } ``` ------ # Diferencias entre los espacios de trabajo personalizados y predeterminados **importante** AWS IoT SiteWise Las nuevas funciones, 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), solo están disponibles en`IoTSiteWiseDefaultWorkspace`. Le recomendamos que utilice un espacio de trabajo predeterminado en lugar de un espacio de trabajo personalizado. Al usar el`IoTSiteWiseDefaultWorkspace`, existen algunas diferencias notables con respecto al uso de un espacio de trabajo personalizado con sincronización de activos. + Al crear un espacio de trabajo predeterminado, la ubicación de Amazon S3 y el rol de IAM son opcionales. **nota** Puede utilizarlos `UpdateWorkspace` para proporcionar la ubicación de Amazon S3 y la función de IAM. + `IoTSiteWiseDefaultWorkspace`No tiene un límite de recuento de recursos con el que sincronizar AWS IoT SiteWise los recursos. AWS IoT TwinMaker + Cuando sincronices los recursos desde AWS IoT SiteWise, `SyncSource` serán los suyos`SITEWISE_MANAGED`. Esto incluye `Entities` y`ComponentTypes`. + Nuevas AWS IoT SiteWise funciones, como `CompositionModel` las que solo están disponibles en`IoTSiteWiseDefaultWorkspace`. Existen algunas limitaciones específicas`IoTSiteWiseDefaultWorkspace`, que son: + El espacio de trabajo predeterminado no se puede eliminar. + Para eliminar recursos, primero debe eliminar los AWS IoT SiteWise recursos y, a continuación, AWS IoT TwinMaker se eliminan los recursos correspondientes. # Recursos sincronizados desde AWS IoT SiteWise En este tema, se enumeran los activos desde los que puedes sincronizar AWS IoT SiteWise con tu AWS IoT TwinMaker espacio de trabajo. **importante** Consulte [Diferencias entre los espacios de trabajo personalizados y predeterminados](tm-sw-default-ws-diffs.md) para obtener información sobre las diferencias entre los espacios de trabajo personalizados y predeterminados. ## Espacios de trabajo personalizados y predeterminados Los siguientes recursos están sincronizados y disponibles en los espacios de **trabajo** personalizados y predeterminados: **Modelos de activos** AWS IoT TwinMaker crea un nuevo tipo de componente para cada modelo de activo de. AWS IoT SiteWise + El componente `TypeId` del modelo de activos utilizará uno de los siguientes patrones: + **Espacio de trabajo personalizado -** `iotsitewise.assetmodel:assetModelId` + **Espacio de trabajo predeterminado -** `assetModelId` + Cada propiedad del modelo de activos es una propiedad nueva en el tipo de componente, con uno de los siguientes patrones de nomenclatura: + **Espacio de trabajo personalizado -** `Property_propertyId` + **Espacio de trabajo predeterminado -** `propertyId` El nombre de la propiedad en AWS IoT SiteWise se guarda como `displayName` en la definición de la propiedad. + Cada jerarquía del modelo de activos es una nueva propiedad de tipo `LIST` y `nestedType` se encuentra `RELATIONSHIP` en el tipo de componente. La jerarquía se asigna a la propiedad con un nombre con el prefijo de uno de los siguientes: + **Espacio de trabajo personalizado -** `Hierarchy_hierarchyId` + **Espacio de trabajo predeterminado -** `hierarchyId` **Activo** AWS IoT TwinMaker crea una nueva entidad para cada activo de AWS IoT SiteWise. + El `entityId` es el mismo que el `assetId` de entrada AWS IoT SiteWise. + Estas entidades tienen un único componente denominado `sitewiseBase`, que tiene el tipo de componente correspondiente al modelo de activo para este activo. + Cualquier anulación con respecto a los activos, como la configuración del alias o de la unidad de medida de la propiedad, se refleja en la entidad en AWS IoT TwinMaker. ## Solo espacio de trabajo predeterminado Los siguientes activos están sincronizados y **disponibles solo en el espacio de trabajo predeterminado**,`IoTSiteWiseDefaultWorkspace`. **AssetModelComponents** AWS IoT TwinMaker crea un nuevo tipo de componente para cada pulgada`AssetModelComponents`. AWS IoT SiteWise + El componente `TypeId` del modelo de activos utiliza el siguiente patrón:`assetModelId`. + Cada propiedad del modelo de activos es una propiedad nueva en el tipo de componente, con el nombre de la propiedad como `propertyId`. El nombre de la propiedad en AWS IoT SiteWise se almacena como `displayName` en la definición de la propiedad. + Cada jerarquía del modelo de activos es una nueva propiedad de tipo `LIST` y `nestedType` se encuentra `RELATIONSHIP` en el tipo de componente. La jerarquía se asigna a la propiedad con un nombre con el prefijo `hierarchyId`. **AssetModelCompositeModel** AWS IoT TwinMaker crea un nuevo tipo de componente para cada `AssetModelCompositeModel` pulgada AWS IoT SiteWise. + El componente `TypeId` del modelo de activos utiliza el siguiente patrón:`assetModelId_assetModelCompositeModelId`. + Cada propiedad del modelo de activos es una propiedad nueva en el tipo de componente, con el nombre de la propiedad como `propertyId`. El nombre de la propiedad en AWS IoT SiteWise se almacena como `displayName` en la definición de la propiedad. **AssetCompositeModels** AWS IoT TwinMaker crea un nuevo componente compuesto para cada `AssetCompositeModel` entrada AWS IoT SiteWise. + El `componentName` es el mismo que `assetModelCompositeModelId` el interior AWS IoT SiteWise. ## Los recursos no están sincronizados Los siguientes recursos no están sincronizados: **Activos y modelos de activos no sincronizados** + Los modelos de alarma se sincronizarán como CompositeModels, pero los datos correspondientes del activo relacionados con las alarmas no se sincronizarán. + [AWS IoT SiteWise los flujos de datos](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/manage-data-streams.html) no están sincronizados. Solo se sincronizan las propiedades modeladas en el modelo de activos. + Los valores de propiedad para el cálculo de los atributos, las medidas, las transformaciones, los agregados y los metadatos, como la fórmula y el periodo, no se sincronizan. Solo se sincronizan los metadatos de las propiedades, como el alias, la unidad de medida y el tipo de datos. Los valores se pueden consultar mediante la API del conector de AWS IoT TwinMaker datos normal,. [ GetPropertyValueHistory](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html) ## Utilice entidades sincronizadas y tipos de componentes en AWS IoT TwinMaker Una vez sincronizados los activos AWS IoT SiteWise, los tipos de componentes sincronizados son de solo lectura. AWS IoT TwinMaker Cualquier acción de actualización o eliminación debe realizarse y esos cambios se sincronizan AWS IoT TwinMaker si el SyncJob sigue activo. AWS IoT SiteWise Las entidades sincronizadas y el componente AWS IoT SiteWise base también son de solo lectura. AWS IoT TwinMaker Puede agregar componentes no sincronizados adicionales a la entidad sincronizada, siempre que no se actualice ningún atributo a nivel de la entidad, como la descripción o `entityName`. Se aplican algunas restricciones a la forma de interactuar con las entidades sincronizadas. No se pueden crear entidades secundarias en una entidad sincronizada de la jerarquía de la entidad sincronizada. Además, no puede crear tipos de componentes no sincronizados que se extiendan a partir de un tipo de componente sincronizado. **nota** Los componentes adicionales se eliminan junto con la entidad si se elimina el activo en el trabajo de sincronización AWS IoT SiteWise o si se elimina el mismo. Puede usar estas entidades sincronizadas en los paneles de Grafana y agregarlas como etiquetas en el compositor de escenas como entidades normales. También puede hacer consultas de gráficos de conocimiento para estas entidades sincronizadas. **nota** Las entidades sincronizadas sin modificación son sin cargo, pero sí tendrán un costo si se las modificó en AWS IoT TwinMaker. Por ejemplo, si añades un componente no sincronizado a una entidad sincronizada, esa entidad ahora se carga. AWS IoT TwinMaker Para más información, consulte [Precios de AWS IoT TwinMaker](https://aws.amazon.com//iot-twinmaker/pricing/). # Analice el estado y los errores de la sincronización En este tema se proporciona orientación sobre cómo analizar los errores y los estados de sincronización. **importante** Consulte [Diferencias entre los espacios de trabajo personalizados y predeterminados](tm-sw-default-ws-diffs.md) para obtener información sobre las diferencias entre los espacios de trabajo personalizados y predeterminados. ## Estados de los trabajos de sincronización Un trabajo de sincronización tiene uno de los siguientes estados, según su estado. + El `CREATING` estado del trabajo de sincronización significa que el trabajo está comprobando los permisos y cargando datos AWS IoT SiteWise para preparar la sincronización. + El `INITIALIZING` estado del trabajo de sincronización significa que todos los recursos existentes AWS IoT SiteWise están sincronizados. AWS IoT TwinMaker Este paso puede tardar más en completarse si el usuario tiene una gran cantidad de activos y modelos de activos en AWS IoT SiteWise. Puede supervisar la cantidad de recursos que se sincronizaron comprobando el trabajo de sincronización en la [consola de AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/) o llamando a la API de `ListSyncResources`. + El estado del trabajo de sincronización `ACTIVE` significa que se completó el paso de inicialización. El trabajo ya está listo para sincronizar cualquier actualización nueva desde AWS IoT SiteWise. + El estado del trabajo de sincronización `ERROR` indica un error en alguno de los estados anteriores. Revise el mensaje de error. Es posible que haya un problema con la configuración del rol de IAM. Si desea utilizar una nueva función de IAM, elimine la tarea de sincronización en la que se produjo el error y cree una nueva con la nueva función. Los errores de sincronización aparecen en la página de origen del modelo, a la que se accede desde la tabla de **orígenes del modelo de la entidad** del espacio de trabajo. La página de origen del modelo muestra una lista de los recursos que no se pudieron sincronizar. El trabajo de sincronización vuelve a intentar con la mayoría de los errores automáticamente, pero si el recurso requiere una acción, entonces permanece en ese estado de `ERROR`. También puedes obtener una lista de errores mediante la [ ListSyncResources](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListSyncResources.html)API. Para ver todos los errores del origen actual, lleve a cabo el siguiente procedimiento. 1. Navegue hasta el espacio de trabajo en la [consola de AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/). 1. Seleccione la AWS IoT SiteWise fuente que aparece en el modal de **fuentes del modelo de entidad** para abrir la página de detalles de la sincronización de activos. ![\[La página AWS IoT SiteWise de origen muestra los detalles de la sincronización de activos, incluidos los errores.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/synced-resources.png) 1. Como se muestra en la captura de pantalla anterior, todos los recursos con errores persistentes se enumeran en la tabla de **Errores**. Puede usar esta tabla para localizar y corregir errores relacionados con recursos específicos. Entre los errores posibles, se incluyen: + Si bien AWS IoT SiteWise admite nombres de activos duplicados, AWS IoT TwinMaker solo los admite a `ROOT` nivel, no bajo la misma entidad principal. Si tiene dos activos con el mismo nombre en una entidad principal AWS IoT SiteWise, uno de ellos no se sincronizará. Para corregir este error, elimine uno de los activos o mueva uno a otro activo principal AWS IoT SiteWise antes de sincronizarlo. + Si ya tienes una entidad con el mismo ID que el ID del AWS IoT SiteWise activo, ese activo no se sincronizará hasta que elimines la entidad existente. # Eliminar un trabajo de sincronización Utilice el siguiente procedimiento para eliminar un trabajo de sincronización. **importante** Consulte [Diferencias entre los espacios de trabajo personalizados y predeterminados](tm-sw-default-ws-diffs.md) para obtener información sobre las diferencias entre los espacios de trabajo personalizados y predeterminados. 1. Vaya a la [consola de AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/). 1. Abra el espacio de trabajo del que desee eliminar el trabajo de sincronización. 1. En **Orígenes de modelos de la entidad**, seleccione el origen de AWS IoT SiteWise para abrir la página de detalles del origen. 1. Para detener el trabajo de sincronización, elija **Desconectar**. Confirme su elección para eliminar completamente el trabajo de sincronización. ![\[El cuadro de diálogo Desconectar la AWS IoT SiteWise sincronización tiene botones para cancelar o desconectar el trabajo de sincronización.\]](http://docs.aws.amazon.com/es_es/iot-twinmaker/latest/guide/images/confirm-delete.png) Una vez que se elimina un trabajo de sincronización, puede volver a crearlo en el mismo espacio de trabajo o en uno diferente. No puedes eliminar un espacio de trabajo si hay trabajos de sincronización en ese espacio de trabajo. Elimine primero los trabajos de sincronización antes de eliminar un espacio de trabajo. Si se produce algún error durante la eliminación del trabajo de sincronización, el trabajo de sincronización permanece en ese estado de `DELETING` y se vuelve a intentar automáticamente. Ahora puede eliminar manualmente cualquiera de las entidades o tipos de componentes sincronizados si se produce algún error relacionado con la eliminación de un recurso. **nota** Todos los recursos desde los que se sincronizaron AWS IoT SiteWise se eliminan primero y, a continuación, se elimina el trabajo de sincronización propiamente dicho. # Límites de la sincronización de activos **importante** Consulte [Diferencias entre los espacios de trabajo personalizados y predeterminados](tm-sw-default-ws-diffs.md) para obtener información sobre las diferencias entre el espacio de trabajo personalizado y el predeterminado. Debido a que las [cuotas de AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html) son superiores a las [cuotas predeterminadas de AWS IoT TwinMaker](https://docs.aws.amazon.com//general/latest/gr/iot-twinmaker.html), vamos a aumentar los siguientes límites para las entidades y los tipos de componentes sincronizados desde AWS IoT SiteWise. + 1000 tipos de componentes sincronizados en un espacio de trabajo, ya que solo se pueden sincronizar 1000 modelos de activos. AWS IoT SiteWise + 100 000 entidades sincronizadas en un espacio de trabajo, ya que solo puede sincronizar 100 000 activos desde él. AWS IoT SiteWise + 2000 entidades secundarias como máximo por entidad principal. Sincroniza 2000 activos secundarios por activo principal único. **nota** La [GetEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetEntity.html)API solo devuelve las 50 primeras entidades secundarias de una propiedad jerárquica, pero puedes utilizarla para paginar y recuperar la lista de todas las entidades secundarias. [GetPropertyValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValue.html) + 600 propiedades por componente sincronizado desde AWS IoT SiteWise, que permiten sincronizar modelos de activos con un total de 600 propiedades y jerarquías. **nota** Estos límites solo se aplican a las entidades sincronizadas. Solicite un aumento de la cuota si necesita aumentar estos límites para los recursos no sincronizados.