Atualizar valores de atributo

Os ativos herdam os atributos de seu modelo de ativo, incluindo o valor padrão do atributo. Em alguns casos, é melhor deixar o atributo padrão do modelo de ativo, como uma propriedade do fabricante do ativo. Em outros casos, é melhor substituir o atributo herdado, como a latitude e a longitude de um ativo.

Atualizar um valor de atributo (console)

Você pode usar o console do AWS IoT SiteWise para atualizar o valor de uma propriedade de ativo de atributo.

Como atualizar o valor de um atributo (console)

1. Navegue até o console do AWS IoT SiteWise.

2. No painel de navegação, selecione Ativos.

3. Escolha o ativo para o qual deseja atualizar um atributo.

   dica

   Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

   

4. Escolha Edit (Editar).

5. Localize o atributo a ser atualizado e insira seu novo valor.

   

6. Escolha Save (Salvar).

Atualizar um valor de atributo (CLI)

Você pode usar a AWS Command Line Interface (AWS CLI) para atualizar um valor de atributo.

Para executar este procedimento, é necessário saber quais são o assetId do ativo e o propertyId da propriedade. Se você criou um ativo, mas não sabeassetId, use a ListAssetsoperação para visualizar todos os seus ativos para um modelo específico. Em seguida, use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo IDs de propriedade.

Use a operação BatchPutAssetPropertyValue para atribuir valores de atributo ao ativo. É possível usar essa operação para definir vários atributos de uma vez. A carga útil dessa operação contém uma lista de entradas, e cada entrada contém o ID do ativo, o ID da propriedade e o valor do atributo.

Como atualizar o valor de um atributo (CLI)

1. Crie um arquivo chamado batch-put-payload.json e copie o seguinte objeto JSON no arquivo. Este exemplo de carga útil demonstra como definir a latitude e a longitude de uma turbina eólica. Atualize os IDs, os valores e os time stamps para modificar a carga útil do 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 na carga contém um entryId que você pode definir como qualquer string exclusiva. Se qualquer entrada de solicitação falhar, cada erro conterá o entryId da solicitação correspondente, para que você saiba quais solicitações tentar novamente.

   Para definir um valor de atributo, você pode incluir uma estrutura timestamp-quality-value (TQV) na lista depropertyValues para cada propriedade de atributo. Essa estrutura deve conter o novo value e o timestamp atual.

   • value— Uma estrutura que contém um dos seguintes campos, dependendo do tipo da propriedade que está sendo definida:

     • booleanValue

     • doubleValue

     • integerValue

     • stringValue

   • timestamp— Uma estrutura que contém o tempo atual da época Unix em segundos,timeInSeconds. AWS IoT SiteWiserejeita quaisquer pontos de dados com carimbos de data e hora anteriores a 7 dias ou mais recentes de 5 minutos no future.

   Para obter mais informações sobre como preparar uma carga útil para BatchPutAssetPropertyValue, consulte Ingerir dados usando a API do AWS IoT SiteWise.

2. Execute o seguinte comando para enviar os valores de atributo ao AWS IoT SiteWise.

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