翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# でのアセット同期の使用 AWS IoT SiteWise
<a name="tm-sw-asset-sync-use"></a>

このトピックでは、 AWS IoT SiteWise アセット同期を有効にして設定する方法について説明します。使用しているワークスペースのタイプに基づいて、適切な手順に従ってください。

**重要**  
カスタムワークスペースとデフォルトワークスペースの違いについては、[カスタムワークスペースとデフォルトワークスペースの違い](tm-sw-default-ws-diffs.md)「」を参照してください。

**Topics**
+ [カスタムワークスペースの使用](tm-sw-custom-ws.md)
+ [IoTSiteWiseDefaultWorkspace の使用](tm-sw-default-ws.md)

# カスタムワークスペースの使用
<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/)で **[設定]** ページに移動します。

1. **[モデルソース]** タブを開きます。  
![\[AWS IoT TwinMaker モデルソースタブが開いたコンソールの設定ページ。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/asset-sync-settings.png)

1. **Connect workspace** を選択して、ワークスペースを AWS IoT TwinMaker AWS IoT SiteWise アセットにリンクします。
**注記**  
アセット同期は 1 つの AWS IoT TwinMaker ワークスペースでのみ使用できます。別のワークスペースで同期する場合は、ワークスペースから同期を切断し、別のワークスペースに接続する必要があります。

1. 次に、アセットの同期を使用するワークスペースに移動します。

1. 「**ソースを追加**」 を選択します。**[エンティティモデルソースを追加]** ページが開きます。  
![\[エンティティモデルソースの追加ページ。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/add-model-source.png)

1. **[エンティティモデルソースを追加]** ページで、[ソース] フィールドに **AWS IoT SiteWise** が表示されることを確認します。**[IAM ロール]** で、前提条件として作成した IAM ロールを選択します。

1. これで、 AWS IoT SiteWise アセット同期が有効になりました。選択した **[ワークスペース]** ページの上部に、アセットの同期がアクティブであることを確認する確認バナーが表示されます。また、**[エンティティモデルソース]** セクションに同期ソースが表示されます。  
![\[エンティティモデルソースのリストを示すワークスペースページ。\]](http://docs.aws.amazon.com/ja_jp/iot-twinmaker/latest/guide/images/success-sync.png)

# IoTSiteWiseDefaultWorkspace の使用
<a name="tm-sw-default-ws"></a>

[AWS IoT SiteWiseAWS IoT TwinMaker 統合](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/integrate-tm.html)にオプトインすると、 という名前のデフォルトのワークスペース`IoTSiteWiseDefaultWorkspace`が作成され、自動的に同期されます AWS IoT SiteWise。

API を使用して AWS IoT TwinMaker `CreateWorkspace`、 という名前のワークスペースを作成することもできます`IoTSiteWiseDefaultWorkspace`。

## 前提条件
<a name="tm-sw-default-ws-prereqs"></a>

を作成する前に`IoTSiteWiseDefaultWorkspace`、以下を実行していることを確認してください。
+  AWS IoT TwinMaker サービスにリンクされたロールを作成します。詳細については「[のサービスにリンクされたロールの使用 AWS IoT TwinMaker](using-service-linked-roles.md)」を参照してください。
+ IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。

  ロールまたはユーザーを確認し、 へのアクセス許可があることを確認します`iotsitewise:EnableSiteWiseIntegration`。

  必要に応じて、ロールまたはユーザーにアクセス許可を追加します。

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Effect": "Allow",
              "Action": "iotsitewise:EnableSiteWiseIntegration",
              "Resource": "*"
          }
      ]
  }
  ```

------