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.
Opérations groupées avec actifs et modèles
Pour travailler avec un grand nombre de ressources ou de modèles d'actifs, utilisez des opérations groupées pour importer et exporter des ressources en masse vers un autre emplacement. Par exemple, vous pouvez créer un fichier de données qui définit les actifs ou les modèles d'actifs dans un compartiment Amazon S3, et utiliser l'importation en masse pour les créer ou les mettre à jour AWS IoT SiteWise. Sinon, si vous avez un grand nombre de ressources ou de modèles d'actifs AWS IoT SiteWise, vous pouvez les exporter vers Amazon S3.
Note
Vous effectuez des opérations AWS IoT SiteWise groupées dans en appelant des opérations dans le AWS IoT TwinMaker API. Vous pouvez le faire sans configurer AWS IoT TwinMaker ni créer d' AWS IoT TwinMaker espace de travail. Tout ce dont vous avez besoin, c'est d'un compartiment Amazon S3 dans lequel vous pouvez placer votre AWS IoT SiteWise contenu.
Rubriques
- Concepts clés et terminologie
- Fonctionnalités prises en charge
- Prérequis pour les opérations en masse
- Exécuter une tâche d'importation groupée
- Exécuter une tâche d'exportation groupée
- Suivi de l'avancement des tâches et gestion des erreurs
- Exemples d'importation de métadonnées
- Exemples de métadonnées d'exportation
- AWS IoT SiteWise schéma de tâche de transfert de métadonnées
Concepts clés et terminologie
AWS IoT SiteWise les fonctionnalités d'importation et d'exportation en bloc reposent sur les concepts et la terminologie suivants :
-
Importer : action qui consiste à déplacer des actifs ou des modèles d'actifs d'un fichier d'un compartiment Amazon S3 vers AWS IoT SiteWise.
-
Exporter : action qui consiste à déplacer des actifs ou des modèles AWS IoT SiteWise d'actifs depuis un compartiment Amazon S3.
-
Source : point de départ à partir duquel vous souhaitez déplacer le contenu.
Par exemple, un compartiment Amazon S3 est une source d'importation et AWS IoT SiteWise une source d'exportation.
-
Destination : emplacement souhaité vers lequel vous souhaitez déplacer votre contenu.
Par exemple, un compartiment Amazon S3 est une destination d'exportation et AWS IoT SiteWise une destination d'importation.
-
AWS IoT SiteWise Schéma : Ce schéma est utilisé pour importer et exporter des métadonnées depuis AWS IoT SiteWise.
-
Ressource de haut niveau : AWS IoT SiteWise ressource que vous pouvez créer ou mettre à jour individuellement, telle qu'un actif ou un modèle d'actif.
-
Sous-ressource : ressource imbriquée au sein d'une AWS IoT SiteWise ressource de niveau supérieur. Les exemples incluent les propriétés, les hiérarchies et les modèles composites.
-
Métadonnées : informations clés requises pour importer ou exporter des ressources avec succès. Les définitions des actifs et des modèles d'actifs sont des exemples de métadonnées.
-
metadataTransferJob: objet créé lors de l'exécution
CreateMetadataTransferJob.
Fonctionnalités prises en charge
Cette rubrique explique ce que vous pouvez faire lorsque vous exécutez une opération en masse. Les opérations groupées prennent en charge les fonctionnalités suivantes :
-
Création de ressources de haut niveau : lorsque vous importez un actif ou un modèle d'actif qui ne définit pas d'identifiant, ou dont l'identifiant ne correspond pas à celui d'un actif existant, il est créé en tant que nouvelle ressource.
-
Remplacement des ressources de haut niveau : lorsque vous importez un actif ou un modèle d'actif dont l'identifiant correspond à un actif qui existe déjà, il remplace la ressource existante.
-
Création, remplacement ou suppression de sous-ressources : lorsque votre importation remplace une ressource de haut niveau telle qu'un actif ou un modèle d'actif, la nouvelle définition remplace toutes les sous-ressources, telles que les propriétés, les hiérarchies ou les modèles composites.
Par exemple, si vous mettez à jour un modèle de ressource lors d'une importation en bloc et que la version mise à jour définit une propriété qui n'était pas présente dans l'original, une nouvelle propriété est créée. S'il définit une propriété qui existe déjà, la propriété existante sera mise à jour. Si le modèle d'actif mis à jour omet une propriété présente dans l'original, la propriété est supprimée.
-
Aucune suppression de ressources de niveau supérieur : les opérations groupées ne suppriment pas un actif ou un modèle d'actif. Les opérations groupées ne font que les créer ou les mettre à jour.
