Associer et dissocier des actifs

Si le modèle de votre ressource définit des hiérarchies de modèles de ressources enfants, vous pouvez associer des ressources enfants à votre ressource. Les ressources parents peuvent accéder aux données des ressources associées et les agréger. Pour de plus amples informations sur les modèles de ressources hiérarchiques, veuillez consulter Définir les hiérarchies des modèles d'actifs.

Associer et dissocier des actifs (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour associer et dissocier des actifs.

Pour associer une ressource (console)

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation, choisissez Ressources.

3. Choisissez la ressource parent à laquelle vous souhaitez associer une ressource enfant.

   Astuce

   Vous pouvez cliquer sur l'icône en forme de flèche pour développer une hiérarchie de ressources afin de trouver votre ressource.

4. Choisissez Modifier.

5. Dans Ressources associées à cette ressource, choisissez Ajouter une ressource associée.

   

6. Pour Hiérarchie, choisissez la hiérarchie qui définit la relation entre la ressource parent et la ressource enfant.

7. Pour Ressource, choisissez la ressource enfant à associer.

8. Choisissez Save (Enregistrer).

Pour dissocier une ressource (console)

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation, choisissez Ressources.

3. Choisissez la ressource parent pour laquelle vous souhaitez dissocier une ressource enfant.

   Astuce

   Vous pouvez cliquer sur l'icône en forme de flèche pour développer une hiérarchie de ressources afin de trouver votre ressource.

4. Choisissez Modifier.

5. Dans Ressources associées à cette ressource, choisissez Dissocier pour la ressource.

   

6. Choisissez Save (Enregistrer).

Associer et dissocier des actifs ()AWS CLI

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour associer et dissocier des actifs.

Pour cette procédure, vous devez connaître l'ID de la hiérarchie (hierarchyId) dans le modèle de ressource parent qui définit la relation avec le modèle de ressource enfant. Utilisez l'DescribeAssetopération pour trouver l'ID de hiérarchie dans la réponse.

Pour rechercher un ID de hiérarchie

• Exécutez la commande suivante pour décrire la ressource parent. Remplacez parent-asset-id avec l'ID de la ressource parent ou l'ID externe.

  aws iotsitewise describe-asset --asset-id parent-asset-id

  L'opération renvoie une réponse qui contient les détails de la ressource. La réponse contient une assetHierarchies liste dont la structure est la suivante :

  {
    ...
    "assetHierarchies": [
      {
        "id": "String",
        "name": "String"
      }
    ],
    ...
  }

  L'ID de hiérarchie est la valeur id d'une hiérarchie dans la liste des hiérarchies de ressources.

Une fois que vous avez l'ID de hiérarchie, vous pouvez associer ou dissocier une ressource à/de cette hiérarchie.

Pour associer un actif enfant à un actif parent, utilisez l'AssociateAssetsopération. Pour dissocier un actif enfant d'un actif parent, utilisez l'DisassociateAssetsopération. Spécifiez les paramètres suivants, qui sont les mêmes pour les deux opérations :

• assetId— L'ID de l'actif parent ou l'ID externe.

• hierarchyId— L'ID de hiérarchie ou l'ID externe de la ressource parent.

• childAssetId— L'identifiant ou l'identifiant externe de l'actif enfant.

Pour associer un actif (AWS CLI)

• Exécutez la commande suivante pour associer une ressource enfant à une ressource parent. Remplacez parent-asset-id, hierarchy-id, et child-asset-id avec les éléments suivants IDs :

  aws iotsitewise associate-assets \
    --asset-id parent-asset-id \
    --hierarchy-id hierarchy-id \
    --child-asset-id child-asset-id

Pour dissocier un actif ()AWS CLI

• Exécutez la commande suivante pour dissocier une ressource enfant d'une ressource parent. Remplacez parent-asset-id, hierarchy-id, et child-asset-id avec les éléments suivants IDs :

  aws iotsitewise disassociate-assets \
    --asset-id parent-asset-id \
    --hierarchy-id hierarchy-id \
    --child-asset-id child-asset-id