

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用自定义工作区
<a name="tm-sw-custom-ws"></a>

在开启资产同步前，请查看这些先决条件。

## 先决条件
<a name="tm-sw-asset-sync-use-prereqs"></a>

在使用之前 AWS IoT SiteWise，必须完成以下操作：
+ 你有一个 AWS IoT TwinMaker 工作空间。
+ 你在里面有资产和资产模型 AWS IoT SiteWise。有关更多信息，请参阅[创建资产模型](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/create-asset-models.html)。
+ 具有以下 AWS IoT SiteWise 操作的读取权限的现有 IAM 角色：
  + `ListAssets`
  + `ListAssetModels`
  +  `DescribeAsset`
  + `DescribeAssetModel`
+ IAM 角色必须具有以下写入权限 AWS IoT TwinMaker：
  + `CreateEntity`
  + `UpdateEntity`
  + `DeleteEntity`
  + `CreateComponentType`
  + `UpdateComponentType`
  + `DeleteComponentType`
  + `ListEntities`
  + `GetEntity`
  + `ListComponentTypes`

  使用以下 IAM 角色作为所需角色的模板：

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

按照以下程序开启和配置 AWS IoT SiteWise 资产同步。

1. 在 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)，导航至 **Settings**（设置）页面。

1. 打开 **模型来源**选项卡。  
![\[打开 “模型来源” 选项卡的 AWS IoT TwinMaker 控制台设置页面。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/asset-sync-settings.png)

1. 选择 **Connect 工作空间**，将您的 AWS IoT TwinMaker 工作空间链接到您的 AWS IoT SiteWise 资产。
**注意**  
您只能在单个 AWS IoT TwinMaker 工作区中使用资产同步。如果要在其他工作区内同步，必须断开原有工作区连接，然后连接至另一工作区。

1. 接下来，导航至要在其中使用资产同步的工作区。

1. 选择 **Add sources (添加源)**。打开**添加试题模型来源**页面。  
![\[添加实体模型源页面。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/add-model-source.png)

1. 在**添加实体模型来源**页面，确认源字段显示 **AWS IoT SiteWise**。选择您所创建的 IAM 角色作为**IAM 角色**的先决条件。

1. 现在，您已开启 AWS IoT SiteWise 资产同步。您应该会在选定**工作区** 页面顶部看到确认横幅，确认资产同步处于活动状态。现在，您还应该看到**实体模型来源**部分列出同步来源。  
![\[显示实体模型源列表的工作区页面。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/success-sync.png)