AWS IoT TwinMaker Massenoperationen - AWS IoT TwinMaker
Schlüsselkonzepte und Terminologie

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS IoT TwinMaker Massenoperationen

Verwenden Sie eine metadataTransferJob , um Ihre AWS IoT TwinMaker Ressourcen in großem Umfang zu übertragen und zu verwalten. Mit einem metadataTransferJob können Sie Massenoperationen durchführen und Ressourcen zwischen AWS IoT TwinMaker und AWS IoT SiteWise Amazon S3 übertragen.

Sie können Massenoperationen in den folgenden Szenarien verwenden:

  • Massenmigration von Komponenten und Daten zwischen Konten, z. B. Migration von einem Entwicklungskonto zu einem Produktionskonto.

  • Umfangreiches Asset-Management, z. B. das Hochladen und Bearbeiten von AWS IoT Assets in großem Umfang.

  • Massenimport Ihrer Komponenten in AWS IoT TwinMaker und AWS IoT SiteWise.

  • Massenimport von AWS IoT TwinMaker Entitäten aus vorhandenen Ontologiedateien wie - revit oder -BIMDateien.

Themen

Schlüsselkonzepte und Terminologie

AWS IoT TwinMaker -Massenoperationen verwenden die folgenden Konzepte und Terminologie:

  • Importieren von : Die Aktion zum Verschieben von Ressourcen in einen AWS IoT TwinMaker -Workspace. Zum Beispiel aus einer lokalen Datei, einer Datei in einem Amazon S3-Bucket oder aus AWS IoT SiteWise einem - AWS IoT TwinMaker Workspace.

  • Exportieren von : Die Aktion zum Verschieben von Ressourcen aus einem AWS IoT TwinMaker -Workspace zu einem lokalen Computer oder einem Amazon S3-Bucket.

  • Quelle : Der Ausgangspunkt, von dem aus Sie Ressourcen verschieben möchten.

    Ein Amazon S3-Bucket ist beispielsweise eine Importquelle und ein - AWS IoT TwinMaker Workspace ist eine Exportquelle.

  • Ziel : Der gewünschte Speicherort, an den Sie Ihre Ressourcen verschieben möchten.

    Ein Amazon S3-Bucket ist beispielsweise ein Exportziel und ein - AWS IoT TwinMaker Workspace ist ein Importziel.

  • AWS IoT SiteWise Schema : Ein Schema, das zum Importieren und Exportieren von Ressourcen in und aus verwendet wird AWS IoT SiteWise.

  • AWS IoT TwinMaker Schema : Ein Schema, das zum Importieren und Exportieren von Ressourcen in und aus verwendet wird AWS IoT TwinMaker.

  • AWS IoT TwinMaker Ressourcen der obersten Ebene: Ressourcen, die in vorhandenen APIs verwendet werden. Insbesondere eine -Entität oder eine ComponentType.

  • AWS IoT TwinMaker Ressourcen auf Unterebene: Verschachtelte Ressourcentypen, die in Metadatendefinitionen verwendet werden. Insbesondere eine Komponente .

  • Metadaten: Schlüsselinformationen, die für den erfolgreichen Import oder Export von - AWS IoT SiteWise und - AWS IoT TwinMaker Ressourcen erforderlich sind.

  • metadataTransferJob: Das Objekt, das erstellt wurde, wenn Sie ausführenCreateMetadataTransferJob.

AWS IoT TwinMaker metadataTransferJob Funktionalität

In diesem Thema wird das AWS IoT TwinMaker folgende Verhalten erläutert, wenn Sie einen Massenvorgang ausführen – wie ein verarbeitet metadataTransferJob wird. Außerdem wird erläutert, wie Sie ein Schema mit den Metadaten definieren, die für die Übertragung Ihrer resources. AWS IoT TwinMaker bulk-Operationen erforderlich sind, und wie Sie die folgenden Funktionen unterstützen:

  • Erstellen oder Ersetzen von Ressourcen der obersten Ebene: AWS IoT TwinMaker erstellt neue Ressourcen oder ersetzt alle vorhandenen Ressourcen, die eindeutig durch eine Ressourcen-ID identifiziert werden.

    Wenn beispielsweise eine Entität im System vorhanden ist, wird die Entitätsdefinition durch die neue ersetzt, die in der Vorlage unter dem Entity Schlüssel definiert ist.

  • Erstellen oder Ersetzen einer Subressource:

    Auf der EntityComponent Ebene können Sie nur eine Komponente erstellen oder ersetzen. Die Entität muss bereits vorhanden sein, andernfalls erzeugt die Aktion eine ValidationException.

    Auf Eigenschafts- oder Beziehungsebene können Sie nur eine Eigenschaft oder Beziehung erstellen oder ersetzen, und das enthaltende EntityComponent muss bereits vorhanden sein.

  • Löschen einer Subressource:

    AWS IoT TwinMaker unterstützt auch das Löschen von Unterressourcen. Eine Unterressource kann eine Komponente, Eigenschaft oder Beziehung sein.

    Wenn Sie eine Komponente löschen möchten, müssen Sie dies auf Entitätsebene tun.

    Wenn Sie eine Eigenschaft oder Beziehung löschen möchten, müssen Sie dies von der Entität oder EntityComponent Ebene aus tun.

    Um eine Unterressource zu löschen, aktualisieren Sie die übergeordnete Ressource und lassen die Definition der Unterressource weg.

  • Keine Löschung von Ressourcen der obersten Ebene: AWS IoT TwinMaker löscht niemals Ressourcen der obersten Ebene. Eine Ressource der obersten Ebene bezieht sich auf eine Entität oder ComponentType.

  • Keine Subressourcendefinitionen für dieselbe Ressource der obersten Ebene in einer Vorlage:

    Sie können die vollständige Entitätsdefinition und die Unterressourcendefinition (wie Eigenschaft) derselben Entität nicht in derselben Vorlage angeben.

    Wenn eine entityId in Entity verwendet wird, können Sie nicht dieselbe ID in Entity, EntityComponentEigenschaft oder Beziehung verwenden.

    Wenn eine Kombination aus entityId oder componentName in verwendet wird EntityComponent, können Sie nicht dieselbe Kombination in EntityComponent, Eigenschaft oder Beziehung verwenden.

    Wenn eine Kombination aus entityId ,componentName und propertyName in Eigenschaft oder Beziehung verwendet wird, können Sie nicht dieselbe Kombination in der Eigenschaft oder Beziehung verwenden.

  • ExternalId ist optional für AWS IoT TwinMaker: Die ExternalId kann verwendet werden, um Ihnen bei der Identifizierung Ihrer -Ressourcen zu helfen.