Mettre à jour des modèles composites personnalisés (composants) - AWS IoT SiteWise
Mettre à jour un composant (console)Mettre à jour un modèle composite personnalisé (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.

Mettre à jour des modèles composites personnalisés (composants)

Vous pouvez utiliser le AWS IoT SiteWise API pour mettre à jour un modèle composite personnalisé ou la AWS IoT SiteWise console pour mettre à jour des composants.

Mettre à jour un composant (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour mettre à jour un composant.

Pour mettre à jour un 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 d'actif dans lequel se trouve le composant.

  4. Dans l'onglet Propriétés, sélectionnez Composants.

  5. Choisissez le composant que vous souhaitez mettre à jour.

  6. Choisissez Modifier.

  7. Sur la page Modifier le composant, effectuez l'une des opérations suivantes :

  8. Choisissez Save (Enregistrer).

Mettre à jour un modèle composite personnalisé (AWS CLI)

Utilisez le AWS Command Line Interface (AWS CLI) pour mettre à jour un modèle composite personnalisé.

Pour mettre à jour le nom ou la description, utilisez l'UpdateAssetModelCompositeModelopération. Pour les modèles composites personnalisés en ligne uniquement, vous pouvez également mettre à jour les propriétés. Vous ne pouvez pas mettre à jour les propriétés d'un modèle composite component-model-based personnalisé, car son modèle de composant référencé fournit les propriétés associées.

Important

Si vous supprimez une propriété d'un modèle composite personnalisé, toutes les données précédentes relatives à cette propriété sont AWS IoT SiteWise supprimées. Vous ne pouvez pas modifier le type ou le type de données d'une propriété existante.

Pour remplacer une propriété de modèle composite existante par une nouvelle propriété identiquename, procédez comme suit :

  1. Soumettez une UpdateAssetModelCompositeModel demande en supprimant l'intégralité de la propriété existante.

  2. Soumettez une deuxième UpdateAssetModelCompositeModel demande qui inclut la nouvelle propriété. La nouvelle propriété de l'actif sera la même name que la précédente et AWS IoT SiteWise générera une nouvelle propriété uniqueid.

Pour mettre à jour un modèle composite personnalisé (AWS CLI)

  1. Pour récupérer la définition du modèle composite existant, exécutez la commande suivante. Remplacez composite-model-id avec l'ID ou l'ID externe du modèle composite personnalisé à mettre à jour, et asset-model-id avec le modèle d'actif auquel le modèle composite personnalisé est associé. Pour plus d’informations, consultez le AWS IoT SiteWise Guide de l’utilisateur .

    1. Exécutez la commande ci-dessous :

      aws iotsitewise describe-asset-model-composite-model \
--asset-model-composite-model-id composite-model-id \
--asset-model-id asset-model-id

    2. La commande ci-dessus renvoie la définition du modèle composite correspondant à la dernière version du modèle associé. Dans le cas d'utilisation où un modèle d'actif est dans un FAILED état, récupérez la définition de modèle valide correspondant à sa version active pour créer votre demande de mise à jour. Consultez Versions du modèle d'actifs pour plus de détails.

    3. Exécutez la commande suivante pour récupérer la définition du modèle actif :

      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

    4. Pour plus d'informations, consultez l'DescribeAssetModelCompositeModelopération.

  2. Créez un fichier appeléupdate-custom-composite-model.json, puis copiez la réponse de la commande précédente dans le fichier.

  3. Supprimez toutes les paires clé-valeur de l'JSONobjet, à update-custom-composite-model.json l'exception des champs suivants :

    • assetModelCompositeModelName

    • assetModelCompositeModelDescription(si présent)

    • assetModelCompositeModelProperties(si présent)

  4. Dans update-custom-composite-model.json, effectuez l’une des actions suivantes :

    • Modifiez la valeur deassetModelCompositeModelName.

    • AjoutezassetModelCompositeModelDescription, supprimez ou modifiez sa valeur.

    • Pour les modèles composites personnalisés en ligne uniquement : modifiez, ajoutez ou supprimez l'une des propriétés du modèle d'actif dansassetModelCompositeModelProperties.

    Pour plus d'informations sur le format requis pour ce fichier, consultez la syntaxe de demande pour UpdateAssetModelCompositeModel.

  5. Exécutez la commande suivante pour mettre à jour le modèle composite personnalisé avec la définition stockée dansupdate-custom-composite-model.json. Remplacez composite-model-id avec l'ID du modèle composite, et asset-model-id avec l'ID du modèle d'actif dans lequel il se trouve.

    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
Important

Lorsque plusieurs utilisateurs mettent à jour un modèle d'actif en même temps, les modifications apportées par un utilisateur peuvent être annulées par inadvertance par un autre utilisateur. Pour éviter cela, vous devez définir une demande de mise à jour conditionnelle. Consultez Verrouillage optimiste pour les écrits sur le modèle d'actifs.