Configuration d'une valeur de seuil (AWS CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour mettre à jour la valeur de l'attribut qui indique le seuil d'une alarme.

Vous devez connaître l'assetId de votre ressource et le propertyIdde 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 pasassetId, utilisez l'ListAssetsAPI pour répertorier tous les actifs d'un modèle spécifique. Utilisez cette DescribeAssetopération pour afficher les propriétés de votre actif, y compris les identifiants de propriété.

Utilisez l'BatchPutAssetPropertyValueopération pour attribuer des valeurs d'attribut à votre actif. 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.

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 les ID, les valeurs et les horodatages pour modifier la charge utile 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 de chaque propriété propertyValues d'attribut. Cette structure doit contenir le nouveau value et le timestamp actuel.

     • value— Structure contenant l'un des champs suivants, selon le type de propriété définie :

       • booleanValue

       • doubleValue

       • integerValue

       • stringValue

     • 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 plus d'informations sur la préparation d'une charge utile pour BatchPutAssetPropertyValue, consultezIngestion de données à l'aide de l'API AWS IoT SiteWise.

2. 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