

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.

# Gérer les passerelles SiteWise Edge
<a name="manage-gateways-ggv2"></a>

Vous pouvez utiliser les opérations de AWS IoT SiteWise console et d'API pour gérer les passerelles AWS IoT SiteWise Edge. Vous pouvez également utiliser l'application [AWS OpsHub for AWS IoT SiteWise for Windows pour](https://aws-iot-sitewise.s3.amazonaws.com/gateway/OpsHub+for+AWS+IoT+SiteWise.exe) gérer certains aspects de votre passerelle SiteWise Edge à partir de votre appareil local.

Nous vous recommandons vivement d'utiliser l' AWS IoT SiteWise application AWS OpsHub for pour surveiller l'utilisation du disque sur votre appareil local. Vous pouvez également surveiller les CloudWatch métriques `Gateway.AvailableDiskSpace` et `Gateway.UsedPercentageDiskSpace` celles d'Amazon et créer des alarmes pour être averti lorsque l'espace disque devient insuffisant. Pour plus d'informations sur les CloudWatch alarmes Amazon, consultez [Créer une CloudWatch alarme basée sur un seuil statique](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html).

Assurez-vous que votre appareil dispose de suffisamment d'espace pour les données à venir. Lorsque vous êtes sur le point de manquer d'espace sur votre appareil local, le service supprime automatiquement une petite quantité de données avec les horodatages les plus anciens pour faire de la place aux données à venir.

Pour vérifier si le service a supprimé vos données, procédez comme suit :

1. Connectez-vous au formulaire AWS OpsHub de AWS IoT SiteWise candidature.

1. Cliquez sur **Paramètres**.

1. Pour **Logs**, spécifiez un intervalle de temps, puis choisissez **Download**.

1. Décompressez le fichier journal.

1. Si le fichier journal contient le message suivant, le service a supprimé vos données : des {{number}} octets de données ont été supprimés pour empêcher le stockage de la passerelle SiteWise Edge de manquer d'espace. 

## Gérez votre passerelle SiteWise Edge à l'aide de la AWS IoT SiteWise console
<a name="cloud-console"></a>

Vous pouvez utiliser la AWS IoT SiteWise console pour configurer, mettre à jour et surveiller toutes les passerelles SiteWise Edge de votre AWS compte. 

[Vous pouvez consulter vos passerelles SiteWise Edge en accédant à la page **Passerelles Edge de** la console.AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) Pour accéder à la page de **détails de la passerelle Edge** d'une passerelle spécifique, choisissez le nom d'une passerelle Edge.

Dans l'onglet **Vue d'ensemble** de la page de **détails de la passerelle Edge**, vous pouvez effectuer les opérations suivantes :
+ Dans la section **Sources de données**, mettez à jour la configuration des sources de données et configurez des sources de données supplémentaires
+ Choisissez **Open CloudWatch metrics** pour afficher le nombre de points de données ingérés par source de données dans la console CloudWatch des métriques
+ Dans la section **Fonctionnalités Edge**, ajoutez des packs de données à votre passerelle SiteWise Edge en cliquant sur **Modifier**
+ Dans la section **Configuration de la passerelle**, consultez l'état de connectivité de vos passerelles SiteWise Edge
+ Dans la section **Configuration de l'éditeur**, consultez l'état de synchronisation de la passerelle SiteWise Edge et la configuration du composant de l' AWS IoT SiteWise éditeur

Dans l'onglet **Mises à jour** de la page de **détails de la passerelle Edge**, vous pouvez voir les versions actuelles des composants et des packs déployées sur la passerelle Edge. C'est également là que vous déployez les nouvelles versions, lorsqu'elles sont disponibles.

## Gérez les passerelles SiteWise Edge à l'aide de AWS OpsHub AWS IoT SiteWise
<a name="opshub-app"></a>

Vous utilisez l' AWS IoT SiteWise application AWS OpsHub for pour gérer et surveiller vos passerelles SiteWise Edge auto-hébergées. Cette application propose les options de surveillance et de gestion suivantes :
+ Sous **Vue d'ensemble**, vous pouvez effectuer les opérations suivantes :
  + Consultez les détails de la passerelle SiteWise Edge qui vous aident à obtenir des informations sur les données de votre appareil de passerelle SiteWise Edge, à identifier les problèmes et à améliorer les performances de la passerelle SiteWise Edge.
  + Portails View SiteWise Monitor qui surveillent les données provenant des serveurs locaux et des équipements situés en périphérie. Pour plus d'informations, voir [Contenu AWS IoT SiteWise Monitor](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/what-is-monitor-app.html) du *guide de AWS IoT SiteWise Monitor candidature*.
+ Sous **Health**, un tableau de bord affiche les données de votre passerelle SiteWise Edge. Les experts du domaine, tels que les ingénieurs de processus, peuvent utiliser le tableau de bord pour avoir une vue d'ensemble du comportement de la passerelle SiteWise Edge.
+ Sous **Ressources**, consultez les ressources déployées sur le périphérique local et la dernière valeur collectée ou calculée pour les propriétés des ressources.
+ Dans **Réglages**, vous pouvez effectuer les opérations suivantes :
  + Si le pack de traitement des données est installé, consultez les informations de configuration de la passerelle SiteWise Edge et synchronisez les ressources avec le AWS cloud.
  + Téléchargez les fichiers d'authentification que vous pouvez utiliser pour accéder à la passerelle SiteWise Edge à l'aide d'autres outils. 
  + Téléchargez des journaux que vous pouvez utiliser pour résoudre les problèmes liés à la passerelle SiteWise Edge.
  + Affichez les AWS IoT SiteWise composants déployés sur la passerelle SiteWise Edge.

**Important**  
Les éléments suivants doivent être utilisés AWS OpsHub pour AWS IoT SiteWise :  
Votre appareil local et l' AWS IoT SiteWise application AWS OpsHub for doivent être connectés au même réseau.
Le pack de traitement des données doit être activé.

**Pour gérer les passerelles SiteWise Edge à l'aide de AWS OpsHub**

1. Téléchargez et installez l'application [AWS OpsHubAWS IoT SiteWise pour Windows](https://aws-iot-sitewise.s3.amazonaws.com/gateway/OpsHub+for+AWS+IoT+SiteWise.exe).

1. Ouvrez l'application .

1. Si vous n'avez pas configuré d'informations d'identification locales pour votre passerelle, suivez les étapes [Accédez à votre passerelle SiteWise Edge à l'aide des informations d'identification du système d'exploitation local](#create-user-pool) ci-dessous pour les configurer.

1. Vous pouvez vous connecter à votre passerelle SiteWise Edge avec vos informations d'identification Linux ou LDAP (Lightweight Directory Access Protocol). Pour vous connecter à votre passerelle SiteWise Edge, effectuez l'une des opérations suivantes :

------
#### [ Linux ]

   1. Dans **Nom d'hôte ou adresse IP**, entrez le nom d'hôte ou l'adresse IP de votre appareil local.

   1. Pour **Authentification**, choisissez **Linux**.

   1. Dans **Nom d'utilisateur**, entrez le nom d'utilisateur de votre système d'exploitation Linux.

   1. Dans **Mot de passe**, entrez le mot de passe de votre système d'exploitation Linux.

   1. Choisissez **Sign in (Connexion)**.

------
#### [ LDAP ]

   1. Dans **Nom d'hôte ou adresse IP**, entrez le nom d'hôte ou l'adresse IP de votre appareil local.

   1. Pour **Authentification**, choisissez **LDAP.**

   1. Dans **Nom d'utilisateur**, entrez le nom d'utilisateur de votre LDAP.

   1. Dans le champ **Mot de passe**, entrez le mot de passe de votre LDAP.

   1. Choisissez **Sign in (Connexion)**.

------

## Accédez à votre passerelle SiteWise Edge à l'aide des informations d'identification du système d'exploitation local
<a name="create-user-pool"></a>

Outre le protocole LDAP (Lightweight Directory Access Protocol), vous pouvez utiliser les informations d'identification Linux ou Windows pour accéder à votre passerelle SiteWise Edge auto-hébergée.

**Important**  
Pour accéder à votre passerelle SiteWise Edge avec des informations d'identification Linux, vous devez activer le pack de traitement de données pour votre passerelle SiteWise Edge.

### Accédez à votre passerelle SiteWise Edge à l'aide des informations d'identification du système d'exploitation Linux
<a name="linux-user-pool"></a>

 Les étapes suivantes supposent que vous utilisez un appareil avec Ubuntu. Si vous utilisez une autre distribution Linux, consultez la documentation correspondante à votre appareil.

**Pour créer un groupe d'utilisateurs Linux**

1. Pour créer un groupe d'administrateurs, exécutez la commande suivante.

   ```
   sudo groupadd --system SWE_ADMIN_GROUP
   ```

   Les utilisateurs du `SWE_ADMIN_GROUP` groupe peuvent autoriser l'accès administrateur à la passerelle SiteWise Edge.

1. Pour créer un groupe d'utilisateurs, exécutez la commande suivante.

   ```
   sudo groupadd --system SWE_USER_GROUP
   ```

   Les utilisateurs du `SWE_USER_GROUP` groupe peuvent autoriser l'accès en lecture seule à la passerelle SiteWise Edge.

1. Pour ajouter un utilisateur au groupe d'administrateurs, exécutez la commande suivante. Remplacez {{user-name}} et {{password}} par le nom d'utilisateur et le mot de passe que vous souhaitez ajouter.

   ```
   sudo useradd -p $(openssl passwd -1 {{password}}) {{user-name}}
   ```

1. Pour ajouter un utilisateur à l'une `SWE_ADMIN_GROUP` ou l'autre`SWE_USER_GROUP`, {{user-name}} remplacez-le par le nom d'utilisateur que vous avez ajouté à l'étape précédente.

   ```
   sudo usermod -a -G SWE_ADMIN_GROUP {{user-name}}
   ```

Vous pouvez désormais utiliser le nom d'utilisateur et le mot de passe pour vous connecter à la passerelle SiteWise Edge sur l' AWS IoT SiteWise application AWS OpsHub for.

### Accédez à votre passerelle SiteWise Edge à l'aide des informations d'identification Windows
<a name="windows-user-pool"></a>

 Les étapes suivantes supposent que vous utilisez un appareil Windows.

**Important**  
La sécurité est une responsabilité partagée entre vous AWS et vous. Créez une politique de mot de passe robuste comportant au moins 12 caractères et une combinaison de majuscules, de minuscules, de chiffres et de symboles. Définissez également les règles du pare-feu Windows pour autoriser le trafic entrant sur le port 443 et pour bloquer le trafic entrant sur tous les autres ports.

**Pour créer un groupe d'utilisateurs Windows Server**

1. Exécutez PowerShell en tant qu'administrateur.

   1. Sur le serveur Windows sur lequel vous souhaitez installer SiteWise Edge Gateway, connectez-vous en tant qu'administrateur.

   1. Entrez **PowerShell**dans la barre de recherche de Windows.

   1. Dans les résultats de recherche, cliquez avec le bouton droit de la souris sur PowerShell l'application Windows. Choisissez **Exécuter en tant qu'administrateur**.

1. Pour créer un groupe d'administrateurs, exécutez la commande suivante.

   ```
   net localgroup SWE_ADMIN_GROUP /add
   ```

   Vous devez être un utilisateur du `SWE_ADMIN_GROUP` groupe pour autoriser l'accès administrateur à la passerelle SiteWise Edge.

1. Pour créer un groupe d'utilisateurs, exécutez la commande suivante.

   ```
   net localgroup SWE_USER_GROUP /add
   ```

   Vous devez être un utilisateur du `SWE_USER_GROUP` groupe pour autoriser l'accès prêt à l'emploi à la passerelle SiteWise Edge.

1. Pour ajouter un utilisateur, exécutez la commande suivante. Remplacez {{user-name}} et {{password}} par le nom d'utilisateur et le mot de passe que vous souhaitez créer.

   ```
   net user {{user-name password}} /add
   ```

1. Pour ajouter un utilisateur au groupe d'administrateurs, exécutez la commande suivante. {{user-name}}Remplacez-le par le nom d'utilisateur que vous souhaitez ajouter.

   ```
   net localgroup SWE_ADMIN_GROUP {{user-name}} /add
   ```

Vous pouvez désormais utiliser le nom d'utilisateur et le mot de passe pour vous connecter à la passerelle SiteWise Edge sur l' AWS IoT SiteWise application AWS OpsHub for.

## Gérer le certificat de passerelle SiteWise Edge
<a name="manage-gateway-certificate"></a>

Vous pouvez utiliser SiteWise Monitor et des applications tierces, telles que Grafana, sur vos appareils de passerelle SiteWise Edge. Ces applications nécessitent une connexion TLS au service. SiteWise Les passerelles Edge utilisent actuellement un certificat auto-signé. Si vous utilisez un navigateur pour ouvrir les applications, par exemple un portail SiteWise Monitor, il est possible que vous receviez un avertissement concernant un certificat non fiable.

Ce qui suit montre comment télécharger le certificat sécurisé depuis l' AWS IoT SiteWise application AWS OpsHub for.

1. Connectez-vous à l'application.

1. Cliquez sur **Paramètres**.

1. Pour **Authentification**, choisissez **Télécharger le certificat**.

Ce qui suit suppose que vous utilisez Google Chrome ou FireFox. Si vous utilisez un autre navigateur, consultez la documentation correspondante. Pour ajouter le certificat que vous avez téléchargé à l'étape précédente dans un navigateur, effectuez l'une des opérations suivantes :
+ Si vous utilisez Google Chrome, suivez les instructions relatives à la [configuration des certificats](https://support.google.com/chrome/a/answer/3505249?hl=en) dans la *documentation d'aide de Google Chrome Enterprise*.
+ Si vous utilisez Firefox, suivez les instructions [pour charger le certificat dans le navigateur Mozilla ou Firefox](https://docs.oracle.com/cd/E19528-01/819-4639/gaesv/index.html) de la *documentation Oracle*.

## Modifier la version des packs de composants de la passerelle SiteWise Edge
<a name="manage-gateway-update-packs"></a>

Vous pouvez utiliser la AWS IoT SiteWise console pour modifier la version des packs de composants sur vos passerelles SiteWise Edge.

**Pour modifier la version d'un pack de composants de passerelle SiteWise Edge**

1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation de gauche, sélectionnez **Passerelles**.

1. Sélectionnez la passerelle SiteWise Edge dont vous souhaitez modifier les versions du pack.

1. Sous **Configuration de la passerelle**, choisissez **Afficher les versions du logiciel**.

1. Sur la page **Modifier les versions du logiciel**, pour le pack dont vous souhaitez mettre à jour la version, sélectionnez la version que vous souhaitez déployer et choisissez **Déployer**.

1. Sélectionnez **Exécuté**.

## Passerelles List SiteWise Edge
<a name="manage-gateway-list-gateways"></a>

------
#### [ Console ]

**Pour répertorier les passerelles SiteWise Edge**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Consultez la liste de toutes vos passerelles SiteWise Edge.

------
#### [ AWS CLI ]

Pour répertorier vos passerelles en utilisant AWS CLI, procédez comme suit :
+ Utilisez la commande list-gateways pour afficher toutes vos passerelles :

  ```
  aws iotsitewise list-gateways
  ```

  Cette commande renvoie une liste de vos passerelles avec leurs noms IDs, ainsi que d'autres informations.

  Vous pouvez également définir les paramètres de pagination :

  ```
  aws iotsitewise list-gateways --max-results {{10}} --next-token {{your-token}}
  ```

Pour plus d'informations, consultez [list-gateways](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/list-gateways.html) dans la AWS CLI référence des commandes.

------

## Décrire une passerelle SiteWise Edge
<a name="manage-gateway-describe-gateway"></a>

------
#### [ Console ]

**Pour afficher les détails de la passerelle**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Choisissez le nom de la passerelle dont vous souhaitez consulter les détails.

1. Consultez les détails de la passerelle sur la page des **détails de la passerelle Edge**.

------
#### [ AWS CLI ]

Pour obtenir des informations détaillées sur une passerelle spécifique utilisant AWS CLI, procédez comme suit :
+ Utilisez la commande describe-gateway avec l'ID de passerelle :

  ```
  aws iotsitewise describe-gateway --gateway-id {{a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE}}
  ```

  Cette commande renvoie des informations détaillées sur la passerelle.

Pour plus d'informations, consultez [describe-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/describe-gateway.html) dans le manuel de référence des AWS CLI commandes.

------

## Création d'une passerelle SiteWise Edge
<a name="manage-gateway-create-gateway"></a>

------
#### [ Console ]

**Pour créer une passerelle SiteWise Edge**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Cliquez sur **Create gateway (Créer une passerelle)**.

1. Entrez un nom pour votre passerelle.

1. Sélectionnez le groupe Greengrass pour votre passerelle.

1. Ajoutez éventuellement des balises à votre passerelle.

1. Choisissez **Créer**.

------
#### [ AWS CLI ]

Pour créer une nouvelle SiteWise passerelle IoT à l'aide de AWS CLI, procédez comme suit :
+ Utilisez la commande create-gateway pour créer une nouvelle passerelle :

  ```
  aws iotsitewise create-gateway \
      --gateway-name "NewSiteWiseGateway" \
      --gateway-platform '{
          "greengrass": {
              "groupArn": "arn:aws:greengrass:us-east-1:123456789012:group/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
          }
      }' \
      --tags '{
          "Environment": "Production",
          "Location": "Factory1"
      }'
  ```

  Cette commande renvoie l'ID et l'ARN de la nouvelle passerelle :

  ```
  {
      "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
      "gatewayArn": "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
  }
  ```

Pour plus d'informations, consultez la section [create-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/create-gateway.html) dans le manuel de référence des AWS CLI commandes.

------

## Mettre à jour une passerelle SiteWise Edge
<a name="manage-gateway-update-gateway"></a>

------
#### [ Console ]

**Pour mettre à jour une passerelle SiteWise Edge**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Sélectionnez la passerelle que vous souhaitez mettre à jour.

1. Choisissez **Modifier**.

1. Mettez à jour le nom de la passerelle ou les autres paramètres selon vos besoins.

1. Choisissez **Enregistrer**.

------
#### [ AWS CLI ]

Pour mettre à jour une passerelle existante à l'aide de AWS CLI, procédez comme suit :
+ Utilisez la commande update-gateway pour mettre à jour le nom d'une passerelle :

  ```
  aws iotsitewise update-gateway \
      --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
      --gateway-name "UpdatedGatewayName"
  ```

  Cette commande ne produit aucune sortie lorsqu’elle réussit.

Pour plus d'informations, consultez [update-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway.html) dans la référence des AWS CLI commandes.

------

## Mettre à jour la configuration des fonctionnalités de passerelle
<a name="manage-gateway-update-capability"></a>

------
#### [ Console ]

**Pour mettre à jour la configuration des fonctionnalités de la passerelle**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Choisissez le nom de la passerelle que vous souhaitez mettre à jour.

1. Dans la section **Sources de données**, choisissez **Modifier**.

1. Mettez à jour la configuration de la source de données selon les besoins.

1. Choisissez **Enregistrer**.

------
#### [ AWS CLI ]

Pour mettre à jour la configuration des fonctionnalités d'une passerelle à l'aide de AWS CLI, procédez comme suit :
+ Utilisez la update-gateway-capability-configuration commande pour mettre à jour la configuration des fonctionnalités :

  ```
  aws iotsitewise update-gateway-capability-configuration \
      --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
      --capability-namespace "iotsitewise:opcuacollector:1" \
      --capability-configuration '{
          "sources": [
              {
                  "name": "OPC-UA Server",
                  "endpoint": {
                      "certificateTrust": {
                          "type": "TrustAny"
                      },
                      "endpointUri": "opc.tcp://10.0.0.1:4840",
                      "securityPolicy": "NONE",
                      "messageSecurityMode": "NONE",
                      "identityProvider": {
                          "type": "Anonymous"
                      }
                  },
                  "measurementDataStreamPrefix": ""
              }
          ]
      }'
  ```

  Cette commande renvoie l'espace de noms des fonctionnalités et l'état de synchronisation :

  ```
  {
      "capabilityNamespace": "iotsitewise:opcuacollector:1",
      "capabilitySyncStatus": "CONFIGURING"
  }
  ```

Pour plus d'informations, consultez [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)le manuel de référence des AWS CLI commandes.

------

## Tag : ressources de passerelle
<a name="manage-gateway-tag-resources"></a>

------
#### [ Console ]

**Pour étiqueter une ressource de passerelle**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Choisissez le nom de la passerelle que vous souhaitez étiqueter.

1. Sélectionnez l’onglet **Tags** (Identifications).

1. Choisissez **Gérer les balises**.

1. Choisissez **Ajouter une nouvelle balise** et entrez une clé et une valeur pour chaque balise.

1. Choisissez **Enregistrer**.

------
#### [ AWS CLI ]

Pour ajouter des balises à une passerelle à l'aide de AWS CLI, procédez comme suit :
+ Utilisez la commande tag-resource pour ajouter des balises à une passerelle :

  ```
  aws iotsitewise tag-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
      --tags '{
          "Department": "Operations",
          "Project": "FactoryAutomation"
      }'
  ```

  Cette commande ne produit aucune sortie lorsqu’elle réussit.

Pour plus d'informations, consultez [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/tag-resource.html) dans le manuel de référence des AWS CLI commandes.

------

## Répertorier les balises d'une passerelle
<a name="manage-gateway-list-tags"></a>

------
#### [ Console ]

**Pour répertorier les balises d'une passerelle**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Choisissez le nom de la passerelle pour laquelle vous souhaitez afficher les balises.

1. Sélectionnez l’onglet **Tags** (Identifications).

1. Consultez la liste des balises associées à la passerelle.

------
#### [ AWS CLI ]

Pour répertorier les balises associées à une passerelle à l'aide de AWS CLI, procédez comme suit :
+ Utilisez la list-tags-for-resource commande pour répertorier les balises d'une passerelle :

  ```
  aws iotsitewise list-tags-for-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
  ```

  Cette commande renvoie les balises associées à la passerelle :

  ```
  {
      "tags": {
          "Environment": "Production",
          "Location": "Factory1",
          "Department": "Operations",
          "Project": "FactoryAutomation"
      }
  }
  ```

Pour plus d'informations, consultez [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/list-tags-for-resource.html)le manuel de référence des AWS CLI commandes.

------

## Supprimer les tags d'une passerelle
<a name="manage-gateway-untag-resources"></a>

------
#### [ Console ]

**Pour supprimer des balises d'une passerelle**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Choisissez le nom de la passerelle dont vous souhaitez supprimer les balises.

1. Sélectionnez l’onglet **Tags** (Identifications).

1. Choisissez **Gérer les balises**.

1. Cliquez sur l'icône de suppression (X) à côté de chaque étiquette que vous souhaitez supprimer.

1. Choisissez **Enregistrer**.

------
#### [ AWS CLI ]

Pour supprimer des balises d'une passerelle à l'aide de AWS CLI, procédez comme suit :
+ Utilisez la commande untag-resource pour supprimer les balises d'une passerelle :

  ```
  aws iotsitewise untag-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
      --tag-keys '["Project", "Department"]'
  ```

  Cette commande ne produit aucune sortie lorsqu’elle réussit.

Pour plus d'informations, consultez [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/untag-resource.html) dans le manuel de référence des AWS CLI commandes.

------

## Mettre à jour la version d'un AWS IoT SiteWise composant
<a name="update-component-version"></a>

Mettez à jour le composant AWS IoT SiteWise passerelle de votre appareil AWS IoT Greengrass principal pour garantir votre accès aux dernières fonctionnalités, aux améliorations de performances et aux correctifs de sécurité.

**Pour mettre à jour un AWS IoT SiteWise composant sur AWS IoT Greengrass**

1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation de gauche, choisissez **Edge gateways**.

1. Sélectionnez la passerelle à modifier, puis choisissez **Modifier**.

1. Dans **Edge Capabilities**, sous **Versions logicielles**, sélectionnez **Mises à jour logicielles disponibles**. La page **Modifier les versions du logiciel** s'affiche.

1. Choisissez la version du composant.
**Note**  
Il est recommandé de sélectionner la dernière version disponible. La conservation des composants de la passerelle vous up-to-date permet de conserver des fonctionnalités optimales pour la collecte et le traitement des données industrielles.

1. Choisissez **Déployer**. Cela lance un AWS IoT Greengrass V2 déploiement pour mettre à jour le AWS IoT SiteWise composant sur la passerelle.

## Supprimer une passerelle SiteWise Edge
<a name="manage-gateway-delete-gateway"></a>

------
#### [ Console ]

**Pour supprimer la passerelle SiteWise Edge**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Dans le volet de navigation, choisissez **Edge gateways**.

1. Choisissez la passerelle que vous souhaitez supprimer.

1. Sélectionnez **Delete (Supprimer)**.

1. Pour confirmer que vous souhaitez supprimer la passerelle, tapez « Supprimer », puis choisissez **Supprimer** dans la fenêtre qui apparaît.

------
#### [ AWS CLI ]

Pour supprimer une passerelle à l'aide de AWS CLI, procédez comme suit :

1. Répertoriez vos passerelles pour identifier l'ID de passerelle que vous souhaitez supprimer.

   ```
   aws iotsitewise list-gateways
   ```

   Cette commande renvoie une liste de vos passerelles avec leurs noms IDs, ainsi que d'autres informations :

   ```
   {
       "gatewaySummaries": [
           {
               "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
               "gatewayName": "ExampleCorpGateway",
               "gatewayCapabilitySummaries": [
                   {
                       "capabilityNamespace": "iotsitewise:opcuacollector:1",
                       "capabilitySyncStatus": "IN_SYNC"
                   }
               ],
               "creationDate": 1588369971.457,
               "lastUpdateDate": 1588369971.457
           }
       ]
   }
   ```

1. Supprimez la passerelle en spécifiant son ID :

   ```
   aws iotsitewise delete-gateway --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
   ```

   Cette commande ne produit aucune sortie lorsqu’elle réussit.
**Note**  
Lorsque vous supprimez une passerelle, certains de ses fichiers restent dans le système de fichiers de votre passerelle.

1. Pour vérifier que la passerelle a été supprimée, vous pouvez à nouveau répertorier vos passerelles :

   ```
   aws iotsitewise list-gateways
   ```

   La passerelle supprimée ne doit plus apparaître dans la liste.

Pour plus d'informations, voir [delete-gateway](https://docs.aws.amazon.com/cli/latest/reference/storagegateway/delete-gateway.html) dans la référence des AWS CLI commandes.

------