

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de la synchronisation des actifs avec AWS IoT SiteWise
<a name="tm-sw-asset-sync-use"></a>

Cette rubrique explique comment activer et configurer la synchronisation AWS IoT SiteWise des actifs. Suivez les procédures appropriées en fonction du type d'espace de travail que vous utilisez.

**Important**  
Consultez [Différences entre les espaces de travail personnalisés et les espaces de travail par défaut](tm-sw-default-ws-diffs.md) pour plus d'informations sur les différences entre les espaces de travail personnalisés et par défaut.

**Topics**
+ [Utilisation d'un espace de travail personnalisé](tm-sw-custom-ws.md)
+ [Utilisation de l'Io TSite WiseDefaultWorkspace](tm-sw-default-ws.md)

# Utilisation d'un espace de travail personnalisé
<a name="tm-sw-custom-ws"></a>

Passez en revue ces conditions préalables avant d'activer la synchronisation des ressources.

## Conditions préalables
<a name="tm-sw-asset-sync-use-prereqs"></a>

Avant toute utilisation AWS IoT SiteWise, vous devez effectuer les opérations suivantes :
+ Vous disposez d'un AWS IoT TwinMaker espace de travail.
+ Vous avez intégré des actifs et des modèles d'actifs AWS IoT SiteWise. Pour plus d'informations, consultez la section [Création de modèles d'actifs](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/create-asset-models.html).
+ Rôle IAM existant doté d'autorisations de lecture pour les AWS IoT SiteWise actions suivantes : 
  + `ListAssets`
  + `ListAssetModels`
  +  `DescribeAsset`
  + `DescribeAssetModel`
+ Le rôle IAM doit disposer des autorisations d'écriture suivantes pour AWS IoT TwinMaker :
  + `CreateEntity`
  + `UpdateEntity`
  + `DeleteEntity`
  + `CreateComponentType`
  + `UpdateComponentType`
  + `DeleteComponentType`
  + `ListEntities`
  + `GetEntity`
  + `ListComponentTypes`

  Utilisez le rôle IAM suivant comme modèle pour le rôle requis :

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

Utilisez la procédure suivante pour activer et configurer la synchronisation AWS IoT SiteWise des actifs.

1. Dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/), accédez à la page **Paramètres**.

1. Ouvrez l'onglet **Sources du modèle**.  
![\[La page de configuration de la AWS IoT TwinMaker console avec l'onglet Sources du modèle ouvert.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/asset-sync-settings.png)

1. Choisissez **Connect workspace** pour associer votre AWS IoT TwinMaker espace de travail à vos AWS IoT SiteWise actifs.
**Note**  
Vous ne pouvez utiliser la synchronisation des actifs qu'avec un seul AWS IoT TwinMaker espace de travail. Vous devez déconnecter la synchronisation d'un espace de travail et vous connecter à un autre espace de travail si vous souhaitez effectuer la synchronisation dans un autre espace de travail.

1. Accédez ensuite à l'espace de travail dans lequel vous souhaitez utiliser la synchronisation des actifs.

1. Choisissez **Add sources (Ajouter des sources)**. Cela ouvre la page **source Ajouter un modèle d'entité**.  
![\[La page source Ajouter un modèle d'entité.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/add-model-source.png)

1. Sur la page **Ajouter une source de modèle d'entité**, vérifiez que le champ source s'affiche **AWS IoT SiteWise**. Sélectionnez le rôle IAM que vous avez créé comme condition préalable au rôle **IAM**.

1. Vous avez maintenant activé la synchronisation AWS IoT SiteWise des actifs. Vous devriez voir une bannière de conformation apparaître en haut de la page **Workspace** sélectionnée pour confirmer que la synchronisation des actifs est active. Vous devriez également voir une source de synchronisation répertoriée dans la section **Sources du modèle d'entité**.  
![\[La page de l'espace de travail présentant la liste des sources du modèle d'entité.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/success-sync.png)

# Utilisation de l'Io TSite WiseDefaultWorkspace
<a name="tm-sw-default-ws"></a>

Lorsque vous optez pour l'[AWS IoT SiteWiseAWS IoT TwinMaker intégration](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/integrate-tm.html), un espace de travail par défaut nommé `IoTSiteWiseDefaultWorkspace` est créé et automatiquement synchronisé avec AWS IoT SiteWise.

Vous pouvez également utiliser l' AWS IoT TwinMaker `CreateWorkspace`API pour créer un espace de travail nommé`IoTSiteWiseDefaultWorkspace`.

## Conditions préalables
<a name="tm-sw-default-ws-prereqs"></a>

Avant de créer`IoTSiteWiseDefaultWorkspace`, assurez-vous d'avoir effectué les opérations suivantes :
+ Créez un rôle AWS IoT TwinMaker lié à un service. Pour plus d’informations, consultez [Utilisation de rôles liés à un service pour AWS IoT TwinMaker](using-service-linked-roles.md).
+ Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

  Passez en revue le rôle ou l'utilisateur et vérifiez qu'il est autorisé à`iotsitewise:EnableSiteWiseIntegration`.

  Si nécessaire, ajoutez une autorisation au rôle ou à l'utilisateur :

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

****  

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

------