Atualizar valores de atributo - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 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.

    
                        AWS IoT SiteWise Captura de tela da página “Editar ativo” com um valor de atributo destacado.
  6. Escolha Salvar.

Atualizando um valor de atributo (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, mas não o conheceassetId, use a ListAssetsAPI para visualizar todos os seus ativos de um modelo específico. Em seguida, use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo os IDs da 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 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, consulte Ingestã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