Mise à jour de modèles composites personnalisés (composants)

Vous pouvez utiliser l' AWS IoT SiteWise API pour mettre à jour un modèle composite personnalisé ou la AWS IoT SiteWise console pour mettre à jour les 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 :

   • Dans Informations relatives au modèle, modifiez le nom du modèle.

   • Modifiez l'une des définitions d'attribut. Vous ne pouvez pas modifier le type de données des attributs existants. Pour plus d’informations, consultez Définition de données statiques (attributs).

   • Modifiez l'une des définitions de mesure. Vous ne pouvez pas modifier le type de données des mesures existantes. Pour plus d’informations, consultez Définition des flux de données provenant des équipements (mesures).

   • Modifiez l'une des définitions de transformation. Pour plus d’informations, consultez Transformation des données (transformations).

   • Modifiez l'une des définitions de métrique. Vous ne pouvez pas modifier l'intervalle de temps des métriques existantes. Pour plus d’informations, consultez Agrégation de données provenant de propriétés et d'autres actifs (métriques).

8. Choisissez Enregistrer.

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

Vous pouvez utiliser 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'opération UpdateAssetModelCompositeModel. 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 par l'ID ou l'ID externe du modèle composite personnalisé à mettre à jour, et asset-model-id par le modèle d'actif auquel le modèle composite personnalisé est associé. Pour plus d'informations, consultez le guide de AWS IoT SiteWise l'utilisateur.

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

   Pour plus d'informations, reportez-vous à la section Fonctionnement du DescribeAssetModelCompositemodèle.

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'objet JSON, à 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 par l'ID du modèle composite et asset-model-id par 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