Versionen von Asset-Modellen - AWS IoT SiteWise
Rufen Sie die aktive Version eines Asset- oder Komponentenmodells (Konsole) abRufen Sie 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 von Asset-Modellen

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.

  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 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 Asset-Modell 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 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 Objektmodelle als auch Komponentenmodelle werden 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, dessen aktive Version abgerufen werden soll.

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

    2. Wenn sich das Modell in einem vorübergehenden FAILED Zustand befindet UPDATINGPROPAGATING, 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

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

Verwenden Sie die DescribeAssetModelOperation 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 DescribeAssetModelOperation für beide Modelltypen. Das assetModelType Feld in der Antwort gibt an, ob es sich um ein ASSET_MODEL oder ein 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. Ersetzen asset-model-id mit der ID oder der externen 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 Details des Modells zurück. Die Antwort enthält ein assetModelStatus Objekt mit der folgenden Struktur.

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