Versions du modèle d'actifs - AWS IoT SiteWise
Récupérer la version active d'un modèle d'actif ou d'un modèle de composant (console)Récupérez la version active d'un modèle d'actif ou d'un modèle de composant (AWS CLI)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Versions du modèle d'actifs

AWS IoT SiteWise prend en charge le traitement asynchrone des opérations de création et de mise à jour sur les modèles d'actifs et les modèles de composants. Il met également à jour le statut du modèle.

AWS IoT SiteWise propage les modifications d'un modèle valide dans les demandes de création et de mise à jour à ses ressources dépendantes (du modèle d'actif aux actifs, ou du modèle de composant aux modèles d'actifs). Il place ensuite le modèle en ACTIVE état.

Si la définition de modèle fournie n'est pas valide, AWS IoT SiteWise place le modèle dans un FAILED état. Les modifications ne sont pas répercutées sur les ressources dépendantes. Les ressources dépendantes font référence à la dernière définition du modèle propagée lorsque le modèle était dans un ACTIVE état.

Sur la base des informations ci-dessus, les définitions de modèles comportent deux types de versions de modèle :

  1. Dernière version : dernière définition acceptée dans le cadre d'une demande de création ou de mise à jour.

  2. Version active : la dernière définition a été traitée avec succès et l'état du modèle estACTIVE.

Par défaut, les détails de la dernière version du modèle APIs sont renvoyés lorsque describe est appelé sur un modèle d'actif ou un modèle de composant. Dans certains scénarios, la version active du modèle d'actif ou du modèle de composant est requise. Consultez les exemples de scénarios ci-dessous :

  • Une opération de mise à jour dont la définition n'est pas valide place votre modèle d'actif dans un FAILED état. Vous devez annuler vos modifications en récupérant la version active du modèle d'actif et en créant une autre demande de mise à jour faisant référence à cette définition valide.

  • AWS IoT SiteWise Il existe une application permettant aux clients de consulter les actifs et leurs modèles d'actifs correspondants. Lorsqu'un utilisateur fait référence à la définition du modèle d'actif correspondant à un actif particulier et que le modèle d'actif est dans un FAILED état transitoire UPDATINGPROPAGATING, la dernière version renvoie la définition du modèle d'actif qui n'est pas encore propagée à ses actifs. Dans ce cas, vous devez récupérer la version active du modèle d'actifs auprès des clients.

Récupérer la version active d'un modèle d'actif ou d'un modèle de composant (console)

Suivez cette procédure pour récupérer la version active d'un modèle de ressource ou d'un modèle de composant dans la AWS IoT SiteWise console.

Astuce

Les modèles d'actifs et les modèles de composants sont tous deux répertoriés sous Modèles dans le volet de navigation. Le panneau Détails du modèle d'actif ou du modèle de composant sélectionné indique de quel type il s'agit.

Pour récupérer la version active d'un modèle de ressource ou d'un modèle de composant (console)

  1. Accédez à la console AWS IoT SiteWise.

  2. Dans le panneau de navigation, choisissez Models (Modèles).

  3. Choisissez le modèle pour récupérer sa version active.

    1. Si le modèle est dans un ACTIVE état, vous consultez sa version active.

    2. Si le modèle est dans un FAILED état transitoire UPDATINGPROPAGATING, recherchez la section Voir la version active sous État dans le panneau Détails.

Récupérez la version active d'un modèle d'actif ou d'un modèle de composant (AWS CLI)

Utilisez le AWS CLI pour récupérer la version active d'un modèle d'actif ou d'un modèle de composant.

Pour récupérer la version active d'un modèle d'actif ou d'un modèle de composant, utilisez l'DescribeAssetModelopération avec le assetModelVersion paramètre.

Astuce

AWS CLI définit les modèles de composants comme un type de modèle d'actif. Par conséquent, vous utilisez la même DescribeAssetModelopération pour les deux types de modèles. Le assetModelType champ de la réponse indique s'il s'agit d'un ASSET_MODEL ou d'unCOMPONENT_MODEL.

Pour récupérer la version active d'un modèle d'actif ou d'un modèle de composant (AWS CLI)

  • Exécutez la commande suivante pour décrire le modèle. Remplacez asset-model-id avec l'ID ou l'ID externe du modèle d'actif ou du modèle de composant. L'identifiant externe est un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise .

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE

    L'opération renvoie une réponse contenant les détails du modèle. La réponse contient un assetModelStatus objet dont la structure est la suivante.

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