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.
**Topics**
+ [Aktualisieren Sie eine Komponente (Konsole)](#update-custom-composite-model-console)
+ [Aktualisieren Sie ein benutzerdefiniertes Verbundmodell (AWS CLI)](#update-custom-composite-model-cli)
## 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](https://console.aws.amazon.com/iotsitewise/).
1. Klicken Sie im Navigationsbereich auf **Models (Modelle)**.
1. Wählen Sie das Asset-Modell aus, in dem sich die Komponente befindet.
1. Wählen Sie auf der ** Registerkarte ** Eigenschaften die Option ** Komponenten aus**.
1. Wählen Sie die Komponente aus, die Sie aktualisieren möchten.
1. Wählen Sie **Bearbeiten** aus.
1. Führen Sie auf der ** Seite ** „Komponente bearbeiten“ einen der folgenden Schritte aus:
+ Ändern Sie unter **Modelldetails** die Angabe unter **Name** für das Modell.
+ Ändern Sie eine der **Attributdefinitionen**. Sie können den **Datentyp** vorhandener Attribute nicht ändern. Weitere Informationen finden Sie unter [Definieren Sie statische Daten (Attribute)](attributes.md).
+ Ändern Sie eine der **Messungsdefinitionen**. Sie können den **Datentyp** vorhandener Messungen nicht ändern. Weitere Informationen finden Sie unter [Definieren Sie Datenströme von Geräten (Messungen)](measurements.md).
+ Ändern Sie eine der **Transformationsdefinitionen**. Weitere Informationen finden Sie unter [Daten transformieren (Transformationen)](transforms.md).
+ Ändern Sie eine der **Metrikdefinitionen**. Sie können das **Zeitintervall** vorhandener Metriken nicht ändern. Weitere Informationen finden Sie unter [Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken)](metrics.md).
1. 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 ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html) 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 neue`name`, identische Eigenschaft zu ersetzen:
Reichen Sie eine `UpdateAssetModelCompositeModel` Anfrage ein, bei der die gesamte vorhandene Eigenschaft entfernt wird.
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 Unikat`id`.
**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-id}}Ersetzen 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}}
```
1. 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](model-active-version.md).
1. 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
```
1. Weitere Informationen finden Sie unter dem Vorgang [DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html).
1. Erstellen Sie eine Datei mit dem Namen `update-custom-composite-model.json` und kopieren Sie dann die Antwort des vorherigen Befehls in die Datei.
1. 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)
1. Führen Sie in `update-custom-composite-model.json` eine der folgenden Aufgaben durch:
+ Ändern Sie den Wert von`assetModelCompositeModelName`.
+ Fügen Sie den Wert hinzu`assetModelCompositeModelDescription`, entfernen Sie ihn oder ändern Sie ihn.
+ Nur für benutzerdefinierte zusammengesetzte Inline-Modelle: Ändern, Hinzufügen oder Entfernen von Eigenschaften des Objektmodells in`assetModelCompositeModelProperties`.
Weitere Informationen zum erforderlichen Format für diese Datei finden Sie in der Anforderungssyntax für [ UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html).
1. Führen Sie den folgenden Befehl aus, um das benutzerdefinierte Verbundmodell mit der in gespeicherten Definition zu aktualisieren`update-custom-composite-model.json`. {{composite-model-id}}Ersetzen 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](opt-locking-for-model.md).