

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
<a name="update-attribute-values"></a>

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. <a name="sitewise-open-console"></a>Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-assets"></a>No painel de navegação, selecione **Ativos**.

1. Escolha o ativo para o qual deseja atualizar um atributo.
**dica**  <a name="sitewise-expand-asset-hierarchy"></a>
Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

1. Escolha **Editar**.

1. 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.](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/sitewise-update-asset-attribute-console.png)

1. 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 conhece`assetId`, use a [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API para listar todos os ativos de um modelo específico. Use a [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operação para visualizar as propriedades do seu ativo, incluindo propriedades IDs.

Use a operação [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) 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.<a name="attribute-id-update-cli"></a>

**Como 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 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`
       + `nullValue`
     + `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](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), consulte [Ingira dados com AWS IoT SiteWise APIs](ingest-api.md).

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

------