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 en vrac avec actifs et modèles
Pour travailler avec un grand nombre d'actifs 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 des actifs ou des modèles d'actifs dans un compartiment Amazon S3, et utiliser l'importation en masse pour les créer ou les mettre à jour dans AWS IoT SiteWise. Sinon, si vous disposez d'un grand nombre d'actifs ou de modèles d'actifs AWS IoT SiteWise, vous pouvez les exporter vers Amazon S3.
Note
Vous effectuez des opérations en masse AWS IoT SiteWise en appelant des opérations dans l' 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.
Concepts clés et terminologie
AWS IoT SiteWise les fonctionnalités d'importation et d'exportation en masse 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 : emplacement 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.
-
Top-level ressource : AWS IoT SiteWise ressource que vous pouvez créer ou mettre à jour individuellement, telle qu'une ressource ou un modèle d'actif.
-
Sub-resource: ressource imbriquée dans 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 les modèles d'actifs sont des exemples de métadonnées.
-
métadonnées TransferJob : 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 groupée. Les opérations groupées prennent en charge les fonctionnalités suivantes :
-
Top-level création de ressources : lorsque vous importez un actif ou un modèle d'actif qui ne définit pas d'identifiant, ou dont l'ID ne correspond pas à celui d'un actif existant, il est créé en tant que nouvelle ressource.
-
Top-level remplacement de ressource : lorsque vous importez un actif ou un modèle d'actif dont l'ID correspond à un actif existant, il remplace la ressource existante.
-
Création, remplacement ou suppression de sous-ressources : lorsque votre importation remplace une ressource de niveau supérieur telle qu'une ressource 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 d'actif lors d'une importation en masse 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é qui était présente dans l'original, la propriété est supprimée.
-
Aucune suppression de ressource 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.
