

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 les valeurs des attributs
<a name="update-attribute-values"></a>

Les ressources héritent des attributs de leur modèle de ressource, y compris la valeur par défaut de l'attribut. Dans certains cas, il vaudra mieux conserver l'attribut par défaut du modèle de ressource, par exemple pour une propriété de fabricant de ressource. Dans d'autres cas, il vaudra mieux actualiser l'attribut hérité, par exemple pour la latitude et la longitude spécifiques d'une ressource. 

------
#### [ Updating an attribute value (console) ]

Vous pouvez utiliser la AWS IoT SiteWise console pour mettre à jour la valeur d'une propriété d'actif attributaire.

**Pour mettre à jour la valeur d'un attribut (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-assets"></a>Dans le panneau de navigation, choisissez **Ressources**.

1. Choisissez la ressource pour laquelle vous souhaitez mettre à jour un attribut.
**Astuce**  <a name="sitewise-expand-asset-hierarchy"></a>
Vous pouvez cliquer sur l'icône en forme de flèche pour développer une hiérarchie de ressources afin de trouver votre ressource.

1. Choisissez **Modifier**.

1. Recherchez l'attribut à mettre à jour, puis saisissez sa nouvelle valeur.  
![AWS IoT SiteWise Capture d'écran de la page « Modifier un actif » avec une valeur d'attribut surlignée.](http://docs.aws.amazon.com/fr_fr/iot-sitewise/latest/userguide/images/sitewise-update-asset-attribute-console.png)

1. Choisissez **Enregistrer**.

------
#### [ Updating an attribute value (AWS CLI) ]

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour mettre à jour la valeur d'un attribut.

Vous devez connaître l'`assetId` de votre ressource et le `propertyId`de la propriété pour effectuer cette procédure. Vous pouvez également utiliser l'identifiant externe. Si vous avez créé un actif et que vous ne le connaissez pas`assetId`, utilisez l'[ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API pour répertorier tous les actifs d'un modèle spécifique. Utilisez cette [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)opération pour afficher les propriétés de votre actif, y compris les propriétés IDs.

Utilisez l'opération [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) pour affecter des valeurs d'attributs à votre ressource. Vous pouvez utiliser cette opération pour définir plusieurs attributs à la fois. La charge utile de cette opération contient une liste d'entrées, chacune contenant l'ID de ressource, l'ID de propriété et la valeur d'attribut.<a name="attribute-id-update-cli"></a>

**Pour mettre à jour la valeur d'un attribut (AWS CLI)**

1. Créez un fichier nommé `batch-put-payload.json` et copiez l'objet JSON suivant dans le fichier. Cet exemple de charge utile montre comment définir la latitude et la longitude d'une éolienne. Mettez à jour IDs les valeurs et les horodatages pour modifier la charge utile en fonction de votre cas d'utilisation.

   ```
   {
     "entries": [
       {
         "entryId": "windfarm3-turbine7-latitude",
         "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
         "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "propertyValues": [
           {
             "value": {
               "doubleValue": 47.6204
             },
             "timestamp": {
               "timeInSeconds": 1575691200
             }
           }
         ]
       },
       {
         "entryId": "windfarm3-turbine7-longitude",
         "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
         "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
         "propertyValues": [
           {
             "value": {
               "doubleValue": 122.3491
             },
             "timestamp": {
               "timeInSeconds": 1575691200
             }
           }
         ]
       }
     ]
   }
   ```
   + Chaque entrée de la charge utile contient un `entryId` que vous pouvez définir sous la forme d'une chaîne unique. Si des entrées de demande échouent, chaque erreur contiendra l'`entryId` de la demande correspondante afin que vous sachiez quelles demandes réessayer.
   + Pour définir une valeur d'attribut, vous pouvez inclure une structure timestamp-quality-value (TQV) dans la liste `propertyValues` pour chaque propriété d'attribut. Cette structure doit contenir le nouveau `value` et le `timestamp` actuel.
     + `value`— Structure contenant l'un des champs suivants, en fonction du type de propriété défini :
       + `booleanValue`
       + `doubleValue`
       + `integerValue`
       + `stringValue`
       + `nullValue`
     + `timestamp`— Une structure qui contient l'heure actuelle d'Unix en secondes,. `timeInSeconds` AWS IoT SiteWise rejette tous les points de données dont l'horodatage existait depuis plus de 7 jours ou moins de 5 minutes dans le futur.

   Pour de plus amples informations sur la préparation d'une charge utile pour [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), veuillez consulter [Ingérez des données avec AWS IoT SiteWise APIs](ingest-api.md).

1. Exécutez la commande suivante pour envoyer les valeurs d'attribut à AWS IoT SiteWise :

   ```
   aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
   ```

------