View a markdown version of this page

Aktualisieren Sie benutzerdefinierte Verbundmodelle (Komponenten) - AWS IoT SiteWise
Aktualisieren Sie eine Komponente (Konsole)Aktualisieren Sie ein benutzerdefiniertes Verbundmodell (AWS CLI)

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.

Aktualisieren Sie benutzerdefinierte Verbundmodelle (Komponenten)

Sie können die AWS IoT SiteWise API verwenden, um ein benutzerdefiniertes Verbundmodell zu aktualisieren, oder die AWS IoT SiteWise Konsole, um Komponenten zu aktualisieren.

Aktualisieren Sie eine Komponente (Konsole)

Sie können die AWS IoT SiteWise Konsole verwenden, um eine Komponente zu aktualisieren.

Um eine Komponente (Konsole) zu aktualisieren

  1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

  2. Klicken Sie im Navigationsbereich auf Models (Modelle).

  3. Wählen Sie das Asset-Modell aus, in dem sich die Komponente befindet.

  4. Wählen Sie auf der Registerkarte Eigenschaften die Option Komponenten aus.

  5. Wählen Sie die Komponente aus, die Sie aktualisieren möchten.

  6. Wählen Sie Bearbeiten aus.

  7. Führen Sie auf der Seite „Komponente bearbeiten“ einen der folgenden Schritte aus:

  8. Wählen Sie Save (Speichern) aus.

Aktualisieren Sie ein benutzerdefiniertes Verbundmodell (AWS CLI)

Verwenden Sie die AWS Command Line Interface (AWS CLI), um ein benutzerdefiniertes Verbundmodell zu aktualisieren.

Verwenden Sie die UpdateAssetModelCompositeModel Operation, um den Namen oder die Beschreibung zu aktualisieren. Nur für benutzerdefinierte Verbundmodelle können Sie die Eigenschaften auch aktualisieren. Sie können die Eigenschaften eines auf einem Komponentenmodell basierenden benutzerdefinierten Verbundmodells nicht aktualisieren, da das referenzierte Komponentenmodell die zugehörigen Eigenschaften bereitstellt.

Wichtig

Wenn Sie eine Eigenschaft aus einem benutzerdefinierten zusammengesetzten Modell entfernen, werden alle vorherigen Daten für diese Eigenschaft AWS IoT SiteWise gelöscht. Sie können den Typ oder den Datentyp einer vorhandenen Eigenschaft nicht ändern.

Gehen Sie wie folgt vor, um eine vorhandene Eigenschaft eines zusammengesetzten Modells durch eine neuename, identische Eigenschaft zu ersetzen:

  1. Reichen Sie eine UpdateAssetModelCompositeModel Anfrage ein, bei der die gesamte vorhandene Eigenschaft entfernt wird.

  2. Reichen Sie eine zweite UpdateAssetModelCompositeModel Anfrage ein, die die neue Immobilie beinhaltet. Die neue Objekteigenschaft entspricht name der vorherigen und AWS IoT SiteWise generiert ein neues Unikatid.

Um ein benutzerdefiniertes Verbundmodell zu aktualisieren (AWS CLI)

  1. Führen Sie den folgenden Befehl aus, um die bestehende Definition des zusammengesetzten Modells abzurufen. composite-model-idErsetzen Sie durch die ID oder die externe ID des benutzerdefinierten zusammengesetzten Modells, das aktualisiert werden soll, und asset-model-id durch das Objektmodell, dem das benutzerdefinierte Verbundmodell zugeordnet ist. Weitere Informationen finden Sie im AWS IoT SiteWise -Benutzerhandbuch.

    1. Führen Sie den folgenden Befehl aus:

      aws iotsitewise describe-asset-model-composite-model \
--asset-model-composite-model-id composite-model-id \
--asset-model-id asset-model-id

    2. Der obige Befehl gibt die Definition des zusammengesetzten Modells zurück, die der neuesten Version des zugehörigen Modells entspricht. Rufen Sie für einen Anwendungsfall, in dem sich ein Anlagenmodell in einem FAILED Zustand befindet, die gültige Modelldefinition ab, die der aktiven Version entspricht, um Ihre Aktualisierungsanforderung zu erstellen. Details dazu finden Sie unter Versionen des Anlagenmodells.

    3. Führen Sie den folgenden Befehl aus, um die aktive Modelldefinition abzurufen:

      aws iotsitewise describe-asset-model-composite-model \
--asset-model-composite-model-id composite-model-id \
--asset-model-id asset-model-id \
--asset-model-version ACTIVE

    4. Weitere Informationen finden Sie unter dem Vorgang DescribeAssetModelCompositeModel.

  2. Erstellen Sie eine Datei mit dem Namen update-custom-composite-model.json und kopieren Sie dann die Antwort des vorherigen Befehls in die Datei.

  3. Entfernen Sie jedes Schlüssel-Wert-Paar aus dem JSON-Objekt in update-custom-composite-model.json mit Ausnahme der folgenden Felder:

    • assetModelCompositeModelName

    • assetModelCompositeModelDescription(falls vorhanden)

    • assetModelCompositeModelProperties(falls vorhanden)

  4. Führen Sie in update-custom-composite-model.json eine der folgenden Aufgaben durch:

    • Ändern Sie den Wert vonassetModelCompositeModelName.

    • Fügen Sie den Wert hinzuassetModelCompositeModelDescription, entfernen Sie ihn oder ändern Sie ihn.

    • Nur für benutzerdefinierte zusammengesetzte Inline-Modelle: Ändern, Hinzufügen oder Entfernen von Eigenschaften des Objektmodells inassetModelCompositeModelProperties.

    Weitere Informationen zum erforderlichen Format für diese Datei finden Sie in der Anforderungssyntax für UpdateAssetModelCompositeModel.

  5. Führen Sie den folgenden Befehl aus, um das benutzerdefinierte Verbundmodell mit der in gespeicherten Definition zu aktualisierenupdate-custom-composite-model.json. composite-model-idErsetzen Sie es durch die ID des zusammengesetzten Modells und asset-model-id durch die ID des Objektmodells, in dem es sich befindet.

    aws iotsitewise update-asset-model-composite-model \
--asset-model-composite-model-id composite-model-id \
--asset-model-id asset-model-id \
--cli-input-json file://update-custom-composite-model.json
Wichtig

Wenn mehrere Benutzer ein Asset-Modell gleichzeitig aktualisieren, können die Änderungen eines Benutzers versehentlich von einem anderen Benutzer überschrieben werden. Um dies zu verhindern, müssen Sie eine bedingte Aktualisierungsanforderung definieren. Siehe Optimistische Sperrung für Schreibvorgänge im Asset-Modell.