View a markdown version of this page

Versionen des Anlagenmodells - AWS IoT SiteWise
Rufen Sie die aktive Version eines Asset- oder Komponentenmodells (Konsole) abRuft die aktive Version eines Asset- oder Komponentenmodells ab (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.

Versionen des Anlagenmodells

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 die zugehörigen Ressourcen (vom Anlagenmodell an die Anlagen oder vom Komponentenmodell an die Anlagenmodelle). Anschließend wird das Modell in den ACTIVE Status versetzt.

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

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

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

  2. Aktive Version — Die neueste Definition wurde erfolgreich verarbeitet, und der Modellstatus istACTIVE.

Standardmäßig werden Details zur neuesten Version des Modells zurückgegeben, wenn Describe-APIs für ein Asset- oder Komponentenmodell aufgerufen werden. 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 Anlagenmodells abrufen und eine weitere Aktualisierungsanforderung erstellen, die sich auf diese gültige Definition bezieht.

  • AWS IoT SiteWise Es gibt eine Anwendung auf, in der Kunden Anlagen und ihre entsprechenden Anlagenmodelle einsehen können. Wenn ein Benutzer auf die Anlagenmodelldefinition verweist, die einer bestimmten Anlage entspricht, und sich das Anlagenmodell in einem vorübergehenden FAILED Zustand befindet UPDATINGPROPAGATING, 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.

Rufen Sie die aktive Version eines Asset- oder Komponentenmodells (Konsole) ab

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

Tipp

Sowohl Anlagenmodelle als auch Komponentenmodelle sind 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. Navigieren Sie zur AWS IoT SiteWise -Konsole.

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

  3. Wählen Sie das Modell aus, um die aktive Version abzurufen.

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

    2. Wenn sich das Modell in einem vorübergehenden FAILED Zustand befindet UPDATINGPROPAGATING, finden Sie im Bereich Details unter Status die Option Aktive Version anzeigen.

Ruft die aktive Version eines Asset- oder Komponentenmodells ab (AWS CLI)

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

Verwenden Sie die DescribeAssetModel Operation mit dem assetModelVersion Parameter, um die aktive Version eines Anlagen- oder Komponentenmodells abzurufen.

Tipp

Das AWS CLI definiert Komponentenmodelle als eine Art von Anlagenmodell. Daher verwenden Sie dieselbe DescribeAssetModel Operation für beide Modelltypen. Das assetModelType Feld in der Antwort gibt an, ob es sich um eine ASSET_MODEL oder eine handeltCOMPONENT_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-idErsetzen 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 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 Modelldetails zurück. Die Antwort enthält ein assetModelStatus Objekt mit der folgenden Struktur.

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