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 das verwenden AWS IoT SiteWise API, 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 Edit (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 AWS Command Line Interface (AWS CLI), um ein benutzerdefiniertes Verbundmodell zu aktualisieren.

Verwenden Sie die UpdateAssetModelCompositeModelOperation, um den Namen oder die Beschreibung zu aktualisieren. Nur für benutzerdefinierte Verbundwerkstoffmodelle können Sie auch die Eigenschaften aktualisieren. Sie können die Eigenschaften eines component-model-based benutzerdefinierten Verbundmodells nicht aktualisieren, da das referenzierte Komponentenmodell die zugehörigen Eigenschaften bereitstellt.

Wichtig

Wenn Sie eine Eigenschaft aus einem benutzerdefinierten Verbundmodell entfernen, AWS IoT SiteWise werden alle vorherigen Daten für diese Eigenschaft 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 neue Eigenschaft mit derselben name zu ersetzen:

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

  2. Reichen Sie eine zweite UpdateAssetModelCompositeModel Anfrage ein, die die neue Immobilie umfasst. Die neue Objekteigenschaft hat dieselbe Eigenschaft name wie die vorherige 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 eines zusammengesetzten Modells abzurufen. Ersetzen composite-model-id mit der ID oder der externen ID des benutzerdefinierten Verbundmodells, das aktualisiert werden soll, und asset-model-id mit dem Asset-Modell, 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. Für einen Anwendungsfall, in dem sich ein Asset-Modell in einem FAILED Status befindet, rufen Sie die gültige Modelldefinition ab, die der aktiven Version entspricht, um Ihre Aktualisierungsanforderung zu erstellen. Details dazu finden Sie unter Versionen von Asset-Modellen.

    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 DescribeAssetModelCompositeModelOperation.

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

  3. Entfernen Sie alle Schlüssel-Wert-Paare 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 Inline-Verbundmodelle: Ändern, hinzufügen oder entfernen Sie alle Eigenschaften des Asset-Modells 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. Ersetzen composite-model-id mit der ID des zusammengesetzten Modells und asset-model-id mit der ID des Asset-Modells, 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 Optimistisches Sperren für Asset-Modell-Schreibvorgänge.