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)
<a name="update-custom-composite-models"></a>

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.

**Topics**
+ [

## Mettre à jour un composant (console)
](#update-custom-composite-model-console)
+ [

## Mettre à jour un modèle composite personnalisé (AWS CLI)
](#update-custom-composite-model-cli)

## Mettre à jour un composant (console)
<a name="update-custom-composite-model-console"></a>

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

**Pour mettre à jour un composant (console)**

1. <a name="sitewise-open-console"></a>Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>Dans le panneau de navigation, choisissez **Models (Modèles)**.

1. Choisissez le modèle d'actif dans lequel se trouve le composant.

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

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

1. Choisissez **Modifier**.

1. 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 de plus amples informations, veuillez consulter [Définir des données statiques (attributs)](attributes.md).
   + Modifiez l'une des **définitions de mesure**. Vous ne pouvez pas modifier le **type de données** des mesures existantes. Pour de plus amples informations, veuillez consulter [Définir les flux de données provenant de l'équipement (mesures)](measurements.md).
   + Modifiez l'une des **définitions de transformation**. Pour de plus amples informations, veuillez consulter [Transformer les données (transformations)](transforms.md).
   + Modifiez l'une des **définitions de métrique**. Vous ne pouvez pas modifier l'**intervalle de temps** des métriques existantes. Pour de plus amples informations, veuillez consulter [Données agrégées provenant de propriétés et d'autres actifs (métriques)](metrics.md).

1. Choisissez **Enregistrer**.

## Mettre à jour un modèle composite personnalisé (AWS CLI)
<a name="update-custom-composite-model-cli"></a>

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'[UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)opé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é identique`name`, procédez comme suit :  
Soumettez une `UpdateAssetModelCompositeModel` demande en supprimant l'intégralité de la propriété existante.
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é unique`id`.

**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-le *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 l’utilisateur AWS IoT SiteWise *.

   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
      ```

   1.  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](model-active-version.md) pour plus de détails. 

   1. 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
      ```

   1. Pour plus d'informations, consultez l'[DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html)opération.

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

1. 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)

1. Dans `update-custom-composite-model.json`, effectuez l’une des actions suivantes :
   + Modifiez la valeur de`assetModelCompositeModelName`.
   + Ajoutez`assetModelCompositeModelDescription`, 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 dans`assetModelCompositeModelProperties`.

   Pour plus d'informations sur le format requis pour ce fichier, consultez la syntaxe de demande pour [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html).

1. Exécutez la commande suivante pour mettre à jour le modèle composite personnalisé avec la définition stockée dans`update-custom-composite-model.json`. *composite-model-id*Remplacez-le 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
   ```

**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](opt-locking-for-model.md).