Actualización de valores de atributos

Los activos heredan los atributos de su modelo de activos, incluido el valor predeterminado del atributo. En algunos casos, querrá conservar el atributo predeterminado del modelo de activos, por ejemplo para una propiedad de fabricante de activos. En otros casos, querrá actualizar el atributo heredado, como para la latitud y la longitud de un activo.

Updating an attribute value (console)

Puede utilizar la AWS IoT SiteWise consola para actualizar el valor de una propiedad de activo de atributo.

Para actualizar el valor de un atributo (consola)

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, elija Activos.

3. Elija el activo para el que desea actualizar un atributo.

   sugerencia

   Puede elegir el icono de flecha para expandir una jerarquía de activos y encontrar su activo.

4. Seleccione Editar.

5. Encuentre el atributo que desea actualizar y, a continuación, escriba su nuevo valor.

   

6. Seleccione Guardar.

Updating an attribute value (AWS CLI)

Puedes usar AWS Command Line Interface (AWS CLI) para actualizar el valor de un atributo.

Debe conocer los assetId de sus activos y los propertyId de las propiedades para completar este procedimiento. También puedes 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