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

# Ative as notificações de propriedades de ativos em AWS IoT SiteWise
<a name="property-notifications"></a>

Você pode ativar as notificações de propriedades para publicar atualizações de dados de ativos e AWS IoT Core, em seguida, executar consultas em seus dados. Com notificações de propriedades de ativos, AWS IoT SiteWise fornece um CloudFormation modelo que você pode usar para exportar AWS IoT SiteWise dados para o Amazon S3.

**nota**  
Os dados do ativo são enviados AWS IoT Core sempre que são recebidos AWS IoT SiteWise, independentemente de o valor ter sido alterado.

**Topics**
+ [Ativar notificações de propriedades de ativo (console)](#enable-property-notifications-console)
+ [Ativar notificações de propriedades de ativo (AWS CLI)](#enable-property-notifications-cli)

## Ativar notificações de propriedades de ativo (console)
<a name="enable-property-notifications-console"></a>

Por padrão, AWS IoT SiteWise não publica atualizações de valores de propriedades. Você pode usar o AWS IoT SiteWise console para ativar as notificações para uma propriedade do ativo.

**Como habilitar ou desabilitar notificações de propriedade de um ativo (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 habilitar as notificações de uma propriedade.
**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. Para o **Status da notificação** da propriedade de ativo, escolha **HABILITADO**.  
![\[AWS IoT SiteWise Captura de tela da página “Editar ativo” com “Status da notificação” destacado.\]](http://docs.aws.amazon.com/pt_br/iot-sitewise/latest/userguide/images/sitewise-enable-property-notifications-console.png)

   Você também pode escolher **DESABILITADO** para desabilitar notificações para a propriedade do ativo.

1. Escolha **Salvar**.

## Ativar notificações de propriedades de ativo (AWS CLI)
<a name="enable-property-notifications-cli"></a>

Por padrão, AWS IoT SiteWise não publica atualizações de valores de propriedades. Você pode usar o AWS Command Line Interface (AWS CLI) para ativar ou desativar as notificações de uma propriedade do ativo.

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 [UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html)operação para ativar ou desativar as notificações de uma propriedade do ativo. Especifique os seguintes parâmetros:
+ `assetId` – a ID do ativo.
+ `propertyId` – a ID da propriedade do ativo.
+ `propertyNotificationState` – o estado de notificação do valor da propriedade: `ENABLED` ou `DISABLED`.
+ `propertyAlias` – o alias da propriedade. Especifique o alias existente da propriedade ao atualizar o estado da notificação. Se você omitir esse parâmetro, o alias existente da propriedade será removido.

**Como habilitar ou desabilitar notificações para a propriedade de um ativo (CLI)**

1. Execute o seguinte comando para recuperar o alias da propriedade de ativo. *asset-id*Substitua pela ID do ativo e *property-id* pela ID da propriedade.

   ```
   aws iotsitewise describe-asset-property \
     --asset-id asset-id \
     --property-id property-id
   ```

   A operação retorna uma resposta que contém os detalhes da propriedade do ativo no formato a seguir. O alias da propriedade está em `assetProperty.alias` no objeto JSON.

   ```
   {
     "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
     "assetName": "Wind Turbine 7",
     "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
     "assetProperty": {
       "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
       "name": "Wind Speed",
       "alias": "/company/windfarm/3/turbine/7/windspeed",
       "notification": {
         "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "state": "DISABLED"
       },
       "dataType": "DOUBLE",
       "unit": "m/s",
       "type": {
         "measurement": {}
       }
     }
   }
   ```

1. Execute o seguinte comando para habilitar notificações para a propriedade de ativo. *property-alias*Substitua pelo alias da propriedade da resposta do comando anterior ou omita `--property-alias` a atualização da propriedade sem um alias.

   ```
   aws iotsitewise update-asset-property \
     --asset-id asset-id \
     --property-id property-id \
     --property-notification-state ENABLED \
     --property-alias property-alias
   ```

   Você também pode passar `--property-notification-state DISABLED` para desabilitar notificações para a propriedade de ativo.