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.

# Versionen von Asset-Modellen
<a name="model-active-version"></a>

 AWS IoT SiteWise unterstützt die asynchrone Verarbeitung von Erstellungs- und Aktualisierungsvorgängen für Anlagenmodelle und Komponentenmodelle. Außerdem wird der Status des Modells aktualisiert. 

 AWS IoT SiteWise überträgt die Änderungen eines gültigen Modells in den Erstellungs- und Aktualisierungsanforderungen an seine abhängigen Ressourcen (vom Asset-Modell zu den Assets oder vom Komponentenmodell zu den Asset-Modellen). Anschließend wird das Modell in den `ACTIVE` Status versetzt. 

 Wenn die angegebene Modelldefinition ungültig ist, AWS IoT SiteWise wird das Modell in einen `FAILED` Status versetzt. Die Änderungen werden nicht auf die abhängigen Ressourcen übertragen. Die abhängigen Ressourcen beziehen sich auf die letzte Modelldefinition, die propagiert wurde, als sich das Modell in einem `ACTIVE` bestimmten Zustand befand. 

 Basierend auf den obigen Informationen gibt es für Modelldefinitionen zwei Arten von Modellversionen: 

1. **Letzte Version —** Die neueste Definition, die als Teil einer Erstellungs- oder Aktualisierungsanforderung akzeptiert wurde.

1. **Aktive Version —** Die neueste Definition wurde erfolgreich verarbeitet, und der Modellstatus ist`ACTIVE`.

 Standardmäßig werden Details zur neuesten Version des Modells zurückgegeben, wenn describe APIs für ein Asset- oder Komponentenmodell aufgerufen wird. Es gibt Szenarien, in denen die aktive Version des Asset- oder Komponentenmodells benötigt wird. Nachfolgend finden Sie Beispielszenarien: 
+  Ein Aktualisierungsvorgang mit einer ungültigen Definition versetzt Ihr Anlagenmodell in einen `FAILED` Zustand. Sie müssen Ihre Änderungen rückgängig machen, indem Sie die aktive Version des Asset-Modells abrufen und eine weitere Aktualisierungsanforderung erstellen, die auf diese gültige Definition verweist. 
+  AWS IoT SiteWise Es gibt eine Anwendung, in der Kunden Anlagen und ihre entsprechenden Anlagenmodelle einsehen können. Wenn ein Benutzer auf die Definition des Anlagenmodells verweist, die einer bestimmten Anlage entspricht, und sich das Anlagenmodell in einem vorübergehenden `FAILED` Zustand befindet `UPDATING``PROPAGATING`, gibt die neueste Version die Anlagenmodelldefinition zurück, die noch nicht auf die Anlagen übertragen wurde. In diesem Fall müssen Sie die aktive Version des Anlagenmodells für Kunden abrufen. 

**Topics**
+ [Rufen Sie die aktive Version eines Asset- oder Komponentenmodells (Konsole) ab](#active-console)
+ [Rufen Sie die aktive Version eines Asset- oder Komponentenmodells ab ()AWS CLI](#active-cli)

## Rufen Sie die aktive Version eines Asset- oder Komponentenmodells (Konsole) ab
<a name="active-console"></a>

Gehen Sie wie folgt vor, um die aktive Version eines Asset- oder Komponentenmodells in der AWS IoT SiteWise Konsole abzurufen.

**Tipp**  
Objektmodelle und Komponentenmodelle werden beide im Navigationsbereich unter **Modelle** aufgeführt. Der Bereich „**Details**“ des ausgewählten Asset- oder Komponentenmodells gibt an, um welchen Typ es sich handelt.

**Um die aktive Version eines Asset- oder Komponentenmodells (Konsole) abzurufen**

1. <a name="sitewise-open-console"></a>Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>Klicken Sie im Navigationsbereich auf **Models (Modelle)**.

1. Wählen Sie das Modell aus, dessen aktive Version abgerufen werden soll.

   1.  Wenn sich das Modell in einem `ACTIVE` Status befindet, wird die aktive Version angezeigt. 

   1.  Wenn sich das Modell in einem vorübergehenden `FAILED` Zustand befindet `UPDATING``PROPAGATING`, suchen Sie im Bereich **Details** unter **Status** nach der Option **Aktive Version** anzeigen. 

## Rufen Sie die aktive Version eines Asset- oder Komponentenmodells ab ()AWS CLI
<a name="active-cli"></a>

Verwenden Sie die AWS CLI , um die aktive Version eines Asset- oder Komponentenmodells abzurufen.

Verwenden Sie die [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)Operation mit dem `assetModelVersion` Parameter, um die aktive Version eines Asset- oder Komponentenmodells abzurufen.

**Tipp**  
Der AWS CLI definiert Komponentenmodelle als eine Art von Asset-Modell. Daher verwenden Sie dieselbe [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)Operation für beide Modelltypen. Das `assetModelType` Feld in der Antwort gibt an, ob es sich um ein `ASSET_MODEL` oder ein handelt`COMPONENT_MODEL`. 

**Um die aktive Version eines Asset- oder Komponentenmodells abzurufen (AWS CLI)**
+ Führen Sie den folgenden Befehl aus, um das Modell zu beschreiben. {{asset-model-id}}Ersetzen Sie es durch die ID oder die externe ID des Asset- oder Komponentenmodells. Die externe ID ist eine benutzerdefinierte ID. Weitere Informationen finden Sie unter [Referenzobjekte mit externen IDs](object-ids.md#external-id-references) im *AWS IoT SiteWise -Benutzerhandbuch*.

  ```
  aws iotsitewise describe-asset-model --asset-model-id {{asset-model-id}} --asset-model-version ACTIVE
  ```

  Die Operation gibt eine Antwort mit den Details des Modells zurück. Die Antwort enthält ein `assetModelStatus` Objekt mit der folgenden Struktur.

  ```
  {
      {{...}}
      "assetModelName": "{{string}}",
      "assetModelProperties": [ ... ],
      ...,
      "assetModelVersion": "{{string}}"
  }
  ```