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.

Updating an attribute value (console)

Você pode usar o AWS IoT SiteWise console 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. Selecione a opção Editar.

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

   

6. Selecione Salvar.

Updating an attribute value (AWS CLI)

Você pode usar o 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. Você também pode usar o ID externo. Se você criou um ativo e não o conheceassetId, use a ListAssetsAPI para listar todos os ativos de um modelo específico. Use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo IDs de propriedade.

Use a BatchPutAssetPropertyValueoperação para atribuir valores de atributos ao seu 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 a ID do ativo, a ID da propriedade e o valor do atributo.

Para atualizar o valor de um atributo (AWS 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 as IDs, os valores e as funções de horas 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 de propertyValues para cada propriedade de atributo. Essa estrutura deve conter o novo value e o timestamp atual.

     • value – uma estrutura contendo um dos valores a seguir, a depender do tipo de propriedade sendo definida:

       • booleanValue

       • doubleValue

       • integerValue

       • stringValue

     • timestamp— Uma estrutura que contém o tempo atual da época do Unix em segundos,. timeInSeconds AWS IoT SiteWise rejeita todos os pontos de dados com carimbos de data/hora que existiam há mais de 7 dias ou menos de 5 minutos no futuro.

   Para obter mais informações sobre como preparar uma carga útil para BatchPutAssetPropertyValue, consulteIngestão de dados usando a API AWS IoT SiteWise.

2. Execute o comando a seguir para enviar os valores dos atributos para AWS IoT SiteWise:

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