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 (transformiert)](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 das 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 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:
Reichen Sie eine `UpdateAssetModelCompositeModel` Anfrage ein, bei der die gesamte vorhandene Eigenschaft entfernt wurde.
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 Unikat`id`.
**Um ein benutzerdefiniertes Verbundmodell zu aktualisieren (AWS CLI)**
1. Führen Sie den folgenden Befehl aus, um die bestehende Definition eines zusammengesetzten Modells abzurufen. *composite-model-id*Ersetzen Sie es durch die ID oder die externe ID des benutzerdefinierten Verbundmodells, das aktualisiert werden soll, und durch das Asset-Modell, *asset-model-id* mit dem das benutzerdefinierte Verbundmodell verknüpft 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. 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](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 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)
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 Inline-Verbundmodelle: Ändern, hinzufügen oder entfernen Sie alle Eigenschaften des Asset-Modells 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 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](opt-locking-for-model.md).