Configurazione di un valore di soglia ()AWS CLI

È possibile utilizzare AWS Command Line Interface (AWS CLI) per aggiornare il valore dell'attributo che specifica il valore di soglia di un allarme.

Per completare questa procedura, è necessario conoscere l'elemento assetId dell'asset e l'elemento propertyId della proprietà. Puoi anche usare l'ID esterno. Se hai creato una risorsa e non la conosciassetId, utilizza l'ListAssetsAPI per elencare tutte le risorse per un modello specifico. Utilizzate l'DescribeAssetoperazione per visualizzare le proprietà della risorsa, compresi gli ID delle proprietà.

Utilizzate l'BatchPutAssetPropertyValueoperazione per assegnare i valori degli attributi alla risorsa. È possibile utilizzare questa operazione per impostare più attributi contemporaneamente. Il payload di questa operazione include un elenco di voci, ciascuna delle quali contenente l'ID asset, l'ID proprietà e il valore dell'attributo.

Per aggiornare il valore di un attributo ()AWS CLI

1. Crea un file denominato batch-put-payload.json e copia il seguente oggetto JSON nel file. Questo esempio di payload mostra come impostare la latitudine e la longitudine di una turbina eolica. Aggiorna gli ID, i valori e i timestamp per modificare il payload per il tuo caso d'uso.

   {
     "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
             }
           }
         ]
       }
     ]
   }

   • Ogni voce nel payload contiene un entryId che è possibile definire come una qualsiasi stringa univoca. Se una richiesta non riesce, ciascun errore conterrà l'entryId della richiesta corrispondente in modo che sia possibile sapere quale richiesta riprovare.

   • Per impostare il valore di un attributo, è possibile includere una struttura timestamp-quality-value (TQV) nell'elenco di ogni proprietà dell'propertyValuesattributo. Questa struttura deve contenere il nuovo value e il timestamp corrente.

     • value— Una struttura che contiene uno dei seguenti campi, a seconda del tipo di proprietà impostata:

       • booleanValue

       • doubleValue

       • integerValue

       • stringValue

     • timestamp— Una struttura che contiene l'ora attuale dell'epoca Unix in secondi,. timeInSeconds AWS IoT SiteWise rifiuta tutti i punti dati con timestamp che esistevano da più di 7 giorni nel passato o più recenti di 5 minuti nelle future.

   Per ulteriori informazioni su come preparare un payload per, consulta. BatchPutAssetPropertyValueAcquisizione di dati tramite l'API AWS IoT SiteWise

2. Eseguite il comando seguente per inviare i valori degli attributi a AWS IoT SiteWise:

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