Configuración de un valor umbral (AWS CLI)

Puede usar AWS Command Line Interface (AWS CLI) para actualizar el valor del atributo que especifica el valor umbral de una alarma.

Debe conocer los assetId de sus activos y los propertyId de las propiedades para completar este procedimiento. También puede usar el ID externo. Si has creado un activo y no lo sabesassetId, usa la ListAssetsAPI para enumerar todos los activos de un modelo específico. Utilice la DescribeAssetoperación para ver las propiedades de su activo, incluidos los identificadores de propiedad.

Utilice la BatchPutAssetPropertyValueoperación para asignar valores de atributos a su activo. Puede utilizar esta operación para establecer varios atributos a la vez. La carga de esta operación contiene una lista de entradas y cada una contiene el ID de activo, el ID de propiedad y el valor de atributo.

Para actualizar el valor de un atributo (AWS CLI)

1. Cree un archivo llamado batch-put-payload.json y copie el siguiente objeto JSON en el archivo. En esta carga de ejemplo se muestra cómo establecer la latitud y la longitud de una turbina eólica. Actualice los ID, los valores y las marcas temporales para modificar la carga para su caso de 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
             }
           }
         ]
       }
     ]
   }

   • Cada entrada de la carga contiene un entryId que puede definir como una única cadena. Si la entrada de la solicitud no se realiza correctamente, cada error contendrá el entryId de la solicitud correspondiente para que sepa qué solicitudes deben volver a intentarse.

   • Para establecer un valor de atributo, puede incluir una estructura timestamp-quality-value (TQV) en la lista de propiedades propertyValues de cada atributo. Esta estructura debe contener el nuevo value y la timestamp actual.

     • value: una estructura que contiene uno de los siguientes campos, en función del tipo de propiedad que se establezca:

       • booleanValue

       • doubleValue

       • integerValue

       • stringValue

     • timestamp— Una estructura que contiene el tiempo de época actual de Unix en segundos,. timeInSeconds AWS IoT SiteWise rechaza todos los puntos de datos con marcas de tiempo que hayan existido durante más de 7 días o más de 5 minutos en el futuro.

   Para obtener más información sobre cómo preparar una carga útil para BatchPutAssetPropertyValue, consulte. Ingerir datos mediante la API AWS IoT SiteWise

2. Ejecute el siguiente comando para enviar los valores de los atributos a AWS IoT SiteWise:

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