

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.

# Cómo utilizar la sincronización de activos con AWS IoT SiteWise
<a name="tm-sw-asset-sync-use"></a>

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
<a name="tm-sw-custom-ws"></a>

Revise estos requisitos previos antes de activar la sincronización de activos.

## Requisitos previos
<a name="tm-sw-asset-sync-use-prereqs"></a>

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
<a name="tm-sw-default-ws"></a>

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
<a name="tm-sw-default-ws-prereqs"></a>

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": "*"
          }
      ]
  }
  ```

------