Atualizar valores de atributos - 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 atributos

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.

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

  6. Escolha 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 o ListAssetsAPIpara listar todos os ativos de um modelo específico. Use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo propriedadesIDs.

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 JSON objeto a seguir no arquivo. Este exemplo de carga útil demonstra como definir a latitude e a longitude de uma turbina eólica. Atualize os IDs valores e os carimbos de data/hora para modificar a carga útil do seu 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, consulteIngira dados usando o AWS IoT SiteWise API.

  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